ClaudeCraft

A Minecraft Forge mod that brings Claude AI into CC: Tweaked computers and turtles.

Players interact with Claude through an in-game terminal — ask questions, run tools, automate tasks, and control turtles using natural language.

Requirements

• Minecraft 1.20.1
• Minecraft Forge 47.2.0+
• CC: Tweaked 1.117.1+
• One of the following:
  • An Anthropic API key (API Key mode), or
  • Claude Code + Bun installed (Channel mode — no API key needed)

Installation

1. Install Minecraft Forge and CC: Tweaked.
2. Drop the ClaudeCraft .jar into your mods/ folder.
3. Open any CC: Tweaked computer or turtle and run:

   claude
   

4. Choose your connection mode:
   • API Key — set your key with /claudecraft setkey sk-ant-... first
   • Claude Code — requires Bun and Claude Code installed on the host (setup guide)

Features

• Two connection modes — use an API key or connect through Claude Code (no key needed)
• Streaming responses — see Claude's output in real time (API key mode)
• Tool use — Claude can read/write files, run shell commands, control redstone, interact with peripherals, pilot turtles, scan inventories, navigate via GPS, build from blueprints, and message other computers
• Per-computer isolation — each computer gets its own Claude session in channel mode
• Monitor support — automatically uses connected monitors for a larger display
• Conversation history — persistent chat history stored per computer
• Configurable — choose model, max tokens, system prompt, and concurrency limits

Tools

General

Tool	Description
reply	Send a response to the player
read_file	Read a file from the computer's filesystem
write_file	Write content to a file
edit_file	Make targeted edits to an existing file
list_files	List files and directories
find_files	Search for files by name pattern
search_content	Search file contents with pattern matching
run_command	Execute a shell command on the computer
delete_path	Delete a file or directory
move_path	Move or rename a file or directory
get_info	Get information about the computer and world
redstone	Read or emit redstone signals
peripheral_call	Call methods on attached peripherals
get_recipes	Look up crafting recipes for items
scan_inventory	Scan containers (chests, barrels, shulker boxes) for items via peripheral
send_message	Send messages to other CC:Tweaked computers/turtles running Claude

Turtle

Tool	Description
turtle_move	Move the turtle (forward, back, up, down, turn)
turtle_dig	Dig blocks in any direction
turtle_place	Place blocks from inventory
turtle_inspect	Inspect blocks around the turtle
turtle_inventory	Manage the turtle's inventory (select, transfer, drop, equip)
turtle_goto	Navigate to GPS coordinates with pathfinding — digs through obstacles
build_structure	Execute multi-block builds from blueprints using relative coordinates

In-Game Commands

Command	Description
/claudecraft setkey <key>	Set your Anthropic API key
/claudecraft model <model>	Change the Claude model
/claudecraft status	Show current configuration

Building from Source

cd forge
./gradlew build

The built jar will be in forge/build/libs/.

License

MIT