diff --git a/.gitbook/assets/PlayerServersDaemon (1).jar b/.gitbook/assets/PlayerServersDaemon (1).jar new file mode 100644 index 0000000..348745d Binary files /dev/null and b/.gitbook/assets/PlayerServersDaemon (1).jar differ diff --git a/.gitbook/assets/PlayerServersDaemon v3.1-beta5.zip b/.gitbook/assets/PlayerServersDaemon v3.1-beta5.zip new file mode 100644 index 0000000..5a12b5f Binary files /dev/null and b/.gitbook/assets/PlayerServersDaemon v3.1-beta5.zip differ diff --git a/.gitbook/assets/PlayerServersDaemon.jar b/.gitbook/assets/PlayerServersDaemon.jar index 348745d..ab0f7cd 100644 Binary files a/.gitbook/assets/PlayerServersDaemon.jar and b/.gitbook/assets/PlayerServersDaemon.jar differ diff --git a/SUMMARY.md b/SUMMARY.md index 584e9f3..5ff8769 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -4,11 +4,12 @@ * [🖥 PlayerServers - Overview](README.md) * [🚀 Plugin Installation Tutorial](overview/installation/README.md) + * [🛳 Adding a node](overview/installation/adding-a-node.md) * [🎁 Templates](overview/installation/templates.md) * [📦 Adding pre-defined plugins](overview/installation/adding-pre-defined-plugins.md) -* [🌐 Pterodactyl configuration](overview/pterodactyl-configuration/README.md) - * [Download custom wings](overview/pterodactyl-configuration/download-custom-wings.md) - * [How to create tokens](overview/pterodactyl-configuration/how-to-create-tokens.md) +* [🌐 Pterodactyl configuration](overview/installation/pterodactyl-configuration.md) + * [🕊 Download custom wings](overview/pterodactyl-configuration/download-custom-wings.md) + * [🔓 How to create tokens](overview/pterodactyl-configuration/how-to-create-tokens.md) * [📜 Current Config files](overview/config.md) * [🚫 Limitations](overview/limitations/README.md) * [Permission-based RAM](overview/limitations/permission-based-ram.md) @@ -18,30 +19,30 @@ *** -* [👵 Legacy (v2.x)](legacy-v2.x/README.md) - * [Updates](legacy-v2.x/updates/README.md) - * [PlayerServers - General](legacy-v2.x/updates/master.md) - * [v1.1 to v1.2](legacy-v2.x/updates/v1.1-to-v1.2.md) - * [8.0 to v1.0](legacy-v2.x/updates/8.0-to-v1.0.md) - * [5.0 to 6.0](legacy-v2.x/updates/5.0-to-6.0.md) - * [3.7-D to 4.0](legacy-v2.x/updates/update1.md) - * [Basic instructions](legacy-v2.x/basic-instructions.md) - * [Plugin management](legacy-v2.x/plugin-management.md) - * [Plugin Installation Tutorial](legacy-v2.x/installation.md) - * [Editing config files](legacy-v2.x/editing-config-files.md) - * [Current Config & Messages File](legacy-v2.x/config.md) - * [Permissions & Commands](legacy-v2.x/permissions-and-commands.md) - * [Limitations](legacy-v2.x/limitations/README.md) - * [Permission-based RAM](legacy-v2.x/limitations/permission-based-ram.md) - * [Max players limitation](legacy-v2.x/limitations/max-players-limitation.md) - * [Max plugins limitation](legacy-v2.x/limitations/max-plugins-limitation.md) - * [Adding pre-defined plugins](legacy-v2.x/adding-pre-defined-plugins.md) - * [Creating MySQL database](legacy-v2.x/creating-mysql-database.md) - * [Additional Tutorials (FAQ)](legacy-v2.x/additional-tutorials-faq.md) - * [Screen (accessing consoles)](legacy-v2.x/screen.md) +* [👵 Legacy (v2.x)](legacy/README.md) + * [Updates](legacy/updates/README.md) + * [PlayerServers - General](legacy/updates/master.md) + * [v1.1 to v1.2](legacy/updates/v1.1-to-v1.2.md) + * [8.0 to v1.0](legacy/updates/8.0-to-v1.0.md) + * [5.0 to 6.0](legacy/updates/5.0-to-6.0.md) + * [3.7-D to 4.0](legacy/updates/update1.md) + * [Basic instructions](legacy/basic-instructions.md) + * [Plugin management](legacy/plugin-management.md) + * [Plugin Installation Tutorial](legacy/installation.md) + * [Editing config files](legacy/editing-config-files.md) + * [Current Config & Messages File](legacy/config.md) + * [Permissions & Commands](legacy/permissions-and-commands.md) + * [Limitations](legacy/limitations/README.md) + * [Permission-based RAM](legacy/limitations/permission-based-ram.md) + * [Max players limitation](legacy/limitations/max-players-limitation.md) + * [Max plugins limitation](legacy/limitations/max-plugins-limitation.md) + * [Adding pre-defined plugins](legacy/adding-pre-defined-plugins.md) + * [Creating MySQL database](legacy/creating-mysql-database.md) + * [Additional Tutorials (FAQ)](legacy/additional-tutorials-faq.md) + * [Screen (accessing consoles)](legacy/screen.md) * [Screen (advanced)](https://linuxize.com/post/how-to-use-linux-screen/) - * [Templates](legacy-v2.x/templates.md) - * [Multi-Node Support](legacy-v2.x/multi-node-support.md) + * [Templates](legacy/templates.md) + * [Multi-Node Support](legacy/multi-node-support.md) * [Unofficial Video Tutorial](https://www.youtube.com/watch?v=VApcwAG4y5c) * [MC-Market Thread](https://www.mc-market.org/threads/583445/#post-4508558) diff --git a/legacy-v2.x/README.md b/legacy/README.md similarity index 95% rename from legacy-v2.x/README.md rename to legacy/README.md index bfcb7d5..c915c43 100644 --- a/legacy-v2.x/README.md +++ b/legacy/README.md @@ -4,7 +4,7 @@ description: >- PlayerServers (older than v3) --- -# 👵 Legacy +# 👵 Legacy (v2.x) {% content-ref url="../" %} [..](../) diff --git a/legacy-v2.x/adding-pre-defined-plugins.md b/legacy/adding-pre-defined-plugins.md similarity index 100% rename from legacy-v2.x/adding-pre-defined-plugins.md rename to legacy/adding-pre-defined-plugins.md diff --git a/legacy-v2.x/additional-tutorials-faq.md b/legacy/additional-tutorials-faq.md similarity index 100% rename from legacy-v2.x/additional-tutorials-faq.md rename to legacy/additional-tutorials-faq.md diff --git a/legacy-v2.x/basic-instructions.md b/legacy/basic-instructions.md similarity index 100% rename from legacy-v2.x/basic-instructions.md rename to legacy/basic-instructions.md diff --git a/legacy-v2.x/config.md b/legacy/config.md similarity index 100% rename from legacy-v2.x/config.md rename to legacy/config.md diff --git a/legacy-v2.x/creating-mysql-database.md b/legacy/creating-mysql-database.md similarity index 100% rename from legacy-v2.x/creating-mysql-database.md rename to legacy/creating-mysql-database.md diff --git a/legacy-v2.x/editing-config-files.md b/legacy/editing-config-files.md similarity index 100% rename from legacy-v2.x/editing-config-files.md rename to legacy/editing-config-files.md diff --git a/legacy-v2.x/installation.md b/legacy/installation.md similarity index 100% rename from legacy-v2.x/installation.md rename to legacy/installation.md diff --git a/legacy-v2.x/limitations/README.md b/legacy/limitations/README.md similarity index 100% rename from legacy-v2.x/limitations/README.md rename to legacy/limitations/README.md diff --git a/legacy-v2.x/limitations/max-players-limitation.md b/legacy/limitations/max-players-limitation.md similarity index 100% rename from legacy-v2.x/limitations/max-players-limitation.md rename to legacy/limitations/max-players-limitation.md diff --git a/legacy-v2.x/limitations/max-plugins-limitation.md b/legacy/limitations/max-plugins-limitation.md similarity index 100% rename from legacy-v2.x/limitations/max-plugins-limitation.md rename to legacy/limitations/max-plugins-limitation.md diff --git a/legacy-v2.x/limitations/permission-based-ram.md b/legacy/limitations/permission-based-ram.md similarity index 100% rename from legacy-v2.x/limitations/permission-based-ram.md rename to legacy/limitations/permission-based-ram.md diff --git a/legacy-v2.x/multi-node-support.md b/legacy/multi-node-support.md similarity index 100% rename from legacy-v2.x/multi-node-support.md rename to legacy/multi-node-support.md diff --git a/legacy-v2.x/permissions-and-commands.md b/legacy/permissions-and-commands.md similarity index 100% rename from legacy-v2.x/permissions-and-commands.md rename to legacy/permissions-and-commands.md diff --git a/legacy-v2.x/plugin-management.md b/legacy/plugin-management.md similarity index 100% rename from legacy-v2.x/plugin-management.md rename to legacy/plugin-management.md diff --git a/legacy-v2.x/screen.md b/legacy/screen.md similarity index 100% rename from legacy-v2.x/screen.md rename to legacy/screen.md diff --git a/legacy-v2.x/templates.md b/legacy/templates.md similarity index 100% rename from legacy-v2.x/templates.md rename to legacy/templates.md diff --git a/legacy-v2.x/updates/5.0-to-6.0.md b/legacy/updates/5.0-to-6.0.md similarity index 100% rename from legacy-v2.x/updates/5.0-to-6.0.md rename to legacy/updates/5.0-to-6.0.md diff --git a/legacy-v2.x/updates/8.0-to-v1.0.md b/legacy/updates/8.0-to-v1.0.md similarity index 100% rename from legacy-v2.x/updates/8.0-to-v1.0.md rename to legacy/updates/8.0-to-v1.0.md diff --git a/legacy-v2.x/updates/README.md b/legacy/updates/README.md similarity index 100% rename from legacy-v2.x/updates/README.md rename to legacy/updates/README.md diff --git a/legacy-v2.x/updates/master.md b/legacy/updates/master.md similarity index 100% rename from legacy-v2.x/updates/master.md rename to legacy/updates/master.md diff --git a/legacy-v2.x/updates/update1.md b/legacy/updates/update1.md similarity index 100% rename from legacy-v2.x/updates/update1.md rename to legacy/updates/update1.md diff --git a/legacy-v2.x/updates/v1.1-to-v1.2.md b/legacy/updates/v1.1-to-v1.2.md similarity index 100% rename from legacy-v2.x/updates/v1.1-to-v1.2.md rename to legacy/updates/v1.1-to-v1.2.md diff --git a/overview/config.md b/overview/config.md index 9b386fc..8cb6b80 100644 --- a/overview/config.md +++ b/overview/config.md @@ -1,7 +1,7 @@ # 📜 Current Config files {% hint style="info" %} -The below page explains how to use this feature on PlayerServers 3. This is only relevant if you're a beta tester. To view this page for PlayerServers 3, click [here.](../legacy-v2.x/config.md) +The below page explains how to use this feature on PlayerServers 3. This is only relevant if you're a beta tester. To view this page for PlayerServers 3, click [here.](../legacy/config.md) {% endhint %} Below you can see the contents of the newest BungeeCord PlayerServers configuration file. diff --git a/overview/installation/README.md b/overview/installation/README.md index 804980d..dcfa1a6 100644 --- a/overview/installation/README.md +++ b/overview/installation/README.md @@ -22,9 +22,9 @@ Operating Systems marked with ⛔️ are currently not supported at all, but the | **Ubuntu** |

18.04

(Bionic)

| ✅ | The plugin was tested on this OS and confirmed to have no issues. | | **Ubuntu** | 16.04 | ⚠️ | Untested, but the plugin should work | | **Debian** |

9

10

11

| ✅ |

Tested, the plugin worked but the instructions from this guide might be invalid for that OS.

Some additional repos might be required.

| -| **Debian** |

9
8

| ⚠️ | Untested, additional repos may be required | -| **CentOS** | 7 & 8 | ⚠️ | **Not tested**, though we had reports of centOS working without any issues. | -| **Windows** |

Server 2016

Server 2019

Server 2022

10

11

| ❌❓ |

Tested, not working. It may work though, by installing Ubuntu subsystem for Windows.

You can find more tutorials about that on Youtube.

| +| **Debian** | 8 | ⚠️ | Untested, additional repos may be required | +| **CentOS** | 7 & 8 | ⚠️ | **Not tested**, though we had reports of centOS working without any issues and we do not see any reason for it not to work there. | +| **Windows** |

Server 2016

Server 2019

Server 2022

10

11

| ✅ |

Tested, works perfectly.

PlayerServers v3+ introduced the full Windows support by using Docker for instance management

| | **MacOS** |

Mojave

Catalina

Big Sur

Monterey
Ventura

| ✅ |

Should work without any problems as it comes with

screen & fuser pre-installed.

Tested on M1 processors as well. On M1 machines, ARM JVM like Azul Zulu is highly recommended.

| ## Requirements @@ -49,8 +49,8 @@ After the first boot of the server, you will see some errors generated by the pl Now navigate to the `plugins folder -> PlayerServers` and open up the config.yml file. It is recommended to open it using some sort of advanced text editor (like [Notepad++](https://notepad-plus-plus.org) or [VisualStudio Code](https://code.visualstudio.com)). After that, you will have to enter your MySQL informations. If you don't have a MySQL server running already, please follow the link below. -{% content-ref url="../../legacy-v2.x/creating-mysql-database.md" %} -[creating-mysql-database.md](../../legacy-v2.x/creating-mysql-database.md) +{% content-ref url="../../legacy/creating-mysql-database.md" %} +[creating-mysql-database.md](../../legacy/creating-mysql-database.md) {% endcontent-ref %} After the configuration of MySQL database, boot up your BungeeCord server. The plugin should successfully launch this time. diff --git a/overview/installation/adding-a-node.md b/overview/installation/adding-a-node.md new file mode 100644 index 0000000..d984c9a --- /dev/null +++ b/overview/installation/adding-a-node.md @@ -0,0 +1,50 @@ +--- +description: Learn how to create a node for servers to be deployed to. +--- + +# 🛳 Adding a node + +## Introduction + +In order to create subservers, you need to have nodes configured. Each node can have a configurable amount of servers running at the same time. A node can be the same machine that you host your BungeeCord on, or any other machine connected to the internet. + +## Instructions + +### Download Daemon + +In order to create a node, you'll need to download the latest Daemon. + +{% file src="../../.gitbook/assets/PlayerServersDaemon v3.1-beta5.zip" %} +Download the latest daemon +{% endfile %} + +After downloading it, put it in a separate folder and extract it, preferably **out** of your BungeeCord folder. This is not a plugin, but a separate software made for handling server requests. + +Now run the Daemon with the following command: + +{% code title="Command to start Daemon" %} +```sh +java -Xmx500M -jar PlayerServeshersDaemon.jar +``` +{% endcode %} + +After running it, type `exit` to stop your Daemon. + +Now, edit your config.toml generated inside Daemon folder to your preference and make sure to use the same token as in config.toml when creating a new node. + +### Create node in-game + +The last step would be to add the node to PlayerServers. To do so, type the following command: + +{% code overflow="wrap" %} +```sh +/psadmin node create +``` +{% endcode %} + +* NodeName is any name you want to give to your node +* IP is the ip of the machine the node is located on +* Port is the port, configurable in config.toml of your Daemon. +* MinPort and MaxPort represent the port range in which your servers are going to be created on. For example, if you put 30000 and 30100 as min and max port respectively, your servers will get a random port between those two numbers when created on this node. +* MaxOnline is the max number of online instances at once on this node. +* Token is the token configured in Daemon's config.toml diff --git a/overview/installation/adding-pre-defined-plugins.md b/overview/installation/adding-pre-defined-plugins.md index 6bb3446..26b656c 100644 --- a/overview/installation/adding-pre-defined-plugins.md +++ b/overview/installation/adding-pre-defined-plugins.md @@ -6,6 +6,6 @@ description: >- # 📦 Adding pre-defined plugins -In order to add plugins to the plugin-installer GUI and make those plugins available to ALL of your players and their servers, you need to navigate to your BungeeCord plugins folder, than go to the PlayerServers folder, and from there, navigate to the `plugins-to-be-added-ingame` subfolder. +In order to add plugins to the plugin-installer GUI and make those plugins available to all of your players and their servers, you need to navigate to your BungeeCord plugins folder, than go to the PlayerServers folder, and from there, navigate to the `server-plugins` subfolder. After that, put the .jar files of all the plugins you want your players to be able to install on their sub-servers. diff --git a/overview/pterodactyl-configuration/README.md b/overview/installation/pterodactyl-configuration.md similarity index 100% rename from overview/pterodactyl-configuration/README.md rename to overview/installation/pterodactyl-configuration.md diff --git a/overview/installation/templates.md b/overview/installation/templates.md index 1655887..093b2e6 100644 --- a/overview/installation/templates.md +++ b/overview/installation/templates.md @@ -9,28 +9,12 @@ description: Learn how to setup templates with plugins, mods, worlds and configu In PlayerServers, Templates are an essential way of managing the creation of your servers. {% hint style="info" %} -_At minimum you are required to have a default Template folder with Spigot.jar file inside. Without that, it will not be possible to create a subserver._ +_At minimum you are required to have a `default` Template folder with Spigot.jar file inside. Without that, it will not be possible to create a subserver._ {% endhint %} ## Instructions 1. Create folder in /templates/\ -2. Put all the server files there INCLUDING Spigot.jar (do not include server.properties or spigot.yml) -3. If the folder includes plugins, please do not include PSServerCore.jar or it's configuration files -4. If your server includes plugins, please add all of them to plugins-to-be-installed-ingame folder -5. Add your template to config.yml as in the following example: - -```yaml -templates: - default: - # Below you should add all the plugins from your template in the described format - plugins: - - EssentialsX-2.18.1.0.jar;Essentials;Provides an essential, core set of commands for Bukkit. -``` - -**As you can see, the template is the following:** \ -JarFileNameFromPluginsToBeInstalledIngameFolder;PluginNameFromPlugin.yml;Description - -* JarFileNameFromPluginsToBeInstalledIngameFolder - the name of the jar file from the plugins to be installed ingame folder (example: EssentialsX-2.18.1.0.jar) -* PluginNameFromPlugin.yml - Find it by openning the plugin with WinRar, for example. Inside, you will see plugin.yml. Copy the plugin name from there -* Description - As described in the previous step, there is also a plugin description in plugin.yml. Copy it in the description part. NOTE THAT NOT ALL THE PLUGINS CONTAIN DESCRIPTION. In that case, you can create a custom one. +2. Put all the server files there **including Spigot.jar** (you must not include server.properties or spigot.yml) +3. If the folder includes plugins, please do not include PSServerCore.jar or it's configuration files +4. If your server includes plugins, please add all of them to the server-plugins folder diff --git a/overview/pterodactyl-configuration/download-custom-wings.md b/overview/pterodactyl-configuration/download-custom-wings.md index ced6d89..ebf8d36 100644 --- a/overview/pterodactyl-configuration/download-custom-wings.md +++ b/overview/pterodactyl-configuration/download-custom-wings.md @@ -4,7 +4,7 @@ description: >- your subservers. --- -# Download custom wings +# 🕊 Download custom wings In order to make sure your players can't remove ServerCore from their servers and thus removing the only thing that will stop their server from being online 24/7, this modification is highly recommended. diff --git a/overview/pterodactyl-configuration/how-to-create-tokens.md b/overview/pterodactyl-configuration/how-to-create-tokens.md index 234c736..c5c9e38 100644 --- a/overview/pterodactyl-configuration/how-to-create-tokens.md +++ b/overview/pterodactyl-configuration/how-to-create-tokens.md @@ -2,7 +2,7 @@ description: Learn how to create Pterodactyl client and application API token. --- -# How to create tokens +# 🔓 How to create tokens ## Introduction