Repository navigation
PlayGoblin 0.1.0 (pre-release)
PlayGoblin is an open-source QA bot that plays your game unattended like a person (real input bindings, mouse look, menu crawl, frontier exploration) and reports crashes, stuck spots, falls through the world, dead input and buttons, placeholder text and art, missing-material pink, blank screens and FPS drops, with frame/clip evidence. The checks are plain deterministic code; an LLM is optional.
What's in it
playgoblinCLI (run,report,file-issues, all with--json) and a dependency-free MCP server (playgoblin mcp)- Unreal Engine plugin (verified on UE 5.8.3 Win64: a sample project and one real game)
- Unity package (verified on Unity 6000.4)
- Run-folder protocol (
docs/PROTOCOL.md) so any engine can write runs the report understands
Install
Python CLI (3.11+), from the release wheel:
pip install https://github.com/grloper/playgoblin/releases/download/v0.1.0/playgoblin-0.1.0-py3-none-any.whl
Unreal: unzip PlayGoblin-Unreal-plugin-0.1.0.zip into your project's Plugins/ folder (it contains a PlayGoblin/ directory), then run the game with -playgoblin.
Unity: Package Manager > Add package from git URL:
https://github.com/grloper/playgoblin.git?path=/unity#v0.1.0
Honest status
This is a pre-release. Accuracy on real games is not measured yet, and "no findings" never means "bug free". The bot walks and clicks rather than playing to win, and it does not judge fun, balance, visuals or audio. Unreal has been tested on one version and one real game; Unity on one version. Expect rough edges and please report false positives. The Unreal plugin ships as source (no prebuilt binaries) and is compiled by your project.
Assets
playgoblin-0.1.0-py3-none-any.whl,playgoblin-0.1.0.tar.gzPlayGoblin-Unreal-plugin-0.1.0.zipSHA256SUMS
Full list of changes: CHANGELOG.md.