How to Set Up a Purpur Server in Minecraft

in Modpacks

By Nathan Young

• Facebook
• Twitter
• Youtube

Purpur 1.19.3

1933

Checkout

Overview

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.
 

Server Setup

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.
 

Automatic Installation

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.

1. Head towards your Apex server panel, then locate the Game File section.
2. Click the currently selected option to reveal its dropdown menu.
   
3. Continue to search for “Purpur” and your desired game version in the text box.
   
4. Once found, press on it and click Change Version in the following prompt.
   
5. Proceed to select Create New World and Restart Now in the other popups.
6. Wait for the server to load, then join to confirm everything works.

Manual Installation

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.

1. Navigate to the Purpur Downloads page, then locate your desired version.
2. Once found, click the Download button to the left of it under the Build category.
   
3. Rename this file to “custom.jar” save it somewhere easily accessible on your computer.
   
4. Head towards your server panel, then click Stop near the top.
5. Locate the Game File section and click on the currently selected option.
6. In the text box, type “Custom Server Jar” and press it.
   
7. Continue to click Change Version, reate New World, and I’ll Restart Later.
   
8. Near the top left corner, select the FTP File Access button and Login accordingly.
   
9. Enter the jar directory, then click Upload at the top left.
10. Drag and drop the custom.jar file into the respective area, then wait until seeing 100%.
    
11. Return to the main panel and Restart the server to load the custom Purpur file.

Purpur Configuration

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.

1. Enter the FTP File Access area and Login with your Password.
   
2. Locate the purpur.yml file and press Edit to the right-hand side of it.
   
3. Proceed to make your desired changes, then click Save at the top.
   
4. Return to the main panel and Restart the server to apply the edits.

Important Settings

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.
 

Common Issues

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.
 

Useful Links

Purpur Official Wiki
How to Switch Server Game Versions
Using and Uploading a Custom JAR File
Becoming a Minecraft Server Operator