Skip to content

README.md

Latest commit

 

History

History
67 lines (44 loc) · 2.69 KB

README.md

File metadata and controls

67 lines (44 loc) · 2.69 KB

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 /extensions/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 (optional).

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.