Plugin & Mod Blocker — Automated Plugin Enforcement for Pterodactyl
Stop resource-heavy and forbidden plugins from impacting your nodes. Plugin & Mod Blocker allows you to block specific plugins and mods, automatically detect them across all servers, remove them with one click, restart affected servers, and notify users — all from a clean and powerful admin dashboard.Ships with Chunky blocked by default. Add your own rules in seconds.
How It Works
Define blocked plugins using:- File patterns (example: Chunky*.jar)
- Folder patterns (example: Chunky)
Upload Prevention
When a user attempts to upload a blocked file through the Pterodactyl file manager, the upload is instantly denied with a styled warning popup explaining the reason.Server Scanning
Scan every server directly from the admin panel to detect and remove blocked files. Each server is processed individually through AJAX with a live progress bar, preventing Cloudflare or PHP timeouts even on large deployments.Features
Blocklist Management
Add, edit, enable, disable, and remove blocked plugins or mods using flexible glob patterns.Auto-Enforce
One click to:- Scan all servers
- Remove blocked files
- Restart affected servers
- Email server owners automatically
Discover Plugins
Scan all servers and view every installed plugin or mod in a searchable table with server counts. Instantly block anything directly from the discovery view.Upload Blocking
Prevent users from uploading blocked files in real time through the Pterodactyl file manager.Email Notifications
Automatically notify server owners when plugins are removed, including your support or Discord link.AJAX Progressive Scanning
Each server is scanned individually with live progress updates and color-coded log output. Built to handle large deployments reliably.Search & Filter
Quickly search discovered plugins and mods across your entire network.Smart Deduplication
Files such as Plugin.jar and Plugin (1).jar are intelligently grouped together.Grouped Activity Logs
Multiple detections from the same server and plugin are merged into clean, readable entries.Comprehensive Audit Trail
Every action is logged, including:- Detections
- Removals
- Upload blocks
- Restarts
- Emails sent
- Blocklist changes
Enforcement Actions
| Action | Description |
|---|---|
| Scan Only | Detect blocked files without removing them |
| Auto-Enforce | Scan, remove, restart, and notify automatically |
| Remove & Restart | Remove blocked files from a single server and restart it |
| Upload Blocking | Prevent blocked files from being uploaded |
Admin Dashboard
Blocked Plugins
Manage your blocklist with support for:- File and folder patterns
- Enable/disable toggles
- Quick editing and removal
Scanner & Enforce
Run scans and enforcement actions with live progress tracking.Discover Plugins
View every installed plugin or mod across all servers with instant search and one-click blocking.Activity Log
Full audit history with grouped entries and color-coded labels.Use Cases
Block Resource-Heavy Plugins
Prevent plugins like Chunky, Dynmap, and other CPU-intensive software from affecting node performance.Enforce Network Policies
Block cracked plugins, unauthorized mods, or anything that violates your Terms of Service.Automated Cleanup
Run enforcement across your entire infrastructure manually or through scheduled tasks.User Communication
Keep server owners informed automatically when plugins are removed.Plugin Auditing
Discover exactly what plugins and mods are installed across your network without SSH access.Client API
The extension includes a client API used for upload blocking.| Method | Endpoint | Description |
|---|---|---|
| GET | /api/client/extensions/pluginblocker/blocked | Retrieve blocked plugin patterns |
| POST | /api/client/extensions/pluginblocker/log-block | Log blocked upload attempts |
Installation
blueprint -install pluginblockerAfter installation, navigate to:
Admin → Extensions → Plugin & Mod Blocker
Chunky is blocked by default. Add additional plugins manually or use the Discover tab to scan and block plugins instantly.
Requirements
- Pterodactyl Panel 1.x
- Blueprint Framework (beta-2026-01 or later)
Support
Discord: azioncloud.com/discordWebsite: azioncloud.com
