Authorization Claims
Overview
By default, ClemBot allows for anyone with administrator permissions in the guild/server full access to ClemBot's functionality. If you want to grant users without administrator permissions access to individual parts/features of ClemBot (a team of moderators, for example), you can do that through "Claims."
Server owners and users with administrator roles are automatically granted all claims, regardless of what roles they possess.
Claims are ClemBot's way of providing servers incredibly granular and precise control over who has access to different parts of ClemBot. Claims are added to roles within your server. Anyone who has a role that has associated claims is granted access to the functionality of the Bot that the claim correlates to. A role can have multiple claims associated with it, and a claim can be associated with multiple roles. You decide how to set up your server!
Available Claims
Name | Description |
---|---|
assignable_roles_add | Allows for marking a role as assignable. |
assignable_roles_delete | Allows for removing a role as assignable. |
bypass_disabled_commands | Allows for bypassing of disabled commands either server-wide or in a specific channel. |
claims_modify | Allows for modifying the assigned claims of a role. |
claims_view | Allows for viewing of claims that a user or role has. |
command_restrictions_edit | Allows for disabling commands server-wide or in specific channels. |
custom_tag_prefix_set | Allows for setting the custom tag prefix that ClemBot responds to. |
custom_prefix_set | Allows for setting the custom prefix that ClemBot responds to. |
delete_message | Allows for deletion of any message that ClemBot reacts to with a trashcan emoji. |
designated_channel_modify | Allows for adding and removing designations from channels in a server. |
designated_channel_view | Allows for viewing of available and assigned designated channels in a server. |
guild_settings_view | Allows for viewing of the guild's settings on the dashboard. |
guild_settings_view | Allows for modifying of the guild's settings on the dashboard. |
manage_emote_boards | Allows for the management of emote boards in a server. |
moderation_ban | Allows for usage of the ban command. |
moderation_infraction_view | Allows for usage of the infractions command to list a given user's infractions. |
moderation_infraction_view_self | Allows for usage of the infractions command to view only the user's own infractions. |
moderation_mute | Allows for usage of the mute command. |
moderation_warn | Allows for usage of the warn command. |
tag_add | Allows for adding a tag in a server. |
tag_delete | Allows for deleting other people's tags in a server. |
tag_transfer | Allows for transferring of a tag they do not own. |
welcome_message_modify | Allows for setting the server's welcome message. |
welcome_message_view | Allows for viewing the server's welcome message. |
Commands
Claims
View all the claims on a given user or role. If a role is given, the command will return the aggregate of all claims from all roles the user has.
Required Claims
claims_view
Format
!claims @Role
!claims @User
Example
!claims @Jayy
!claims @MyCoolRole
Add
Adds a claim to a given role. Everyone who has that role will be granted permission to that functionality.
Aliases
set
Required Claims
claims_modify
Format
!claims add <ClaimName> @Role
Example
!claims add tag_add @MyCoolRole
Remove
Removes a claim from a given role, everyone who has that role will no longer have permissions for that functionality.
Aliases
delete
Required Claims
claims_modify
Format
!claims add <ClaimName> @Role
Example
!claims add tag_add @MyCoolRole
List
Lists the currently available bot claims that can be assigned.
Aliases
get
Format
!claim list
Example
!claims get