Docs  /  Minecraft **client** → `_AugmentedIntelligence` bridge

Minecraft client → _AugmentedIntelligence bridge

Status: Enabled (2026-07-19)

Previously, only the Spigot server plugin connected to _AI over TCP; the desktop “client controller” used window focus + key injection. The stack now accepts Fabric client peers on the same bridge.

Architecture

  Minecraft Java client (Fabric mod)
        │  TCP JSON-lines  role=client
        ▼
  _AugmentedIntelligence  minecraft bridge :8765
        ▲
        │  TCP JSON-lines  role=server
  Minecraft Spigot/Paper (server plugin)
  • Multi-peer listen: server plugin and client mod can stay connected together.
  • Actions/chat from _AI are broadcast to all peers.
  • Client applies action via local key presses; server applies via SafeActionExecutor.

Enable on _AI

minecraft bridge configure 0.0.0.0 8765 change-me true
minecraft bridge start
minecraft bridge status

Look for:

accepts_client=yes  client_peers=1  server_peers=0|1
peer_list=client@127.0.0.1(fabric-client)

Env: AI_MINECRAFT_BRIDGE_TOKEN, optional host/port in config file.

Enable on Minecraft client

  1. Fabric Loader 1.20.1 + Fabric API.
  2. Build minecraft_fabric_client → install jar in mods/.
  3. Edit config/ai_client_bridge.properties — same token as _AI.
  4. Join a world (singleplayer or multiplayer); mod autostarts on JOIN.

In-game: prefix chat with ?ai to send a private coach message to _AI.

Commands (operator)

minecraft bridge status
minecraft bridge start
minecraft bridge stop
minecraft bridge action <id> [player]
minecraft bridge chat say <player> <message>
minecraft dqn status

Legacy window controller (no mod required):

minecraft client …                   # MinecraftClientController key injection
minecraft dqn client chat <message>  # bot types into the client chat box (T → text → Enter)

client chat requires the Minecraft window to be foreground; it temporarily suppresses the UI-pause so the bot's own T/Enter keystrokes are not read as the human opening chat.

Hello (client)

{
  "type": "hello",
  "protocol": 1,
  "token": "change-me",
  "role": "client",
  "client_id": "fabric-client",
  "player": "Steve",
  "minecraft_plugin_capabilities": "client_observation,client_action,client_chat"
}

auth_ok includes "accepts_client":true.

Safety

Control Notes
Token Shared secret; never commit real tokens
Bind Prefer 127.0.0.1 unless LAN is firewalled
dry_run_actions Client config flag for testing
Ethics / Legal Agent policies still apply to remote typed commands

Files

Path Role
MinecraftSpigotBridge.cpp Multi-peer accept + client role
minecraft_fabric_client/ Fabric mod source
minecraft_spigot_plugin/ Server peer (role=server)
MinecraftClientController.* Optional focus/key fallback
Generated from the project markdown docs on 2026-07-24. This is a static, self-contained site.