# Moderation

> Security provides moderation commands with a built-in permission system. Moderators can operate with zero Discord permissions while still being protected by Anti-Nuke limits.

## Why Use Security's Moderation?

| Feature                        | Benefit                                             |
| ------------------------------ | --------------------------------------------------- |
| **Zero Permission Moderation** | Moderators don't need dangerous Discord permissions |
| **Limit Protection**           | Anti-Nuke limits apply to all moderation commands   |
| **Audit Trail**                | All actions are logged for accountability           |
| **Custom Permissions**         | Grant specific command access per user              |

## Available Commands

| Command      | Description                                 |
| ------------ | ------------------------------------------- |
| `/ban`       | Permanently ban a member                    |
| `/kick`      | Remove a member from the server             |
| `/softban`   | Ban and immediately unban (clears messages) |
| `/unban`     | Remove a ban                                |
| `/mute`      | Prevent a member from sending messages      |
| `/unmute`    | Remove a mute                               |
| `/lock`      | Lock a specific channel                     |
| `/lockall`   | Lock all channels                           |
| `/unlock`    | Unlock a specific channel                   |
| `/unlockall` | Unlock all channels                         |
| `/clear`     | Delete messages in bulk                     |

## Who Can Use Commands?

Commands can be used by:

1. **Users with Administrator permission** and a higher role than the target
2. **Users with the relevant Discord permission** (e.g., Ban Members) and a higher role
3. **Users with Security's custom permission** for that command

## Security's Permission System

The safest way to grant moderation access. Users with custom permissions:

* Don't need Discord permissions
* Can't bypass Anti-Nuke limits
* Can only use specifically granted commands

### Add Permission

```
/permission add
```

1. Type `/permission add`
2. Select the user
3. Select the permission to grant
4. Send the command

### Remove Permission

```
/permission remove
```

1. Type `/permission remove`
2. Select the user
3. Select the permission to remove
4. Send the command

### View User Permissions

```
/permission view_user
```

1. Type `/permission view_user`
2. Select the user
3. Send the command

### View Users with Permission

```
/permission view_permission
```

1. Type `/permission view_permission`
2. Select the permission
3. Send the command

### Reset User Permissions

```
/permission reset
```

1. Type `/permission reset` (or `/permission reset_id` for user ID)
2. Select the user or enter the ID
3. Send the command

## Best Practices

* **Use custom permissions** instead of Discord permissions for moderators
* **Grant only necessary permissions** - don't give ban access if they only need mute
* **Regularly audit permissions** to remove former staff
* **Set appropriate limits** in Anti-Nuke based on expected moderation volume

## Related

* [Anti-Nuke](https://docs.securitybot.gg/anti-nuke/anti-nuke) - Limits that apply to moderation commands
* [Whitelist](https://docs.securitybot.gg/whitelist/whitelist) - Exempt trusted moderators from limits
* [Logs](https://docs.securitybot.gg/other-modules/logs) - Track moderation actions