SnCoinFlip changelog

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