Ward

Ward lets you write automated tests for your datapacks as plain .mcfunction files in a test/ folder.

Ward is two pieces that work together:

• 🧩 The Mod (on Modrinth) — a Fabric mod adding the test commands (/assert, /await, /fail, /succeed, /dummy) and a headless test server that streams results live.
• 🐍 The Tooling (on PyPI) — the mcward CLI that installs test servers (fetching Java and the mod for you), runs your packs against one or several Minecraft versions with a live display, plus a beet plugin adding beet test.

Write tests in your datapack under data/<namespace>/test/:

# @timeout 100
summon minecraft:armor_stand ~ ~ ~ {Tags: ["target"]}
assert entity @e[tag=target]
await not entity @e[tag=target]

Test files support directives (# @timeout, # @optional, # @dummy, # @template, # @environment, # @skyaccess) and the full command set:

Console

uv tool install mcward[cli]   # or: pip install mcward[cli]
mcward test                   # discovers datapacks, picks compatible versions, runs

In-Game

• /test run <name> - Run a specific test
• /test runall [namespace] - Run all tests (optionally filtered by namespace)
• /test runfailed - Re-run previously failed tests
• /test runthis - Run the closest test
• /test runthese - Run all tests within 200 blocks

Documentation

• CLI — the mcward CLI and beet test
• Dummies — fake players and the /dummy command
• Directives — # @timeout, # @environment, ...
• Test commands — /assert, /await, /fail, /succeed
• Test environments — world setup/teardown around tests

Acknowledgements

Ward is heavily inspired by packtest by misode.

Ward implements packtest's full command set, so existing packtest tests run unmodified under Ward. On top of that, Ward adds a few extra commands, a CLI with multi-version runs and a live test display, and a beet test plugin.