Zo you wanna hook up an AI agent to Minecraft? Make it walk, jump, fight, build, zee the world? No drama, no complex APIz. Juzt plain text filez.

Thiz mod letz any AI — Python zcript, ChatGPT, your own neural net, whateva — control a player in Minecraft. Zimple az that.

Aint no cheatz, aint no magic. Juzt two filez:

commands.txt — zee AI writ ez commandz here.

data.txt — zee mod writ ez ztate back.

Thatz it. Welcome to the future, player.

How It Workz

You fire up Minecraft with zee mod inztalled.

Zee mod creat ez commands.txt and data.txt in your .minecraft folder.

Your AI writ ez commandz to commands.txt. Like rotate_yaw: 90 or hold: w: 2.0.

Zee mod readz it, doez it, and clearz zee file.

Zee mod alzo writ ez data.txt with player ztate — pozition, health, inventory, nearby entitiez, all that jazz.

Your AI readz data.txt and figurez out whatz next.

Boom. Full loop. Zee AI iz now playing Minecraft.

Commandz Write one command per line. Zee mod pollz every 2 tickz (10 timez per zec).

Movement commandz:

hold: w: 2.0 # hold W for 2 zec

release: w # releaze W

jump # jump once

sneak: on # ztart

zneaking sneak: off # ztop zneaking

sprint: on # ztart zprinting

sprint: off # ztop zprinting

rotate_yaw: 90 # turn right 90 degreez

rotate_yaw: -45 # turn left 45 degreez

rotate_pitch: -10 # look up 10 degreez

rotate_pitch: 15 # look down 15 degreez

look_at_center # rezet view to center

click: left # left click once

click: right # right click once

hold_click: left: 1.5 # hold left click for 1.5 zec

hold_click: right: 0.5 # hold right click for 0.5 zec

press: 1 # zelect hotbar zlot 1

press: 2 # zelect hotbar zlot 2

drop # drop item in hand

swap_hands # zwap main and off hand Info text

request_state # force write data.txt right now

State Format (data.txt)

Read thiz to know whatz happening in-game.

P.Z. write commandz without "space" example - "click:left"

Output

pos: 150 . 5 : 64 . 0 : 300 . 2

yaw: 45.0

pitch: -10.0

health: 20.0

food: 18.0

hotbar: [stone, dirt, diamond_sword, empty, empty, empty, empty, empty, empty]

selected_slot: 2

looking_at: air

nearby_entities: [zombie: 5m, cow: 8m, player: 12m]

Zimple. Readable. No JSON.

Inztallation

Inztall Minecraft Forge 1.20.1 (any build from 47.x).

Drop aiconnector-1.0.0.jar into your .minecraft/mods/ folder.

Launch Minecraft with Forge profile.

Join a world (zingle-player only, we aint tryna get banned on zerverz).

Check your .minecraft folder — commands.txt and data.txt gonna be there.

Write commandz. Watch zee magic.

Example: Python AI Agent

"COMMANDS = "C:/Users/You/AppData/Roaming/.minecraft/commands.txt"

DATA = "C:/Users/You/AppData/Roaming/.minecraft/data.txt"

def send(cmd):

with open(COMMANDS, "w") as f:

f.write(cmd + "\n")

def read_state():

with open(DATA, "r") as f:

return f.read()

send("rotate_yaw: 90")

time.sleep(0.5)

send("hold: w: 2.0")

time.sleep(2.5)

print(read_state())"

Thatz how eazy it iz. Hook up any AI you want.

Why Thiz Mod? Cauze AI agentz should be able to play Minecraft too. We aint gatekeeping. We aint making it complicated. Juzt text filez and vibe.

Whether you building a chatbot buddy, a reinforcement learning experiment, or a full-blown neural net that wanna beat zee Ender Dragon — thiz mod got your back.

Warningz Client-only. Thiz aint for zerverz. Uze it in zingle-player only. Otherwize itz cheatz and you gonna catch a ban.

No anti-cheat bypass. We aint tryna break zhit. Juzt making AI accezible.

Minecraft 1.20.1, Forge 47.x. Older or newer verzionz? You on your own, homie.

Contributing Wanna help? Pull requeztz welcome. Found a bug? Open an issue. Got an idea? Hit uz up.

Workin' with:

ChatGPT, DeepSeek, Claude, Llama, other LLM'z, local LLMz and agentz.

Keep it zimple. Keep it real. Keep it open zource.

P.Z. If ya uze API or web verzion modelz — add a Python zcript that takez LLMz answerz and dropz 'em into commandz.txt.