Purpur is an optimized Minecraft server that combines the best features of Paper and Spigot. It enhances your server's performance while offering great flexibility for configuration. In this guide, we will show you how to launch an optimized Purpur server, step by step.

Prerequisites Before Installation

Before launching your Purpur server, you need to ensure you have the following:

Java 17 or higher installed on your machine.
Access to a terminal, whether on Windows, Linux, or macOS.
A dedicated server or a VPS is recommended for better performance.

Downloading Purpur

To get started, you need to download the latest version of Purpur. Follow these steps:

Go to the Purpur download page.
Download the .jar file of the desired version.
Move the .jar file to a dedicated folder for your Minecraft server.

Configuring Your Server

Creating the Startup File

To run your Purpur server, you need to create a startup script. This script will launch the server with the correct options. Here’s an example script for Linux:

#!/bin/bash

# Starts the Purpur server
java -Xms1G -Xmx4G -jar purpur.jar nogui

Make sure to give execution permissions to your script:

chmod +x start.sh

Configuring the Server with `server.properties`

Once your server is running, you will have a server.properties file generated. Open it to configure various settings:

server-port: the port on which your server listens (default 25565).
max-players: maximum number of players allowed on the server.
level-name: name of the world the server will load.

Here’s an example of server.properties content:

server-port=25565
max-players=20
level-name=world

Optimizing the Purpur Server

Using Performance Settings

Purpur offers many optimization settings that you can configure in the purpur.yml file. Here are some recommended settings:

ticking-area: allows you to configure the chunk loading area.
entity-activation-range: adjusts the distance at which entities are active.
view-distance: reduces the render distance to improve performance.

Example configuration in purpur.yml:

ticking-area:
  enabled: true
  radius: 4

entity-activation-range:
  animals: 32
  monsters: 32

view-distance: 6

Installing Plugins

To extend your server's capabilities, you can install plugins. Here’s how to do it:

Download a plugin compatible with Purpur from a site like SpigotMC or Bukkit.
Place the plugin file in the plugins folder of your server.
Restart the server for the plugin to be loaded.

Server Management and Maintenance

Restarting and Backups

It is crucial to regularly restart the server to free up memory and apply updates. Use the following command to restart the server:

/restart

To perform backups, you can use plugins like EssentialsX that offer automatic backup features.

Performance Monitoring

Use tools like Timings to monitor your server's performance. The following command will generate a performance report:

/timings on

After testing, don’t forget to disable Timings:

/timings off

Common Troubleshooting

Startup Errors

If your server does not start, check the logs for errors. The most common errors include:

Incorrect Java version.
Port already in use.
Improperly configured server.properties file.

Latency Issues

To resolve latency issues, you can:

Reduce the view distance in server.properties.
Limit the number of players on the server.
Use a lag management plugin.

Conclusion

Setting up an optimized Purpur server requires precise steps and attention to detail. By following this guide, you will be able to launch and optimize your server for a smooth and enjoyable gaming experience. Feel free to explore more settings and plugins to customize your server according to your needs.