SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedTechnology & automation

M1 - Machine One AI Interface

by Kishku7 · for Minecraft

Operate the Minecraft client through a local text interface, for automation and AI control.

1.4KDownloads
2 mo agoLast updated
LicenseRef-All-Rights-ReservedLicense
Fabric · Forge +2Loaders

About M1 - Machine One AI Interface

From Modrinth

Operate the Minecraft client through a local text interface, for automation and AI control.

M1 -- Machine One AI Interface

PLEASE review the branches above for the source code tree.

M1 is a Minecraft mod that exposes the real, running game client over a plain localhost text socket. It describes whatever screen or world is in front of the client as text, and accepts text commands to drive it -- so a human at a terminal, or an AI over a socket, can operate Minecraft entirely by typing. No GUI mouse/keyboard is required and nothing needs to be "looked at" on screen; the window is there purely for observability.

Ships as a Fabric, NeoForge, and Forge mod spanning Minecraft 1.20 through 26.x, as a client agent plus an optional server-side /m1srv command (needs neither side present).

Source code / build & setup guide | Report an issue / get support

> New here? Read the AI_Brain (00_Index.md) first. That is the file an AI agent > is expected to load before a play session. This README is the reference manual behind it.


1. Popular Uses for M1

Most "AI plays Minecraft" projects never actually run Minecraft. They are protocol bots that speak the server's network protocol from the outside (Mineflayer, and LLM agents built on it like Voyager), or research stacks pinned to ancient versions (Malmo, MineRL). Because they never load the real client, they are blind to anything the client draws -- mod GUIs simply do not exist to them, and a version or mod mismatch breaks them.

M1 is the real client. It loads as an ordinary Fabric / NeoForge / Forge mod, reads every real screen, and drives the game the way you would. That unlocks what the protocol bots cannot touch:

  1. Mod development & real-client testing. Test your mod the way a player actually experiences

it -- open its screens, click its buttons, read its inventories, drive its menus, grab screenshots -- all by text. M1 has served as the live test harness across 20+ release builds spanning many Minecraft versions and all three loaders, so you validate a mod across the whole range, not one pinned version.

  1. AI agents that genuinely play. Point any LLM at a text socket and let it go -- proven

end-to-end: spawn, find a tree, mine, craft, and build a wooden axe, entirely over the wire -- and because it is the real client, your agent can operate mod GUIs too, not just vanilla movement.

  1. Hands-free / accessible play. Run the whole game -- menus, worlds, inventory, crafting -- by

typing. Nothing on screen needs to be looked at.

  1. Automation & scripting. Repeatable command sequences for the tedious stuff (gather, craft,

navigate, set up a world), from any language, in plain text -- with auto armor-upgrade built in.

No protocol reverse-engineering, no pixel pipeline, no RL training, no lock-in to one AI model or one Minecraft version -- just plain text into the real game.

M1 plays fair -- it does not cheat or x-ray. A scan perceives only what a player looking at the screen could: it never sees raw ores buried inside unexposed rock, and -- apart from living entities, which it detects all around -- it reports only what is in front of the player, never through or behind walls. An AI driving M1 works from exactly the information a human at the keyboard would have.


2. Getting M1 running

M1 is client-side only (no server mod). Drop the jar for your loader + MC version in your instance's mods/ folder, launch a world, and on load M1 opens its text socket on 127.0.0.1:26000 and extracts the AI_Brain docs.

To drive it from Claude Desktop (or any MCP client) you also run the small MCP-Minecraft bridge shipped in the source repo. Full step-by-step setup -- install, the bridge, and the Claude Desktop wiring -- is in the build & setup guide on the minecraft-1.20-26.3 branch.

3. Connecting

When the modded client starts, M1 opens a TCP server on 127.0.0.1:26000 on the machine running the client. It binds loopback only -- there is no new inbound network surface; only processes already on that machine can reach it. Run one modded client at a time (every build binds the same port).

The channel is the same whether a person types it or an AI sends it -- one grammar, one code path. Anything an AI does is reproducible by hand and vice versa.

Wire protocol

Read the full description on Modrinth →

Highlights

From source data

Game versions

Supports 29 Minecraft versions, the newest being 26.3.

Loaders

Runs on Fabric, Forge, NeoForge and Quilt.

Footprint

Rated a light load on a server.

M1 - Machine One AI Interface on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
Server side
Optional on the server
Server type needed
Fabric, Forge, NeoForge, Quilt
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
0.17.5+26.3-neoforge, released 2026-09-18

Game versions by loader

LoaderGame versionsNewest
NeoForge26.1 to 26.3 (5 versions)26.3
Fabric26.2 to 26.3 (2 versions)26.3

From 5 recorded builds of M1 - Machine One AI Interface.

Recent builds

BuildReleasedGame versionsLoaders
0.17.5+26.3-neoforge2026-09-1826.3NeoForge
0.17.5+26.32026-09-1826.3Fabric
0.17.5+26.2-neoforge2026-09-1826.2NeoForge
0.17.5+26.22026-09-1826.2Fabric
0.17.5+26.1-neoforge2026-09-1826.1 to 26.1.2 (3 versions)NeoForge

Dependencies

  • Required: modrinth project P7dR8mSH (modrinth, not in our catalogue)

Declared by the newest build that lists any. Required ones are installed with it on one-click installs.

Run M1 - Machine One AI Interface on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Modrinth as “Mods”

Technology & automation

Machines, power, logistics and automation.

Works on a server

From source side support

Modrinth lists server-side support for M1 - Machine One AI Interface as optional: it can run on a server, but isn’t required there.

Compatibility

Game
Minecraft
Loaders
FabricForgeNeoForgeQuilt
Runs on
Serveroptional on the server
Game versions
26.3 and 28 earlier

Verified at the source

  • ✓ModrinthOfficial listing, checked 2026-10-17Open ↗
  • ✓AuthorKishku7, as published on Modrinth
  • ✓LicenseLicenseRef-All-Rights-ReservedFree

M1 - Machine One AI Interface, answered

Generated from the mod’s own source data.

Do my players need to install M1 - Machine One AI Interface?

Modrinth lists server-side support for M1 - Machine One AI Interface as optional: it can run on a server, but isn’t required there.

Which loaders does it support?

Fabric, Forge, NeoForge and Quilt.

Is it free?

Yes. M1 - Machine One AI Interface is free to download from Modrinth. Its license is LicenseRef-All-Rights-Reserved.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run M1 - Machine One AI Interface on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add M1 - Machine One AI Interface in one click.