Please make sure it is Fabric that you require before reading this guide - if you require Forgethe installation process is different! There are guides for Forge here:
- Installing Custom Builds of Forge and/or Custom Mods (Forge 1.16.5 and Older)
- Installing Custom Builds of Forge and/or Custom Mods (Forge 1.17.1 and Newer)
Installing Fabric through the 1-click Install list on your control panel
If the Fabric version/build you need is an available option on our list then you do not need to install it manually.
Fabric is checked for updates every Wednesday and are updated for new FabricLoader updates as well as Fabric-API updates (the Fabric options on the jar list come with the Fabric-API mod - it can be removed after install if you do not need it). If any of the available builds will work for the mods you are installing you can install them easily following these steps:
- Log into your mc.beastnode.com account and go to your servers main page (Where the Start/Stop/Restart buttons are found).
- Change the drop down list of server options (Will be set to 'Default' if you have never changed this) to the Fabric version you wish to install.
- Once the page refreshes to confirm the change, restart the server.
This will install the selected Fabric version.
As stated above our Fabric options come with the Fabric-API mod included as standard - if you do not require it for your setup you can simply delete it from the mods folder. If you are not sure it is recommended to leave it in the mods folder.
Note that if you delete the jar folder or it's contents (or update the Fabric build/change to another Fabric option on the list), the server will reinstall the Fabric-API mod on the next restart so you would need to delete it again if it is not needed.
Step by step on installing a custom Fabric version/build
First, download the installer you from: https://fabricmc.net/use/ (you should only need the Universal/JAR option):
Once downloaded, double click the .jar file to start the setup process:
You will be given some options in the window that opens - select "Server" at the top, then select the Minecraft version and Loader version you need (if you are unsure on loader version leave it as the latest) and the directory to download the files to by clicking the "..." button (by default it will be the directory the installer you ran is in). Then click Install to begin the installation process.
Once it has downloaded the main Fabric file a second window will open like this:
Click the "Download server jar" button and when it has finished downloading click "Done" and close the installer.
You should then have the server files in the directory you set it to install to, like so:
The installer .jar and the ".fabric-installer" folder can be deleted at this stage.
The two .jars you are left with can now be uploaded to your server via FileZilla - however both need to go in different locations. The server.jar needs to go in the base directory of your server files - the fabric-server-launch.jar file needs to go into the servers jar folder (if no jar folder is present create one). So you should have something like this:
(Note that you will likely have more folders listed in the top panel, the example server used's files had been wiped prior to the Fabric installation - it is just to show that the jars are placed in two different locations)
You will now need to rename the Fabric jar in the jar folder accordingly - if you wish to use Java 8 you need to rename the Forge jar to custom_server.jar, for Java 11 rename the Forge jar to custom_server_j11.jar and for Java 16 rename the Forge jar to custom_server_j16.jar (most 1.16.5 and older versions do not work with Java 11 or 16, so it is strongly recommended to use Java 8 unless specifically required, and Java 16 for 1.17 and newer).
Now go to your servers control panel and change the drop down list to the correct Custom Server JAR option at the top of the list:
And once the page has refreshed to confirm this selection - start the server up!
Installing your mods once Fabric is set up
Note that not every mod installs via this method, so always make sure to read the full directions for the particular mod you are installing.
Once you have uploaded all mods you wish to use, restart the server to load them - If the mods are compatible with the installed Fabric version and build, and have any dependancies installed also on the correct versions, your server should start up fine.
Tip: Install mods one at a time (including any dependancies for that mod) so that you can always determine if a single mod is the cause of your server not working - if you upload a lot of mods at once it is harder to isolate which mod may be causing issues.
Once the mods you wish to use are all installed and working fine, it is recommended to shut it down and then follow these steps to load a new world generated by those mods specifically:
- Enter a new world name in the World box (can be anything, just not the name of a world that has already been created unless you are uploading your own world folder for it to load).
- Hit Save at the bottom of the page.
Then if you are using a world generation mod that requires a specific level-type follow these steps too:
- Go to Files > Config Files on your control panel and open the Server Settings.
- Change the level-type option to what your mod requires.
- Save changes to the file.
Then start the server back up to load a new world up, generated specifically by the mods you are using (so all natural ores/mods/buildings etc... are spawned correctly).
**Note: As with any mods, the client side is required to be modded as well (with the same version mods) for you to be able to join a modded server. There are various guides and videos on how to do this - a quick Google will provide the information needed.
**Note that some mods are clientside-only, or singleplayer-only and cannot be used on the server!
Clientside only mods will work fine if they are installed on your launcher but not on the server, and will commonly crash the server if installed on it if they are not set to disable when loaded serverside by the devs (examples being HUD mods, most minimap mods or Optifine).