blueprintframework / main

Powerful, fast and developer-friendly extension framework for Pterodactyl. Utilize extension APIs, inject HTML, modify stylesheets, package extensions and so much more.

Open-source modding framework for the Pterodactyl panel.

Website · Community · Documentation

🧩 Introduction

Blueprint is an open-source extension framework/manager for Pterodactyl. Developers can create versatile, easy-to-install extensions that system administrators can install within minutes (usually even seconds!) without having to custom-code compatibility across multiple panel modifications.

We aim to introduce new developers to Blueprint with easy to understand guides, documentation, developer commands, community support and more.

📷 Showcase

💖 Sponsors

Sponsors help fund development and maintenance. Interested in sponsoring Blueprint?

Type	Company	About
	FastVPS.Systems	Your gateway to next-level hosting! Blast off with our ultra-fast VPS and game servers in the UK and Germany. Power your digital frontier with top-tier Rust and Minecraft hosting. Use code Blueprint for 25% off your first month!

👥 Contributors

Contributors help shape the future of the Blueprint modding framework. To start contributing you have to fork this repository and open a pull request.

🌟 Stargazers

🔗 Related Links

Pterodactyl is a free, open-source game server management panel built with PHP, React, and Go.
BlueprintFramework/templates is a repository with initialization templates for extension development.
BlueprintFramework/web is our open-source documentation and landing website.

main's Issues

No puzzle icon in the corner.

I installed, and it said it succeeded, but I do not see a puzzle icon in the admin panel. Tried installing a plugin (recolor), and it said it succeeded too but nothing changed.

Icons displaying too large.

Installing Blueprint on Docker (on Unraid) discussion.

is there any way to install this on unraid?

Access forbidden to admin panel.

Use ShellCheck for CI

Having ShellCheck for the CI workflow would be useful for catching bugs caused by shell edge-cases and enforcing safe practices. You can view its extensive list in the wiki. There are over 100 issues in blueprint.sh at present.

How can I uninstall blueprint

I am having a problem with it I just need a answer

Cannot access data directory

do I have to create a folder first?

Blueprint should not assume certain things about the environment

Tested with alpha-SLX:

• Blueprint assumes that /usr/local/bin exists and is user-writable.
• Blueprint assumes that the panel lives in /var/www/pterodactyl.
• Blueprint assumes that the panel directory will never change.

This causes the following issues:

• Certain distros do not have a /usr/local directory (such as NixOS), or even a /usr/bin! (NixOS has it, but it only contains env) Because of this, the blueprint tool does not get installed if /usr/local/bin is not present or if it's not writable to by users.
• The installer falls apart anywhere outside of /var/www/pterodactyl. A safer assumption would be setting FOLDER="$(dirname $0)".
• When setting up symlinks to .blueprint, Blueprint will create absolute links. If the panel directory is renamed, Blueprint will partially break.

Replace admin cache refresh overlay with a notification/banner.

Bug on admin overview

So every time i click on the admin it doesnt load the site (which triggers my cloudflare crash site) but everything else works. You can go to admin but you cant click on overview if you click it it says the same thing. Then i tried without an account to see if admin overview triggers the same thing but it sayed the pterodactyl error code which means the page works but not when i click it with admin. This all happened after i installed the blueprint.

Also on the admin overview i remember i had installed a statics thing and it worked maybe thay could be the problem?

Version: 1.11.3

Weak Hardware

Hi! Regarding an email I sent, I'm now creating the issue. On my hardware, it's not possible for me to install Blueprint and a theme that requires it, as my server seems to be too weak. I have 512mb of RAM and a 1vcore processor, which appears to be insufficient. For those who have managed to install it: What resources do you have available? How powerful are your servers? What should I keep in mind?

Script requires ZIP, while readme doesn't say so

While I understand the common sense part, there are people who won't know that they just run sudo apt install zip xD