Built by Game Devs, for Game Devs

ghosttester-sdk / v0.9.41 / local-first

Stop walking into walls.

Let autonomous telemetry find your collision leaks.

GhostTester is a Unity and Unreal SDK that turns chaotic NPC movement into actionable collision evidence, before your release build reaches players.

Unity 2022.3+Unreal 5.2+No build upload
Unity Editor / GhostTester
CONNECTED

Scene

Map_Level_01

Agent

GhostTesterBot_01

State

RECORDING

1
2
3
4
5
6
7
8
9
10
11
12
{
  "event": "collision_breach",
  "timestamp_ms": 184029,
  "transform": {
    "position": { "x": 12.45, "y": -4.20,
      "z": 89.11 },
    "velocity": { "x": 2.14, "y": 0.00, "z": 6.80 }
  },
  "collider_type": "MeshCollider",
  "layer_mask": "Environment.Solid",
  "object_name": "NorthWall_A_07"
}
telemetry buffer: 2.4 KBLOCAL PROCESS

01 / The brief

A small tool for a very specific release-day problem.

README.md / WHY_GHOSTTESTER

# target_user

For teams shipping complex 3D spaces.

Indie developers protecting their sanity during a tight release schedule, plus AA/AAA QA teams that need more coverage than human wall-walking can provide.

// Not a general-purpose test suite.
// A focused collision signal for game teams.

# pain_point

Manual coverage misses the weird stuff.

A tester can spend hundreds of hours walking into walls, but cannot recreate every jump, crouch, wall-hug, and high-velocity edge case. One missed breach becomes a Day-1 crash or a costly post-launch patch.

issue_status: unresolved_without_automation

02 / The AI core

A build pipeline for collision evidence.

No magic box. Three observable stages from movement data to a ticket your team can triage.

01 / CAPTURE_coordinates

Autonomous Exploration

A lightweight reinforcement learning agent roams Unity or Unreal maps, recreating chaotic player behavior across jump, crouch, and wall-hug paths.

02 / DETECT[breach_event]

Instant Collision Breach

When transform coordinates cross a solid mesh layer, the engine pauses, captures the physics state, and preserves the exact failing frame.

03 / REPORT-> git_issue

LLM Reasoning & Reporting

Telemetry and a frame snapshot become a structured report with severity, coordinates, collider context, and a production-ready JIRA ticket.

03 / Local engine integration

Install the plugin. Keep the build local.

SDK_STATUS: READY

Seamless Engine Integration

Download our lightweight package, import it into Unity or Unreal in 2 clicks, then attach the GhostTester script to any NPC or autonomous test agent.

source_codestays_local
game_buildstays_local
external_uploaddisabled
Download Unity SDK (.unitypackage) Watch Live MVP Framework Demo (2 Mins Video)
Unity Console / ghosttester
LOCAL ONLY

12:00:01.042 [OK] SDK initialized in Map_Level_01

12:00:04.819 [OK] 14,200 movement combinations executed

12:00:08.227 [CRITICAL_BREACH] Collision at Vector3(12.45, -4.20, 89.11)

12:00:08.228 [CRITICAL_BREACH] MeshCollider / Environment.Solid / NorthWall_A_07

12:00:09.091 [JIRA_API_SYNC] Sending coordinates and object name only

12:00:11.540 [JIRA_API_SYNC] Ticket #GT-402 created / High Severity

telemetry: 2.4 KB / api_payload: 184 B / build_upload: false

04 / Quality & feasibility

Useful signal, honestly scoped.

Metric
Manual
GhostTester
Time to coverage
48 hours
1 hour
Run cost
High
$0.05 API
Human error
High
0%

Honest limitations

Minor false positives can occur on non-solid visual meshes such as foliage or cloth curtains. The active bounding-box metadata filter bypasses non-blocking layers.

Zero security risks

The SDK operates locally inside engine telemetry. Only lightweight text strings, coordinates, and object names are sent to the LLM API for report generation.