moincraft

๐Ÿ–ฅ๏ธ Dashboard

Svelte dashboard and relay: Socket.IO, bot state/events, metrics, backend status, and JSONL telemetry.

The dashboard is the operator’s mission-control surface for bot state, logs, metrics, backend status, capabilities, and viewer links.

Architecture#

bots/dashboard.js relay :55667
  โ†’ Socket.IO events + REST/API contracts
  โ†’ bots/dashboard SvelteKit UI :55666
  โ†’ bot state, metrics, backend status, capabilities

Streaming principle#

Prefer server-pushed events over polling. Relay rooms can target individual bots (bot:<name>) while global stats broadcast to all clients.

Data worth preserving#

  • Bot health, hunger, position, goal, mode, and inventory snapshots.
  • Command/message/cost/death/error/innovation events.
  • Backend status, relay health, capabilities, and viewer availability.
  • Structured JSONL event records instead of brittle log-string parsing.

UI posture#

  • Dark, high-density mission-control style.
  • Monospace for precision data.
  • Command palette and clear destructive controls.
  • Graceful degraded state when relay/backend is unavailable.

Sources: root AGENTS.md, wiki/content/docs/dashboard.md, moincraft/docs/next-lvl-dashboard.md, moincraft/docs/jsonl-event-schema.md.