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>
  • /rolemenu edit menu:<menu>
  • /rolemenu add menu:<menu> role:<role> [label] [emoji] [style]
  • /rolemenu editbutton menu:<menu> role:<role> [label] [emoji] [style]
  • /rolemenu remove menu:<menu> role:<role>
  • /rolemenu list
  • /rolemenu info menu:<menu>
  • /rolemenu toggle menu:<menu>
  • /rolemenu refresh menu:<menu>
  • /rolemenu delete menu:<menu>

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.