How to Set Up a Purpur Server in Minecraft
By Nathan Young
Hosting a Vanilla Minecraft server can be fun with friends, as you’re given an entire dedicated space for any adventures. However, problems may arise such as lag or a lack of control due to the game’s design. Solving this requires using an API to enhance Minecraft’s structure, which means you have more power over in-game aspects. An extremely popular one is known as Purpur, a drop-in replacement for Paper servers. This is completely free and open source, allowing many individuals to continue growing its features. Using this gives you the ability to tweak Minecraft’s settings through many config files, among installing plugins to change the gameplay. Setting this up is easily done on our panel, but can still confuse some owners. Due to this, we’ll show you how to install Purpur on your Minecraft server in this Apex Hosting tutorial.
There are two primary ways to set up Purpur on your Minecraft server, using our installer on the panel or manually doing the process. The first method is highly recommended, as you’re provided many game versions to choose from that support Purpur. Whether you’re wanting a 1.16.5 or 1.19.3 server, our panel will quickly install everything required to get you started. As for the other method, you’d have to download Purpur’s build file and upload it accordingly. This process can cause problems, such as the server not loading or corrupting your world. However, if done correctly, there won’t be any issues and it’ll function normally. With everything in mind, review the subsections below to begin installing Purpur on your server.
Remember, our panel will do everything for you to get it installed. However, you’ll need to understand how to initiate the installation. Follow these steps below to learn more about this process.
- Head towards your Apex server panel, then locate the
- Click the currently selected option to reveal its dropdown menu.
- Continue to search for “Purpur” and your desired game version in the text box.
- Once found, press on it and click
Change Versionin the following prompt.
- Proceed to select
Create New Worldand
Restart Nowin the other popups.
- Wait for the server to load, then join to confirm everything works.
Instead of using our panel to install Purpur, you can selectively choose the build you want to manually upload. This process is longer than the automatic way, but will accomplish the same task. Follow along below to get everything ready for you to play.
- Navigate to the Purpur Downloads page, then locate your desired version.
- Once found, click the
Downloadbutton to the left of it under the
- Rename this file to “custom.jar” save it somewhere easily accessible on your computer.
- Head towards your server panel, then click
Stopnear the top.
- Locate the
Game Filesection and click on the currently selected option.
- In the text box, type “Custom Server Jar” and press it.
- Continue to click
reate New World, and
I’ll Restart Later.
- Near the top left corner, select the
FTP File Accessbutton and
- Enter the
jardirectory, then click
Uploadat the top left.
- Drag and drop the custom.jar file into the respective area, then wait until seeing
- Return to the main panel and
Restartthe server to load the custom Purpur file.
Once you’ve successfully installed Purpur on the server, regardless of the method, there will be new files to access and edit. The main one is purpur.yml, containing important settings that determine in-game features. Whether you’re wanting to change how enchantments or blocks work, this is the area you’ll need to view before making any changes. It’s strongly advised to review the official Purpur Wiki for more information about each option in the file. The following instructions below reveal how you can tweak the settings.
- Enter the
FTP File Accessarea and
- Locate the purpur.yml file and press
Editto the right-hand side of it.
- Proceed to make your desired changes, then click
Saveat the top.
- Return to the main panel and
Restartthe server to apply the edits.
We’ll briefly review some important settings to get you started with Purpur’s configuration. However, there are similar files such as spigot.yml or bukkit.yml that contain equally vital options that determine Minecraft’s functionality in-game. Besides this, review notable purpur.yml settings below to see if you want to edit them.
Inside the “Blocks” category in the file, you can see tons of configurable materials. For example, editing the
ender_chest option can allow you to get more rows to store items in an Ender Chest. Another useful aspect of this category is disabling the
cumulative-cost for Anvils, giving players cheaper EXP costs to add or combine enchantments. There are other blocks to review, with some being less important than others.
If you’re wanting to have better enchantments on your tools, weapons, or equipment, then enabling the
allow-unsafe-enchants option in the “Enchantment” category is required. This will allow players to continuously combine Sharpness levels to exceed the max value, leading to overpowered weapons. Other enchantments follow the same concept, such as pickaxes with Efficiency.
As for the last important area, the “World-Settings” category gives you an enormous amount of options to tweak. These include determining a mob’s max health, enabling sleep with enemies nearby, among player settings. Due to the amount of them, you’ll need to carefully go through the large list. Fortunately, everything is straightforward and easy to follow.
Make sure you aren’t switching from a higher game version to a lower one without creating a new world, as this would cause the server to crash. In other words, make sure to upgrade instead of downgrade due to map incompatibility problems. Otherwise, generate a new world to resolve the situation and/or revert to a compatible version of Purpur that works with your saved progress. However, if this doesn’t apply to you, then make sure to review your plugins since they can sometimes cause issues to arise.
In cases where your custom jar isn’t working properly, confirm you’ve successfully renamed it to “custom.jar” before the upload. Our system, by default, checks this file name so it can begin loading it on the server. Additionally, this must be installed in the jar directory if you want everything to work correctly. On rare occasions, the
Game File’s name field will have something different. If this happens, then change it to “custom.jar” so the system knows how to load it.
Most owners switched to Purpur due to previous lag issues on other server types. If the situation persisted even after this entire process, then make sure to review our optimization guide. This will provide you with detailed information on how to improve the game’s performance. For example, there are helpful plugins that’ll increase the ticks in-game. Another one is changing specific settings in the server files to optimize the gameplay. Unfortunately, if nothing seems to be working, then contact our support team to get additional assistance.
Purpur Official Wiki
How to Switch Server Game Versions
Using and Uploading a Custom JAR File
Becoming a Minecraft Server Operator
How To Make a Purpur Server With Apex Hosting
- Select your server package from our pricing page
- On the ‘Configure Your Server’ page, complete the required fields
- Under ‘Server Version’, select your version from the dropdown list
- Complete the order and your Purpur server will be created instantly