Changing the Java Server Version Manually
This guide is for when you want to use a specific version that isn't available in the panel, or you want to use a custom build.
It's important to distinguish whether you want to Upgrade (move to a newer version) or Downgrade (move to an older version), because they're handled differently.
- UPGRADE (e.g. 1.20 -> 1.21): Safe. You DO NOT NEED to delete the
worldfolder or plugins (unless those plugins don't support the new version). - DOWNGRADE (e.g. 1.21 -> 1.20): Dangerous. You MUST DELETE the
world,world_nether, andworld_the_endfolders because a newer-version map will become corrupt if opened in an older version.
Step 1: Back Up Server Data
Whatever the goal (Upgrade/Downgrade), backing up is mandatory.
- Turn off the server (Stop).
- Use SFTP or the File Manager.
- Download/Archive the important folders (
world,plugins,server.properties).
Step 2: Preparing the Server Files
Do these steps according to your needs:
OPTION A: If You're UPGRADING (Moving to a Newer Version)
You only need to delete the server's core file. Player data and the map are safe.
- Open the Files menu.
- Find the file named
server.jar. - Delete that file.
- (Optional) Delete the
cache,versions, orlibrariesfolders if present, to make sure the system files are truly fresh.
OPTION B: If You're DOWNGRADING (Moving to an Older Version)
You need to do a clean reset, especially for the map.
- Open the Files menu.
- Check all files and folders (Select All).
- Click Delete.
- Note: If you want to keep your plugin configs, you can leave the
pluginsfolder, but there's still a risk of plugin errors.
- Note: If you want to keep your plugin configs, you can leave the
Step 3: Download Server.jar (PaperMC)
Now find the new server "engine" you want. Example: We'll use Paper 1.21.1.
- Visit the official PaperMC site.
- Select version 1.21.1 (or another version according to your needs).
- Download the latest build (for example:
paper-1.21.1-133.jar). - Save it on your computer.
Step 4: Upload and Rename
- Go back to Files in the Raznar panel.
- Upload the
.jarfile you just downloaded. - Right-click the file -> Select Rename.
- Change the name to:
server.jar.
The file name MUST be changed to server.jar (all lowercase) so the panel can detect and launch it.
Step 5: Start the Server
- Go to the Console menu.
- Click Start.
- Wait for the libraries download process to finish.
- If this is an upgrade, the server will automatically convert the old world to the new version.
Congratulations! Your server is now running on the new version.