Introduction
Installation
Development
Extensions
Contributors
Related Links
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 (and sometimes even seconds!).
We aim to introduce new developers to Blueprint with easy to understand guides, documentation, developer commands, community support and more.
What you need:
- The latest release of Blueprint.
unzip
zip
curl
git
nodejs
(20.x or later)yarn
- Linux and Pterodactyl knowledge.
- Common sense.
Installation:
Important
Blueprint doesn't mix well with other modifications, so if you already have any, perform a panel update before moving on with this guide.
- Navigate to your Pterodactyl folder. (most likely
/var/www/pterodactyl
) - Install NodeJS, NPM and Yarn using the following commands. This assumes you are running Pterodactyl on Ubuntu or Debian-based systems.
sudo apt-get install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list
apt-get update
apt-get install -y nodejs
npm i -g yarn
yarn
- Download the latest release of Blueprint and extract it (stable build) or pull the files via git (bleeding-edge build).
- If you haven't already, place the Blueprint files inside of your Pterodactyl folder. (common location is
/var/www/pterodactyl
) - Run the Blueprint installation script. This runs the commands required for Blueprint to function correctly. If your Pterodactyl folder is not
/var/www/pterodactyl
you may need to put_FOLDER="/path/to/pterodactyl"
in front ofbash blueprint.sh
.
chmod +x blueprint.sh
bash blueprint.sh
- After waiting for the installation script to finish, open up your Pterodactyl admin panel and click on the puzzle icon in the top right of the website.
We've made some guides and documentation for extension development over on GitBook. We are adding more guides over time, don't hesitate to suggest a topic for future guides.
Note
Open a pull request on GitHub and add your extension here (in alphabetic order). To install an extension, upload your something.blueprint
file to your Pterodactyl folder and run blueprint -install something
.
Announcements: PterodactylMarket, sourceXchange, BuiltByBit
Arc.io Integration: BuiltByBit
Cats: sourceXchange
Cookies: sourceXchange
dbEdit: GitHub
Loader: sourceXchange
Nebula: PterodactylMarket, sourceXchange, BuiltByBit
Recolor: GitHub, sourceXchange, BuiltByBit
Redirect: PterodactylMarket, GitHub
Show Node IDs: BuiltByBit
Simple Footers: BuiltByBit
prplwtf - creator and maintainer
ahwxorg - contributor
alipoyrazaydin - contributor
sp11rum - contributor
phedona - contributor
codixer - contributor
Pterodactyl is a free, open-source game server management panel built with PHP, React, and Go.
teamblueprint/templates is a repository with initialization templates for extension development.
teamblueprint/web is our work-in-progress website and documentation revision.