> ## Documentation Index
> Fetch the complete documentation index at: https://pumpkings.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LiricCasino: 10 Casino Games for Your Minecraft Server

> LiricCasino adds 10 casino minigames to your server, with Vault economy, per-rank bet limits, Discord webhooks, and live leaderboards included.

LiricCasino is a feature-rich Minecraft casino plugin that adds ten interactive gambling minigames to your Paper or Spigot server. Every game connects directly to your server's economy through Vault, so players wager and win real in-game currency. Physical in-world objects — like a spinning roulette wheel and slot machines — make the experience feel alive on your server, while a flexible permission system lets you tailor bet limits and daily usage caps to each player rank.

## The 10 Games

<CardGroup cols={2}>
  <Card title="🎡 Roulette" icon="circle-dot">
    A physical, scalable roulette wheel placed in your world. Players place bets on numbers, red, black, or green before the wheel spins. Use `/casino ruleta escala` to resize it live.
  </Card>

  <Card title="🃏 Blackjack" icon="cards-blank">
    Classic 21 Blackjack at a physical table. Players hit, stand, or raise their bet against the dealer in a GUI-driven experience.
  </Card>

  <Card title="🎰 Slots" icon="slot-machine">
    A physical 777 slot machine with fully configurable prize symbols, multipliers, and weighted odds. Luck-booster permissions can increase a player's chances.
  </Card>

  <Card title="♠️ Poker" icon="spade">
    A physical poker table where players compete for the pot. Join or leave a table at any time with `/poker`.
  </Card>

  <Card title="🎟 Scratch Cards" icon="ticket">
    Four scratch-card tiers (Basic 3×3 up to Giant 9×6) with escalating ticket prices and payout multipliers. Give tickets to players as rewards.
  </Card>

  <Card title="🏆 Lottery" icon="trophy">
    A server-wide jackpot lottery. Players buy numbered tickets and wait for the scheduled draw. The jackpot grows as 50 % of each ticket price rolls into the pot.
  </Card>

  <Card title="🪙 CoinFlip" icon="coin">
    PvP head-to-head coin flip. One player creates a wager, another joins, and the result is broadcast server-wide. Animation plays out over a configurable number of ticks.
  </Card>

  <Card title="✊ Rock Paper Scissors" icon="hand-back-fist">
    PvP Rock Paper Scissors with real money on the line. Create a duel, wait for an opponent, then lock in your choice through the GUI.
  </Card>

  <Card title="⬛ Tic Tac Toe" icon="grid-2">
    PvP Tic Tac Toe played entirely through a GUI. The winner collects both bets; a tie returns stakes to both players.
  </Card>

  <Card title="🏇 Horse Racing" icon="horse">
    Bet on a horse before the race begins. The winning horse pays out based on the configured multiplier and tax rate.
  </Card>
</CardGroup>

## What's Included

<CardGroup cols={2}>
  <Card title="Configurable GUIs" icon="sliders">
    Every game menu is defined in `menus/<game>.yml`. Change titles, rows, slot positions, item materials, and display names without touching any code.
  </Card>

  <Card title="Tax / House Edge System" icon="percent">
    Apply a per-game tax rate to winnings (disabled by default). Set a global default rate or override it individually for each game.
  </Card>

  <Card title="Permission-Based Tiers" icon="shield">
    Control minimum bets, maximum bets, and daily play limits per rank. Grant VIP and admin tiers higher caps or unlimited plays with simple permission nodes.
  </Card>

  <Card title="Discord Webhooks" icon="discord">
    Automatically announce big jackpot wins to a Discord channel. Configure all webhook targets in the dedicated `webhooks.yml` file.
  </Card>

  <Card title="Stats & Leaderboards" icon="chart-bar">
    Players view personal stats with `/casino stats` and compare scores with `/casino top [game]`. Built-in leaderboards cover wins, losses, and total wagered per game.
  </Card>

  <Card title="PlaceholderAPI Support" icon="code">
    Expose casino statistics as PlaceholderAPI variables, ready to drop into scoreboards, chat formatters, or any PAPI-compatible plugin.
  </Card>
</CardGroup>

## Compatibility

| Requirement         | Details                               |
| ------------------- | ------------------------------------- |
| **Server software** | Paper or Spigot 1.20.x – 1.21.x       |
| **Folia**           | Supported                             |
| **Java**            | 21 or newer                           |
| **Plugin version**  | 2.0.3                                 |
| **Database**        | SQLite (default) or MariaDB           |
| **Economy**         | Vault + any compatible economy plugin |