> ## 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 Configure TShock Groups & Permissions in Terraria

> Master the administrative hierarchy of your server. Learn how to create custom ranks, assign permission nodes, and manage TShock group inheritance.

## Authority Management: The TShock Hierarchy

TShock uses a sophisticated grouping architecture that enables you to delegate administrative power and reward community loyalty with high precision. By defining specialized permission nodes, you can architect a granular hierarchy where "Guests" are restricted to exploration, "Citizens" can build and collaborate, and "Staff" possess the tactical tools required for moderation. This guide ensures your server's authority structure is secure, scalable, and correctly synchronized with your community goals.

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

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

***

## Technical Core Group Hierarchy

By default, the TShock framework initializes with a balanced set of roles. Understanding these baseline groups is essential before creating custom variants.

<Tabs>
  <Tab title="Guest (Unregistered)">
    The entry point for all new participants. Authorized for basic world navigation but restricted from structural modification if world protection is active.
  </Tab>

  <Tab title="Default (Registered)">
    Survivors who have successfully executed the `/register` command. This represents the standard participant rank with building and container access.
  </Tab>

  <Tab title="Admin (Moderator)">
    Authorized for tactical community management, including the ability to kick, ban, and mute disruptive players.
  </Tab>

  <Tab title="SuperAdmin (Owner)">
    Absolute world authority. Possesses the `*` (Global) permission node, granting control over every technical command and server variable.
  </Tab>
</Tabs>

***

## Essential Administrative Commands

Ranks are managed through real-time console commands or the in-game chat interface (provided you possess SuperAdmin status).

| Administrative Action | Technical Syntax                | Strategic Purpose                                                         |
| :-------------------- | :------------------------------ | :------------------------------------------------------------------------ |
| **Create Group**      | `/group add [name] [parent]`    | Defines a new rank that inherits all powers from the `parent` group.      |
| **Authorize Power**   | `/group addperm [group] [node]` | Grants a specific capability (e.g., `tshock.teleport`) to an entire rank. |
| **Revoke Power**      | `/group delperm [group] [node]` | Removes a specific node from the group's authorized registry.             |
| **Assign Player**     | `/user group [player] [rank]`   | Migrates a specific participant into a new administrative or social tier. |

***

## Strategic Permission Architecture

<AccordionGroup>
  <Accordion title="The 'Star' Permission Security">
    The **`*`** (Asterisk) permission is a powerful technical wildcard. It bypasses every security check within the TShock engine. We strongly recommend that this node remains restricted exclusively to the **SuperAdmin** group. Granting "Star" access to junior staff members creates a significant security vulnerability, as it allows for the deletion of world data and manipulation of server-side credentials.
  </Accordion>

  <Accordion title="Implementing Inheritance">
    using the **Parent** parameter when adding a group (e.g., `/group add vip default`) ensures that your `vip` group automatically receives every future permission granted to the `default` group. This prevents redundant configuration and ensures your hierarchy remains consistent.
  </Accordion>
</AccordionGroup>

***

<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:** TShock permissions active.
</div>