# Permissions

{% hint style="info" %}
Watora public invitations don't generate an useless role when joining your server. 
{% endhint %}

{% hint style="info" %}
You can use`settings`to display current Watora's settings.
{% endhint %}

## Watora's Permissions Logic

Watora's permissions are mostly based on your channel/guild permissions.

#### Exemples :

* You cannot use the ban command if you cannot ban users.
* You cannot use the purge command if you cannot manage messages.

{% hint style="info" %}
To manage Watora's settings you need at least the `manage guild`permission.
{% endhint %}

## Music Permissions

Watora's music permissions are based on a DJ role system.

#### You are a DJ when you can verify one of the following line :

* You have a [DJ role](https://watora.gitbook.io/watora/settings#set-a-dj-role)
* You have at least the manage guild permission
* You are alone in the voice channel with Watora

#### DJ permissions :

* It allows to use every musical commands without necessarily having high permissions on the server.
* It allows to use musical commands without being in the voice channel.

## How to limit Watora's commands

{% hint style="danger" %}
Users with at least the`manage guild`permissions aren't affected by this limitations.
{% endhint %}

### How to disable Watora on one or several channels

* You can use `ignore` to ignore one channel.
* You can use `bind` to disable Watora on every channels excepted one.

| Usage                  | Help                                                                                           |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| **`ignore (channel)`** | <p>Disables Watora's commands on a channel. <br><em>Current channel if not specified.</em></p> |
| **`bind (channel)`**   | <p>Binds Watora's commands to a channel. <br><em>Current channel if not specified.</em></p>    |

### How to disable Watora to several users or roles

You have to use `blacklist` to blacklist users or roles

| Usage                               | Help                                               |
| ----------------------------------- | -------------------------------------------------- |
| **`blacklist add [user\|role]`**    | Adds a user to the guild blacklist.                |
| **`blacklist remove [user\|role]`** | Removes a user or a role from the guild blacklist. |
| **`blacklist clear`**               | Clears the guild blacklist.                        |
| **`blacklist list`**                | Displays the guild blacklist content.              |

### How to disable Watora's commands

{% hint style="info" %}
You can't disable a customcommand. Instead, delete it.
{% endhint %}

To disable a command you have to use `disabledcommand` (also called`dc`)

| Usage                                  | Help                                              |
| -------------------------------------- | ------------------------------------------------- |
| **`dc add [command\|module\|all]`**    | Disables a command and its aliases on the server. |
| **`dc delete [command\|module\|all]`** | Enables anew a disabled command.                  |
| **`dc list`**                          | Displays the disabled commands list.              |

### How to disable Watora commands per channel

You can disable a lot of thing per channel thanks to the ignore command.

| Usage                                         | Help                                                        |
| --------------------------------------------- | ----------------------------------------------------------- |
| **`ignore [channel] [command\|module\|all]`** | Disables a command, a module or every command in a channel. |

{% hint style="info" %}
List of known module : `Music, Fun, Useful, Moderation, Config, Image`
{% endhint %}