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

# Commands

> The custom Technified commands added to your admin system.

The plugin adds four commands, all prefixed with `t` for Technified. They use your admin system's normal prefix, so `:tbans` on a default Adonis setup and `;tbans` on a default Guardsman setup.

| Command   | Minimum rank    | Description                  |
| --------- | --------------- | ---------------------------- |
| `tbans`   | Moderator (100) | View active Technified bans  |
| `tmutes`  | Moderator (100) | View active Technified mutes |
| `tsync`   | Admin (300)     | Force a full resync          |
| `tstatus` | Admin (300)     | View plugin status and stats |

Each has a longer alias too: `technifiedbans`, `technifiedmutes`, `technifiedsync` and `technifiedstatus`.

## tbans

View active bans from the Technified API. The first 15 are listed, with a count of any beyond that. Each line shows the username and ID, a shortened reason, and the expiry or `Perm`.

```
=== Active Technified Bans (5) ===
Player1 (123456789) - Exploiting [03/15 14:30]
Player2 (987654321) - Spam [Perm]
```

## tmutes

View active mutes, in the same format as bans.

```
=== Active Technified Mutes (3) ===
Player1 (123456789) - Inappropriate language [03/15 14:30]
```

## tsync

Force a full resync from the API. It refetches all bans and mutes, loads them into your admin system's lists, rechecks every online player, and kicks or mutes as needed.

```
Sync complete!
Ban list: +15 | Mute list: +5
Online: 2 kicked, 1 muted
```

<Tip>
  Run `tsync` after making changes in the dashboard, if sync looks out of date, or after API issues.
</Tip>

## tstatus

View plugin version, uptime, which features are enabled, and counters since the server started.

```
Version: Beta 8.5
Uptime: 2h 15m
Server: a1b2c3d4...

--- Features ---
Permissions: ON
Ban Sync: ON
Shield Sync: OFF
Mute Sync: ON
Bidirectional: ON
Action Logging: ON
Sessions: ON

--- Statistics ---
Bans Checked: 150
Mutes Checked: 150
Bans -> API: 5
Mutes -> API: 2
Actions Logged: 47
Permissions: 30
API Errors: 0
Active Sessions: 3
```

<Note>
  `API Errors` counts every failed request since server start. A number climbing steadily usually means a bad API key or a network problem. Set `DEBUG = true` to see the actual errors.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Failed to fetch from API">
    Check your API key is correct and HTTP Requests are enabled. Set `DEBUG = true` and look at the console for the detailed error.
  </Accordion>

  <Accordion title="Command not found">
    Confirm the plugin loaded, check your rank is high enough, and make sure you are using your admin system's prefix.
  </Accordion>

  <Accordion title="Empty ban or mute list">
    There may be no active bans or mutes for this game. Bans scoped to a different Place ID are not shown. Run `tsync` to refresh and check the dashboard.
  </Accordion>
</AccordionGroup>
