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

# Permissions

> Understanding Flamey's flexible permission system for command control.

Flamey provides a robust permission system that allows you to control exactly who can use which commands and where.

<Note>
  Role hierarchy is always respected. Flamey cannot punish a user who has a role higher than or equal to the bot's highest role.
</Note>

## Bot Managers

**Bot Managers** are special users who bypass **all** permission checks and restrictions. They have full access to the bot's capabilities.

<Warning>
  Grant Bot Manager status only to people you fully trust. They can bypass all checks!
</Warning>

<CardGroup cols={1}>
  <Card title="Manage via Dashboard" icon="gauge" href="https://dashboard.flamey.lol">
    Go to **Dashboard > Settings > Bot Managers** to add or remove managers.
  </Card>
</CardGroup>

## Command Restrictions

You can restrict individual commands based on roles, channels, or Discord permissions.

<AccordionGroup>
  <Accordion title="Allowed Roles" icon="users">
    Specify which roles are allowed to use a command.

    * If no roles are set, the command is available to everyone (unless other restrictions apply).
    * If roles are set, **only** users with those roles can use the command.
  </Accordion>

  <Accordion title="Allowed Channels" icon="hashtag">
    Restrict command usage to specific channels.

    * Useful for keeping spammy commands (like games or leveling) out of serious channels.
    * Admin commands are often restricted to staff-only channels.
  </Accordion>

  <Accordion title="Required Permissions" icon="lock">
    Some commands require native Discord permissions.

    * Example: The `ban` command requires the `Ban Members` permission by default.
    * You can overwrite this in the dashboard to allow specific roles to use it without giving them the Discord permission.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Why can't I use a command?" icon="question">
    * Check if you have the required role.
    * Check if you are in an allowed channel.
    * Ensure you are not on a cleanup/blacklist (if applicable).
  </Accordion>

  <Accordion title="Hierarchy Error" icon="layer-group">
    If you see a "Hierarchy Error", it means the user you are trying to moderate has a role higher than or equal to the bot's role. Move the bot's role higher in the Server Settings.
  </Accordion>
</AccordionGroup>