diff --git a/docs/tasks/nc1-node-usage-stats/deployment-plan.md b/docs/tasks/nc1-node-usage-stats/deployment-plan.md new file mode 100644 index 0000000..d5cf4b0 --- /dev/null +++ b/docs/tasks/nc1-node-usage-stats/deployment-plan.md @@ -0,0 +1,75 @@ +# Task #44 — NC1 Node Usage Stats: Deployment Plan + +**Status:** READY — installation steps documented +**Discovered:** March 12, 2026 (Chronicler #29) +**Planned:** Dedicated session required + +## Root Cause +NC1 node stats showing dashes in Pterodactyl panel (CPU, RAM, Disk, Swap, +I/O, Network). Node Usage Status addon from Velta Studios requires custom +Wings build to expose these metrics. + +## Solution +Install "Node Usage Status" addon (v1.0.2) — licensed via BuiltByBit. +File already downloaded: NodeUsageStatus-v1.0.2.zip on Panel VPS at +/var/www/pterodactyl/NodeUsageStatus-v1.0.2.zip +Extracted to: /var/www/pterodactyl/NodeUsageStatus_extracted/ + +## WARNING — Wings Recompile Required +This addon requires modifying Wings source code and rebuilding the binary. +If the build fails, game servers lose their daemon connection. +Do NOT attempt during a long session or when servers are active. + +## Part 1: Panel Installation + +### Step 1: Upload panel files +cd /var/www/pterodactyl/NodeUsageStatus_extracted/PanelFiles +cp -r app/Http/Controllers/Admin/VeltaStudios /var/www/pterodactyl/app/Http/Controllers/Admin/ +cp resources/views/admin/nodes/view/index.blade.php /var/www/pterodactyl/resources/views/admin/nodes/view/ + +### Step 2: Modify routes/admin.php +Add the NodeStats route. Reference the HTML guide for exact location. + +### Step 3: Optimize panel +cd /var/www/pterodactyl +php artisan optimize +chown -R www-data:www-data /var/www/pterodactyl + +## Part 2: Wings Installation (TX1 + NC1 both) + +### Step 4.1: Download Wings source +WINGSDIR="/srv/wings" +mkdir -p $WINGSDIR && cd $WINGSDIR +Download latest Wings source zip from GitHub releases and unzip. + +### Step 4.2: Upload Wings addon files +Copy from Panel VPS extraction: +- WingsFiles/router/router_node_stats.go -> Wings router directory +- WingsFiles/system/metrics.go -> Wings system directory + +### Step 4.3: Modify router/router.go +Add node stats router include. Reference HTML guide for exact line. + +### Step 4.4: Install Go if not present +go version # check first + +### Step 4.5: Build and restart Wings +systemctl stop wings +go build -o /usr/local/bin/wings +chmod +x /usr/local/bin/wings +systemctl start wings +Build takes several minutes. Monitor carefully. + +## Files Location +- Zip: /var/www/pterodactyl/NodeUsageStatus-v1.0.2.zip +- Extracted: /var/www/pterodactyl/NodeUsageStatus_extracted/ +- HTML guide: /var/www/pterodactyl/NodeUsageStatus_extracted/Node Usage Status.html +- BuiltByBit license: Active (purchased Jan 31, 2026) +- Support: Velta Studios Discord + +## Session Requirements +- Fresh session, not end of long day +- TX1 and NC1 SSH ready +- Plan 45-60 minutes +- Low server activity before Wings restart +- Backup Wings binary before recompile