Resource Manager (Blueprint Addon)

Admin-only upload manager for images/assets you want to reuse across Blueprint addons/themes in the Pterodactyl panel.

What This Addon Does

• Adds an admin extension page for uploading, listing, copying links, and deleting images.
• Stores files under /fs/resourcemanager/uploads/ so other addons can reference them by URL.
• Ships with a starter set of images in public/uploads/ (optional convenience assets).

Security Notes

• Uploaded files are stored in a public directory and can be accessed by URL.
• Only root admins can upload/delete via the UI, but you should still only upload trusted files.
• SVG uploads are allowed and run through a server-side sanitizer, but SVGs can still carry more risk than raster images. Only upload trusted SVGs, and review admin/Controller.php if you want to further restrict or disable SVG support.

Compatibility

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

Image Format Support

Base formats (always supported): SVG, JPG, JPEG, PNG, GIF, WebP, BMP

Advanced formats (require Imagick): AVIF, ICO, TIFF, HEIF/HEIC

To enable advanced format support on Pterodactyl servers (PHP 8.3):

apt install -y php8.3-imagick
systemctl restart php8.3-fpm

Without Imagick, attempts to upload advanced formats will be rejected with a clear error message listing your server's supported formats.

Installation / Development Guides

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

Uninstall (as shown in the admin view): blueprint -remove resourcemanager

How It Works (Repo Layout)

• conf.yml: Blueprint addon manifest (metadata, target version, entrypoints).
• routes/web.php: Backend endpoints for uploading/listing/deleting files.
• admin/Controller.php: Admin-only upload and file management endpoints.
• admin/view.blade.php: Admin UI for managing uploads.
• public/uploads/: Bundled starter assets copied into the public Blueprint filesystem during installation.

Contributing

This repo is shared so the community can help improve and extend the addon, not because it's abandoned. If you customize it for your theme/workflow, consider upstreaming improvements that benefit others.

Pull Request Requirements

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

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.