SysAdmin
389e053dc5
Lobby addon detects players in portal zones at X: -15/0/15 and transfers them to Jamie/Lyla/Mya survival worlds. Hub-return addon gives players a recovery compass and chat commands (!hub, !lobby) to return to the lobby. Includes docker-compose.yml for 4 Bedrock servers (lobby + 3 child worlds), spark pet behavior/resource packs, and updated .gitignore. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.6 KiB
Minecraft AI World
This is a Claude Code workspace for interacting with a Minecraft Bedrock world via the mc-ai-bridge MCP server.
Multi-World Architecture
Four Bedrock servers on 10.0.0.247, connected via native /transfer (no proxy):
| Server | Port | Purpose |
|---|---|---|
| Lobby | 19132 | Main entry point (adventure mode) |
| Jamie | 19133 | Jamie's survival world |
| Lyla | 19134 | Lyla's survival world |
| Mya | 19135 | Mya's survival world |
Players connect to 10.0.0.247:19132 (lobby) and use portal zones to transfer to child worlds.
Child worlds have a hub-return addon (compass, !hub/!lobby commands, portal zone) to transfer back.
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 sendplayer(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_statusfirst to verify Minecraft is connected before issuing commands. - Subscribe to
PlayerMessageto receive chat from the player. - Use
minecraft_buildfor multi-block constructions — it handles rate limiting automatically. - Coordinates in Minecraft are (X, Y, Z) where Y is vertical height.