ArCoinFlips | Modern & Optimized Plugin

Carousel Demo video

ArCoinFlips

ArCoinFlips is a premium, highly optimized, and visually stunning Minecraft plugin for Paper, Spigot, and Purpur (1.20 - 1.21+) that allows players to wager in-game currency against each other in real-time coinflip games. Inspired by top-tier server UI designs (such as FireMC and DonutSMP), this plugin features a modern glassmorphism GUI, smooth animations, anti-exploit features, and robust database logging.

Features

-

Modern GUI Design
- Sleek 54-slot inventory layouts with beautiful gray stained glass border elements and dynamic player head items.
- Interactive controls including a refresh bell, quick filter hopper, and lime-colored next/previous page buttons.
-

Smart Sorting & Filters
- Instantly cycle through active bets with one-click filtering:
-

Highest → Lowest (by bet amount)
-

Lowest → Highest (by bet amount)
-

Newest → Oldest (by creation time)
-

Oldest → Newest (by creation time)
-

Dynamic Circular Flip Animation
- Suspenseful head rotation animation in a circular motion around a central gold block, creating a high-stakes, engaging atmosphere.
- Celebrates wins with fireworks sound effects, screen titles (YOU WON! / YOU LOST!), chat broadcasts, and colored stained-glass victory indicators.
-

Configurable Tax System
- Optional house edge tax system to drain currency from the server economy (e.g., a 5% tax where the winner of a $100k game receives $95k).
-

Smart Broadcast & Personal Toggles
- Global announcement triggers for large wagers (configurable threshold).
- Players can toggle coinflip messages on or off using /cf toggle to avoid chat clutter.
-

Persistent Statistics & PlaceholderAPI Integration
- SQLite backend database to log Wins, Losses, Games Played, Money Won, and Money Lost.
- Complete PAPI support for leaderboards, scoreboards, and tablists.
-

Exploit Proof & Robust Architecture
- Explicit click cooldowns in menus to prevent duplicate inventory click/join exploits.
- Safe transaction handlers that support offline player payouts, preventing money loss if a player leaves during a coin flip.
- Multi-format color support: MiniMessage, Hex code (e.g. #ffb300 or &#ffb300), and legacy color symbols (&).

[!NOTE]
All admin command permissions inherit from the wildcard permission arcoinflips.admin.

Placeholders (PlaceholderAPI)

Enable real-time player statistics on scoreboards, tablists, or holograms:

%arcoinflips_wins% - Total number of won coinflips
%arcoinflips_losses% - Total number of lost coinflips
%arcoinflips_winrate% - Percentage win rate (e.g. 52.5%)
%arcoinflips_money_won% - Total money won across player lifetime
%arcoinflips_money_lost% - Total money lost across player lifetime
%arcoinflips_games% - Total number of games played

---

Configuration Examples

coinflip.yml

YAML:

# ArCoinFlips Configuration File
config-version: 2

 General Settings
minimum-bet: 1000
maximum-bet: 100000000

 Tax / House Fee Settings
tax:
  enabled: true
  percentage: 5.0 # Takes 5% of the total pot as a tax

 Broadcast Settings
broadcast:
  min-amount: 100000 # Minimum wager amount to broadcast creation globally
  on-create: true
  on-win: true

 Sound effects config
sounds:
  flip-tick: "block.note_block.hat"
  win: "entity.firework_rocket.blast"
  lose: "entity.villager.no"

messages.yml

YAML:

# Prefix formatting
prefix: "<#ffb300><bold>COINFLIPS</bold> <gray>▶</gray> "

messages:
  no-permission: "<#ff0000>You do not have permission to execute this command."
  invalid-amount: "<#ff0000>Please specify a valid wager amount (e.g., 1000, 10k, 1m)."
  min-bet: "<#ff0000>The minimum bet is <#fcd703>${min}."
  max-bet: "<#ff0000>The maximum bet is <#fcd703>${max}."
  insufficient-funds: "<#ff0000>You do not have enough money to place this bet."
  already-active: "<#ff0000>You already have an active coinflip wager listed."
  wager-created: "<#88fc03>Your wager of <#fcd703>${amount} <#88fc03>has been listed!"
  wager-canceled: "<#88fc03>Your wager has been canceled and you have been refunded."
  broadcast-create: "<#ffb300>%player% <gray>has created a coinflip bet for <#88fc03>$%amount%!"
  broadcast-win: "<#ffb300>%winner% <gray>won a <#88fc03>$%amount% <gray>coinflip against <#ffb300>%loser%!"

Installation & Requirements

1. Download the latest ArCoinFlips-1.0.0.jar.
2. Drop it into your server's plugins/ directory.
3. Install Vault (required) along with a compatible economy provider (e.g. EssentialsX).
4. (Optional) Install PlaceholderAPI for statistic displays.
5. Restart your server. Customize your configurations in the plugins/ArCoinFlips/ folder, then run /cf reload!

Upcoming Updates:
visual editor and visual presets!

ArCoinFlips | Modern & Optimized Plugin v1.0 beta

Overview Dependencies History