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) |
| main_faction | string (optional) | No | Faction of the main cart: Fighters, Shooters, Riders |
| second_faction | string (optional) | No | Faction of the second cart: Fighters, Shooters, Riders |
Both faction parameters are optional. When omitted, the previously set faction is preserved (COALESCE in SQL).
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
/apc-set
Manually set or update a member's APC strength. Used by leadership when the member isn't using /apc themselves or the recorded value needs to be corrected.
| Parameter | Type | Required | Description |
|---|---|---|---|
| user | member | Yes | Member whose APC to set |
| main | string | Yes | Main APC strength (e.g. 1.5G, 800M, 2T) |
| second | string | Yes | Second APC strength (e.g. 500M, 200K) |
| main_faction | choice | No | Faction of the main cart: Fighters, Shooters, Riders |
| second_faction | choice | No | Faction of the second cart: Fighters, Shooters, Riders |
Permissions: Moderation Roles or Administrator
Example: /apc-set user:@Alice main:1.5G second:500M main_faction:Fighters
Success:
Validates the strength format (same parser as /apc)
Upserts the record for the target member
Ephemeral confirmation with the new values
Updates the leaderboard embed so the change shows up immediately
Logs an APC Manual Set audit entry under the apc Logs category
Errors:
- Missing moderation permissions
- Invalid strength format (must look like
1.5G,800M, etc.)
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
- 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
- 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.