SnCoinFlip changelog

Changes

/cf works again

The alias was declared only in config.yml under command.aliases, and that binding fails silently when the key is missing, so /cf did not exist on a real server across 2.0.0-2.3.0. aliases: [cf] is back in plugin.yml, where Bukkit binds it at load.

command.aliases still works and is still re-read on /coinflip reload: anything you add there is registered immediately and removed again when you take it out. The one change is that cf itself can no longer be removed from that list.

Abbreviated wagers

/coinflip create <currency> <amount> now accepts 1k, 1.5m, 2B - suffixes k/m/b/t/qa/qi, case-insensitive. Comma grouping (1,000) and the European decimal comma (1,5k) come with it.

The wager is still a whole number, so 1.5 is refused rather than truncated. 10.000 is refused too: a lone dot is read as a decimal point, so it would have become a wager of ten. Write 10000 or 10k.

bet.suggested-amounts may use the abbreviated forms now as well.

Requires

SnLib 1.33.0 or newer on the server (this build moved up from 1.24.1).

Changes

• The winner/result broadcast can now be filtered by wager, exactly like the creation broadcast added in 2.2.0: broadcast.result-min-amount (global, default 0, so every finished match is still announced until you raise it), plus an optional result-broadcast-min override inside any single currency's entry under currencies:.
• The two thresholds are independent: a currency can throttle its creation noise and still announce every winner, or the reverse.
• Both compare against the wager, not the doubled prize, so the same number means the same match in either key.
• Silencing a result moves no money: the winner is paid and the stats are recorded before the announcement, and both players still see their own outcome in the animation.
• Existing servers are unaffected until they edit the new key. currencies: is owner-owned, so the per-currency key is never inserted into an entry that already exists on disk.

Changes

• Coinflip creations are now filtered from chat below a configurable minimum wager: broadcast.min-amount (global, default 0 - same chat as before until you raise it) plus an optional broadcast-min override inside any single currency's entry under currencies:.
• The result/winner broadcast is never filtered: every finished match is still announced, whatever the wager.
• A coinflip below the floor is completely unaffected otherwise - it is still created, still listed in the lobby and still joinable. Only its own creation announcement is silenced.

Changes

• The defaults shipped in the jar are now English. config.yml ships lang: en, and the lobby and statistics menus (guis/lobby.yml, guis/stats.yml) are English.
• Spanish is unchanged and one key away: lang/messages_es.yml still ships complete, so lang: es plus /coinflip reload switches the messages back.
• lang never translated the menus, and now the files say so. Setting lang: en previously gave you English chat with Spanish menus; menu text is edited directly in guis/*.yml.

Upgrading

Nothing to do, and nothing changes on a server that already ran this plugin. SnLib preserves the values already on disk, so your config.yml keeps its lang and your menus keep their current wording. Only a fresh install starts out in English.

Heads up: Vault is now REQUIRED

plugin.yml declares depend: [SnLib, Vault]. A server without Vault.jar will not load SnCoinFlip at all. Install Vault before updating.

Changes

• Vault is a third currency backend, and the default one. A currency with vault: true is served by whatever economy plugin registered its provider with Vault (EssentialsX, CMI, XConomy, ...). It needs no other field - no id, no commands, no placeholder - so a fresh install can wager with zero editing.
• It verifies its own debit. Vault's withdrawal returns the provider's own verdict on the transaction, so no deferred snapshot check runs against a Vault currency. That is a stronger guarantee than either of the other two backends has.
• A missing economy provider is not a startup failure. Vault only brokers an economy, it does not provide one, so an economy plugin registering after SnCoinFlip enables is ordinary. A vault: true currency registers either way and starts working the moment a provider appears - no restart, no /coinflip reload. Until then its wagers are refused as unverifiable and the players are told exactly that, not told they are broke.
• Default config. It now ships a Vault-backed money currency first, one command-backed example and one EdTools example. The five EdTools examples are down to one: copying the block is all the other four ever were.

Upgrading from 2.0.0

Nothing in an existing config.yml changes meaning. vault: is a new key that means false when absent, so every currency you already have keeps the backend it already had.

currencies: is a section this plugin never edits (# sn:extensible), which also means the new money currency is not inserted into a config.yml that already exists. To pick it up, add it by hand:

  money:
    display-name: "&aMONEY"
    vault: true

or delete the whole currencies: block and let the plugin write the new defaults back on the next boot.

PvP coinflip gambling for Paper 1.20.x / 1.21.x, with as many currencies as you care to configure.

A player stakes an amount, the wager goes up in a public lobby menu, someone accepts it, both stakes are debited, a fair 50/50 winner is drawn and an animation plays before the winner takes the pot. Lifetime totals are kept per player per currency.

Features

• Any number of currencies, all config-driven. Each declares a display name and either a give/take command pair with a balance placeholder, or an EdTools currency id to use that API directly. The plugin links no economy plugin of its own.
• A lobby menu, a stats menu and a coin-flip animation, all three laid out in guis/*.yml.
• Eight PlaceholderAPI placeholders: wins, losses, wagered and won, per currency and totalled.
• Nothing is debited until a match is joined; a match that cannot confirm both wagers pays nobody and refunds what it can prove was taken; a restart mid-animation refunds both sides, by UUID for whoever is offline; a disconnect mid-animation still resolves the match and still pays the winner.
• English and Spanish shipped, with lang/ merged on update so your edits and comments survive.

Install

• SnLib.jar must be present in plugins/ (com.sn:snlib 1.24.1 or newer).
• Paste your key into plugins/.Sn-License/license.yml. One key covers every bundled Sn plugin.
• config.yml, lang/ and guis/ generate on first boot. Replace the shipped currencies: block with your own before letting players use it.
• PlaceholderAPI is needed by command-backed currencies and by the placeholders. EdTools is needed by any currency with edtoolapi: true.

Two settings are worth reading the docs for, because getting either wrong costs players money and neither looks like a misconfiguration from the outside: balance-placeholder must render an exact, unabbreviated number, and verification.confirm-look-ticks must out-wait whatever refreshes that number on a proxied setup.

Requirements: Java 21+, Paper 1.20.x or 1.21.x

Full documentation: https://github.com/ValentinTarnovsky/Sn-Releases/tree/main/docs/gitbook/sncoinflip