Bring AIRI into Minecraft

Imagine logging into your survival world and your AI buddy greets you at spawn, ready to gather resources or defend the base. The Minecraft integration turns AIRI into an autonomous player.

What It Can Do (Function-First)

Setup Guide

1. Ensure the server allows Java edition logins and online-mode=false if using an alt account.
2. In Settings → Integrations → Minecraft, enter server IP, bot username, and (optional) skin URL.
3. Start the Minecraft Service from the desktop app; a terminal window shows connection logs.
4. In game, type a request in chat; the AI responds and starts acting.

How It Works (Conceptual)

1. Mineflayer Bot — services/minecraft/src/main.ts creates a bot instance and connects.
2. Neuri Agent — High-level planner receives goals from LLM via WebSocket.
3. Skill Modules — Movement, combat, crafting, inventory; each exposes async functions.
4. LLM Goal Translation — neuri.ts breaks down a goal into skill calls (e.g., gather wood → movement.goToForest → combat.attack → inventory.store).
5. Feedback Loop — Skill results stream back to LLM to refine plan.

Sequence Diagram:

Performance & Safety

• Uses mineflayer-pathfinder for efficient navigation; avoids chunk-loading lag.
• Optional Y-level limit prevents the bot from digging too deep and causing server holes.
• All commands run under a sandbox user; cannot run /op or destructive server commands.

Related Technical Files