Skip to content

Setting Up Roles

This guide walks you through configuring Armory Bot's role management system — auto-roles for new members, self-assign role menus, and role persistence.

Prerequisites

  • Administrator permission on your server
  • Armory Bot added and online in your server

Auto-Roles (Assign on Join)

Auto-roles are automatically given to new members when they join your server.

Configure Auto-Roles

/roleconfig autorole add role:@Member
/roleconfig autorole add role:@Newcomer

You can assign multiple auto-roles. Each new member receives all configured roles on join.

View Current Auto-Roles

/roleconfig autorole list

Remove an Auto-Role

/roleconfig autorole remove role:@Newcomer

Role Hierarchy

Armory Bot can only assign roles below its own highest role in the server's role hierarchy. Drag the bot's role above any roles you want it to manage.

Self-Assign Role Menus

Role menus let members pick their own roles from buttons or dropdowns.

Step 1: Create a Role Menu

/rolemenu create

This opens an interactive setup panel where you can:

  • Set the embed title, description, and color
  • Add a thumbnail or image
  • Add roles with custom button labels and emoji
  • Choose button style (primary, secondary, success, danger)

Step 2: Customize the Menu

The setup panel lets you configure each button:

Setting Description
Label Button text shown to members
Emoji Custom or Unicode emoji on the button
Style Button color (blue, gray, green, red)
Role The Discord role to assign/remove

Step 3: Deploy

Once configured, the role menu is posted as a persistent message. It survives bot restarts — members can use it anytime.

Edit or Delete

/rolemenu edit message_id:123456789
/rolemenu delete message_id:123456789

Role Persistence

Armory Bot tracks which roles each member has. If a member leaves and rejoins, their roles are automatically restored.

This feature is enabled by default when auto-roles are configured.

Stale Role Cleanup

If a role is deleted from your server, Armory Bot automatically removes it from its tracking — no manual cleanup needed.

Best Practices

  1. Keep auto-roles minimal — Assign only essential roles (e.g., @Member) on join. Let members self-assign interest or notification roles.
  2. Use descriptive labels — Button labels like "Announcements" or "Gaming" are clearer than role names.
  3. Test the hierarchy — After setup, have a non-admin member try the role menu to verify it works.
  4. Place menus in visible channels — Put role menus in a #roles or #get-roles channel that every member can see.