Universal Manager

Mod/Plugin Manager Blueprint Extension for Pterodactyl

It is not currently production-ready!⚠️ 📦 Universal Manager — Pterodactyl Blueprint Extension > Install mods, plugins, modpacks, resource packs and datapacks from Modrinth, CurseForge, Hangar and SpigotMC directly into your Pterodactyl game servers — with one click. --- ✨ Features | Feature | Details | |---|---| | 🔍 Multi-Provider Search | Modrinth, CurseForge, Hangar, SpigotMC in one interface | | ⚙️ Mod Support | Forge, NeoForge, Fabric, Quilt, LiteLoader, Rift | | 🔌 Plugin Support | Paper, Spigot, Bukkit, Purpur, Folia, Velocity, Waterfall, BungeeCord, Sponge | | 📦 Modpack Installer | Auto-extract archives directly into server root | | 🎯 Smart Install Paths | Auto-detects /mods/, /plugins/, /world/datapacks/ etc. | | 🔒 Secure Downloads | File type validation, size limits (500 MB), path traversal protection | | 🧩 Modular Providers | Add/update any provider without touching UI or core | --- 📋 Requirements • Pterodactyl Panel 1.11.x • Blueprint Framework beta-2025-09 or later • PHP 8.1+ • A free CurseForge API Key (optional — only needed for CurseForge content) --- 🚀 Installation 1. Download the latest release Download universalmanager.blueprint from the Releases page. 2. Upload to your panel server 3. Install via Blueprint CLI 4. (Optional) Add your CurseForge API Key Go to Admin Panel → Extensions → Universal Manager and enter your CurseForge API key. --- 🗂️ Project Structure --- 🔌 Adding a New Provider Only 3 steps — the UI updates automatically: --- 📡 API Endpoints All routes are prefixed with /api/client/extensions/universalmanager/ | Method | Path | Description | |--------|------|-------------| | GET | /providers | List all active providers | | GET | /search | Search across providers | | GET | /versions | Get versions for a project | | POST | /download | Download & install a file | | GET | /settings | Get admin settings (admin only) | | POST | /settings | Save admin settings (admin only) | --- 🛡️ Security • File type whitelist: Only .jar, .zip, .mrpack, .litemod are allowed • Max file size: 500 MB • Path traversal protection: Filename regex validation • Permission check: Only server owner, subusers, and admins can install files • API key masking: CurseForge key is masked in all API responses --- 📜 License MIT — free to use, modify and distribute. --- 🙏 Credits Built with Blueprint Framework by the community. APIs used: Modrinth, CurseForge, Hangar, Spiget