mcward

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

demo

A test run with ward, results stream in live.

Ward comes in two parts:

🧩 Mod - Modrinth	Adds the test commands (`/assert`, `/await`, `/fail`, `/succeed`, `/dummy`) and a headless test server that streams results live.
🐍 CLI - PyPI	Installs test servers (Java and the mod are fetched for you) and runs your packs on one or several Minecraft versions. Also ships a beet plugin that adds `beet test`.

Quickstart

Install the CLI:

uv tool install mcward[cli]   # or: pip install mcward[cli]

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

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

Run it:

ward   # discovers your packs, picks compatible versions, runs the tests

Comment lines starting with @ are directives that configure the test, and assert is one of the test commands.

Ward is heavily inspired by packtest by misode, and implements its full command set.

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

mcward-1.1.0.tar.gz (2.3 MB view details)

Uploaded Aug 1, 2026 Source

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mcward-1.1.0-py3-none-any.whl (8.0 kB view details)

Uploaded Aug 1, 2026 Python 3

Details for the file mcward-1.1.0.tar.gz.

Download URL: mcward-1.1.0.tar.gz
Upload date: Aug 1, 2026
Size: 2.3 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Details for the file mcward-1.1.0-py3-none-any.whl.

Download URL: mcward-1.1.0-py3-none-any.whl
Upload date: Aug 1, 2026
Size: 8.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}