MC Puppet

•

Enables programs to observe and control a running Minecraft client or server, facilitating automated mod testing and script-driven interactions without human input.

MC Puppet empowers developers and testers to automate interactions within a running Minecraft instance, whether client or server. Unlike traditional server-side-only automation, it uniquely allows programs to 'see' and 'act' upon the client's graphical interface, including screens, widgets, and player views, precisely as a human player would. This capability is crucial for thoroughly testing mod functionality that relies on UI elements or intricate gameplay mechanics, offering a robust solution for automated testing in CI/CD pipelines, integration with AI agents, or scripting complex in-game scenarios, thereby eliminating the need for manual player intervention.

主な機能

01Client-Side UI Automation: Access screen data, widgets, slots, and merchant offers; perform clicks, drags, key presses, and typing to simulate player input.
02Comprehensive Game Interaction: Control player actions like looking, holding keys, attacking, breaking blocks, and using entities or blocks through game-native code paths.
03Enhanced Server-Side Control: Execute commands with captured output, inspect player inventories, view entity data (like villager offers), and examine block contents, exceeding basic RCON capabilities.
04Scenario-Driven Testing: Define and execute automated test sequences with expectations using JSON-based steps, suitable for integration with shell scripts, CI systems, or AI agents.
05World and Session Management: Programmatically create, open, and leave worlds, resize windows, change GUI scale, quit the game, and wait for specific in-game states.
060 GitHub stars

ユースケース

01Empowering AI coding agents or scripts to interact with and test Minecraft environments directly through the game client.
02Automating comprehensive client-side mod testing for UI, gameplay interactions, and visual integrity.
03Integrating Minecraft game automation into CI/CD pipelines for continuous validation of mod functionality.