How ikavon/maidllmlocal works
MaidLLMLocal is a Minecraft mod that lets each player’s client handle its own AI requests and credentials, while the server coordinates requests and preserves fallback behavior. The main flow routes LLM chat to either a player’s local compatible endpoint or MAICA; MAICA also provides conversational state, triggers, and optional speech synthesis. README capabilities include per-player configuration, automatic MAICA login, MTrigger actions, and experimental shared memory. Some protocol and integration wiring is unsampled, so the graph omits uncertain links.
Main entry points: RelayHub.java Server relay · MaidLLMLocal.java Mod bootstrap · ClientMaicaHandler.java Chat handler · ClientRelayHandler.java Client relay
Components 24
Mod integration
- Mod bootstrap
src/main/java/com/maidllmlocal/MaidLLMLocal.java - Site types
src/main/java/com/maidllmlocal/maica - LLM interception
src/main/java/com/maidllmlocal/mixin/LLMOpenAIClientMixin.java - Network packages
src/main/java/com/maidllmlocal/network
MAICA chat
- MAICA client
src/main/java/com/maidllmlocal/maica/MaicaClient.java - WebSocket session
src/main/java/com/maidllmlocal/client/maica/MaicaWsSession.java - Session manager
src/main/java/com/maidllmlocal/client/maica/ClientMaicaSessions.java - Chat handler
src/main/java/com/maidllmlocal/client/ClientMaicaHandler.java - Round results
src/main/java/com/maidllmlocal/maica/MaicaRoundResult.java - MTrigger actions
src/main/java/com/maidllmlocal/maica/MaicaTrigger.java
Player relay
- Relay site
src/main/java/com/maidllmlocal/relay/RelaySite.java - Server relay
src/main/java/com/maidllmlocal/relay/RelayHub.java - Client relay
src/main/java/com/maidllmlocal/client/ClientRelayHandler.java - Server MTrigger state
src/main/java/com/maidllmlocal/client/ServerMtState.java
Speech and accounts
- MTTS site
src/main/java/com/maidllmlocal/maica/MttsSite.java - MTTS client
src/main/java/com/maidllmlocal/maica/MttsClient.java - Client TTS handler
src/main/java/com/maidllmlocal/client/ClientMttsHandler.java - Account configuration
src/main/java/com/maidllmlocal/account - Automatic login
src/main/java/com/maidllmlocal/client/maica/MaicaAutoLogin.java - MAICA authentication
src/main/java/com/maidllmlocal/account/MaicaAuthClient.java
Other components
- Player
- Minecraft server
- MAICA service
- Player LLM endpoint
Connections 24
- Mod bootstrap → Network packages: registers
src/main/java/com/maidllmlocal/MaidLLMLocal.java - Mod bootstrap → Server relay: uses
src/main/java/com/maidllmlocal/MaidLLMLocal.java - Mod bootstrap → Site types: registers
src/main/java/com/maidllmlocal/MaidLLMLocal.java - LLM interception → Server relay: delegates to
src/main/java/com/maidllmlocal/mixin/LLMOpenAIClientMixin.java - Relay site → Server relay: uses
src/main/java/com/maidllmlocal/relay/RelaySite.java - Server relay → Player: dispatches request
src/main/java/com/maidllmlocal/relay/RelayHub.java - Player → Client relay: handles request
src/main/java/com/maidllmlocal/client/ClientRelayHandler.java - Client relay → Player LLM endpoint: posts HTTP
src/main/java/com/maidllmlocal/client/ClientRelayHandler.java - Client relay → Minecraft server: returns response
src/main/java/com/maidllmlocal/client/ClientRelayHandler.java - MAICA client → WebSocket session: routes chat
src/main/java/com/maidllmlocal/maica/MaicaClient.java - Chat handler → Session manager: gets session
src/main/java/com/maidllmlocal/client/ClientMaicaHandler.java - Session manager → WebSocket session: creates session
src/main/java/com/maidllmlocal/client/maica/ClientMaicaSessions.java - Chat handler → Round results: returns result
src/main/java/com/maidllmlocal/client/ClientMaicaHandler.java - WebSocket session → MAICA service: WebSocket chat
src/main/java/com/maidllmlocal/client/maica/MaicaWsSession.java - MAICA client → MTrigger actions: applies actions
src/main/java/com/maidllmlocal/maica/MaicaClient.java - Chat handler → Network packages: sends response
src/main/java/com/maidllmlocal/client/ClientMaicaHandler.java - MTTS site → MTTS client: creates client
src/main/java/com/maidllmlocal/maica/MttsSite.java - Client TTS handler → MAICA service: requests speech
README.md - Automatic login → Account configuration: reads credentials
src/main/java/com/maidllmlocal/client/maica/MaicaAutoLogin.java - Automatic login → MAICA authentication: authenticates with
src/main/java/com/maidllmlocal/client/maica/MaicaAutoLogin.java - Player → Account configuration: configures
README.md - Minecraft server → Player: routes chat
README.md - Minecraft server → Player: requests speech
README.md - MAICA service → Round results: returns chat