Armory
The Armory module manages the armory rotation system: 8 slots with buff descriptions, weekly assignments to alliances, and automatic announcements. Assignments are made by administrators or the current president and reset each week.
See Commands for full command reference.
Enabling the Module
Enable the module
Dashboard → Your server → toggle Armory
Configure announcement channel
Click Edit and set the channel where assignment announcements will be posted
Configure slots
Edit slot names and buff descriptions for all 8 slots
Save
Save changes
Configuration
| Option | Type | Default | Description |
|---|---|---|---|
announcement_channel_id | string / null | null | Channel for weekly assignment announcements |
history_mode | string | "command" | "command" (on-demand via command) or "embed" (persistent updated embed) |
history_message_id | string / null | null | Message ID of the history embed (embed mode only) |
history_channel_id | string / null | null | Channel for the history embed (embed mode only) |
Armory Slots
Each guild has 8 slots, created automatically on first use. Each slot has:
- Slot number (1–8)
- Name — configurable in dashboard
- Buff description — configurable in dashboard
Weekly Rotation
Assignments are tied to the current week (Monday 00:00 UTC — Sunday 23:59 UTC):
- Each week gets a fresh set of assignments
- Old assignments remain in the database for history
- The bot calculates the current week start automatically
Assignment Announcements
When an assignment is made, the bot sends an embed to announcement_channel_id showing the full weekly layout: all 8 slots with their assigned alliances and buffs. The embed includes a footer with the last update timestamp.
No auto-clear
Assignments persist until overwritten with a new assignment or cleared manually via /armory clear. There is no automatic weekly reset — the president or admin must manage the rotation.
Dashboard — Configuration
The Armory edit panel contains:
- Announcement Channel — channel dropdown
- Slots Configuration — inline editor for all 8 slots (name + buff description)
- Current Assignments — read-only view of this week's assignments
The panel uses the UnsavedBar — changes are not saved automatically. Click Save to save or Cancel to revert.
Commands
See Commands — Armory for full details.
| Command | Description | Permission |
|---|---|---|
/armory assign | Assign an alliance to a slot for the current week | Admin or president |
/armory clear | Clear a slot's assignment for the current week | Admin or president |
Autocomplete
The /armory assign command provides autocomplete for active alliances displaying [TAG] Name format, with fuzzy name/tag search.
Logging
Armory actions are logged by Logs under the armory category:
- Armory Assigned — slot number, alliance, who assigned
- Armory Cleared — slot number
Tips
Best Practices
- Configure the announcement channel to a place visible to all alliance leaders
- Give slots descriptive names matching in-game buffs (e.g., "Infantry Armory", "Cavalry Armory")
- Rotate assignments weekly to ensure fair access across alliances
- The president should assign slots at the start of each week
Permissions Required
The bot needs Send Messages and Embed Links permissions on the announcement channel. If permissions are revoked, announcements will fail silently with a warning log.