WHAT WAS DONE:
- Re-added MINECRAFT_NEST_IDS filtering
- Keeps the node ID mapping fix (2→NC1, 3→TX1)
WHY:
Non-Minecraft servers were appearing in the matrix.
We need to filter to only show Minecraft servers.
Signed-off-by: Claude (Chronicler #60) <claude@firefrostgaming.com>
WHAT WAS DONE:
- Removed MINECRAFT_NEST_IDS filtering
- Now shows ALL servers from Pterodactyl, not just Minecraft nests
WHY:
Trinity Console should show all servers for management,
not just those in specific nests.
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>
WHAT WAS FIXED:
Production deployment revealed silent sync failure. Root cause: Pterodactyl
API nest filtering was broken. Gemini consultation provided Solution C
(environment variable configuration) for robust, maintainable operation.
GEMINI'S RECOMMENDATIONS IMPLEMENTED:
1. Solution C: MINECRAFT_NEST_IDS environment variable (explicit control)
2. Comprehensive sync logging (visibility into each step)
3. 'lifetime' status support for The Trinity (owner access)
4. Early exit with warning when 0 servers discovered
ROOT CAUSE ANALYSIS:
Original code filtered servers by nest relationship name:
server.attributes.relationships?.nest?.attributes?.name === 'Minecraft'
Problem: API doesn't include nest relationships in response, so filter
returned 0 servers, causing silent sync failure with no error logs.
Solution: Filter by nest ID directly using environment variable:
allowedNests.includes(server.attributes.nest)
CHANGES:
.env.example:
- Added MINECRAFT_NEST_IDS=1,6,7 (Minecraft, NeoForge, Hytale nests)
- Explicit configuration instead of dynamic discovery
- User controls which nests to sync (adaptable to nest reorganization)
src/panel/discovery.js:
- Parse MINECRAFT_NEST_IDS from environment
- Filter servers by nest ID (not relationship name)
- Remove broken ?include=allocations,node,nest parameter
- Direct integer comparison (robust, predictable)
src/sync/immediate.js:
- Added comprehensive logging at each step:
* Player count from database
* Server discovery count
* Success/failure counts per sync
- Added 'lifetime' status to query (for Trinity owner access)
- Early exit with warning if 0 servers discovered
- Per-server error logging with server name + identifier
PRODUCTION TESTING RESULTS:
✅ Discovered 12 target servers (nests 1, 6, 7)
✅ Retrieved 1 active player from database
✅ Synced successfully to all 12 servers (0 failures)
✅ Whitelist.json confirmed on Panel servers
✅ Logs show clear visibility into sync process
GEMINI ARCHITECTURAL GUIDANCE:
- Solution C preferred over dynamic discovery (predictable, no extra API calls)
- Manual whitelist enforcement (don't automate server.properties editing)
- Configure Pterodactyl Eggs with white-list=true for future servers
- Explicit configuration > keyword matching (prevents accidental overwrites)
DEPLOYMENT VERIFIED:
Command Center (63.143.34.217) running Arbiter 3.0 successfully syncing
whitelists to 12 Minecraft servers across nests 1 (Minecraft), 6 (NeoForge),
and 7 (Hytale).
SOFT LAUNCH BLOCKERS:
✅ Task #87 (Cancellation flow) - Webhook handlers ready
✅ Task #90 (Whitelist management) - DEPLOYED AND OPERATIONAL
FILES MODIFIED:
- .env.example (added MINECRAFT_NEST_IDS)
- src/panel/discovery.js (environment-based nest filtering)
- src/sync/immediate.js (comprehensive logging + lifetime status)
Signed-off-by: The Golden Chronicler <claude@firefrostgaming.com>
