Перейти к содержимому
Mineforgian

MCio

Minecraft Input/Output

Загрузки
562
Подписчики
0
Обновлён
15 февраля 2026 г.
Лицензия
MIT

Опубликован 6 декабря 2024 г.

Исходный кодСообщить об ошибке

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

Ченджлог

1.6.1+1.21.3Релиз1.21.3 · 15 февраля 2026 г.

Changelog

1.6.1+1.21.3 - 2026-02-15

  • Fix issue that caused initial mouse movements to be ignored in some cases

1.6.0+1.21.3 - 2026-02-11

  • Convert to Mojang mappings in preparation for deobfuscated Minecraft

1.5.0+1.21.3 - 2026-02-09

  • Move disable command feedback to mcio_ctrl
  • Last version before converting to Mojang mappings
  • MCIO_PROTOCOL_VERSION = 7

1.4.0+1.21.3 - 2025-10-22

  • Clean up protocol parsing
  • Auto-format code
  • MCIO_PROTOCOL_VERSION = 7

1.3.0+1.21.3 - 2025-06-05

  • Track built-in Minecraft stats and send updates to the agent
  • Moving protocol to use options. This should help with performance as new data is added, and ease backward compatibility
  • MCIO_PROTOCOL_VERSION = 6

1.2.0+1.21.3 - 2025-05-26

  • Preload initial chunks in sync mode.
  • Add Open-To-LAN support
  • Default to the Steve skin. Also allow selection among default skins.
  • MCIO_PROTOCOL_VERSION = 5

1.1.0+1.21.3 - 2025-05-16

  • Fractional cursor positions. This allows for POV changes of < 0.15 degrees, matching MineRL.
  • MCIO_PROTOCOL_VERSION = 5

1.0.0+1.21.3 - 2025-05-09

  • MCIO_PROTOCOL_VERSION = 4

0.6.1+1.21.3 - 2025-05-05

  • Update readme for mcio_ctrl
  • MCIO_PROTOCOL_VERSION = 4

0.6.0+1.21.3 - 2025-05-03

  • More consistent clear input behavior in sync mode
  • Clear input also sets the mouse to a default position
  • MCIO_PROTOCOL_VERSION = 4

0.5.0+1.21.3 - 2025-04-06

  • Change protocol to combine keys and mouse buttons in the same list
  • MCIO_PROTOCOL_VERSION = 4

0.4.0+1.21.3 - 2025-03-11

  • Add key/button tracking
  • Add clean_input action
  • Add option to hide Minecraft window
  • Add option to disable FPS limits and vsync
  • Add raw frame support and make it the default. Raw frames are currently exported upside-down for performance reasons.
  • Removed jpeg and png frame export. Too slow.
  • Client and server tick fast in sync mode
  • MCIO_PROTOCOL_VERSION = 3

0.3.0+1.21.3 - 2025-01-14

  • Change from zmq pub/sub to push/pull
  • Action and observation ports are configurable via env variables
  • Option to send frames as jpeg
  • MCIO_PROTOCOL_VERSION = 2

0.2.0+1.21.3 - 2024-12-23

  • Add Stop to protocol
  • Reverse bind/connect for the action port
  • MCIO_PROTOCOL_VERSION = 1

0.1.2+1.21.3 - 2024-12-16

  • Default to mode ASYNC
  • MCIO_PROTOCOL_VERSION = 0

0.1.1+1.21.3 - 2024-12-08

  • Fix frame alignment issue
  • MCIO_PROTOCOL_VERSION = 0

0.1.0+1.21.3 - 2024-12-05

  • Initial release of the MCio mod for Minecraft.
  • MCIO_PROTOCOL_VERSION = 0
1.6.0+1.21.3Релиз1.21.3 · 12 февраля 2026 г.

Changelog

1.6.0+1.21.3 - 2026-02-11

  • Convert to Mojang mappings in preparation for deobfuscated Minecraft

1.5.0+1.21.3 - 2026-02-09

  • Move disable command feedback to mcio_ctrl
  • Last version before converting to Mojang mappings
  • MCIO_PROTOCOL_VERSION = 7

1.4.0+1.21.3 - 2025-10-22

  • Clean up protocol parsing
  • Auto-format code
  • MCIO_PROTOCOL_VERSION = 7

1.3.0+1.21.3 - 2025-06-05

  • Track built-in Minecraft stats and send updates to the agent
  • Moving protocol to use options. This should help with performance as new data is added, and ease backward compatibility
  • MCIO_PROTOCOL_VERSION = 6

1.2.0+1.21.3 - 2025-05-26

  • Preload initial chunks in sync mode.
  • Add Open-To-LAN support
  • Default to the Steve skin. Also allow selection among default skins.
  • MCIO_PROTOCOL_VERSION = 5

1.1.0+1.21.3 - 2025-05-16

  • Fractional cursor positions. This allows for POV changes of < 0.15 degrees, matching MineRL.
  • MCIO_PROTOCOL_VERSION = 5

1.0.0+1.21.3 - 2025-05-09

  • MCIO_PROTOCOL_VERSION = 4

0.6.1+1.21.3 - 2025-05-05

  • Update readme for mcio_ctrl
  • MCIO_PROTOCOL_VERSION = 4

0.6.0+1.21.3 - 2025-05-03

  • More consistent clear input behavior in sync mode
  • Clear input also sets the mouse to a default position
  • MCIO_PROTOCOL_VERSION = 4

0.5.0+1.21.3 - 2025-04-06

  • Change protocol to combine keys and mouse buttons in the same list
  • MCIO_PROTOCOL_VERSION = 4

0.4.0+1.21.3 - 2025-03-11

  • Add key/button tracking
  • Add clean_input action
  • Add option to hide Minecraft window
  • Add option to disable FPS limits and vsync
  • Add raw frame support and make it the default. Raw frames are currently exported upside-down for performance reasons.
  • Removed jpeg and png frame export. Too slow.
  • Client and server tick fast in sync mode
  • MCIO_PROTOCOL_VERSION = 3

0.3.0+1.21.3 - 2025-01-14

  • Change from zmq pub/sub to push/pull
  • Action and observation ports are configurable via env variables
  • Option to send frames as jpeg
  • MCIO_PROTOCOL_VERSION = 2

0.2.0+1.21.3 - 2024-12-23

  • Add Stop to protocol
  • Reverse bind/connect for the action port
  • MCIO_PROTOCOL_VERSION = 1

0.1.2+1.21.3 - 2024-12-16

  • Default to mode ASYNC
  • MCIO_PROTOCOL_VERSION = 0

0.1.1+1.21.3 - 2024-12-08

  • Fix frame alignment issue
  • MCIO_PROTOCOL_VERSION = 0

0.1.0+1.21.3 - 2024-12-05

  • Initial release of the MCio mod for Minecraft.
  • MCIO_PROTOCOL_VERSION = 0
1.5.0+1.21.3Релиз1.21.3 · 10 февраля 2026 г.

Changelog

1.5.0+1.21.3 - 2026-02-09

  • Move disable command feedback to mcio_ctrl
  • Last version before converting to Mojang mappings
  • MCIO_PROTOCOL_VERSION = 7

1.4.0+1.21.3 - 2025-10-22

  • Clean up protocol parsing
  • Auto-format code
  • MCIO_PROTOCOL_VERSION = 7

1.3.0+1.21.3 - 2025-06-05

  • Track built-in Minecraft stats and send updates to the agent
  • Moving protocol to use options. This should help with performance as new data is added, and ease backward compatibility
  • MCIO_PROTOCOL_VERSION = 6

1.2.0+1.21.3 - 2025-05-26

  • Preload initial chunks in sync mode.
  • Add Open-To-LAN support
  • Default to the Steve skin. Also allow selection among default skins.
  • MCIO_PROTOCOL_VERSION = 5

1.1.0+1.21.3 - 2025-05-16

  • Fractional cursor positions. This allows for POV changes of < 0.15 degrees, matching MineRL.
  • MCIO_PROTOCOL_VERSION = 5

1.0.0+1.21.3 - 2025-05-09

  • MCIO_PROTOCOL_VERSION = 4

0.6.1+1.21.3 - 2025-05-05

  • Update readme for mcio_ctrl
  • MCIO_PROTOCOL_VERSION = 4

0.6.0+1.21.3 - 2025-05-03

  • More consistent clear input behavior in sync mode
  • Clear input also sets the mouse to a default position
  • MCIO_PROTOCOL_VERSION = 4

0.5.0+1.21.3 - 2025-04-06

  • Change protocol to combine keys and mouse buttons in the same list
  • MCIO_PROTOCOL_VERSION = 4

0.4.0+1.21.3 - 2025-03-11

  • Add key/button tracking
  • Add clean_input action
  • Add option to hide Minecraft window
  • Add option to disable FPS limits and vsync
  • Add raw frame support and make it the default. Raw frames are currently exported upside-down for performance reasons.
  • Removed jpeg and png frame export. Too slow.
  • Client and server tick fast in sync mode
  • MCIO_PROTOCOL_VERSION = 3

0.3.0+1.21.3 - 2025-01-14

  • Change from zmq pub/sub to push/pull
  • Action and observation ports are configurable via env variables
  • Option to send frames as jpeg
  • MCIO_PROTOCOL_VERSION = 2

0.2.0+1.21.3 - 2024-12-23

  • Add Stop to protocol
  • Reverse bind/connect for the action port
  • MCIO_PROTOCOL_VERSION = 1

0.1.2+1.21.3 - 2024-12-16

  • Default to mode ASYNC
  • MCIO_PROTOCOL_VERSION = 0

0.1.1+1.21.3 - 2024-12-08

  • Fix frame alignment issue
  • MCIO_PROTOCOL_VERSION = 0

0.1.0+1.21.3 - 2024-12-05

  • Initial release of the MCio mod for Minecraft.
  • MCIO_PROTOCOL_VERSION = 0
1.4.0+1.21.3Релиз1.21.3 · 22 октября 2025 г.

Changelog

1.4.0+1.21.3 - 2025-10-22

  • Clean up protocol parsing
  • Auto-format code
  • MCIO_PROTOCOL_VERSION = 7

1.3.0+1.21.3 - 2025-06-05

  • Track built-in Minecraft stats and send updates to the agent
  • Moving protocol to use options. This should help with performance as new data is added, and ease backward compatibility
  • MCIO_PROTOCOL_VERSION = 6

1.2.0+1.21.3 - 2025-05-26

  • Preload initial chunks in sync mode.
  • Add Open-To-LAN support
  • Default to the Steve skin. Also allow selection among default skins.
  • MCIO_PROTOCOL_VERSION = 5

1.1.0+1.21.3 - 2025-05-16

  • Fractional cursor positions. This allows for POV changes of < 0.15 degrees, matching MineRL.
  • MCIO_PROTOCOL_VERSION = 5

1.0.0+1.21.3 - 2025-05-09

  • MCIO_PROTOCOL_VERSION = 4

0.6.1+1.21.3 - 2025-05-05

  • Update readme for mcio_ctrl
  • MCIO_PROTOCOL_VERSION = 4

0.6.0+1.21.3 - 2025-05-03

  • More consistent clear input behavior in sync mode
  • Clear input also sets the mouse to a default position
  • MCIO_PROTOCOL_VERSION = 4

0.5.0+1.21.3 - 2025-04-06

  • Change protocol to combine keys and mouse buttons in the same list
  • MCIO_PROTOCOL_VERSION = 4

0.4.0+1.21.3 - 2025-03-11

  • Add key/button tracking
  • Add clean_input action
  • Add option to hide Minecraft window
  • Add option to disable FPS limits and vsync
  • Add raw frame support and make it the default. Raw frames are currently exported upside-down for performance reasons.
  • Removed jpeg and png frame export. Too slow.
  • Client and server tick fast in sync mode
  • MCIO_PROTOCOL_VERSION = 3

0.3.0+1.21.3 - 2025-01-14

  • Change from zmq pub/sub to push/pull
  • Action and observation ports are configurable via env variables
  • Option to send frames as jpeg
  • MCIO_PROTOCOL_VERSION = 2

0.2.0+1.21.3 - 2024-12-23

  • Add Stop to protocol
  • Reverse bind/connect for the action port
  • MCIO_PROTOCOL_VERSION = 1

0.1.2+1.21.3 - 2024-12-16

  • Default to mode ASYNC
  • MCIO_PROTOCOL_VERSION = 0

0.1.1+1.21.3 - 2024-12-08

  • Fix frame alignment issue
  • MCIO_PROTOCOL_VERSION = 0

0.1.0+1.21.3 - 2024-12-05

  • Initial release of the MCio mod for Minecraft.
  • MCIO_PROTOCOL_VERSION = 0
1.3.0+1.21.3Релиз1.21.3 · 6 июня 2025 г.

Changelog

1.3.0+1.21.3 - 2025-06-05

  • Track built-in Minecraft stats and send updates to the agent
  • Moving protocol to use options. This should help with performance as new data is added, and ease backward compatibility
  • MCIO_PROTOCOL_VERSION = 6

1.2.0+1.21.3 - 2025-05-26

  • Preload initial chunks in sync mode.
  • Add Open-To-LAN support
  • Default to the Steve skin. Also allow selection among default skins.
  • MCIO_PROTOCOL_VERSION = 5

1.1.0+1.21.3 - 2025-05-16

  • Fractional cursor positions. This allows for POV changes of < 0.15 degrees, matching MineRL.
  • MCIO_PROTOCOL_VERSION = 5

1.0.0+1.21.3 - 2025-05-09

  • MCIO_PROTOCOL_VERSION = 4

0.6.1+1.21.3 - 2025-05-05

  • Update readme for mcio_ctrl
  • MCIO_PROTOCOL_VERSION = 4

0.6.0+1.21.3 - 2025-05-03

  • More consistent clear input behavior in sync mode
  • Clear input also sets the mouse to a default position
  • MCIO_PROTOCOL_VERSION = 4

0.5.0+1.21.3 - 2025-04-06

  • Change protocol to combine keys and mouse buttons in the same list
  • MCIO_PROTOCOL_VERSION = 4

0.4.0+1.21.3 - 2025-03-11

  • Add key/button tracking
  • Add clean_input action
  • Add option to hide Minecraft window
  • Add option to disable FPS limits and vsync
  • Add raw frame support and make it the default. Raw frames are currently exported upside-down for performance reasons.
  • Removed jpeg and png frame export. Too slow.
  • Client and server tick fast in sync mode
  • MCIO_PROTOCOL_VERSION = 3

0.3.0+1.21.3 - 2025-01-14

  • Change from zmq pub/sub to push/pull
  • Action and observation ports are configurable via env variables
  • Option to send frames as jpeg
  • MCIO_PROTOCOL_VERSION = 2

0.2.0+1.21.3 - 2024-12-23

  • Add Stop to protocol
  • Reverse bind/connect for the action port
  • MCIO_PROTOCOL_VERSION = 1

0.1.2+1.21.3 - 2024-12-16

  • Default to mode ASYNC
  • MCIO_PROTOCOL_VERSION = 0

0.1.1+1.21.3 - 2024-12-08

  • Fix frame alignment issue
  • MCIO_PROTOCOL_VERSION = 0

0.1.0+1.21.3 - 2024-12-05

  • Initial release of the MCio mod for Minecraft.
  • MCIO_PROTOCOL_VERSION = 0
1.2.0+1.21.3Релиз1.21.3 · 26 мая 2025 г.

Changelog

1.2.0+1.21.3 - 2025-05-26

  • Preload initial chunks in sync mode.
  • Add Open-To-LAN support
  • Default to the Steve skin. Also allow selection among default skins.
  • MCIO_PROTOCOL_VERSION = 5

1.1.0+1.21.3 - 2025-05-16

  • Fractional cursor positions. This allows for POV changes of < 0.15 degrees, matching MineRL.
  • MCIO_PROTOCOL_VERSION = 5

1.0.0+1.21.3 - 2025-05-09

  • MCIO_PROTOCOL_VERSION = 4

0.6.1+1.21.3 - 2025-05-05

  • Update readme for mcio_ctrl
  • MCIO_PROTOCOL_VERSION = 4

0.6.0+1.21.3 - 2025-05-03

  • More consistent clear input behavior in sync mode
  • Clear input also sets the mouse to a default position
  • MCIO_PROTOCOL_VERSION = 4

0.5.0+1.21.3 - 2025-04-06

  • Change protocol to combine keys and mouse buttons in the same list
  • MCIO_PROTOCOL_VERSION = 4

0.4.0+1.21.3 - 2025-03-11

  • Add key/button tracking
  • Add clean_input action
  • Add option to hide Minecraft window
  • Add option to disable FPS limits and vsync
  • Add raw frame support and make it the default. Raw frames are currently exported upside-down for performance reasons.
  • Removed jpeg and png frame export. Too slow.
  • Client and server tick fast in sync mode
  • MCIO_PROTOCOL_VERSION = 3

0.3.0+1.21.3 - 2025-01-14

  • Change from zmq pub/sub to push/pull
  • Action and observation ports are configurable via env variables
  • Option to send frames as jpeg
  • MCIO_PROTOCOL_VERSION = 2

0.2.0+1.21.3 - 2024-12-23

  • Add Stop to protocol
  • Reverse bind/connect for the action port
  • MCIO_PROTOCOL_VERSION = 1

0.1.2+1.21.3 - 2024-12-16

  • Default to mode ASYNC
  • MCIO_PROTOCOL_VERSION = 0

0.1.1+1.21.3 - 2024-12-08

  • Fix frame alignment issue
  • MCIO_PROTOCOL_VERSION = 0

0.1.0+1.21.3 - 2024-12-05

  • Initial release of the MCio mod for Minecraft.
  • MCIO_PROTOCOL_VERSION = 0
1.1.0+1.21.3Релиз1.21.3 · 17 мая 2025 г.

Changelog

1.1.0+1.21.3 - 2025-05-16

  • Fractional cursor positions. This allows for POV changes of < 0.15 degrees, matching MineRL.
  • MCIO_PROTOCOL_VERSION = 5

1.0.0+1.21.3 - 2025-05-09

  • MCIO_PROTOCOL_VERSION = 4

0.6.1+1.21.3 - 2025-05-05

  • Update readme for mcio_ctrl
  • MCIO_PROTOCOL_VERSION = 4

0.6.0+1.21.3 - 2025-05-03

  • More consistent clear input behavior in sync mode
  • Clear input also sets the mouse to a default position
  • MCIO_PROTOCOL_VERSION = 4

0.5.0+1.21.3 - 2025-04-06

  • Change protocol to combine keys and mouse buttons in the same list
  • MCIO_PROTOCOL_VERSION = 4

0.4.0+1.21.3 - 2025-03-11

  • Add key/button tracking
  • Add clean_input action
  • Add option to hide Minecraft window
  • Add option to disable FPS limits and vsync
  • Add raw frame support and make it the default. Raw frames are currently exported upside-down for performance reasons.
  • Removed jpeg and png frame export. Too slow.
  • Client and server tick fast in sync mode
  • MCIO_PROTOCOL_VERSION = 3

0.3.0+1.21.3 - 2025-01-14

  • Change from zmq pub/sub to push/pull
  • Action and observation ports are configurable via env variables
  • Option to send frames as jpeg
  • MCIO_PROTOCOL_VERSION = 2

0.2.0+1.21.3 - 2024-12-23

  • Add Stop to protocol
  • Reverse bind/connect for the action port
  • MCIO_PROTOCOL_VERSION = 1

0.1.2+1.21.3 - 2024-12-16

  • Default to mode ASYNC
  • MCIO_PROTOCOL_VERSION = 0

0.1.1+1.21.3 - 2024-12-08

  • Fix frame alignment issue
  • MCIO_PROTOCOL_VERSION = 0

0.1.0+1.21.3 - 2024-12-05

  • Initial release of the MCio mod for Minecraft.
  • MCIO_PROTOCOL_VERSION = 0
1.0.0+1.21.3Релиз1.21.3 · 10 мая 2025 г.

Changelog

1.0.0+1.21.3 - 2025-05-09

  • MCIO_PROTOCOL_VERSION = 4

0.6.1+1.21.3 - 2025-05-05

  • Update readme for mcio_ctrl
  • MCIO_PROTOCOL_VERSION = 4

0.6.0+1.21.3 - 2025-05-03

  • More consistent clear input behavior in sync mode
  • Clear input also sets the mouse to a default position
  • MCIO_PROTOCOL_VERSION = 4

0.5.0+1.21.3 - 2025-04-06

  • Change protocol to combine keys and mouse buttons in the same list
  • MCIO_PROTOCOL_VERSION = 4

0.4.0+1.21.3 - 2025-03-11

  • Add key/button tracking
  • Add clean_input action
  • Add option to hide Minecraft window
  • Add option to disable FPS limits and vsync
  • Add raw frame support and make it the default. Raw frames are currently exported upside-down for performance reasons.
  • Removed jpeg and png frame export. Too slow.
  • Client and server tick fast in sync mode
  • MCIO_PROTOCOL_VERSION = 3

0.3.0+1.21.3 - 2025-01-14

  • Change from zmq pub/sub to push/pull
  • Action and observation ports are configurable via env variables
  • Option to send frames as jpeg
  • MCIO_PROTOCOL_VERSION = 2

0.2.0+1.21.3 - 2024-12-23

  • Add Stop to protocol
  • Reverse bind/connect for the action port
  • MCIO_PROTOCOL_VERSION = 1

0.1.2+1.21.3 - 2024-12-16

  • Default to mode ASYNC
  • MCIO_PROTOCOL_VERSION = 0

0.1.1+1.21.3 - 2024-12-08

  • Fix frame alignment issue
  • MCIO_PROTOCOL_VERSION = 0

0.1.0+1.21.3 - 2024-12-05

  • Initial release of the MCio mod for Minecraft.
  • MCIO_PROTOCOL_VERSION = 0

Комментарии

Загружаем…