APC Rankings
The APC (Alliance Power Contribution) module allows players to report their in-game strength values. The bot maintains a live leaderboard embed that updates automatically.
Enabling the Module
Enable the module
Dashboard → Your server → toggle APC
Configure the channel
Click Edit and configure the leaderboard channel
Save
Save — the bot will create/update the leaderboard embed
Configuration
| Option | Type | Default | Description |
|---|---|---|---|
channel_id | string / null | null | Channel for the leaderboard embed |
message_id | string / null | null | Leaderboard message ID (auto-managed) |
private_leaderboard | boolean | false | When enabled, no public leaderboard is posted; access is gated |
leaderboard_roles | string[] | [] | Role IDs allowed to view the full leaderboard (empty = moderation roles) |
How It Works
Report strength
Player uses /apc 1.5G 500M to report their strength, optionally adding main_faction and second_faction
Parse values
Bot parses the shorthand notation and stores raw numeric values
Update leaderboard
Bot updates the leaderboard embed in the configured channel
Rank
Ranking sorted by main APC value (descending)
Strength Notation
| Suffix | Meaning | Example |
|---|---|---|
| K | Thousands | 200K = 200,000 |
| M | Millions | 1.5M = 1,500,000 |
| G | Billions | 2G = 2,000,000,000 |
Decimals are supported: 1.5G, 800.5M, 50.2K
Leaderboard Embed
The bot maintains a single persistent embed that shows:
- Position (with medal emojis for top 3)
- Player name
- Main APC value
- Second APC value
- Last update time
A custom faction emoji appears before each player's name (Fighters, Shooters, Riders). Entries without a faction (old entries or when none was set) show no emoji — just the name. Factions are optional per-user and set via /apc main_faction:... second_faction:...; omitting them preserves the previously set faction.
The embed is edited in-place after every /apc or /apc-remove command — no spam, just one clean message.
Commands
| Command | Description | Who can use |
|---|---|---|
/apc [main] [second] [main_faction] [second_faction] | Submit/update your strength (factions optional) | Everyone |
/apc view | View only your own submitted strength | Everyone (private) |
/apc leaderboard | Show the full leaderboard | Everyone (restricted roles in private mode) |
/apc-remove [position] | Remove a record by ranking position | Moderation Roles / Admin |
/apc-set [user] [main] [second] [main_faction] [second_faction] | Manually set or update a member's APC (used by leadership to correct or pre-fill entries) | Moderation Roles / Admin |
Privacy (Private Leaderboard)
Enable Private Leaderboard in the dashboard to restrict the scoreboard:
- No public leaderboard embed is posted in the channel.
- Members use
/apc viewto check only their own APC (ephemeral, private). - Only the configured Leaderboard Roles (or moderation roles by default) can run
/apc leaderboardto see the full ranking.
This is optional — when disabled, the public leaderboard embed works exactly as before.
Dashboard
The APC edit panel contains:
- Leaderboard Channel — dropdown with text channels
- The embed is created/moved automatically when the channel changes
Logging
Actions logged by Logs under the apc category:
- APC Update — user, main value, second value
- APC Remove — who removed, target user, position
- APC Manual Set — moderator, target user, main value, second value
Tips
Channel Lockdown
Use /lockdown on the APC channel so users can only post slash commands there. This keeps the channel clean — only the leaderboard embed and /apc commands.
For Moderators
Use /apc-remove to clean up entries from users who left the server or became inactive. The position number corresponds to the current leaderboard order. Use /apc-set @user main second to manually enter or correct a member's APC when they can't or haven't submitted it themselves.
DWS Context
APC is a Dark War Survival mechanic. Each player has two APC values — main (primary army) and second (secondary army). The ranking helps alliances and the president evaluate overall server strength.