e9373300a3
Wings recompile required on TX1 + NC1. Files already downloaded to Panel VPS. Detailed installation steps documented from vendor guide. Requires dedicated session. Chronicler #29
2.7 KiB
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