1. Minecraft
FSH Knowledgebase
  • Game Guides
    • Minecraft
      • How to change MOTD for a Minecraft server
      • How to download your Minecraft server world
      • How to install a custom Minecraft modpack
      • How to Install Datapacks to your server
      • How to upload a custom Minecraft world
      • What is the difference between Spigot Paper and PurPur
      • Reducing Lag
        • Reduce Lag on ForgeMC server
        • Reduce Lag on FabricMC server
      • Common Issues
        • How to Fix Authentication servers are down Please try again later
        • Failed to check session lock
        • Exception Server Tick Loop
        • Server Connection Timed Out
        • Fixing the Connection timed out getsockopt Error in Minecraft
      • Managing your Server
        • How to Optimize Your Server
        • How to set a custom seed on your Minecraft Server
        • Using Chunker to Convert Minecraft Worlds Across Editions
        • Which Java version to use for Minecraft server
        • Add Add-ons to your Bedrock Server
        • How To EnableDisableManage Your WhitelistAllowlist
      • Plugins
        • Simple Voice Chat
        • Dynmap
        • Bluemap
        • Chunky
    • Palworld
      • How to add mods to your Palworld Server
      • How To Update A Palworld Server
      • Resetting a Player's Save on a Palworld Server
      • Finding Your Palworld Server in the Community Servers List
      • Changing the Egg Hatching Time on a Palworld Server
      • How to Edit Palworld Server Settings
      • How to Become Admin on Your Palworld Server
  • Panel Knowledgebase
    • Game Server Panel
      • How to reset your Game Panel Password
      • Uploading Files Via SFTP
      • Adding Dev Sub Users
    • Client Area
      • Affiliate Program
      • Discord Linking
      • How to Cancel A Service
      • How to upgrade or downgrade your service
  • Service Knowledgebase
    • Virtual Private Servers (VPS)
      • Change Window Server Password Locked Out
      • Creating Your VPS
      • Developers and your VPS
      • How to connect to your VPS from any Linux or Debian Distro
      • Logging into your VPS Windows
      • Opening Ports on a VPS
      • Resetting your VPS Password
      • SSH Client Setup
  1. Minecraft

How to install a custom Minecraft modpack

The first section of this guide will briefly cover the installation of a server software, this essentially allows the mods to run on the server. Examples of popular mod software are Forge, Fabric, Neoforge & Quilt. For the purpose of this demonstration, we will use Forge, however, the process is very identical for the other options.
1.
Access your server from the gamepanel and head over to the Versions tab.
2.
Select your desired server software with the appropriate version, and press install. In order to avoid incompatibility issues, ensure that the server and client use the same version of Forge.

b64u-MDE5ZTFmMTktMjdiNy03OTg2LWI0OWEtODc5ZDdlZjhhNDA2.png#

💡
It is important to understand that some Minecraft mods are only made for client-side gameplay and can NOT be used on the server. These generally include mods that change the HUD, graphics, or player controls.

Once the server installation is complete, do not start your server just yet as we have not added any of the custom files.
There are two ways of installing mods to your server. The first method is through the Mods tab on the panel, which allows seamless installation from a variety of sources. This method can be used if there are only a small number of mods that you are intending to install. The second and the recommended method is manually uploading the mods to the server using SFTP, which we will cover next.

3.
On your computer, prepare a folder for the server which consists of all the custom files and directories that you are intending to upload to your server. The files you will need for your custom modpack will vary based on your specific requirements. This may include but not be limited to mods, configs, kubejs, resource-packs, worlds etc.
4.
Once your server folder is ready, select all of the content and create a zip file as observed below. Your number and selection of files will vary. In the below demonstration, the "server-files" is a ZIP file that consists of all the necessary files and directories.

b64u-MDE5ZTFmMTktMjU5Yy03YWUxLTg4OTItODgxOTcwZWRmM2Vj.png

5.
Upload the ZIP file to your server using SFTP. This may take a while depending on the size of the file and your internet speed.
6.
Unarchive the file from the panel using the built-in feature.
b64u-MDE5ZTFmMTktMjVkMi03YTU4LWFkYmMtNWUwMGI4MjEyNTVm.png

7.
The server files should now be present in the root (main) directory as observed in the image below. Make any other adjustments if necessary.
b64u-MDE5ZTFmMTktMjY5Mi03YTc1LThjZjYtYmU4ODMwNDhjMGVk.png

8.
Start your server!

#

Common Problems#


1.
Client mods
Using mods that are only intended for client-side on a server will prevent the server from booting up (crash) or throw errors in the console such as invalid dist DEDICATED_SERVER . You can fix this by deleting the client mod(s) and restart your server.

2.
Incompatible mod or wrong version
Kindly ensure that the version and type of mod matches the server. For example: Using a Fabric only mod for a Forge server will not work. Also, if the server is using Forge 1.20.1, the mod should also be of the same version, using an older or newer version may not work.

3.
Missing dependencies
Certain mods will fail to load properly as they require other mods to function, these as referred to as dependency mods. To fix this issue, check the mod information page and upload any required dependencies to your server then restart.
General advice If this is your first time setting up a custom modpack, we suggest starting with a smaller group of mods and working your way up after some testing. While this may slow you down initially, you will improve stability in the long term by being selective.
Modified at 2026-06-18 07:19:28
Previous
How to download your Minecraft server world
Next
How to Install Datapacks to your server
Built with