From e07ad62f65b4897e15b40a851c2a36599f69cd47 Mon Sep 17 00:00:00 2001 From: RebelMythik <50276986+RebelMythik@users.noreply.github.com> Date: Wed, 23 Oct 2024 23:41:34 -0400 Subject: [PATCH 1/4] Update doc that covers new versions Removed specifics of 1.19 and changed it to general wording to cover future mc updates. --- docs/running_a_server/exploitfix.md | 2 +- .../{1.19.md => update-minecraft.md} | 28 +++++++++---------- 2 files changed, 14 insertions(+), 16 deletions(-) rename docs/running_a_server/{1.19.md => update-minecraft.md} (63%) diff --git a/docs/running_a_server/exploitfix.md b/docs/running_a_server/exploitfix.md index 679cf22e..82f5075a 100644 --- a/docs/running_a_server/exploitfix.md +++ b/docs/running_a_server/exploitfix.md @@ -166,4 +166,4 @@ You should be able to download one of the jars above (make sure you download a b As per PaperMC team: To test if the patch is working, run `say ${date:YYYY}` in console, it should output the same command and not `2021`. If it outputs `2021` you have not fixed the issue properly. -If you need help updating your server please refer to our [Updating](1.19.md) guide and #support-chat channel. +If you need help updating your server please refer to our [Updating](update-minecraft.md) guide and #support-chat channel. diff --git a/docs/running_a_server/1.19.md b/docs/running_a_server/update-minecraft.md similarity index 63% rename from docs/running_a_server/1.19.md rename to docs/running_a_server/update-minecraft.md index dd5bac21..e4d1bcf4 100644 --- a/docs/running_a_server/1.19.md +++ b/docs/running_a_server/update-minecraft.md @@ -1,26 +1,24 @@ --- -id: 1.19 -title: 1.19 Update -slug: /1.19 +id: update-minecraft +title: Update Minecraft Server +slug: /updateminecraft hide_table_of_contents: true -sidebar_label: ❗ How to update to 1.19 ❗ +sidebar_label: ❗ How to update your Minecraft Server ❗ --- ### Introduction -Minecraft 1.19 - The Wild Update has been released! +With every update it takes a while for softwares such as Spigot, Paper and forks of it to update and support all the changes. Unfortunately it's not possible to have a set ETA for new versions, but you can keep track of updates on [SpigotMC.org](https://www.spigotmc.org) or on [PaperMC's Discord](https://discord.gg/papermc)! -With every update it takes a while for softwares such as Spigot, Paper and forks of it to update and support all the changes. Unfortunately it's not possible to have a set ETA for 1.19 support but you can keep track of updates on [SpigotMC.org](https://www.spigotmc.org) or on [PaperMC's GitHub](https://github.com/PaperMC/Paper/issues/7780)! - -Moving forward the game will use Java's latest release, Java 17. +Moving forward the games latest versions will use Java 21. --- ### Precautions A new version of the game with loads of new content also means potential new exploits and issues. -- Before updating be sure to create and test a backup of your entire server. Downgrading a world without causing corruption is near impossible. +- Before updating, be sure to create and test a backup of your entire server. Downgrading a world without causing corruption is near impossible. - Moreover, if you aren't utilizing our [completely free and automatic backup feature](../using_the_panel/backups.md), we would highly suggest you set that up before updating. -- Once you update to 1.19 you can't go back to any previous version, unless you reset your worlds or restore a backup that was made when the server was on the previous version. +- Once you update to a newer version of minecraft you can't go back to any previous version, unless you reset your worlds or restore a backup that was made when the server was on the previous version. :::important @@ -37,17 +35,17 @@ From Paper 1.19.3 build 425, the server will not stop on cyclic dependencies for --- ### Updating The Jar using Bloom's Server Type System - How to update your server -Once your desired server jar supports 1.19, simply follow these steps to update: +Once your desired server jar supports the version you want to upgrade to, simply follow these steps to update: - Make sure that your server is backed up completely. - [Create full backup](../using_the_panel/backups.md) of your server. (As an additional step, we would suggest testing this backup on a local or a split test server) - Go to the Settings section of the Minecraft Panel and under the Change Server Type section click on the "Update" button. -- If there's no update button you can choose the server type (Jar) you want to use, then on version select 1.19 and click on Change Egg then click on Reinstall Now. Do note that not all server jars have updated to support 1.19, so 1.19 will not appear on the list until the server jar is updated. +- If there's no update button you can choose the server type (Jar) you want to use, then on version select the latest version of minecraft available, click on Change Egg, then click on Reinstall Now. Do note that not all server jars have updated to support the latest version, so it will not appear on the list until the server jar is updated. --- ### Updating The Jar Manually -Once your desired server jar supports 1.19, simply follow these steps to update: +Once your desired server jar supports the latest version of minecraft, simply follow these steps to update: - Make sure that your server is backed up completely. - [Create full backup](../using_the_panel/backups.md) of your server. (As an additional step, we would suggest testing this backup on a local or a split test server) - Remove your current server jar through [SFTP](../using_the_panel/sftp.md) or the [File Manager](../using_the_panel/file-manager-controls.md). @@ -56,10 +54,10 @@ Once your desired server jar supports 1.19, simply follow these steps to update: --- -### Changing To Java 17 +### Changing Java Version :::important -If you are unable to change this next setting and you see a message such as "This server's Docker image has been manually set by an administrator and cannot be changed through this UI.", please [open a ticket on the support Discord.](https://discord.com/invite/bloom) and Bloom.host staff will need to change this for you. +If you are unable to change this next setting, and you see a message such as "This server's Docker image has been manually set by an administrator and cannot be changed through this UI.", please [open a ticket on the support Discord.](https://discord.com/invite/bloom) and Bloom.host staff will need to change this for you. ::: 1. Firstly you want to go to the [Minecraft server control panel](https://mc.bloom.host/) and select the server that you want to change the Java version of. From 7c39a5fc7e1233c1407b0f6571f136b58424ce1c Mon Sep 17 00:00:00 2001 From: RebelMythik <50276986+RebelMythik@users.noreply.github.com> Date: Wed, 23 Oct 2024 23:45:02 -0400 Subject: [PATCH 2/4] nvm there is a 2nd doc --- docs/running_a_server/exploitfix.md | 2 +- docs/running_a_server/update-minecraft.md | 69 ----------------------- 2 files changed, 1 insertion(+), 70 deletions(-) delete mode 100644 docs/running_a_server/update-minecraft.md diff --git a/docs/running_a_server/exploitfix.md b/docs/running_a_server/exploitfix.md index 82f5075a..70dfafa4 100644 --- a/docs/running_a_server/exploitfix.md +++ b/docs/running_a_server/exploitfix.md @@ -166,4 +166,4 @@ You should be able to download one of the jars above (make sure you download a b As per PaperMC team: To test if the patch is working, run `say ${date:YYYY}` in console, it should output the same command and not `2021`. If it outputs `2021` you have not fixed the issue properly. -If you need help updating your server please refer to our [Updating](update-minecraft.md) guide and #support-chat channel. +If you need help updating your server please refer to our [Updating](updating.md) guide and #support-chat channel. diff --git a/docs/running_a_server/update-minecraft.md b/docs/running_a_server/update-minecraft.md deleted file mode 100644 index e4d1bcf4..00000000 --- a/docs/running_a_server/update-minecraft.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -id: update-minecraft -title: Update Minecraft Server -slug: /updateminecraft -hide_table_of_contents: true -sidebar_label: ❗ How to update your Minecraft Server ❗ ---- - -### Introduction - -With every update it takes a while for softwares such as Spigot, Paper and forks of it to update and support all the changes. Unfortunately it's not possible to have a set ETA for new versions, but you can keep track of updates on [SpigotMC.org](https://www.spigotmc.org) or on [PaperMC's Discord](https://discord.gg/papermc)! - -Moving forward the games latest versions will use Java 21. - ---- - -### Precautions -A new version of the game with loads of new content also means potential new exploits and issues. -- Before updating, be sure to create and test a backup of your entire server. Downgrading a world without causing corruption is near impossible. -- Moreover, if you aren't utilizing our [completely free and automatic backup feature](../using_the_panel/backups.md), we would highly suggest you set that up before updating. -- Once you update to a newer version of minecraft you can't go back to any previous version, unless you reset your worlds or restore a backup that was made when the server was on the previous version. - -:::important - -Starting with Paper 1.19.3 build 405, changes made to the plugin loader means that setups with cyclic plugin dependencies (where plugin loading causes a loading loop which will cycle back to the original plugin) will no longer function. A server with plugin dependency loops will not load and will be shut down with an error. - -See the [Paper help page](https://docs.papermc.io/paper/reference/paper-plugins#cyclic-plugin-loading) for information on how to resolve the issue. - -From Paper 1.19.3 build 425, the server will not stop on cyclic dependencies for Bukkit/Spigot plugins. -::: - -![logo](/running_a_server/1.18/2.png) - - ---- - -### Updating The Jar using Bloom's Server Type System - How to update your server -Once your desired server jar supports the version you want to upgrade to, simply follow these steps to update: -- Make sure that your server is backed up completely. -- [Create full backup](../using_the_panel/backups.md) of your server. (As an additional step, we would suggest testing this backup on a local or a split test server) -- Go to the Settings section of the Minecraft Panel and under the Change Server Type section click on the "Update" button. -- If there's no update button you can choose the server type (Jar) you want to use, then on version select the latest version of minecraft available, click on Change Egg, then click on Reinstall Now. Do note that not all server jars have updated to support the latest version, so it will not appear on the list until the server jar is updated. - ---- - - -### Updating The Jar Manually -Once your desired server jar supports the latest version of minecraft, simply follow these steps to update: -- Make sure that your server is backed up completely. -- [Create full backup](../using_the_panel/backups.md) of your server. (As an additional step, we would suggest testing this backup on a local or a split test server) -- Remove your current server jar through [SFTP](../using_the_panel/sftp.md) or the [File Manager](../using_the_panel/file-manager-controls.md). -- Download the new version of your server software. If you are unsure which one to use, check out our guide on server jars [here](jars.md). -- Upload it using SFTP or the File Manager and make sure to define the full name (such as `paper-1.19-023` in the 'Startup' tab on the panel) - ---- - -### Changing Java Version - -:::important -If you are unable to change this next setting, and you see a message such as "This server's Docker image has been manually set by an administrator and cannot be changed through this UI.", please [open a ticket on the support Discord.](https://discord.com/invite/bloom) and Bloom.host staff will need to change this for you. -::: - -1. Firstly you want to go to the [Minecraft server control panel](https://mc.bloom.host/) and select the server that you want to change the Java version of. -2. On the left side, select 'Startup'. -3. Next, find the Java Version tab (usually on the top right of the page) -4. Select the `Java 17` option! -5. Start your server back up! - -![java version](/running_a_server/java_version/1.png) From 3fb0f5b354b36a5d9b6a51610094f12b94d1eebf Mon Sep 17 00:00:00 2001 From: RebelMythik <50276986+RebelMythik@users.noreply.github.com> Date: Thu, 24 Oct 2024 00:09:48 -0400 Subject: [PATCH 3/4] Update info / grammer removed incorrect info and updated wording / removed not needed information in docs. --- docs/running_a_server/binarysearch.md | 12 +++--- docs/running_a_server/converting-worlds.md | 2 +- docs/running_a_server/jars.md | 45 +--------------------- 3 files changed, 9 insertions(+), 50 deletions(-) diff --git a/docs/running_a_server/binarysearch.md b/docs/running_a_server/binarysearch.md index 83df3be5..6e6b00c4 100644 --- a/docs/running_a_server/binarysearch.md +++ b/docs/running_a_server/binarysearch.md @@ -13,7 +13,7 @@ keywords: - Error --- -A common problem that server owners encounter is that they have a bug on their server that is not caused by the server JAR or any of its configurations, server settings, and other external factors. When you are certain that it is a plugin causing the issue but not sure which **among** your plugins are causing the issue, one of the best things to do is conduct a binary search. +A common problem that server owners encounter is that they have a bug on their server that is not caused by the server JAR or any of its configurations, server settings, and other external factors. When you are certain that it is a plugin causing the issue but not sure which among your plugins are causing the issue, one of the best things to do is conduct a binary search. :::warning @@ -21,19 +21,19 @@ While it is technically possible to use plugins such as ServerUtils to unload an ::: -## Step 0 +## Step 1 -First, you need to be 100% sure that this bug is not caused by the server JAR you are using. If you are using forks of Paper such as Purpur or Airplane, switch back to Paper first or check if you set something in the JAR configuration that you did not mean to. Also check if it is not an issue with your startup flags, database details, ports and proxies, etc. +First, you need to be 100% sure that this bug is not caused by the server JAR you are using. If you are using forks of Paper switch back to Paper first or check if you set something in the JAR configuration that you did not mean to. Also check if it is not an issue with your startup flags, database details, ports and proxies, etc. -## Step 1 +## Step 2 Remove half of your plugins. To do this, select the plugins and move them outside of the /plugins folder. After this, reboot your server. -## Step 2 +## Step 3 If the bug is not fixed after that, now you know that the bug is among the plugins that are left. If the bug was fixed, you know that the bug is among the plugins that you removed. If you still cannot determine which plugin is the culprit after narrowing it down, remove half of the group of plugins again. -## Step 3 +## Step 4 Rinse and repeat. After you have finally found the culprit, you can fix the bug and then bring back all the plugins to your server. diff --git a/docs/running_a_server/converting-worlds.md b/docs/running_a_server/converting-worlds.md index ebc5af6d..1487f98b 100644 --- a/docs/running_a_server/converting-worlds.md +++ b/docs/running_a_server/converting-worlds.md @@ -22,6 +22,7 @@ If you upload or generate a world on a Bukkit/Spigot/Paper server, you will noti ## Part 1: Download the world **Note:** This is not strictly necessary, you CAN use SFTP or the file manager if you want, but downloading the files makes them much easier to work with. + This is most easily done by archiving the files using the Pterodactyl file manager and downloading them using SFTP. For instructions on using the file manager and SFTP, please see [File Manager Controls](/file-manager-controls/) and [How to use SFTP](/sftp/), respectively. ## Part 2: Converting the world @@ -46,4 +47,3 @@ Return to the root folder once again and go into `world_the_end`. From here, cop By copying the DIM-1 and DIM1 folders into `world`, you have made a copy of all the data of the Nether and End dimensions available in the `world` folder, which means that it now contains all the required data to run all three dimensions successfully (it already has its own copies of `level.dat`, `session.lock` and `uid.dat`) and can be run without issue on vanilla, Fabric, Forge and other servers. -You did it! diff --git a/docs/running_a_server/jars.md b/docs/running_a_server/jars.md index f5b33f09..fe792c8f 100644 --- a/docs/running_a_server/jars.md +++ b/docs/running_a_server/jars.md @@ -9,7 +9,6 @@ keywords: - Spigot - Paper - Bukkit - - Tuinity - Forge - Fabric - Purpur @@ -46,22 +45,9 @@ Fabric, with a few performance mods added, is recommended if you want to run a m ## Other popular options: :::warning -Some popular Jars such as Sponge attempt to merge Bukkit and Forge to allow the use of Plugins and Mods in the same enviorment, while popular these implementations can end up combining the issues of both server types and be unstable as a result. +Some popular Jars such as Mohist/Magma attempt to merge Bukkit and Forge to allow the use of Plugins and Mods in the same enviorment, while popular these implementations can end up combining the issues of both server types and be unstable as a result. ::: -### [Vanilla](https://www.minecraft.net/en-us/download/server) -Vanilla is the jar provided by Mojang to run Minecraft servers. This is the bare minimum for servers with no plugin API for plugins to hook into or a modding API like forge. It is not optimized and only recommended for small groups of friends who want to play plain vanilla. - - - -### [Bukkit](https://bukkit.org/) -Bukkit is an open source but defunct jar that was used in the early days of Minecraft plugin development. In 2014, Bukkit Project lead Warren Loo announced the end of the Bukkit project. The project was then DMCA'd by a former developer causing massive amounts of code to no longer be apart of Bukkit. If you want to learn the whole situation, read [Justin Flory blog post](https://blog.jwf.io/2020/04/open-source-minecraft-bukkit-gpl/) about it. CraftBukkit is a continuation that is still supported by Spigot, but is not recommended for servers as it's old and rarely recieves updates. - - - -### [Spigot](https://www.spigotmc.org/) -Spigot is a fork of Bukkit that began in 2012. After Bukkit defuncted, it became the new standard as Bukkit plugins could all run on Spigot. Spigot is not recommended anymore as Paper has far surpassed it in performance and options. - ### [Pufferfish](https://github.com/pufferfish-gg/Pufferfish) "A highly optimized Paper fork designed for large servers requiring both maximum performance, stability, and "enterprise" features." Pufferfish is a fork of paper (and as such also includes all of the improvements paper adds) that aims to add even more performance optimizations over paper. It includes every change that airplane used to have. And adds some of its own changes too. @@ -76,32 +62,5 @@ Purpur aims to make your server more configurable, it adds **a lot** of fun or u ### [Sponge](https://www.spongepowered.org/) - Sponge is an API designed to be an overhaul of the Bukkit API, it also allows you to run Forge mods together with Sponge plugins. It doesn't run Bukkit or any of its fork plugins. Currently, Sponge is on version 1.12.2 and is recommended for if you want modpacks and plugins together as smoothly as possible. - - - -### [Minestom](https://minestom.com/) -"Minestom is a complete rewrite of Minecraft server software, open-source and without any code from Mojang." -Minestom is a *very* experimental developer API not meant to be used by end-users. Replacing Paper with this will not work since it does not implement the Bukkit API. It's very fast and can handle a lot of players. Only try if you like tinkering with code and are prepared to put in the work. - + Sponge is an API designed to work with forge allowing the use of mods and plugins together in a stable environment. Currently, Sponge is recommended if you want modpacks and plugins together as smoothly as possible. However, Sponge does not support any sort of Spigot/Paper plugins as it's a completely different software. ---- - -## Deprecated Server Software - -:::warning -The server software mentioned in this section are no longer updated and are not recommended for use on your servers; however they are kept here for reference purposes. -::: - -### [Airplane](https://airplane.gg/) -~~"A stable, optimized, well supported 1.16.5 & 1.17 Paper fork." -Airplane is a fork of paper (and as such also includes all of the improvements paper adds) that aims to add even more performance optimizations over paper.~~ -Airplane isn't being updated to modern versions of the game. - -It is recommended that an alternative JAR such as [Purpur](#purpur) or [Pufferfish](#pufferfish) should be used. - -### [Tuinity](https://github.com/Spottedleaf/Tuinity) -~~Tuinity is a high performance fork of paper (and as such also includes all of the improvements paper adds) that brings more performance changes for servers to play around with. It can greatly increase TPS, allowing a smoother experience, especially on bigger servers.~~ -Tuinity has now been merged into [Paper](#paper) with all of its improvements and optimizations, and as such Tuinity as a jar is now obsolete. - ---- From c16317301488f3f818f5eb063b01bdf18cd76b86 Mon Sep 17 00:00:00 2001 From: RebelMythik <50276986+RebelMythik@users.noreply.github.com> Date: Thu, 24 Oct 2024 00:15:55 -0400 Subject: [PATCH 4/4] Update jars.md --- docs/running_a_server/jars.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/running_a_server/jars.md b/docs/running_a_server/jars.md index fe792c8f..d994f7ce 100644 --- a/docs/running_a_server/jars.md +++ b/docs/running_a_server/jars.md @@ -12,14 +12,12 @@ keywords: - Forge - Fabric - Purpur - - Airplane - Pufferfish - Server Jars - Minecraft - Modded Server Jars - Plugin Server Jars - Bloom.host - - Minestom --- ## Recommended Software: