SnDevelopmentCommands
The root command is /coinflip. /cf is an alias, and the alias list is configurable under command.aliases in config.yml, re-read on /coinflip reload.
| Command | Permission | Description |
|---|---|---|
/coinflip | sncoinflip.use | Opens the lobby with every active coinflip. Prints the generated help instead when presentation.main is chat. |
/coinflip create <currency> <amount> | sncoinflip.use | Creates a coinflip for that amount of that currency. Nothing is debited yet. |
/coinflip cancel | sncoinflip.use | Cancels your pending coinflip. Costs nothing, because a waiting coinflip holds no money. |
/coinflip stats | sncoinflip.use | Shows your lifetime totals per currency, as a menu or as chat depending on presentation.stats. |
/coinflip reload | sncoinflip.admin.reload | Reloads configuration, language and menus. |
/coinflip help | sncoinflip.use | Shows the generated help. |
/coinflip debug | sncoinflip.admin.debug | Toggles debug output live. |
<currency> is the currency id, which is the map key in config.yml, not the display name. Tab completion offers every registered id, so a currency that was skipped at startup is also absent from the completion list.
Creating and joining
/coinflip create <currency> <amount> puts your wager in the lobby and takes nothing from you. The lobby entry is the join button: another player opens /coinflip, left-clicks your entry, and that is the moment both stakes are debited and the animation starts for both of you.
Joining is left-click only. The lobby item is a commit button that spends real money, so it deliberately ignores right-click, shift-click and the number keys.
You may hold one active coinflip at a time, as the creator or as the joiner.
The amount
The wager must be a whole number between bet.min and bet.max inclusive. Tab completion suggests the values in bet.suggested-amounts, but any amount inside the bounds is accepted.
A wager can also be refused before anything is charged when the currency's balance placeholder is too coarse to prove that the debit happened. The player is told, and the console names the balance and the amount. Raising the wager past what the render can display makes it work, so this costs exactly the bets that could not have been verified.
During the animation
Neither player can close the animation menu or start another coinflip until the reveal has passed. The hold lasts animation.duration-ticks plus animation.reveal-delay-ticks.
Disconnecting does not cancel anything. The match resolves on schedule and the winner is paid, offline if necessary.