Skip to content
flankerDocs
Dashboard

Roles commands

Type / and pick the slash command, or mention Flanker before the command. (round) parameters are required; [square] parameters are optional. Expand a syntax row for its slash command, permissions and example.

reactionrole

Members react to a message to get a role. Run `reactionrole` on its own for a setup panel with menus and buttons.

Permission
Manage Roles
Aliases
rrreactionroles
reactionrole create (channel) (reaction) (role) [--exclusive] [--message (message or script)]

Creates a new reaction role panel. Add --message at the end to post your own text, embed or card instead of "Choose your roles".

Slash: /reactionrole create

Mention
@Flanker reactionrole create (channel) (reaction) (role) [--exclusive] [--message (message or script)]
reactionrole message (message link) (message)

Edits the panel message, keeping its reactions and role controls.

Slash: /reactionrole message

Mention
@Flanker reactionrole message (message link) (message)
reactionrole add (message link) (reaction) (role) [--exclusive]

Adds a reaction role. --exclusive allows only one role from that message at a time.

Slash: /reactionrole add

Mention
@Flanker reactionrole add (message link) (reaction) (role) [--exclusive]
reactionrole remove (message link) (reaction)

Removes one.

Slash: /reactionrole remove

Mention
@Flanker reactionrole remove (message link) (reaction)
reactionrole removeall (message link)

Removes every reaction role on a message.

Slash: /reactionrole removeall

Mention
@Flanker reactionrole removeall (message link)
reactionrole list [page]

Pages through reaction roles and their panels.

Slash: /reactionrole list

Mention
@Flanker reactionrole list [page]

buttonrole

Members press a button on a message to get a role. Run `buttonrole` on its own for a setup panel with menus and buttons.

Permission
Manage Roles
Aliases
buttonrolesbtnrole
buttonrole create (channel) (role) [style] [emoji] [label] [--exclusive] [--inside] [--message (message or script)]

Creates a new button role panel. Styles: blurple, grey, green, red. Add --message at the end to post your own text, embed or card; the buttons go under it.

Slash: /buttonrole create

Mention
@Flanker buttonrole create (channel) (role) [style] [emoji] [label] [--exclusive] [--inside] [--message (message or script)]
buttonrole message (message link) (message)

Edits the panel message, keeping its role controls.

Slash: /buttonrole message

Mention
@Flanker buttonrole message (message link) (message)
buttonrole layout (message link) [inside/under] [1-5] [even/natural]

Any mix of: buttons inside the card or under it, how many buttons sit on a row, and even widths (shorter labels padded to match the longest) or natural ones.

Slash: /buttonrole layout

Mention
@Flanker buttonrole layout (message link) [inside/under] [1-5] [even/natural]
Example/buttonrole layout https://discord.com/channels/1/2/3 inside 4 even
buttonrole add (message link) (role) (style) [emoji] [label] [--exclusive]

Adds a role button. Styles: blurple, grey, green, red.

Slash: /buttonrole add

Mention
@Flanker buttonrole add (message link) (role) (style) [emoji] [label] [--exclusive]
buttonrole remove (message link) (index)

Removes a button.

Slash: /buttonrole remove

Mention
@Flanker buttonrole remove (message link) (index)
buttonrole removeall (message link)

Removes every button.

Slash: /buttonrole removeall

Mention
@Flanker buttonrole removeall (message link)
buttonrole list [page]

Pages through role buttons and their panels.

Slash: /buttonrole list

Mention
@Flanker buttonrole list [page]

rolemenu

Dropdown menus members pick roles from. Run `rolemenu` on its own for a setup panel with menus and buttons.

Permission
Manage Roles
Aliases
selectrolerolemenus
rolemenu create (message link) (role) [multiple/exclusive] [placeholder]

Adds a menu to one of flanker's messages.

Slash: /roles rolemenu create

Mention
@Flanker rolemenu create (message link) (role) [multiple/exclusive] [placeholder]
rolemenu panel (channel) (role) [multiple/exclusive] [placeholder] [--message script]

Creates a new role menu panel.

Slash: /roles rolemenu panel

Mention
@Flanker rolemenu panel (channel) (role) [multiple/exclusive] [placeholder] [--message script]
rolemenu message (message link) (message)

Edits the panel message, keeping its role controls.

Slash: /roles rolemenu message

Mention
@Flanker rolemenu message (message link) (message)
rolemenu add (message link) (menu) (role) [label]

Adds a role to a menu.

Slash: /roles rolemenu add

Mention
@Flanker rolemenu add (message link) (menu) (role) [label]
rolemenu remove (message link) (menu) (option)

Removes a role from a menu.

Slash: /roles rolemenu remove

Mention
@Flanker rolemenu remove (message link) (menu) (option)
rolemenu edit (message link) (menu) (mode/limit/placeholder) (value)

Changes a menu.

Typed slash actions (3)
Mention
@Flanker rolemenu edit (message link) (menu) (mode/limit/placeholder) (value)
rolemenu delete (message link) (menu)

Deletes a menu.

Slash: /roles rolemenu delete

Mention
@Flanker rolemenu delete (message link) (menu)
rolemenu view (message link) [page]

Pages through the menus and options on a message.

Slash: /roles rolemenu view

Mention
@Flanker rolemenu view (message link) [page]
rolemenu list [page]

Pages through role menu panels and their selection limits.

Slash: /roles rolemenu list

Mention
@Flanker rolemenu list [page]

boosterrole

Boosters make their own custom role with a name, colour and icon.

Permission
Server Booster
Aliases
brboosterroles
boosterrole create (name) [color] [second color]

Makes your booster role. A second colour makes a gradient role.

Slash: /roles boosterrole create

Mention
@Flanker boosterrole create (name) [color] [second color]
Example/roles boosterrole create shahzain #ff7a00
boosterrole share max (0-25)

Sets how many members each booster role may be shared with.

Permission: Manage Roles

Slash: /roles boosterrole share-max

Mention
@Flanker boosterrole share max (0-25)
boosterrole share list

Lists the members sharing your booster role.

Slash: /roles boosterrole share-list

Mention
@Flanker boosterrole share list
boosterrole share remove (member)

Stops sharing your booster role with one member.

Slash: /roles boosterrole share-remove

Mention
@Flanker boosterrole share remove (member)
boosterrole rename (new name)

Renames it.

Slash: /roles boosterrole rename

Mention
@Flanker boosterrole rename (new name)
boosterrole color (color) [second color] [name]

Changes its colour.

Slash: /roles boosterrole color

Mention
@Flanker boosterrole color (color) [second color] [name]
boosterrole icon (image URL, emoji, or attachment)

Sets its icon (needs boost level 2).

Slash: /roles boosterrole icon

Mention
@Flanker boosterrole icon (image URL, emoji, or attachment)
boosterrole random

Picks a random colour.

Slash: /roles boosterrole random

Mention
@Flanker boosterrole random
boosterrole dominant

Uses the main colour of your avatar.

Slash: /roles boosterrole dominant

Mention
@Flanker boosterrole dominant
boosterrole share (member)

Shares your role with someone.

Slash: /roles boosterrole share

Mention
@Flanker boosterrole share (member)
boosterrole remove

Deletes your role.

Slash: /roles boosterrole remove

Mention
@Flanker boosterrole remove
boosterrole list [page]

Pages through custom booster roles, owners and shared access.

Permission: Anyone

Slash: /roles boosterrole list

Mention
@Flanker boosterrole list [page]
boosterrole base [role]

Booster roles are placed above this role. Omit it to restore automatic placement. With no custom base, Flanker uses Server Booster when its hierarchy allows. Roles stay below Flanker Protection.

Permission: Manage Roles

Slash: /roles boosterrole base

Mention
@Flanker boosterrole base [role]
boosterrole organize

Organizes existing booster roles above the custom base or Server Booster, within Flanker and protection hierarchy limits.

Permission: Manage Roles

Slash: /roles boosterrole organize

Mention
@Flanker boosterrole organize
boosterrole limit (1-10)

How many booster roles one member can have.

Permission: Manage Roles

Slash: /roles boosterrole limit

Mention
@Flanker boosterrole limit (1-10)
boosterrole award set (role)

A role every booster gets.

Permission: Manage Roles

Slash: /roles boosterrole award-set

Mention
@Flanker boosterrole award set (role)
boosterrole link (member) (role)

Links an existing role to a booster.

Permission: Manage Roles

Slash: /roles boosterrole link

Mention
@Flanker boosterrole link (member) (role)

badge

Rewards members who wear this server's guild tag. Run `badge` on its own for a setup panel with menus and buttons.

Permission
Manage Roles
Aliases
guildtagtagrole
badge role add (role)

Gives the role to members with the tag.

Slash: /roles badge role-add

Mention
@Flanker badge role add (role)
badge role remove (role)

Stops giving it.

Slash: /roles badge role-remove

Mention
@Flanker badge role remove (role)
badge channel (channel)

Where new tag wearers are announced.

Slash: /roles badge channel

Mention
@Flanker badge channel (channel)
badge message (message/view/clear)

The announcement message.

Slash: /roles badge message

Mention
@Flanker badge message (message/view/clear)
badge sync

Rechecks everyone now.

Slash: /roles badge sync

Mention
@Flanker badge sync

vanity

Rewards visible custom statuses containing a link or keyword, with optional required roles. Does not read bios. Discord privacy settings can hide statuses. Configure everything at flanker.wtf/dashboard, under Community, Vanity rewards. No boost tier or vanity URL is needed. Only roles awarded by this module are removed when eligibility is lost. Run `vanity` on its own for a setup panel with menus and buttons.

Permission
Manage Server
Aliases
vanityroles
vanity (on/off)

Enable rewards or turn them off and remove recorded awards.

Slash: /roles vanity run

Mention
@Flanker vanity (on/off)
vanity set substring (text)

The text to look for in statuses, 1 to 128 characters.

Slash: /roles vanity set-substring

Mention
@Flanker vanity set substring (text)
Example/roles vanity set-substring /flanker
vanity role (add/remove) (role)

The reward role.

Permission: Manage Roles

Slash: /roles vanity role

Mention
@Flanker vanity role (add/remove) (role)
vanity require (add/remove) (role)

Require a role before someone earns rewards. Required roles cannot also be rewards.

Slash: /roles vanity require

Mention
@Flanker vanity require (add/remove) (role)
Example/roles vanity require add @Members
vanity require clear

Remove required-role conditions.

Slash: /roles vanity require-clear

Mention
@Flanker vanity require clear
vanity requiremode (all/any)

Match all required roles or at least one. Default: all.

Slash: /roles vanity requiremode

Mention
@Flanker vanity requiremode (all/any)
vanity strict (on/off)

Exact status match instead of contains. Both ignore case.

Slash: /roles vanity strict

Mention
@Flanker vanity strict (on/off)
vanity offline (on/off)

Remove rewards when offline or invisible. Off by default; known required-role loss is still enforced.

Slash: /roles vanity offline

Mention
@Flanker vanity offline (on/off)
vanity award [channel/clear]

Where rewards are announced. Clear keeps awards silent.

Slash: /roles vanity award

Mention
@Flanker vanity award [channel/clear]
vanity message [message/clear]

A message, embed or card for new awards. Variables: member, channel and {vanity.keyword}. Role repair does not send it again.

Slash: /roles vanity message

Mention
@Flanker vanity message [message/clear]
vanity configure (settings JSON)

Atomically save dashboard settings. Reward roles always use automatic-role safety checks.

Permission: Manage Server and Manage Roles when changing rewards

Slash: /roles vanity configure

Mention
@Flanker vanity configure (settings JSON)