> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Install & Manage TShock Plugins in Terraria

> Extend your server's technical capabilities. Learn how to deploy TShock plugins for WorldEdit, economy systems, and advanced server administration.

## Expanding the Engine: TShock Plugins

TShock plugins are modular technical extensions, typically distributed as `.dll` files, that introduce sophisticated new functionalities to your Terraria server. Whether your community requires a decentralized economy for trading, **WorldEdit** for massive structural terraforming, or **Essentials** for streamlined player shortcuts, plugins serve as the backbone of a successful community ecosystem. By using the TShock API, these modifications can alter world behavior without requiring players to install any localized mods.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Intermediate
  </Card>

  <Card title="Time" icon="clock">
    6 Minutes
  </Card>
</CardGroup>

***

## Technical Deployment Workflow

Follow these steps to correctly integrate new modifications into your server's software stack.

<Steps>
  <Step title="Acquire Latest Binaries">
    Obtain the desired plugin from the official [TShock Hangar](https://hangar.papermc.io/) or the community Discord. **Important:** Ensure the plugin is explicitly designed for TShock; modifications for "tModLoader" are architecturally incompatible.
  </Step>

  <Step title="Initialize File Transfer">
    Log in to the [Game Panel](https://games.freakhosting.com) and navigate to the **Files** tab, or connect via [SFTP](/portals/game-panel/how-to-connect-via-sftp).
  </Step>

  <Step title="Deploy to ServerPlugins">
    Upload the `.dll` file directly into the `/ServerPlugins/` directory located in your server's root folder.
  </Step>

  <Step title="Initialize the Logic">
    **Restart** your server. Monitor the **Console** tab during the boot sequence; TShock will broadcast a registry of every successfully loaded assembly.
  </Step>
</Steps>

***

## Configuration & Customization

Once a plugin has successfully initialized for the first time, it programmatically generates its own configuration registry.

<AccordionGroup>
  <Accordion title="Locating JSON Configs">
    Navigate to the `/tshock/` or `/ServerPlugins/Config/` directory. Most plugins use a `.json` format for their settings, allowing you to calibrate parameters such as command cooldowns, block placement limits, or starter item IDs.
  </Accordion>

  <Accordion title="Managing Access (Permissions)">
    Simply installing a plugin does not always grant players access to its commands. You must explicitly authorize the new capabilities using the [TShock Permission System](/games/terraria/configuring-tshock-groups-and-permissions) (e.g., `/group addperm default plugin.command.node`).
  </Accordion>
</AccordionGroup>

***

<Warning>
  ### Technical Version Sensitivity

  TShock plugins are highly dependent on the specific **TShock API version**. If you perform a major server update (e.g., transitioning from Terraria 1.4.4 to 1.4.5), ensure your plugins are also updated to their corresponding compatible builds. A mismatched plugin assembly will frequently trigger a "Reflection Type Load Exception" or a "Method Not Found" error, causing the server process to crash on startup.
</Warning>

***

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **Terraria:** Plugins active.
</div>