/> />

How to Install a Custom JAR (Custom Server Type)

Managing your Server

·

Oct 26, 2024

·

14 Mins Read

A server type allows you to select the JAR file that your server will run on startup, for example, PaperSpigot, Bukkit, and Forge are all different types of JARs/server types.

Although we offer built-in support for many different server types using our server type selector, it is possible to install any server type or mod pack on your Shockbyte server. To do this, you will need to install it as a custom JAR by following the steps provided in this article.

Important

Forge versions 1.17.1 and newer can only be installed using our server type selector, a custom jar will not work.

# Installing a Custom JAR

To install a custom JAR file, you must select the appropriate server type, upload your custom JAR file, and rename it to match the appropriate Java version as needed.

  1. Access your control panel and Stop your server.

  1. Navigate to the Choose a Server Type window at the top of the control panel.

If you want to create a new instance for your server type, you can find a guide for this here.

  1. Click on Custom Jar and then click Next Step.

  1. Select a version for the Custom Jar depending on which Minecraft version you wish to use and click on Next Step.
Minecraft VersionRecommended Java VersionCustom JAR File Name
1.8 to 1.11Java 8custom-java8.jar
1.12 to 1.16.4Java 11custom-java11.jar
1.16.5Java 16custom-java16.jar
1.17.1+Java 18custom-java18.jar

  1. Once you have chosen the Custom Jar you wish to use, click on Save Changes.

  1. Navigate to your server Files.

  1. Upload your desired server JAR to the base directory of your server files.

  1. Rename the server type to custom.jar or custom-javaX.jar(X being the required Java version). Make sure that it is in lowercase, otherwise, it will not load properly.
Important

If you have selected the **Custom JAR** server type with a specific Java Version, you must rename the JAR file as shown in step 4. For example, a server type for 1.16.5 will need to be renamed to `custom-java16.jar`.

  1. If you're installing a server type that requires extra files (usually additional libraries) such as Forge, SpongeForge or any mod pack, you will also need to upload these. These are generally generated by running the installer for a server type on your own computer, and then uploading the files it downloads onto your computer.

That's all! Once you restart your server, it will begin loading your custom server JAR.

minecraft pfp
Jay Miller

Game Experience Engineer @ Shockbyte