Resource Alerts (Blueprint Addon)

Adds an in-panel resource usage alert (CPU/RAM) for Pterodactyl servers using the Blueprint Framework.

What This Addon Does

• Injects a client-side component into the server terminal page.
• Requests live server stats via the panel WebSocket and keeps a rolling average.
• Shows an alert when CPU and/or RAM usage stays above configured thresholds for a sustained period.
• (Optional) Displays an "Upgrade" button that links to your store/upgrade page.

Compatibility

• Blueprint Framework on Pterodactyl Panel
• Target: beta-2026-01 (see conf.yml)

Installation / Development Guides

Follow the official Blueprint guides for installing addons and developing components/extensions: https://blueprint.zip/guides

Uninstall: blueprint -remove resourcealerts

Configuration (Admin)

In the Blueprint admin area for this addon you can configure:

• CPU threshold (%)
• RAM threshold (%)
• Averaging window (seconds)
• Stats request interval (seconds)
• Sustain duration (seconds)
• Dismiss cooldown (seconds)
• Store/upgrade button URL (optional)
• Enable/disable the addon behavior

How It Works (Repo Layout)

• conf.yml: Blueprint addon manifest (metadata, target version, entrypoints).
• components/Components.yml: Injects resourceAlert into Server -> Terminal -> AfterContent.
• components/resourceAlert.tsx: Fetches thresholds and listens for WebSocket stats to trigger alerts.
• routes/web.php: Web routes for admin updates + thresholds API endpoint used by the component.
• admin/Controller.php: Stores settings in Blueprint's key/value store and returns them to the UI.
• admin/view.blade.php: Admin configuration page.

Contributing

This repo is shared so the community can help improve and extend the addon, not because it's abandoned. Where it helps, the code includes comments explaining non-obvious behavior; keep comments high-signal.

Pull Request Requirements

• Clearly state what was added/updated and why.
• Include images or a short video of the change working/in action (especially for UI changes).
• Keep changes focused and avoid unrelated formatting-only churn.
• Keep credits/attribution intact (see LICENSE).

Helpful Contribution Ideas

• Improve styling to better fit different themes.
• Add small UX improvements (tooltip placement, accessibility, etc.).
• Performance improvements (without changing behavior).

License

Source-available. Redistribution and resale (original or modified) are not permitted, and original credits must be kept within the addon. See LICENSE for the full terms.