1 Permissions EN
darksoon edited this page 2026-05-13 21:28:31 +02:00

Permissions — Who Can Do What

Overview

Action Supporter Moderator Admin
/mod warn
/mod note
/mod mute (timeout)
/mod unmute
/mod kick
/mod ban
/mod softban
/mod history
/mod unwarn <id>
/mod clear
/mod reload
Submit /report Everyone Everyone Everyone
Ticket Claim/Close (buttons)
/ticket transfer
/tickets force-close
/tickets reopen
/tickets history
/welcome preview*
/welcome setup-verify
/tickets setup-panel
/botstatus
Post news (DM) *
/voice rename / lock / limit / kick / trust / untrust / transfer Channel owner Channel owner Channel owner
/voice claim / info Anyone in the channel Anyone in the channel Anyone in the channel
/voice reload
/help show / module Everyone Everyone Everyone
/help redeploy / reload
/cmd <name> Everyone (or per allowed-role) Everyone Everyone
/cc list / info Everyone Everyone Everyone
/cc add / edit / delete
/radio start / stop / info / list Everyone (in voice channel) Everyone Everyone
/radio reload / passive enable / disable / status

*News posts are restricted to user IDs listed in configs/modules/news.yml > adminIds.

This table reflects the default permissions. Via Server Settings → Integrations → GrumpyCore you can fine-tune each command per role/channel.


Role Hierarchy

You can only moderate users who have a lower rank than you. The bot checks this automatically.


Setting Up Support Roles

In configs/config.yml:

roles:
  support:
    - "SUPPORTER_ROLE_ID"
    - "MOD_ROLE_ID"
    - "ADMIN_ROLE_ID"

This list acts as a global fallback. Per ticket category you can additionally set staffRoleIds in tickets.yml — that specific list then takes precedence for that category.

Discord permission: Grant "Manage Threads" / "View Channel" in the ticket area → all ticket channels become automatically visible.


Bot Permissions (Discord-side)

The bot itself requires the following Discord permissions per channel depending on the module:

Permission Bit Required? Used for
View Channel, Send Messages, Embed Links Everything
Manage Channels, Move Members (Voice) Voice module (channel creation & moving users)
Manage Roles (Welcome) Assigning verified / unverified roles
Manage Messages (Mod) Auto-Mod, /mod clear
Connect + Speak (Music) Joining voice channels and sending audio
Set Voice Channel Status 1 << 48 optional (Music) Now-playing display below the voice channel name — without this permission the radio still works, only the "🎵 Station · Artist - Title" line is missing

Configuring Commands

Server Settings → Integrations → GrumpyCore [BOT]

Here you can set which roles may use each command and in which channels it is available.

Because the bot uses per-guild slash commands, changes are effective immediately — no 1-hour cache.