Braven
Getting started

Permissions

What Braven asks for, why, and what breaks without each one.

Braven does not need Administrator. If an invite link is offering it, it is the wrong link — use the button on bravenbot.com.

What it asks for

PermissionUsed for
Manage ChannelsCreating ticket threads and renaming them.
Manage RolesThe On Duty role, reward roles, self-assignable roles, LOA roles.
Manage ThreadsWorking tickets: archiving, adding and removing people.
Create Private ThreadsTickets are private threads, so only the opener and staff see them.
Send Messages in ThreadsPosting inside tickets.
Embed LinksNearly every message Braven sends is an embed.
Attach FilesPosting transcripts when a ticket closes.
Read Message HistoryBuilding transcripts, and measuring first reply time.
Add ReactionsSuggestion voting and the FiveM sits tracker.
Kick / Ban MembersOnly used by /mod kick and /mod ban.
Moderate MembersTimeouts, and automod.

The role hierarchy catch

Discord will not let any bot manage a role that sits above its own in your server settings, no matter what permissions it has.

If reward roles, the On Duty role or LOA roles are not being applied, this is almost always why. Drag Braven's role above the roles it needs to hand out.

Braven tells you what is missing

When a permission is missing, Braven names the exact permission and the exact channel rather than failing silently. If something is not working and you have seen no message, permissions are probably not the cause.

Privileged intents

Two features need privileged intents enabled on the bot, which is already done on the hosted version:

  • Server Members — the join gate, raid protection, sticky roles and welcomes.
  • Presence — vanity role rewards and the status blacklist.

Without Presence, those two features are simply inert; nothing else is affected.

On this page