FoCoinflip

Add fast player-vs-player coinflips with a clean GUI, Vault payouts, stats, tax controls, and admin editing.

FoCoinflip lets players create wager listings, join other players' flips, watch a short result animation, and track their won/lost totals. Server owners get simple admin controls for tax, min/max bet limits, announcements, GUI text, and animation behavior.

Features

• Let players create one active coinflip listing with /cf create <amount>.
• Show active coinflips in a paginated GUI with player heads and bet amounts.
• Withdraw stakes up front, refund deleted or shutdown coinflips, and pay winners through Vault.
• Configure tax percentage, minimum bet, maximum bet, result announcements, and animation timing.
• Display a rolling coinflip animation and final winner result to both players.
• Track player totals for money won, money lost, and net sum.
• Expose PlaceholderAPI placeholders for coinflip stats when PlaceholderAPI is installed.
• Edit key settings from an admin GUI with chat prompts.

Dependencies

• Required: Vault and a Vault-compatible economy provider.
• Optional: PlaceholderAPI for %focoinflip_total_won%, %focoinflip_total_lost%, and %focoinflip_total_sum%.

Commands

• /coinflip - Open the coinflip GUI.
• /coinflip create <amount> - Create a coinflip listing.
• /coinflip delete - Delete your active coinflip and refund the stake.
• /coinflipadmin version - Show plugin version and author.
• /coinflipadmin editor - Open the admin settings editor.
• /coinflipadmin reload - Reloadds config.yml, messages.yml and guis folder.

Aliases: /focoinflip, /cf, /focoinflipadmin, /cfadmin

Permissions

• focoinflip.use - Use coinflip commands.
• focoinflip.admin - Use admin commands and the editor.

Placeholders

• %focoinflip_total_won% - Player's formatted total money won from coinflips.
• %focoinflip_total_lost% - Player's formatted total money lost from coinflips.
• %focoinflip_total_sum% - Player's formatted net coinflip total.

<dependency>
  <groupId>me.foesio</groupId>
  <artifactId>FoCoinflip</artifactId>
  <version>2.5</version>
  <scope>provided</scope>
</dependency>

import me.foesio.foCoinflip.api.CoinflipApi;
import me.foesio.foCoinflip.api.CoinflipClosedEvent;

CoinflipApi api = Bukkit.getServicesManager().load(CoinflipApi.class);
if (api != null) api.openFlips();

@EventHandler
public void onCoinflipClosedEvent(CoinflipClosedEvent event) {
    Bukkit.getLogger().info(event.getClass().getSimpleName());
}