99 lines
5.3 KiB
Markdown
99 lines
5.3 KiB
Markdown
<h2><img src="https://i.imgur.com/nBYQ4Bl.png" style="height:30px;padding-right:1px"></img></h2>
|
|
|
|
[Discord ➚](https://ptero.shop/community)\
|
|
[Documentation ➚](https://ptero.shop/docs)
|
|
|
|
[Introduction](#introduction)\
|
|
[Installation](#installation)\
|
|
[Development](#development)\
|
|
[Extensions](#extensions)\
|
|
[Contributors](#contributors)\
|
|
[Related Links](#related-links)
|
|
|
|
<br/>
|
|
|
|
## 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 *(and sometimes even seconds!)*.
|
|
|
|
We aim to introduce new developers to Blueprint with easy to understand guides, documentation, developer commands, community support and more.
|
|
|
|
<br/>
|
|
|
|
## Installation
|
|
**What you need:**
|
|
* [The latest release of Blueprint.](https://github.com/teamblueprint/main/releases/latest)
|
|
* [`unzip`](https://pkgs.org/download/unzip)
|
|
* [`zip`](https://pkgs.org/download/zip)
|
|
* [`curl`](https://github.com/curl/curl)
|
|
* [`git`](https://github.com/git/git)
|
|
* [`nodejs`](https://nodejs.org) (20.x or later)
|
|
* [`yarn`](https://yarnpkg.com/)
|
|
* 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](https://pterodactyl.io/panel/1.0/updating.html) before moving on with this guide.
|
|
|
|
<br/>
|
|
|
|
1. Navigate to your Pterodactyl folder. (most likely `/var/www/pterodactyl`)
|
|
2. Install NodeJS, NPM and Yarn using the following commands. This assumes you are running Pterodactyl on Ubuntu or Debian-based systems.
|
|
```sh
|
|
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
|
|
```
|
|
3. Download [the latest release of Blueprint](https://github.com/teamblueprint/main/releases/latest) and extract it (stable build) or pull the files via git (bleeding-edge build).
|
|
4. If you haven't already, place the Blueprint files inside of your Pterodactyl folder. (common location is `/var/www/pterodactyl`)
|
|
5. 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 of `bash blueprint.sh`.
|
|
```sh
|
|
chmod +x blueprint.sh
|
|
bash blueprint.sh
|
|
```
|
|
6. 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.
|
|
|
|
<br/>
|
|
|
|
## Development
|
|
We've made some guides and documentation for extension development over on [GitBook](https://ptero.shop/docs). We are adding more guides over time, don't hesitate to suggest a topic for future guides.
|
|
|
|
<br/>
|
|
|
|
## Extensions
|
|
> **Note**
|
|
> [Open a pull request](https://github.com/teamblueprint/main/pulls) 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`.
|
|
|
|
<br/>
|
|
|
|
**Announcements**: [PterodactylMarket](https://pterodactylmarket.com/resource/679), [sourceXchange](https://www.sourcexchange.net/products/announcements), [BuiltByBit](https://builtbybit.com/resources/announcements-for-blueprint.32546/)\
|
|
**Arc.io Integration**: [BuiltByBit](https://builtbybit.com/resources/pterodactyl-v1-addon-arc-integration.32109/)\
|
|
**Cats**: [sourceXchange](https://www.sourcexchange.net/products/cats)\
|
|
**Cookies**: [sourceXchange](https://www.sourcexchange.net/products/cookies)\
|
|
**dbEdit**: [GitHub](https://github.com/prplwtf/blueprint-dbedit)\
|
|
**Loader**: [sourceXchange](https://www.sourcexchange.net/products/loader)\
|
|
**Nebula**: [PterodactylMarket](https://pterodactylmarket.com/resource/698), [sourceXchange](https://www.sourcexchange.net/products/nebula), [BuiltByBit](https://builtbybit.com/resources/nebula-for-blueprint.32442/)\
|
|
**Recolor**: [GitHub](https://github.com/sp11rum/recolor), [sourceXchange](https://www.sourcexchange.net/products/recolor), [BuiltByBit](https://builtbybit.com/resources/recolor.33818/)\
|
|
**Redirect**: [PterodactylMarket](https://pterodactylmarket.com/resource/664), [GitHub](https://github.com/prplwtf/blueprint-redirect)
|
|
|
|
<br/>
|
|
|
|
## Contributors
|
|
[prplwtf](https://github.com/prplwtf) - creator and maintainer\
|
|
[ahwxorg](https://github.com/ahwxorg) - contributor\
|
|
[alipoyrazaydin](https://github.com/alipoyrazaydin) - contributor\
|
|
[sp11rum](https://github.com/sp11rum) - contributor\
|
|
[phedona](https://github.com/Phedona) - contributor\
|
|
[codixer](https://github.com/Codixer) - contributor
|
|
|
|
<br/>
|
|
|
|
## Related Links
|
|
[**Pterodactyl**](https://pterodactyl.io/) is a free, open-source game server management panel built with PHP, React, and Go.\
|
|
[**teamblueprint/templates**](https://github.com/teamblueprint/templates) is a repository with initialization templates for extension development.\
|
|
[**teamblueprint/web**](https://github.com/teamblueprint/web) is our work-in-progress website and documentation revision.
|