APC Rankings
Commands for the APC (Alliance Power Contribution) ranking system. Players report their strength values, and the bot maintains a leaderboard embed.
Commands
/apc
Submit or update your APC strength values. The bot parses shorthand notation (e.g., 1.5G, 500M, 200K) and updates the leaderboard.
| Parameter | Type | Required | Description |
|---|---|---|---|
| main | string | Yes | Main APC strength (e.g., 1.5G, 800M, 50K) |
| second | string | Yes | Second APC strength (e.g., 500M, 200K) |
Permissions: Everyone
Examples:
/apc main:1.5G second:500M/apc main:800M second:200K
Success:
Parses both values (supports K, M, G suffixes with decimals)
Upserts the record in the database (one entry per user per guild)
Ephemeral confirmation with parsed values
Updates the leaderboard embed automatically
/apc view
View only your own submitted APC values. Always available and fully private (ephemeral).
Permissions: Everyone
Example: /apc view
/apc leaderboard
Show the full leaderboard embed. When Private Leaderboard is enabled, only the configured Leaderboard Roles (or moderation roles) can view it; everyone else gets a permission error.
Permissions: Everyone (restricted to authorized roles in private mode)
Example: /apc leaderboard
Private Leaderboard
Configure the Privacy panel in the APC dashboard to enable Private Leaderboard: no public leaderboard is posted, members use /apc view for their own strength, and only authorized roles can run /apc leaderboard.
Errors:
- Invalid format (not a recognized strength notation)
- Database error
/apc-remove
Remove an APC record by its position in the ranking. Used by moderators to clean up inactive entries.
| Parameter | Type | Required | Description |
|---|---|---|---|
| position | integer | Yes | Position number in the ranking (1, 2, 3...) |
Permissions: Moderation Roles or Administrator
Example: /apc-remove position:3
Success:
Finds the user at the given position (sorted by main APC descending)
Deletes their record
Ephemeral confirmation with removed user and their value
Updates the leaderboard embed
Errors:
- Missing moderation permissions
- Position must be 1 or higher
- No record at that position
Strength Format
The bot recognizes the following formats:
| Suffix | Multiplier | Examples |
|---|---|---|
| K | ×1,000 | 50K, 200K, 1.5K |
| M | ×1,000,000 | 500M, 1.2M, 800M |
| G | ×1,000,000,000 | 1G, 1.5G, 2.3G |
Decimal values are supported: 1.5G = 1,500,000,000
Leaderboard
The bot maintains a persistent leaderboard embed in a configured channel:
- Auto-updates after every
/apcor/apc-removecommand - Shows rank, username, main APC, and second APC
- Sorted by main APC value (descending)
- Configured via dashboard:
channel_idandmessage_id
Tip
Use /lockdown on the APC channel to prevent regular messages — only /apc commands will work there.