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

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

You can assign up to 4 auto-roles. Each new member receives all configured roles on join.

View Current Auto-Roles

/autorole view

Remove an Auto-Role

/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 channel:#get-roles

This opens a guided form for the menu's title, description, footer, and max roles, then walks you through picking a mode (normal, unique, or verify) and adding role buttons.

Step 2: Customize the Buttons

Each role button can have:

Setting Description
Label Button text shown to members
Emoji A server emoji or any pasted emoji
Colour Button colour
Role The Discord role to assign/remove

You can also build and edit menus on the Roles dashboard page, which includes an emoji picker that can import emoji from your other servers.

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 menu:<menu>
/rolemenu delete menu:<menu>

Role Persistence

Armory Bot can track which roles each member has and restore them if a member leaves and rejoins:

/autorole persist enable

Turn it off anytime with /autorole persist disable; /autorole view shows both auto-role and persistence state.

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.