Server Status Widget
Live, embeddable status badges for your game servers.
Paste a single script tag onto any website and show a live, auto-refreshing status card for any server on your panel — online/offline state, player count, version, MOTD, ping, and a 24-hour player-activity graph. Server owners turn it on per-server from your panel. No third-party services, no API keys, no external dependencies.
Features
- One-line embed — a single script tag; pure vanilla JavaScript with zero dependencies that works on any website.
- Live data — online/offline, players (current/max), version and MOTD via the Minecraft Server List Ping protocol. Other games fall back to a TCP reachability and latency check.
- 24-hour activity graph — a smooth player-count sparkline drawn on an HTML canvas, so visitors can see when a server is busy.
- Dark and light themes — switch per embed with a single data-theme attribute.
- Per-server control — enable or disable each server, choose its theme, and restrict which domains may embed it (CORS allow-list with wildcard support).
- Admin and client management — manage every server from the admin panel, let owners self-manage their own, or drop an optional section straight into the server Settings tab.
- Fast and safe — public responses are cached in Redis for 30 seconds; player history is recorded every minute and auto-pruned to 24 hours.
Installation
A single self-contained installer embeds the entire addon and wires everything for you. Just run it and choose Install. It copies the files, registers routes, schedules the poller, runs migrations, and clears caches. It is idempotent, fully reversible, and never modifies your panel's core files beyond clearly-marked wiring lines. No new Composer or npm packages, and the core addon needs no frontend build.
Requirements
- Pterodactyl Panel v1.12.0
- PHP 8.1+, MySQL or MariaDB, and Redis (all standard on a Pterodactyl install)
- The panel's scheduler cron, which powers the 24-hour activity history
What you get
Full source: PHP controllers, services, models, migrations, and CORS middleware; the dependency-free public widget and admin UI; an optional React Settings-tab component; route files; the one-command installer; and a detailed README plus an HTML install guide.
