commit 4c68cb60bc8cb110d56b8a22dcd2f32b8e6bb4ac
Author: SysAdmin <sysadmin@silverlabs.uk>
Date:   Mon Mar 16 17:04:54 2026 +0000

    feat: initialize minecraft-aiworld Claude Code workspace
    
    Configure mc-ai-bridge MCP server at 10.0.0.247:3002 for AI-driven
    Minecraft Bedrock interaction with all 6 tools documented.
    
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..94af6ee
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,12 @@
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Claude Code
+.claude/
diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 0000000..30d8d7b
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "minecraft": {
+      "url": "http://10.0.0.247:3002/mcp"
+    }
+  }
+}
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..7e1ba32
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,50 @@
+# Minecraft AI World
+
+This is a Claude Code workspace for interacting with a Minecraft Bedrock world via the mc-ai-bridge MCP server.
+
+## Connection
+
+The mc-ai-bridge runs at `10.0.0.247`:
+- **WebSocket** (Minecraft → Bridge): port `3001`
+- **MCP HTTP** (Claude → Bridge): port `3002`
+
+To connect Minecraft Bedrock to the bridge, run this command in-game:
+```
+/connect 10.0.0.247:3001
+```
+
+## Available MCP Tools
+
+### `minecraft_command`
+Execute any slash command in Minecraft. Do NOT include the leading `/`.
+- `command` (string): e.g. `"give @p diamond 64"`, `"tp @p 100 64 200"`, `"time set night"`
+
+### `minecraft_chat`
+Send a chat message visible in Minecraft.
+- `message` (string): The message to send
+- `player` (string, optional): Target player for `/tell`. Omit to broadcast with `/say`.
+
+### `minecraft_build`
+Execute a batch of build commands with rate limiting. Max 200 commands per call. Only `setblock`, `fill`, `clone`, and `structure` commands are allowed.
+- `commands` (string[]): e.g. `["setblock 10 64 10 stone", "fill 10 64 10 20 64 20 glass"]`
+
+### `minecraft_get_events`
+Get recent game events from the in-memory event buffer.
+- `count` (number, optional): Number of events to return (default 20, max 100)
+- `type` (string, optional): Filter by event type, e.g. `"PlayerMessage"`, `"BlockChanged"`
+
+### `minecraft_get_status`
+Check if Minecraft is connected and get status info (player name, uptime, subscriptions, queue stats). No parameters.
+
+### `minecraft_subscribe`
+Subscribe to Bedrock event types. Available events:
+`PlayerMessage`, `BlockChanged`, `PlayerTransform`, `ItemUsed`, `ItemAcquired`, `ItemCrafted`, `MobKilled`, `MobInteracted`, `PlayerTravelled`, `PlayerDied`, `BossKilled`
+
+- `event` (string): Event type to subscribe to
+
+## Tips
+
+- Always call `minecraft_get_status` first to verify Minecraft is connected before issuing commands.
+- Subscribe to `PlayerMessage` to receive chat from the player.
+- Use `minecraft_build` for multi-block constructions — it handles rate limiting automatically.
+- Coordinates in Minecraft are (X, Y, Z) where Y is vertical height.