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.
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).
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"
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.
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.
"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.
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.
