- Migration: added subdomain, server_ip, server_port columns
- Seed: rewritten with hardcoded identifiers + full subdomain/IP/port data
from Chronicler #87 audit (no more Pterodactyl API dependency)
- Route: POST /:id/provision-subdomain creates A + SRV records via
Cloudflare API, saves subdomain to server_config
- Card: subdomain section shows FQDN if provisioned, provision button
with inline input if not
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
New files:
- 139_server_config.sql — DB migration for short_name system
- 139_seed_server_config.js — auto-populates 17 servers from Pterodactyl
- src/services/uptimeKuma.js — Socket.IO direct (no npm wrapper)
- src/services/pterodactyl.js — power actions + console commands
Modified files:
- servers.js — 6 new POST routes (short-name, lock, createserver,
delserver, power, console) + short_name-based channel detection
- _server_card.ejs — full rebuild with command center UI
- _matrix_body.ejs — refactored from 144 lines to 20 (uses partial)
- package.json — added socket.io-client
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- 'Homestead - A Cozy Survival Experience' now matches 'homestead-chat'
- 'All The Mons (Private) - TX' now matches 'all-the-mons-chat'
- Strips subtitles after ' - ' and removes parentheticals
- Checks for 4 channels per server: chat, in-game, forum, voice
- Shows 'All 4 channels configured' or lists missing channels
- Caches Discord channel data for 5 minutes to reduce API calls
WHAT WAS DONE:
- Added POST /admin/servers/sync-all/:node endpoint
- Accepts 'tx1' or 'nc1' as node parameter
- Syncs whitelist to all servers on that node
- Returns count of synced/errors
- Wired up buttons in index.ejs with htmx
- hx-post to the new endpoint
- Results display in #sync-result span
Files changed:
- services/arbiter-3.0/src/routes/admin/servers.js (+45 lines)
- services/arbiter-3.0/src/views/admin/servers/index.ejs
Signed-off-by: Claude (Chronicler #60) <claude@firefrostgaming.com>
WHAT WAS DONE:
- discovery.js: Added node field to server objects
- Maps Pterodactyl node ID 2 → NC1
- Maps Pterodactyl node ID 3 → TX1
- Also includes raw nodeId for debugging
- servers.js: Simplified grouping logic
- Removed fallback checks for 'Node 2', 'Node 3', name patterns
- Now uses clean s.node === 'TX1' / 'NC1' checks
THE BUG:
getMinecraftServers() was only returning identifier and name,
but the matrix filter was checking s.node which was undefined.
Servers were being grouped by name pattern fallback only.
Files changed:
- services/arbiter-3.0/src/panel/discovery.js (+8 lines)
- services/arbiter-3.0/src/routes/admin/servers.js (simplified)
Signed-off-by: Claude (Chronicler #60) <claude@firefrostgaming.com>
GEMINI DELIVERED THE SERVER MATRIX! 🎉
Complete real-time server monitoring with htmx polling, 60-second caching,
Fire/Frost node grouping, and instant sync controls.
GEMINI'S ARCHITECTURAL DECISIONS:
1. 60-second cache - Prevents Panel API rate limits (13+ servers = 13 API calls)
2. htmx polling every 15s - Simulates real-time without complex SSE
3. Sequential sync only - Prevents HTTP 429 (Too Many Requests)
4. Warn-only whitelist toggle - No auto-restart (dangerous during boss fights!)
SERVER MATRIX FEATURES:
- Dynamic server discovery from Panel API
- Grouped by node: TX1 (Dallas) and NC1 (Charlotte)
- Real-time status with glowing borders (green=healthy, red=error, gray=offline)
- Per-server controls: Force Sync, Toggle Whitelist
- Bulk actions: Sync All Dallas, Sync All Charlotte
- 60-second intelligent caching for RV low-bandwidth
- htmx auto-refresh every 15 seconds
SERVER CARD DETAILS:
- Server name + identifier
- Online/offline status with pulsing dot
- Whitelist enabled/disabled
- Last successful sync timestamp
- Error messages if sync failed
- Sync Now button (disabled when offline)
- Toggle Whitelist with restart warning
FILES ADDED:
- src/panel/files.js - Added readServerProperties() function
- src/routes/admin/servers.js - Complete server matrix router
- src/views/admin/servers/index.ejs - Server matrix shell with htmx
- src/views/admin/servers/_matrix_body.ejs - Two-column node grouping
- src/views/admin/servers/_server_card.ejs - Individual server cards
SERVER DISCOVERY:
- Uses existing getMinecraftServers() from panel/discovery.js
- Filters by MINECRAFT_NEST_IDS (nests 1, 6, 7)
- Enriches with server.properties whitelist status
- Joins with server_sync_log table for sync history
WHITELIST TOGGLE:
- Reads current server.properties
- Toggles white-list=true <-> white-list=false
- Writes back to Panel via File API
- Shows ⚠️ Requires Restart warning (hx-confirm modal)
- Clears cache for immediate UI update on next poll
FORCE SYNC:
- Fetches active/grace/lifetime players from database
- Writes whitelist.json to server
- Executes 'whitelist reload' command
- Updates server_sync_log with success/failure
- Shows ✅ Synced or ❌ Error inline via htmx
CACHING LOGIC:
In-memory cache refreshes every 60 seconds:
- Cache hit: Returns cached server data instantly
- Cache miss: Fetches fresh from Panel + reads server.properties
- Database sync logs: ALWAYS fetch fresh (never cached)
NODE GROUPING:
TX1 (Dallas): Filters by node === 'Node 3' OR name includes 'TX'
NC1 (Charlotte): Filters by node === 'Node 2' OR name includes 'NC'
HTMX MAGIC:
- hx-get="/admin/servers/matrix" hx-trigger="load, every 15s"
- Auto-loads matrix on page load
- Auto-refreshes every 15 seconds
- hx-post for sync actions (updates inline, no page reload)
- hx-confirm for whitelist toggle (browser confirmation modal)
VISUAL DESIGN:
- Green glow border: Server online + recent sync success
- Red glow border: Sync error detected
- Gray border: Server offline
- Pulsing green dot: Server is online
- Fire emoji 🔥 for Dallas node
- Frost emoji ❄️ for Charlotte node
INTEGRATION:
- Mounted in src/routes/admin/index.js
- Uses existing database.js for PostgreSQL
- Uses existing panel/discovery.js for server list
- Uses existing panel/files.js for whitelist writes
- Uses existing panel/commands.js for reload commands
NEXT FROM GEMINI:
- Financials/MRR tracker
- Grace Period dashboard
- Additional modules as needed
GEMINI'S WISDOM:
"The Server Matrix is the true bridge of the ship, giving you complete
visibility and control without having to log into the game panel."
Signed-off-by: The Golden Chronicler <claude@firefrostgaming.com>
Co-authored-by: Gemini AI <gemini@anthropic-partnership.ai>
