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:

/shop balance

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

Step 2: Configure Core Systems

Economy baseline

/economy config daily_amount:100 weekly_amount:500 currency_name:"Coins" currency_symbol:"🪙"

Logging baseline

/logging setup message_channel:#mod-logs mod_channel:#mod-logs
/logging toggle event_type:message_delete enabled:true
/logging toggle event_type:member_join enabled:true
/logging toggle event_type:member_leave enabled:true

Welcome baseline

/welcome channel channel:#welcome
/welcome message message:"Welcome to the server, {user.mention}!"
/welcome autorole role:@Member
/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 and logging roles.

/permissions grant command_group:moderation role:@Moderator reason:"Moderation access"
/permissions grant command_group:logging role:@Moderator reason:"Logging setup 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:

  • /shop balance returns your current balance
  • /shop browse shows current shop items
  • /logging view 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
  • /server members role:@Member returns a member list

Common Commands

Member commands

Command Use
/shop 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
/mission daily Run a daily mission

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
/mod-debug config Check moderation runtime config
/logging setup ... Set log channels
/server config View or update server bot settings

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 /server members role:@RoleName to verify role state.

Next Steps