moincraft
🎛️ Configuration
MindServer, relay, behavior profile, and dashboard configuration surfaces that matter for Moincraft operators.
Use configuration to shape bot behavior, relay exposure, and dashboard fidelity without editing runtime code.
Core surfaces#
| Surface | Port | Responsibility |
|---|---|---|
| Paper server | 25565 |
World/auth/network baseline. |
| MindServer | 55668 |
Agent hub, state, controls, and WebSocket events. |
| Dashboard relay | 55667 |
HTTP + Socket.IO bridge and optional protected mutations. |
| Dashboard UI | 55666 |
Operator view and controls. |
MindServer agent state#
Typical live state includes gamemode, health, hunger, position, biome, inventory slots, equipped item, and last message.
Control plane#
| Action | Event/API | Meaning |
|---|---|---|
| Send message | send-message |
Chat to one agent. |
| Restart agent | restart-agent |
Restart a process cleanly. |
| Stop agent | stop-agent |
Disconnect from the server. |
| Destroy agent | destroy-agent |
Remove a process permanently. |
Behavior profile knobs#
Important settings include:
- connection:
minecraft_version,host,port,auth; - behavior:
base_profile,load_memory,init_message,only_chat_with,language; - AI limits:
relevant_docs_count,max_messages,num_examples,max_commands; - communication:
narrate_behavior,log_all_prompts,chat_ingame,chat_bot_messages,speak; - safety:
blocked_actions,allow_insecure_coding,code_timeout_mins.
Relay environment#
| Variable | Purpose |
|---|---|
DASHBOARD_PORT / PORT |
HTTP + Socket.IO listen port. |
MINDSERVER_HOST, MINDSERVER_PORT |
Upstream agent hub location. |
MOINCRAFT_HISTORY_STORE, REDIS_URL |
Stats/history persistence mode. |
DASHBOARD_API_TOKEN |
Protect mutating relay endpoints. |
DASHBOARD_ALLOWED_ORIGIN, DASHBOARD_TRUST_PROXY |
Network exposure and proxy behavior. |
DASHBOARD_RATE_COMMAND_PER_MIN |
Mutating command rate limiting. |
MOINCRAFT_TAIL_SWARM_LOG, MOINCRAFT_SWARM_LOG_PATH |
JSONL/log tail emission. |
Dashboard data flow#
MindServer :55668
→ Socket.IO events
→ dashboard.js relay :55667
→ browser client
→ live operator UI
Sources: wiki/content/docs/configuration.md, wiki/content/docs/dashboard.md.