From 8812c9b3f1577969cbd0b3c8fa82a83dcc9bde63 Mon Sep 17 00:00:00 2001 From: mkrause612 Date: Mon, 16 Feb 2026 05:42:52 -0600 Subject: [PATCH] Update tasks.md: Expand Whitelist Manager to web dashboard MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Task #1 (Whitelist Manager) expanded from CLI script to full web dashboard - Changed from 1 hour → 2-2.5 hours (more comprehensive solution) - Added reference to docs/tools/whitelist-manager-deployment-plan.md - Detailed tech stack, deployment phases, prerequisites - Listed all 11 Minecraft servers managed (TX1 + NC1) - Excluded non-Minecraft servers (FoundryVTT, Hytale) - Added future Phase 2 enhancements - Updated document version to 2.2 Philosophy change: Tasks now REFERENCE detailed plans rather than inline everything. Updated by: The Chronicler Date: February 16, 2026 --- docs/core/tasks.md | 82 ++++++++++++++++++++++++++++++---------------- 1 file changed, 54 insertions(+), 28 deletions(-) diff --git a/docs/core/tasks.md b/docs/core/tasks.md index 02d3bed..1ef3d8b 100644 --- a/docs/core/tasks.md +++ b/docs/core/tasks.md @@ -2,7 +2,7 @@ **Last Updated:** February 16, 2026 **Updated By:** The Chronicler (current session) -**Version:** 2.1 (NC1 Cleanup marked complete with lessons learned) +**Version:** 2.2 (Whitelist Manager expanded to web dashboard with full deployment plan) **Purpose:** Comprehensive dependency-ordered roadmap — execute top to bottom --- @@ -25,42 +25,68 @@ Quick wins with high impact and no dependencies. (1 of 3 complete) -### 1. Centralized Whitelist Manager -**Time:** 1 hour -**Priority:** DO WHEN HOME -**Location:** `/opt/firefrost/whitelist-manager.sh` on Command Center +### 1. Centralized Whitelist Manager Web Dashboard +**Time:** 2-2.5 hours +**Priority:** DO WHEN HOME + LIGHT DUTY APPROVED +**Status:** READY TO BUILD +**Documentation:** `docs/tools/whitelist-manager-deployment-plan.md` + +**Overview:** +Build web dashboard at `whitelist.firefrostgaming.com` to manage player whitelists across all 11 Minecraft servers, replacing manual SSH and console work. **The Problem:** - Currently requires manual SSH to each node (TX1, NC1) -- Update whitelist on each of 12+ servers individually via Pterodactyl console -- Time-consuming, error-prone, painful +- Update whitelist on each server individually via Pterodactyl console +- Time-consuming (15+ minutes), error-prone, no visibility **The Solution:** -- Command Center script using Pterodactyl API -- One command updates all whitelisted servers at once -- Logs all changes (audit trail) -- Master whitelist stored in repo +Web interface with: +- Toggle whitelist ON/OFF per server (one click) +- Add/remove player from one or all servers +- View current whitelist status across all servers +- Staff-accessible (you, Meg, trusted staff) -**Usage:** -```bash -whitelist-manager.sh add PlayerName -whitelist-manager.sh remove PlayerName -whitelist-manager.sh list -whitelist-manager.sh sync # Ensure all servers match -``` +**Managed Servers (11 Minecraft):** +- TX1: Reclamation, Stoneblock 4, Society Sunlit Valley, Vanilla 1.21.11, All The Mons +- NC1: Ember Project, Minecolonies, ATM10, Homestead, EMC Subterra Tech -**Before Building:** -- Which servers are whitelisted vs public? -- Pterodactyl API key (create or use existing) -- Toggle enforcement or just add/remove names? -- Access control (Michael only or also Meg/staff?) +**Excluded (Non-Minecraft):** +- FoundryVTT, Hytale (stay public) -**Future Enhancement (Phase 2):** -- Paymenter integration (subscriber pays → auto-whitelisted) -- Discord bot interface -- Web interface on staff.firefrostgaming.com +**Tech Stack:** +- Backend: Python Flask +- Frontend: HTML + TailwindCSS +- Host: Ghost VPS (Chicago) - same as Wiki.js Staff +- Domain: whitelist.firefrostgaming.com +- Auth: Basic username/password (SSL/HTTPS) -**After Completion:** 15-minute task → 10 seconds +**Prerequisites:** +- Pterodactyl panel URL +- Pterodactyl API key (generate in panel) +- Ghost VPS SSH access +- DNS A record: whitelist.firefrostgaming.com → Ghost VPS +- Admin credentials for dashboard + +**Deployment Phases:** +1. Information Gathering (5 min) - Get API key, credentials, DNS +2. Infrastructure Setup (15 min) - DNS, directories, Python dependencies +3. Build Application (45-60 min) - Flask app, HTML dashboard, API integration +4. Security & Web Server (20 min) - Nginx, SSL, systemd service +5. Testing (15 min) - Test with one server, then all servers +6. Deploy & Document (15 min) - Add to Wiki.js, commit to Git + +**After Completion:** +- ✅ 15-minute task → 30 seconds +- ✅ Zero-error whitelist management +- ✅ Full visibility across all servers +- ✅ Link from Wiki.js Staff portal + +**Future Enhancements (Phase 2):** +- Discord bot integration +- Paymenter subscriber auto-whitelist +- Whitelist sync verification + +**See full deployment plan:** `docs/tools/whitelist-manager-deployment-plan.md` ---