To remove a mod, take it off the list on the Mods page and Apply. The server stops loading it from the next start. Its files stay on the server, not loaded, until you delete them. That keeps the space in use until you free it.
This is for a Terraria server that runs tModLoader. A world can hold items and blocks that came from the mod, so make a backup first. See panel backups.
Take a mod off the list
- Open the Mods page, tab On this server.
- On the mod’s row, choose the red bin button. Its tooltip reads Take (name) off the list.
- The page says “(name) is off the list. Apply to take it off the server.” Nothing has changed on the server yet.
- In the bar at the bottom you see “1 to remove”. Choose Apply, or Apply and restart on a running server.
- In the box Apply the mod changes?, Takes off the list names the mod. Confirm.
A running server stops, applies the change and starts again. Everyone online is disconnected, so warn them first with Message everyone on the Players page. An offline server changes the list now and loads it at its next start.
You can change your mind before you apply. Choose Discard changes in the bar.
Other mods may go with it
A mod can need the one you removed. The server does not load any mod whose needed mod is missing. In the box, Left off when you apply names each one and says why. Those mods stay on the list, waiting. Add the needed mod back, or take them off too. See a mod needs another mod.
The files stay
After Apply, the mod is not loaded, but its files are still on the server. The page says so: “Mods taken off stay downloaded, not loaded, until their files are deleted.”
They show in a card named On the server, not loaded: “These folders are not on the list, so the game does not load them. They only take disk space.” The card gives the total size and has two buttons on each folder:
- Put on the list: use the mod again. It loads at the next apply.
- Delete files: free the space. A box, Delete (name)‘s files?, says “This frees the space. Adding the mod again later downloads it again.”
Deleting files needs a role that allows deleting files.
If it does not work
- There is no bin button. Your role may not allow changing the startup. Ask the owner of the organization.
- Apply is greyed out. Applying needs permission to change the startup and to restart the server.
- You changed your mind. Before you apply, choose Discard changes. After you apply, choose Put on the list in On the server, not loaded, then apply again.