How to Install and Manage Mods on Your Icarus Server

Icarus supports server-side mods that can change how your world plays, add new content, or tweak existing systems. The RiverHosting panel gives you a dedicated Mods page for your Icarus server so you can manage mods in one place without editing any files by hand.

This guide walks you through finding, installing, and removing mods on your Icarus server step by step.

Before you start

• You need an active Icarus server on RiverHosting. Log in to the panel at panel.riverhosting.com to get started.
• Make sure your server is stopped before installing or removing mods. Changing mods while the server is running can cause errors or data loss.
• Players who connect to your server may also need the same mod installed on their own Icarus client, depending on the mod. Check the mod's description to confirm.
• It is a good idea to create a backup of your server before making any mod changes. Go to the Backups tab and create a fresh backup before you begin.

1. How to install mods on your Icarus server

The Mods page in the RiverHosting panel is the easiest way to add mods to your Icarus server. Here is how to use it:

1. Log in to the RiverHosting panel and open your Icarus server.
2. In the left-hand menu, click Mods.
3. The Mods page will show you the mods currently installed on your server. To add a new mod, look for the option to browse or search for mods.
4. Find the mod you want to install by searching its name or browsing the available list.
5. Click the install button next to the mod you want to add.
6. Wait for the panel to confirm that the mod has been installed successfully.
7. Once all your mods are installed, start your server from the Console page using the Start button.

2. How to remove or disable a mod on your Icarus server

If a mod is causing problems or you simply want to run a cleaner server, removing it is straightforward from the same Mods page.

1. Log in to the RiverHosting panel and open your Icarus server.
2. Stop your server if it is currently running.
3. In the left-hand menu, click Mods.
4. Find the mod you want to remove in the list of installed mods.
5. Click the remove or uninstall button next to that mod.
6. Confirm the removal when prompted.
7. Start your server again once the mod has been removed.

3. How to upload a mod manually using the File Manager

If a mod is not available through the Mods page and you have the mod files yourself, you can upload them manually using the File Manager.

1. Stop your server first.
2. In the left-hand menu, click Files to open the File Manager.
3. Navigate to the folder where Icarus mods are stored. This is typically a folder named Mods inside your server directory. If the folder does not exist, you can create it by clicking the New Folder button.
4. Click Upload and select your mod file from your computer.
5. Wait for the upload to complete, then start your server.

Troubleshooting

• Server crashes on startup after adding a mod. Stop the server, go to the Mods page, and remove the mod you just added. Restart and see if the problem is resolved. The mod may be incompatible with your current server version or with another installed mod.
• Players cannot see the mod content in-game. Some Icarus mods need to be installed on each player's own game client as well. Check the mod's documentation to confirm whether it is client-side, server-side, or both.
• Mod does not appear after installation. Make sure the server was fully stopped before you installed the mod. Try stopping the server, then starting it again and checking the console for any error messages related to the mod.
• File Manager upload fails or the mod file is too large. Try a different browser, or check whether the file is a supported format. If the upload continues to fail, contact RiverHosting support for help.
• You are not sure which folder to use for the manual upload. Check the Console output when your server starts for any lines that reference the mods directory. That will confirm the correct path. If you are still unsure, support can help you identify the right location.

Need help?

If you run into any issues installing or managing mods on your Icarus server, the RiverHosting support team is ready to help. Visit the support page and open a ticket and the team will look into it with you.