CraftCoach

An interactive Minecraft learning system powered by AI mentor bots. Learn building and fighting skills inside Minecraft with in-game NPC guidance.

CraftCoach is a Fabric mod for Minecraft Java Edition that adds AI-powered NPC mentors to the game. Players interact with these mentors to learn building and fighting skills through interactive, step-by-step tutorials — right inside Minecraft.

• Phase 1: Fabric mod skeleton, MentorEntity NPC, /mentor commands
• Phase 2: AI integration (OpenRouter), player interaction, tutorial system
• Phase 3: Custom NPC models, position-based validation, more skills
• Phase 4: Tutorial world/map, voice integration, polish

• AI-powered NPC mentors (Building & Combat) via OpenRouter API
• Right-click NPC to browse and select skills
• Step-by-step interactive tutorials with validation
• Chat-based dialogue with AI responses
• Configurable models and API settings
• 4 built-in tutorials:
  • Cobblestone Wall (build a 3x2 wall)
  • Simple Shelter Floor (build a 3x3 oak plank floor)
  • Critical Hits (learn to deal bonus damage)
  • Shield Blocking (learn to block attacks)

• Minecraft Java Edition 1.20.4
• Fabric Loader 0.15.0+
• Fabric API
• OpenRouter API key (free tier works)

./gradlew build

The compiled JAR will be in build/libs/.

1. Install Fabric Loader for Minecraft 1.20.4
2. Place the CraftCoach JAR and Fabric API in your mods/ folder
3. Launch Minecraft
4. Edit config/craftcoach.json with your API key

• /mentor spawn [building|combat] - Spawn a mentor NPC
• /mentor list - List all active mentors
• /mentor remove - Remove nearby mentors

1. Use /mentor spawn building to spawn a Building Master
2. Right-click the NPC to see available skills
3. Type the skill name in chat (e.g., "cobblestone_wall")
4. Follow the NPC's step-by-step instructions
5. For building tutorials: place the correct blocks to complete each step
6. For combat tutorials: read the instructions and practice in the game
7. Chat with the NPC for hints and guidance (powered by AI)
8. Type quit to end the tutorial

MIT