MCTestPlaywright for Minecraft

Let Claude Code, or any MCP client, drive a running Minecraft client and test your mod. Dev-only, for Minecraft 26.3 on Fabric and NeoForge.

Get started

Browse the tools

Real input, real code paths

Clicks and keys go through Minecraft's own mouse and keyboard handlers, and interactions through MultiPlayerGameMode, so the server validates them as for a real player.

See what the player sees

Screenshots, widget and container snapshots, tooltips (including hold-shift ones), block-entity NBT, entities, inventories and the captured log.

Plays like a player

Pathfinding walks, mining with real dig time, recipe-book crafting, melee with attack cooldowns, and lockstep time so the world waits while the agent thinks.

GameTests in the loop

Run your mod's GameTests in the open world and get pass/fail per test, so an agent can write a test, rebuild and check it.

Dedicated servers too

A second API on the server shows the authoritative side, for bugs that only appear in multiplayer.

Never shipped

Added as a dev-runtime dependency, loopback-only, and never in your jar or published POM.