# Bot Access/Permissions

{% hint style="warning" %}
Only server administrators (users with`ADMINISTRATOR`permission) can modify StormBeatz settings!
{% endhint %}

### Command Channels

{% tabs %}
{% tab title="Explanation" %}
This setting can be used to set specific channels where StormBeatz commands can be used. Commands will not work in other channels. If no command channel is set, commands will work in all channels the bot can access. You can set a maximum of 10 command channels. Server Administrators can bypass this setting.

{% hint style="success" %}
`settings cmdchannel [#channel]`
{% endhint %}

{% hint style="danger" %}
Make sure the bot has the correct text [permissions](https://docs.stormbeatz.xyz/guides/introduction#permissions) in that channel!
{% endhint %}

{% hint style="info" %}
To remove a command channel, just use the same command again!
{% endhint %}
{% endtab %}

{% tab title="Visualization" %}
![](/files/-Ma0S7XlOHTD2Zw2R5LT)

![](/files/-Ma0SB9ldGprTvs4KveX)

{% endtab %}
{% endtabs %}

### **Music Roles**

{% tabs %}
{% tab title="Explanation" %}
This setting can be used to set specific roles that can use the [Music Commands](broken://pages/-MNLSy02eC23gpKmqkA_). Only members with music roles, DJ roles, or admin permission will be able to use music commands. If no music role is set, all members will be able to use music commands (in the command channels only, if any are set).

{% hint style="success" %}
`settings musicrole [role]`
{% endhint %}

{% hint style="info" %}
To remove a music role, just use the same command again!
{% endhint %}
{% endtab %}

{% tab title="Visualization" %}
![](/files/-Ma0STQTWvCKZan8bcb4)

![](/files/-Ma0SdxfSUrozxesTqL1)

{% endtab %}
{% endtabs %}

### DJ Roles

{% tabs %}
{% tab title="Explanation" %}
This setting can be used to set specific roles that can use the [DJ Commands](broken://pages/-MNLWXgX_SQko9NuQFhC) and are considered server DJs. Members with the `ADMINISTRATOR` permission are considered DJs by default. If no DJ role is set, only admins will be able to use DJ commands.

{% hint style="success" %}
`settings djrole [role]`
{% endhint %}

{% hint style="info" %}
To remove a DJ role, just use the same command again!
{% endhint %}
{% endtab %}

{% tab title=" Visualization" %}
![](/files/-Ma0SnfdKVVnNmpQzByn)

![](/files/-Ma0Sr1k6NWYJZWirUAa)
{% endtab %}
{% endtabs %}

### Role Blacklist

{% tabs %}
{% tab title="Explanation" %}
This setting can be used to set roles that will not be able to use any StormBeatz commands in your server. Blacklisted roles are above music roles, so if a member has both roles, they will not be able to use commands. DJ roles and admins bypass blacklisted roles, so even if they have a blacklisted role, they will still be able to use commands.

{% hint style="success" %}
`settings blacklistrole [role]`
{% endhint %}

{% hint style="info" %}
To remove a role from the blacklist, just use the same command again!
{% endhint %}

{% endtab %}

{% tab title="Visualization" %}
![](/files/-Ma0SzAmu6V2W8sHLUIM)

![](/files/-Ma0T6ZQBcZlzZ6NbMXi)
{% endtab %}
{% endtabs %}

### Voice Channels

{% tabs %}
{% tab title="Explanation" %}
This setting can be used to set voice channel(s) you want StormBeatz to play from. The bot will not join any other voice channel(s). DJ roles and admins bypass this setting, so even if you set this up, they will still be able to make the bot join other voice channel(s).

{% hint style="success" %}
`;settings voicechannel [#channel/channel ID]`
{% endhint %}

{% hint style="info" %}
To remove a voice channel, just use the same command again!
{% endhint %}
{% endtab %}

{% tab title="Visualization " %}
![](/files/0gI4FtjrWPXN7V3EWqnh)

![](/files/asOkawTE2P06o5veG7DQ)
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stormbeatz.org/guides/cmd-permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.