A plugin you installed does nothing until the server restarts: TShock loads plugins when it starts. If Install itself fails, the panel says why, usually that the plugin list or download could not be reached; try again in a few minutes. If a plugin stops loading after a TShock update, it needs a version built for the new TShock.
Install fails
| Message | What to do |
|---|---|
TShock plugins can only be installed on a TShock server. Change the server type to TShock to use them. | Your server is not on TShock: How to switch your Terraria server to TShock or tModLoader. |
The TShock plugin list could not be reached. Try again in a few minutes. | The plugin collection is not answering. Try later. |
The TShock plugin bundle could not be downloaded. Try again in a few minutes. | The same, for the download. Try later. |
| A message that the plugin could not be written to the server | Try again in a minute. If it keeps failing, open a ticket. |
No Install button at all? Your role needs the Create and upload file permission.
Installed, but it does nothing
- Restart the server. The panel's message after Install says TShock loads it at the next restart.
- Read the Console as TShock starts and look for the plugin's name and any error near it.
- Type
helpin the Console to see if its commands are there. - A command that answers that you lack permission needs a group permission: How to manage TShock groups and permissions.
After a TShock update
When TShock updates at a start, the Console says Plugins built for older TShock versions may need an update too. Install the plugin again from the Plugins tab to get the version in the collection, or get an update from its author. To hold TShock where it is meanwhile, pin TShock Version: How to update your Terraria server and hold a version.
A library was removed
Plugins that need LazyAPI, linq2db or another library stop loading if it was uninstalled. Install the plugin again: its libraries come with it.
The server will not start after a plugin
Remove the newest plugin in Files, in ServerPlugins, and start again: How to upload or remove a TShock plugin. Or restore the backup from before: How to back up and restore your Terraria world.
