Skip to content

Role Management

Armory Bot's role tooling is centered on persistent role menus plus auto-role and role-persistence workflows.

Scope

  • Self-assignment is handled through interactive role menus.
  • Join-role automation and rejoin restoration are handled by dedicated role commands.
  • Direct role assignment, creation/editing/deletion, inspection, and bulk operations are handled by the /role command group (below). There is no separate /roleconfig, /reactionrole, or /roleadmin command group.

Direct Role Management (/role)

  • /role add <member> <role> [reason] — assign a role to a member
  • /role remove <member> <role> [reason] — remove a role from a member
  • /role create <name> [color] [hoist] [mentionable] — create a new role
  • /role edit <role> [name] [color] [hoist] [mentionable] — edit a role's properties
  • /role delete <role> — delete a role
  • /role info <role> — role metadata for everyone; adding any other option (roster dump, sort, filter, export, include_bots, limit, etc.) requires moderator permissions
  • /role massadd <role> <of> [include_bots] [reason] — give a role to every member of another role
  • /role massremove <role> [of] [include_bots] [reason] — remove a role from members; with no of, strips the role from every current holder

add/remove/massadd/massremove require the roles command category; create/edit/delete require admin. Mass operations run behind a Confirm/Cancel step and a per-guild lock so only one bulk run executes at a time. Full parameter tables and the mass-op confirm flow are documented in Admin Commands.

Role Menus (/rolemenu)

Available Commands

  • /rolemenu create channel:<channel> — opens a guided form (modal) for the menu's title/description/footer/max-roles, then walks you through mode and adding role buttons (role, colour, server emoji or pasted emoji, label).
  • /rolemenu edit menu:<menu> — opens an interactive panel to change the menu's text, mode, and enabled state, and to add, remove, or edit its role buttons.
  • /rolemenu list
  • /rolemenu info menu:<menu>
  • /rolemenu delete menu:<menu>

Creating a menu and managing its buttons are both handled inside create and edit. The earlier add, editbutton, remove, setup, and toggle commands have been folded into those two; enabling/disabling a menu is now the Enabled control in /rolemenu edit.

Runtime Behavior

  • Menus are persisted and reloaded after restarts.
  • Menus support up to 25 role buttons.
  • Menu modes include normal, unique, and verify.
  • Menu-level requirements and exclusions are enforced from saved menu config.

Auto-Roles and Role Persistence

Available Commands

  • /autorole add role:<role>
  • /autorole remove role:<role>
  • /autorole view — shows current auto-role and role-persist settings together
  • /autorole disable
  • /autorole persist enable
  • /autorole persist disable

Notes

  • Auto-role supports up to 4 configured roles per guild.
  • Role persistence restores configured roles when members rejoin.
  • Join-time auto-role assignment is executed by the roles auto-role listener.
  • The Welcome dashboard page's auto-roles update the same underlying role auto-assignment model.

Chain roles together so granting one automatically grants another:

  • /rolelink add — link a role to a trigger role
  • /rolelink remove — remove a link
  • /rolelink view — view configured links
  • /role add and /role remove are direct role-assignment commands, not role-menu commands.
  • /role info provides advanced role roster filtering and CSV export; any parameter beyond bare role requires moderator permissions.

Permissions

Role menu and role automation configuration require role-management permission via Discord and/or configured command overrides.