Screenshots
About this Mod
Minecraft Input/Output (MCio)
MCio mod | mcio_ctrl | Documentation | Discord
MCio is a Fabric mod that exposes a network interface to Minecraft for AI research. It accepts keyboard/mouse input and sends back video frames and game state over ZeroMQ.
Features
- Python library (mcio_ctrl) with Gymnasium environments
- Faster than real-time performance (>13x on an M3 laptop)
- Works with performance mods like Sodium
- Supports resource packs for varied training environments
- Connect/reconnect agents without restarting Minecraft
- Decoupled ZMQ protocol for easy integration
- Synchronous mode for fast training
- Asynchronous mode for real-time human/AI interaction
- Headless mode with GPU acceleration
- VPT and STEVE-1 support on modern Minecraft with Sodium
Links
Available Versions
How to Install MCio on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.3).
Install Mod
Open the mod browser in the dashboard and search for "MCio". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.3
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
MCio server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.3). You can switch loaders with one click in the panel.
Is MCio compatible with fabric?
MCio officially supports fabric for Minecraft 1.21.3. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with MCio – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if MCio consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install MCio with just one click on your server.