Skip to content

Configuration

Jump to bottom
ItsNotSkyeZ edited this page Jul 18, 2026 · 13 revisions

Configuration · MD

Configuration

EndlessCoinflip uses two config files found in plugins/EndlessCoinflip/:

  • config.yml — Settings, GUI, sounds, gameplay and feature toggles
  • messages.yml — All player-facing chat messages Run /cf reload after making changes — no restart needed. New keys added in updates are automatically merged into your existing files without overwriting anything you've set.

config.yml

Features

features:
  bot-battles: true       # Enable/disable bot battles
  join-confirmation: true # Enable/disable the join confirmation screen
  private-matches: true   # Enable/disable private matches entirely

Storage

storage:
  type: FILE # FILE, SQLITE, or MYSQL
 
  sqlite:
    file: playerdata.db
 
  mysql:
    host: localhost
    port: 3306
    database: coinflip
    username: root
    password: ""
    use-ssl: false

See the Database Setup page for full details.

Wagers

settings:
  min-wager: 100
  max-wager: 1000000
  max-active-matches: 6
  server-tax-percent: 10  # Percentage cut from pot before paying winner (0 = disabled)
 
# Per-permission max-wager overrides.
# Highest matching value wins; falls back to settings.max-wager if no match.
wager-limits:
  # endlesscoinflip.vip: 5000000
  # endlesscoinflip.mvp: 10000000

Cooldowns & Match Expiry

cooldowns:
  enabled: true
  seconds: 5
 
match-expiry:
  enabled: true
  minutes: 10
  check-interval-seconds: 30 # Requires a restart to take effect

Big Win Broadcasts

broadcast:
  big-win:
    enabled: false
    threshold: 1000000
    message: "&6&l⭐ &e{winner} &6just won &f{amount} &6off &f{loser} &6in a coinflip!"

Sounds

Sound names must match a valid Bukkit Sound enum value.

sounds:
  win:
    sound: UI_TOAST_CHALLENGE_COMPLETE
    volume: 1.0
    pitch: 1.5
  lose:
    sound: UI_TOAST_CHALLENGE_COMPLETE
    volume: 1.0
    pitch: 1.0
  countdown:
    sound: BLOCK_NOTE_BLOCK_HAT
    volume: 1.0
    pitch: 0.8
    pitch-step: 0.1
  roll:
    sound: UI_BUTTON_CLICK
    volume: 0.5
    pitch: 0.8
    pitch-step: 0.06

GUI

All values support & colour codes. See your config.yml for the full list of GUI keys.

gui:
  main-title: "&0Coinflip"
  color-picker-title: "&0Choose Your Colour"
  match-title: "&0Coinflip &8— &f{wager}"

Match History

gui-size must be a multiple of 9 (9-54). The bottom row is reserved for navigation.

history:
  max-stored: 200
  gui-size: 54
  title: "&0Coinflip History &8({page}/{pages})"
  date-format: "dd/MM/yyyy HH:mm"
  win-material: LIME_STAINED_GLASS_PANE
  lose-material: RED_STAINED_GLASS_PANE
  previous-slot: 45
  next-slot: 53

Leaderboard

leaderboard:
  enabled: true
  sort-by: total-won  # wins, losses, total-wagered, total-won, biggest-win, biggest-loss
  gui: false          # true = GUI leaderboard, false = chat leaderboard
  entries-per-page: 10

Join Confirmation

join-confirm:
  title: "&0Confirm Join"
  confirm-slot: 3
  confirm-material: LIME_STAINED_GLASS_PANE
  confirm-name: "&a&lConfirm"
  cancel-slot: 5
  cancel-material: RED_STAINED_GLASS_PANE
  cancel-name: "&c&lCancel"

messages.yml

All chat messages support & colour codes.

Multi-line Messages

The help and stats keys support multi-line lists:

help:
  - "&b&lEndlessCoinflip &8— &7Commands"
  - "  &b/cf &8— &7Open the coinflip lobby"
 
stats:
  - "  &7Wins&8: &f{wins}"
  - "  &7Losses&8: &f{losses}"

Placeholders

Placeholder Description
{wager} The wager amount
{opponent} The opponent's name, or "Coinflip Bot"
{amount} A generic amount (e.g. pending payout)
{min} Minimum wager
{max} Maximum wager
{time} Cooldown seconds remaining
{wins} Player's win count
{losses} Player's loss count
{wagered} Total amount wagered
{won} Total amount won
{win} Biggest single win
{loss} Biggest single loss
{winner} Winner's name (big-win broadcast only)
{loser} Loser's name (big-win broadcast only)
{host} The match host's name
{target} The invited player's name
{color} A wool colour's chat colour code
{colorName} A wool colour's display name
{count} Countdown number (5-1)
{ratio} A player's win:loss ratio
{page} Current page number
{pages} Total page count
{rank} Leaderboard position
{value} Leaderboard sorted stat value
{type} "Player" or "Coinflip Bot" (history only)
{date} Formatted date (history only)
{biggestWin} Biggest win (leaderboard lore only)
{biggestLoss} Biggest loss (leaderboard lore only)

Colour Codes

Code Colour
&a Green
&b Aqua
&c Red
&e Yellow
&f White
&7 Gray
&8 Dark Gray
&l Bold
&m Strikethrough

Clone this wiki locally