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.
  • There is no standalone /role, /roleconfig, /reactionrole, or /roleadmin command group in the current cog surface.

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 refresh 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
  • /autorole-disable
  • /rolepersist-enable roles:<comma-separated role mentions or IDs>
  • /rolepersist-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.
  • /welcome autorole updates the same underlying role auto-assignment model.
  • /mod addrole and /mod removerole are moderation commands, not role-menu commands.
  • /utility roleinfo provides advanced role roster filtering and CSV export.

Permissions

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