Ward runs automated tests for Minecraft datapacks. Tests are plain .mcfunction files in a test/ folder.
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 and runs your packs on one or more Minecraft versions. Java and the mod are downloaded for you. Also ships a beet plugin that adds beet test. |
Quickstart
Install the CLI (requires Python 3.14 or newer):
uv tool install mcward[cli] # or: pip install mcward[cli]
Write a test in your datapack under data/<namespace>/test/:
# @max_ticks 20
summon minecraft:zombie ~ ~ ~ {Tags: ["target"]}
kill @e[tag=target]
await not entity @e[tag=target]
Ward finds your packs, picks matching versions, and runs the tests:
ward
Comments starting with @ are directives. They configure the test.
await and assert are the test commands.
Documentation
- Test commands:
/assert,/await,/fail,/succeed - Test environments: world setup/teardown around tests
- Directives:
@max_ticks,@environment, ... - Dummies: fake players and the
/dummycommand - Coverage: which parts of your packs the tests run
- Benchmarks: time commands and compare them
- CLI: the
mcwardCLI andbeet test
Acknowledgements
Ward is heavily inspired by packtest by misode, and implements its full command set.
1 maintainer
Metadata
1 maintainer
Release files for mcward 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcward-1.4.0.tar.gz | 2.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcward-1.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.4 MB
Release files / mcward-1.4.0.tar.gz
| Download URL | mcward-1.4.0.tar.gz |
|---|---|
| Size | 2.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
64d23c82c938c67555e1221a4985dbc62eac95c6c1bc994df7bba17de31f200a
|
|
BLAKE2b-256 checksum How to use checksums |
bd1a9e2db717a633a6b68be78633027d2d393d606cbacd3fcdaca8fc705af07d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","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}
|
Release files / mcward-1.4.0-py3-none-any.whl
| Download URL | mcward-1.4.0-py3-none-any.whl |
|---|---|
| Size | 8.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
45aebdd01f03bc9a749bb051405763979d2ad8b57c3cce9ae88b5f4dc38379c6
|
|
BLAKE2b-256 checksum How to use checksums |
0e6c01824a4c6d85f73a92c8bf1f5b435836008d28fa45621b29d55e7e7bb33b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","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}
|
