Rival Credits Configuration

When dashboard-backed configuration is enabled, use the dashboard first because live settings may be stored in MongoDB instead of only reading local JSON5 files.

Config Files

Main config: configuration/rival_credits.json5
Language config: configuration/rival_credits_lang.json5
Plugin entry: plugins/rival_credits/main.js

Main Fields

Field	Type	Default / Template Value	Notes
`enabled`	boolean	`true`	Turns the integration on or off.
`command_permission`	string	`member`	Base permission needed to see and use `/rcredits`.
`ephemeral_reply`	boolean	`true`	Keeps command replies private by default.
`cooldown_seconds`	number	`5`	Per-user cooldown for RCON actions.
`max_requests_per_minute`	number	`30`	Server-wide RCON request cap.
`response_limit_chars`	number	`900`	Maximum RCON response text shown in embeds.
`player_name_pattern`	string	`^[A-Za-z0-9_]{3,16}$`	Username validation regex. Adjust for Geyser or custom name formats.
`rcon.host`	string	`127.0.0.1`	Reachable RCON host or IP for the Minecraft server.
`rcon.port`	number	`25575`	RCON port, not the Minecraft game or query port.
`rcon.password`	string	`CHANGE_ME`	Must match `rcon.password` in `server.properties`.
`rcon.timeout_ms`	number	`5000`	RCON connection timeout.
`amounts.allow_decimals`	boolean	`true`	Allows decimal credit amounts.
`amounts.decimal_places`	number	`2`	Rounds decimal amounts before sending them to RCON.
`amounts.max_amount`	number	`1000000000`	Highest allowed amount for give, remove, and set actions.
`permissions.balance`	string	`member`	Permission for balance checks.
`permissions.give`	string	`management`	Permission for granting credits.
`permissions.remove`	string	`management`	Permission for removing credits.
`permissions.set`	string	`management`	Permission for setting a balance.
`permissions.reset`	string	`management`	Permission for resetting a balance.
`permissions.test`	string	`management`	Permission for testing RCON.
`commands.balance`	string	`credits balance {player}`	RCON command template for balance checks.
`commands.give`	string	`credits give {player} {amount}`	RCON command template for giving credits.
`commands.remove`	string	`credits remove {player} {amount}`	RCON command template for removing credits.
`commands.set`	string	`credits set {player} {amount}`	RCON command template for setting credits.
`commands.reset`	string	`credits reset {player}`	RCON command template for resets.
`commands.test`	string	`list`	RCON command used by `/rcredits test`.
`response_parsing.balance_regex`	string	Balance capture regex	First matched capture group is shown as the parsed balance.
`logging.log_commands`	boolean	`true`	Logs RCON command text to AthenaBot logs.
`logging.log_rcon_responses`	boolean	`false`	Logs raw RCON responses. Keep off unless debugging.

Command Template Variables

The plugin replaces these placeholders before sending the RCON command:

Placeholder	Available On	Example
`{player}`	balance, give, remove, set, reset	`Notch`
`{amount}`	give, remove, set	`25`
`{reason}`	give, remove, set, reset	`refund`

Do not include a leading slash in command templates. RCON runs them as console commands.

Language Config

Use configuration/rival_credits_lang.json5 to rename the slash command, subcommands, options, action labels, error messages, and embed text. Restart AthenaBot after changing slash command names so Discord receives the updated command structure.