Idle Guard for Blueprint v1.0.0

Your nodes are full of servers nobody is playing on.

Free tiers, trials, abandoned projects: on most hosts a large share of running servers sit at 1-3% CPU for hours, holding RAM that paying customers could use. Idle Guard finds them and stops them - politely.

How it works

• Every minute, one single API call per node reports the state and CPU of every server - no per-server polling, no measurable load even on big nodes
• A server whose CPU stays under your threshold (default 5% of its limit) for the whole idle window (default 30 minutes) is stopped with a graceful stop action
• A few minutes before the stop, a configurable warning command is sent to the console (e.g. say Server stopping in 5 minutes due to inactivity)
• After the stop, the owner sees a friendly notice on their console page explaining what happened - one click on Start and they're back

Controls you actually need

• CPU threshold, idle window and warning lead time are all configurable
• Exempt egg IDs: proxies, databases and other always-on eggs are never touched
• Owner opt-out (optional): let owners exclude their server with a toggle on their Settings tab - or keep the policy mandatory
• Discord webhook (optional): an embed in your staff channel for every automatic stop
• Impact dashboard in the admin panel: stops today, total stops, opted-out count, recent stop log
• Ships disabled so you can review the policy before it acts

Safety

• Suspended, installing and transferring servers are always ignored
• Unreachable nodes are skipped silently
• Graceful stop only - never kill
• All state lives in two small tables, cleaned up automatically when servers are deleted

What it needs
The standard Pterodactyl cron (schedule:run) that every install already has - the poller is a scheduled Artisan command registered by Blueprint. No extra services.

Installation
Running the panel in Docker? Restart the panel container after installing so the database migrations apply (standard Blueprint-in-Docker behavior).
Requires the free Blueprint extension framework (blueprintframe.work). Game-agnostic - works with any egg.