How to Uninstall Mods from Your Minecraft Server
Learn how to safely remove mods from your Forge or Fabric server.
Removing mods requires care — deleting a mod that added blocks or items to your world will permanently remove those blocks.
Removing a Mod
Stop your server
Access the XGamingServer panel and stop your server.
Create a backup
Go to Backups and create a backup in case the removal causes issues.
Delete the mod JAR
Go to Files, navigate to /mods/, and delete the mod's .jar file.
Delete the mod's config (optional)
Navigate to /config/ and delete the mod's configuration folder or file.
Start your server
Start the server and check Console for errors.
What Happens to Modded Content?
| Content Type | What Happens |
|---|---|
| Modded blocks (placed in world) | Replaced with air (permanently gone) |
| Modded items (in inventories) | Removed from inventories |
| Modded dimensions | Becomes inaccessible |
| Modded enchantments | Stripped from items |
| Config files | Remain unless manually deleted |
⚠️ Warning: Removing a mod that adds blocks or items to the world permanently deletes that content. Always backup first.
📝 Note: If other mods depend on the one you're removing, the server may crash. Check for dependency errors in
Console.
💡 Tip: If players get "Mismatched mod channel list" errors after you remove a mod, they need to remove the same mod from their client.
See also: Installing Mods | Fix Mismatched Mod Channel
If you need help, join our Discord.
How is this guide?

Understanding the Types of Lag on Your Minecraft Server (TPS, Network, Client)
Learn the difference between server TPS lag, network ping lag, and client FPS lag on your Minecraft Java server — and how to diagnose each.
How to Uninstall Plugins from Your Minecraft Server
Learn how to safely remove plugins and their configuration files.