Skip to content

Quick Start Guide

Use this page to get Armory Bot set up in about 10 minutes.

Before You Start

Make sure you have:

  • Armory Bot invited to your server
  • Administrator or Manage Server permission
  • The bot role above any roles the bot needs to manage
  • A channel ready for logs (for example, #mod-logs)

Step 1: Confirm Commands Are Working

Run a simple command:

/economy balance

If the command appears in Discord's slash command picker and returns a response, command sync is working.

Step 2: Configure Core Systems

Shortcut: the setup wizard

/setup start does most of this step for you — it asks for your server's vibe, lets you pick features, and applies a starter config. /setup server goes further and scaffolds channels, roles, and role menus. The sections below are for tuning things individually.

Economy baseline

Set daily/weekly Work rewards and your currency name/symbol on the Economy dashboard page (open with /dashboard).

Logging baseline

On the Logging dashboard page (open with /dashboard): set a message log channel and a moderation log channel, then enable the message-delete and member join/leave toggles.

Welcome baseline

Set the welcome channel, message, and auto-roles on the Welcome dashboard page (open with /dashboard), then preview in Discord:

/welcome test

Moderation baseline

No separate setup command is required for basic moderation. Start with core actions:

/mod warn member:@TestUser reason:"Rules reminder"
/mod timeout member:@TestUser duration:60 reason:"Cooldown"
/cases stats

Step 3: Grant Access by Command Category

Use /permissions grant to assign command access to moderation roles.

/permissions grant command_group:moderation role:@Moderator reason:"Moderation access"
/permissions grant command_group:roles role:@RoleTeam reason:"Role management access"

View current overrides:

/permissions list

Step 4: Run a Validation Pass

Use this short checklist before opening features to your full community:

  • /economy balance returns your current balance
  • /shop browse shows current shop items
  • the Logging dashboard page shows your log configuration
  • /welcome test sends a test welcome message
  • /mod warn member:@TestUser reason:"Test warning" creates a case
  • /cases list user:@TestUser shows recent moderation cases
  • /role info role:@Member returns role details

Common Commands

Member commands

Command Use
/economy balance Check your balance
/shop browse View shop items
/shop buy item_id:1 Buy an item by shop ID
/shop inventory View your inventory
/work shift Work a shift for guaranteed pay
/work daily Take on a Daily Mission (optional wager)

Moderator commands

Command Use
/mod warn member:@User reason:"Spam" Add a warning
/mod timeout member:@User duration:60 reason:"Cooldown" Timeout a member
/mod purge count:20 Remove recent messages
/cases view case_number:42 View a specific case

Administrator commands

Command Use
/permissions list Review command access overrides
/dashboard Configure logging, welcome, and other features
Dashboard → Permissions (/dashboard) Global bot settings (manager role, mod-only)

Troubleshooting

Commands do not appear

  1. Wait a few minutes for Discord to sync slash commands.
  2. Re-invite the bot if commands still do not show.
  3. Restart the Discord client.

Permission denied errors

  1. Confirm your role has the expected override with /permissions list.
  2. Confirm the bot role is high enough in role hierarchy.
  3. Check channel-level overrides for blocked permissions.

Roles are not being assigned

  1. Confirm bot has Manage Roles permission.
  2. Confirm bot role is above the target role.
  3. Run /role info role:@RoleName to verify role state.

Next Steps