Why Plugwright?
MockBukkit has limited support for GUIs and lacks NMS support. We created Plugwright because testing plugins that rely on real mechanics, complex GUIs, and NMS was painful. With Plugwright, you spin up a real server, inject real player bots, and test your plugins end-to-end.Key Features
Plugwright offers a unique set of features tailored for modern Minecraft plugin development:Real Player Bots
Instead of mocking the server, Plugwright spawns actual Mineflayer bots that connect to your local test server. They can move, chat, click blocks, and interact with your GUIs exactly like a real human player.
Zero Configuration Server
The framework automatically downloads the correct Paper server JAR for your specified version, sets it up, accepts the EULA, and loads your plugin before running tests. When tests are done, the environment is cleanly wiped (or cached).
Live GUI Locators
Tired of asserting raw inventory slots? Use reactive locators to find items by name, lore, or material. The locators automatically poll for updates, making your tests flake-free even if the server lags.
Type-Safe API
Written in TypeScript, the Plugwright test runner provides excellent IDE autocompletion for matchers, server actions, and bot interactions.
CI/CD Ready
Designed to run flawlessly in GitHub Actions or any other CI pipeline. It takes less than 5 minutes to set up automated PR checks that test your plugin against a real server.
Next Steps
Ready to get started?Quick Start
Check out the Quick Start guide to run your first test in less than 5 minutes!