golem

Appearance

golemTest your plugin the way players use it

One command boots a real PocketMine-MP server, loads your plugin from source and fills it with simulated players. Run it in your terminal, in CI, or from a dashboard in your browser. No mocks, no client, no more testing by hand.

Get started
Try the dashboard
View on GitHub
The Golem pixel-art head
🧭

A dashboard in your browser

vendor/bin/golem ui: run your tests and watch them live, read failures next to the code, see coverage line by line, build tests without writing PHP.

Try the live demo

🖥️

A real server

Your plugin runs on the PocketMine-MP version you pick, with every event fired in the real order. If it passes in Golem, it works in production.

🧍

Simulated players

Golems are genuine Player objects behind a fake network session. They join, chat, run commands, click forms, break blocks and get kicked.

What golems can do

⏱️

Time is a first-class citizen

Tests are generators. Yield a golem, a number of ticks or a condition, and the test resumes when it is ready. Cooldowns and delayed tasks become testable.

Waiting in tests

📦

Zero setup

Golem downloads the official PocketMine PHP build and server phar once, caches them, and creates a fresh world for every run.

🔎

Failures you can read

Expected versus actual, the failing line of your test, and the server log when something crashes. Minecraft-aware assertions included.

All assertions

🐛

Finds what you missed

The fuzzer has golems do random things to your plugin and turns every crash into a test. The benchmark tells you how many players it holds.

Fuzzing and benchmarks

✅

Made for CI

JUnit reports, failures annotated on the pull request, and a GitHub Action that fits in one line.

Set up CI

Twenty seconds of Golem ​

A test spawns Steve, he joins a real server, gets greeted, and the test checks it. Then the same thing for every behaviour of your plugin, in one command.

php
public function testGreetsPlayersByName(): Generator
{
    $steve = yield $this->golem('Steve');

    $this->assertReceivedMessage($steve, 'Welcome, Steve!');
    $this->assertHasItem($steve, VanillaItems::BREAD(), 3);
}

Three steps ​

From a plugin with no tests to a green run in about five minutes.

Install ​

Golem is a dev dependency. The CLI itself needs nothing else.

bash
composer require --dev achedon12/golem

Scaffold ​

A first test and a GitHub Actions workflow.

bash
vendor/bin/golem init

Run ​

Boots a server, runs every test, stops it. Or open the dashboard.

bash
vendor/bin/golem
vendor/bin/golem ui

Results as they happen ​

Each test reports as soon as it finishes, with how long it took in milliseconds and server ticks. This is the real output of the example plugin shipped with Golem.

Golem output: every test of the example plugin passing

And when it breaks ​

You see what was expected, what the server actually sent, and the exact line of your test.

A failing test with expected and actual values and the failing line

Or click through it all ​

vendor/bin/golem ui opens a dashboard on your machine: pick tests, watch them pass live, open a failure next to the line that broke, see which lines of your plugin your tests never ran. Fuzz, benchmark, and build tests without writing PHP, from the same page.

The Golem dashboard: the tests of a plugin, a failure with the expected and actual values and the line that failedOpen the live demo →

Every pull request, tested ​

Add one step to your workflow. PocketMine is cached between runs, a JUnit report is written, and failures are annotated right on the diff.

yaml
jobs:
  golem:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: achedon12/golem@v0

Stop testing your plugin by hand ​

Golem is open source (MIT) and young: feedback shapes what comes next.

Get started
Join the discussion

Released under the MIT License.

Copyright © 2026 Achedon12