Rival Credits Commands And Workflow
Commands
| Command | Notes |
|---|---|
/rcredits balance player:<name> | Checks a player’s RivalCredits balance. |
/rcredits give player:<name> amount:<amount> reason:<note> | Adds credits to a player. |
/rcredits remove player:<name> amount:<amount> reason:<note> | Removes credits from a player. |
/rcredits set player:<name> amount:<amount> reason:<note> | Sets a player’s balance. |
/rcredits reset player:<name> reason:<note> | Resets a player’s balance. |
/rcredits test | Sends the configured test command over RCON. |
The reason option is optional and is meant as an internal staff note.
Workflow
- A staff member runs
/rcredits. - AthenaBot checks the base command permission and the action-specific permission.
- The plugin validates the Minecraft username and amount.
- AthenaBot fills the configured RCON command template.
- The command is sent to the Minecraft server through RCON.
- The cleaned server response is shown in a Discord embed.
Expected Discord Behavior
- Replies are ephemeral by default.
- Balance responses show the parsed balance when the configured regex can find one.
- Give, remove, set, and reset actions return the server response from RivalCredits.
- Rate limits prevent one user or one server from spamming RCON.
- User-facing text and embeds come from
rival_credits_lang.
Recommended Permissions
Use a light split between viewing and changing balances:
| Action | Recommended Permission |
|---|---|
balance | member or staff |
give | management |
remove | management |
set | management |
reset | management |
test | management |
For public community servers, keep all balance-changing actions limited to trusted staff.