Skip to content

Utility Commands

Armory Bot utility features are split across focused slash command groups.

Command Groups

  • /utility for server/user info, AFK, highlights, and role intelligence
  • /poll for interactive polls
  • /remind for personal reminders
  • /announce for announcements
  • /timestamp and /countdown for Discord time formatting helpers

Utility Group — /utility

Info Commands

  • /utility serverinfo
  • /utility userinfo [user]
  • /utility roleinfo <role> [options]
  • /utility avatar [user]
  • /utility membercount
  • /utility channelinfo [channel]
  • /utility emojis [search]
  • /utility banner [user]

AFK

  • /utility afk [message]

Sets your AFK status and notifies people who mention you.

Highlights

  • /utility highlight-add <keyword>
  • /utility highlight-remove <keyword>
  • /utility highlight-list
  • /utility highlight-block [user] [channel]

Highlights DM you when tracked keywords appear in visible channels.

Deep Role Utility — /utility roleinfo

/utility roleinfo now supports moderator-grade roster filtering and export.

Advanced Options

  • include_member_dump - Include roster preview in the embed response
  • include_bots - Include bot accounts in results
  • granted_on_after - Lower date bound for role holding window
  • granted_on_before - Upper date bound for role holding window
  • held_for_min - Minimum held duration (example: 30d)
  • held_for_max - Maximum held duration (example: 365d)
  • sort_preset - Named sorting mode (held_longest, granted_newest, etc.)
  • sort_by - display_name, granted_on, held_for, user_id
  • sort_order - asc or desc
  • custom_filter - User-defined filter query for advanced matching
  • export_csv - Attach CSV roledump of filtered results
  • limit - Max rows shown in embed preview

Explicit Sort Presets

Use sort_preset for one-click intent-driven sorting:

  • name_az
  • name_za
  • granted_oldest
  • granted_newest
  • held_longest
  • held_shortest
  • user_id_asc
  • user_id_desc

sort_preset overrides sort_by and sort_order when used.

Custom Filter Query Syntax

Use custom_filter to define your own filters. Clauses are ANDed together.

Clause format:

field operator value

Clause separators:

  • ; (recommended)
  • new line

Operators:

  • = equals
  • != not equals
  • > greater than
  • >= greater than or equal
  • < less than
  • <= less than or equal
  • ~ contains (string fields only)

Supported fields:

  • display_name (aliases: name) — string
  • username — string
  • user_id (aliases: id, userid) — integer
  • bot — boolean (true/false, yes/no, 1/0)
  • has_nickname — boolean
  • granted_on (aliases: joined, joined_on) — date/datetime (YYYY-MM-DD or YYYY-MM-DD HH:MM)
  • held_for (alias: held) — duration (30d, 12h, 90m)

Examples:

held_for>=30d;display_name~mod
bot=false;granted_on>=2026-01-01
has_nickname=true;user_id>=100000000000000000

Moderator Filters

Advanced roledump filters are moderator-only. Basic role info remains available to everyone.

GrantedOn and HeldFor Notes

Discord does not expose exact per-member role grant timestamps.

  • GrantedOn uses best-available proxy (member guild join timestamp)
  • HeldFor is computed from that proxy duration

Example Queries

/utility roleinfo role:@Moderators include_member_dump:true sort_by:held_for sort_order:desc
/utility roleinfo role:@Veteran held_for_min:30d granted_on_after:2026-01-01 include_member_dump:true
/utility roleinfo role:@RaidTeam include_member_dump:true export_csv:true sort_by:user_id sort_order:asc
/utility roleinfo role:@Moderators sort_preset:held_longest include_member_dump:true
/utility roleinfo role:@RaidTeam custom_filter:"held_for>=14d;display_name~raid" include_member_dump:true export_csv:true

Polls — /poll

  • /poll create <question> <options> [duration] [allow_multiple] [anonymous]
  • /poll end <poll_id>
  • /poll results <poll_id>

options should be provided as a | separated string (example: Red | Blue | Green).

Reminders — /remind

  • /remind me <duration> <message>
  • /remind list
  • /remind cancel <id>

Duration examples: 10s, 5m, 2h, 1d.

Announcements — /announce

  • /announce create <channel> <message> [title]
  • /announce embed <channel>
  • /announce schedule <channel> <message> <minutes_from_now> [title]
  • /announce list
  • /announce cancel <announcement_id>

Time Helpers — standalone slash commands

  • /timestamp [day] [month] [year] [hour] [minute] [second] [format]
  • /countdown [days] [hours] [minutes] [label]

Quick Examples

/utility userinfo user:@Member
/utility roleinfo role:@Moderators include_member_dump:true held_for_min:14d sort_by:held_for sort_order:desc
/poll create question:"Next event?" options:"Raid | PvP | Chill" duration:120
/remind me duration:2h message:"Check bounty board"
/announce schedule channel:#announcements message:"Patch drops tonight" minutes_from_now:180

Notes

Some older community references may show deprecated commands. Use grouped commands above as source of truth.