Skip to content

fastesteash/SJHack2026

Repository files navigation

Playtest Pilot

Playtest Pilot is a Unity QA bot that helps automate parts of the playtesting process. It tests gameplay, settings, hardware and performance profiles, and basic exploit or security-related issues, then generates a report showing what broke.

For our demo, we used Dragon Crashers as the test game and built a workflow that could run checks automatically and present the results in a dashboard.


Overview

Playtesting a Unity game can be repetitive, messy, and hard to organize, especially for smaller teams. Playtest Pilot was built to make testing easier, more structured, and more useful for developers.

It also includes hardware-based game settings for a more personalized and smoother gameplay experience. We added this because many in-game settings can be confusing for players, and if they are not configured properly, they can hurt performance or create a frustrating experience.


Features

  • Automated Unity playtesting
  • Gameplay path validation
  • Settings and configuration checks
  • Hardware and performance testing
  • Basic exploit and security-related checks
  • Bug reporting dashboard
  • Severity labels for issues
  • Hardware-based personalized settings

MVP Scope

Our first version focuses on five core tasks:

  1. Run the game automatically
  2. Play one short scripted path
  3. Change a few settings and test them
  4. Run 2–3 security or logic checks
  5. Generate a report

Example Test Cases

For Dragon Crashers, we prioritized tests such as:

  • Duplicate reward claim
  • Attack cooldown spam
  • Invalid state checks, such as attacking while dead or paused
  • Fullscreen/windowed switch
  • Low vs high graphics preset performance
  • Ultrawide UI/layout check

Architecture

High-level flow:

React Dashboard → FastAPI Backend → Python Host Agent → Unity Bridge / QA Agent → Telemetry Storage

Main Components

  • Dashboard (React)
    Frontend UI for viewing results and interacting with the system.

  • Backend (FastAPI, Port 8000)
    Main service connecting the dashboard to the automation system.

  • Host Agent Server (Python, Port 19091)
    Local automation server that communicates with Unity.

  • Unity Bridge (C#, Port 9090)
    Connects Unity gameplay data and controls to the automation layer.

  • QA Agent
    Runs automated actions and checks inside Unity.

  • Telemetry Storage (JSON + NDJSON)
    Stores logs, events, and test results.


Tech Stack

Core

  • Unity
  • Dragon Crashers
  • C#
  • Python
  • JSON / NDJSON

Frontend

  • React
  • Vite
  • Tailwind CSS
  • Framer Motion
  • Lucide React

Backend / Automation

  • FastAPI
  • Python host agent
  • Unity C# bridge

AI / Development Support

  • Cursor
  • Claude
  • ChatGPT
  • Qwen Local

Project Structure

playtest-pilot/
├── frontend/              # React dashboard
├── backend/               # FastAPI backend
├── host-agent/            # Python host agent / automation runner
├── unity-project/         # Unity game integration and hooks
├── telemetry/             # JSON / NDJSON logs and test results
└── README.md

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors