Adding Armory Bot to Your Server¶
This guide walks you through inviting Armory Bot and getting it ready for your Discord server.
Prerequisites¶
- A Discord server where you have Administrator or Manage Server permission
- The bot's invite link (available from the Discord Support Server)
Inviting the Bot¶
- Open the invite link shared in the support server
- Select the server you want to add Armory Bot to
- Review and approve the requested permissions
- Complete the CAPTCHA and confirm
Recommended Permissions
Armory Bot requests these permissions for full functionality:
- Manage Roles — Role rewards and auto-roles
- Manage Channels — Voice channels and logging
- Kick/Ban Members — Moderation commands
- Moderate Members — Timeout functionality
- Move Members — AFK monitoring, management, and voice channel creation.
- Send Messages — Core functionality
- Embed Links — Rich embeds
- Attach Files — Rank cards and exports
- Read Message History — Context for logging
- Use Slash Commands — All commands
Verification¶
After inviting the bot, verify it's working:
- Test a basic command — Run
/shop balance - Check logging config access — Run
/logging view - Check permissions — Ensure the bot role is positioned above any roles it needs to manage
Role Hierarchy
The bot's role must be higher in your server's role list than any roles it assigns (level rewards, auto-roles, shop items). Drag the Armory Bot role up in Server Settings → Roles.
Next Steps¶
- Quick Start Guide — Set up economy, leveling, logging, and moderation
- Configuration — Detailed per-feature configuration
- Features Overview — See everything Armory Bot can do
- Permission Setup — Configure who can use what
Troubleshooting¶
Commands Not Showing¶
Symptom: Slash commands don't appear when you type /
Solutions:
- Wait 5–10 minutes for Discord to sync commands
- Kick and re-invite the bot
- Restart your Discord client (Ctrl+R)
Bot Not Responding¶
Symptom: Bot is online but ignores commands
Solutions:
- Check the bot has permission to read and send in the channel
- Verify the bot role isn't restricted by channel permission overrides
- Try a different channel
Permissions Issues¶
Symptom: Bot can't assign roles or moderate members
Solutions:
- Ensure bot role is above managed roles in the role hierarchy
- Check channel-specific permission overrides aren't blocking the bot
- Verify the bot has the required Discord permissions