Removing mods safely

Caution

Mods that add items, blocks, creatures or buildings can leave broken data in your world when removed. Create a backup first so you can go back.

Short answer: Create a backup, stop the server, then go to [Your Server] > Mods > Installed and select Remove next to the mod. Start the server and check the world.

Before you begin

• You need: the server owner’s account, or a subuser with file permissions.
• Do first: create a backup (see How to create and restore a backup).
• Time needed: 5 minutes.

What this guide covers

• Removing a mod installed from the Mods page
• Removing a mod you installed by hand
• Going back if the world breaks

Steps

A mod installed from the Mods page

1. Create a backup.
2. Stop the server on the Console page.
3. Go to Mods and open the Installed tab.
4. Select Remove next to the mod.
5. Confirm. This deletes the downloaded files and removes the mod from the server’s configuration.
6. Start the server and check the console and your world.

Note

On the History tab, Delete only clears a failed install from the list. To uninstall a mod, use Remove on Installed.

A mod you installed by hand

1. Create a backup and stop the server.
2. In Files, delete the mod’s files from the mods folder your game uses (see your game’s guide).
3. If you added the mod to a config file or mod list, remove it there too.
4. Start the server.

If the world is broken afterwards

7. Restore the backup from step 1 with Restore safely… on the Backups page. The mod is still uninstalled, so either reinstall it, or ask the mod’s community how to remove it cleanly.

Expected result

The mod is gone from Installed, the server starts, and the console doesn’t mention it.

Common mistakes

• Removing a mod other mods depend on. Remove the mods that need it too, or the server may not start.
• Removing world-changing mods mid-game. Check the mod’s page for removal advice first.
• Not telling players. They may need to remove it on their side too.

Troubleshooting

What you see	What it means	What to do
Server won’t start after removal	Another mod needed it, or the world references it	Read the console; restore the backup if needed
Mod still loads	Files left from a manual install	Check the game’s mods folder in Files

When to contact support

Contact support if Remove fails, or the mod keeps loading after removal from the Mods page. Include the mod name and console output. See How to contact support with useful diagnostic information.

Related guides

• Installing mods from the Mods page
• How to create and restore a backup
• My server will not start

Last reviewed: 2026-10-05 · Applies to: Game Panel (HiCiTools 3.0.2)