> ## 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 PlaceholderAPI Stats Variables Reference

> Full list of %casino_*% PlaceholderAPI variables exposed by LiricCasino, covering wagered totals, profits, and per-game stats: spins, wins, and winrates.

LiricCasino registers a full set of `%casino_*%` placeholders through [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/), giving you live access to every player's gambling statistics for use in scoreboards, tab-list headers, holograms, and leaderboard plugins. PlaceholderAPI is a soft dependency — the plugin works without it, but placeholders only resolve when it is installed and running.

<Note>
  Install PlaceholderAPI and ensure LiricCasino is loaded **after** it. No extra expansion download is needed — LiricCasino registers its own expansion automatically on startup.
</Note>

## Global economy placeholders

These placeholders reflect the player's totals across **all** casino games combined.

| Placeholder              | Returns      | Description                                                  |
| ------------------------ | ------------ | ------------------------------------------------------------ |
| `%casino_total_wagered%` | `$1,234,567` | Total money wagered by the player across every game          |
| `%casino_total_won%`     | `$2,345,678` | Total money won by the player across every game              |
| `%casino_profit%`        | `$1,111,111` | Net profit — total won minus total wagered (can be negative) |

## Roulette placeholders

| Placeholder                 | Returns    | Description                                                         |
| --------------------------- | ---------- | ------------------------------------------------------------------- |
| `%casino_roulette_bets%`    | `42`       | Total number of roulette bets placed                                |
| `%casino_roulette_wins%`    | `18`       | Total roulette bets that resulted in a win                          |
| `%casino_roulette_losses%`  | `24`       | Total roulette bets that resulted in a loss                         |
| `%casino_roulette_winrate%` | `42%`      | Win rate as a percentage; returns `N/A` if no bets have been placed |
| `%casino_roulette_wagered%` | `$84,000`  | Total amount wagered on Roulette                                    |
| `%casino_roulette_won%`     | `$120,000` | Total amount won on Roulette                                        |

## Slots 777 placeholders

| Placeholder               | Returns    | Description                               |
| ------------------------- | ---------- | ----------------------------------------- |
| `%casino_slots_spins%`    | `150`      | Total number of slot machine spins        |
| `%casino_slots_jackpots%` | `2`        | Total jackpot (777) hits across all spins |
| `%casino_slots_wagered%`  | `$75,000`  | Total amount wagered on Slots             |
| `%casino_slots_won%`      | `$200,000` | Total amount won on Slots                 |

## Blackjack placeholders

| Placeholder              | Returns   | Description                                                |
| ------------------------ | --------- | ---------------------------------------------------------- |
| `%casino_bj_games%`      | `60`      | Total blackjack games played                               |
| `%casino_bj_wins%`       | `33`      | Total blackjack games won                                  |
| `%casino_bj_losses%`     | `27`      | Total blackjack games lost                                 |
| `%casino_bj_blackjacks%` | `5`       | Total natural blackjacks (Ace + 10-value card on deal)     |
| `%casino_bj_winrate%`    | `55%`     | Win rate as a percentage; returns `N/A` if no games played |
| `%casino_bj_wagered%`    | `$60,000` | Total amount wagered on Blackjack                          |
| `%casino_bj_won%`        | `$90,000` | Total amount won on Blackjack                              |

## Scratch card placeholders

| Placeholder              | Returns    | Description                                        |
| ------------------------ | ---------- | -------------------------------------------------- |
| `%casino_scratch_used%`  | `30`       | Total scratch cards scratched (all tiers combined) |
| `%casino_scratch_wins%`  | `12`       | Total scratch cards that produced a winning match  |
| `%casino_scratch_spent%` | `$150,000` | Total amount spent on scratch cards                |
| `%casino_scratch_won%`   | `$210,000` | Total amount won from scratch cards                |

## All placeholders at a glance

| Placeholder                 | Description                     |
| --------------------------- | ------------------------------- |
| `%casino_total_wagered%`    | Total money wagered (all games) |
| `%casino_total_won%`        | Total money won (all games)     |
| `%casino_profit%`           | Net profit: won − wagered       |
| `%casino_roulette_bets%`    | Roulette bets placed            |
| `%casino_roulette_wins%`    | Roulette wins                   |
| `%casino_roulette_losses%`  | Roulette losses                 |
| `%casino_roulette_winrate%` | Roulette win-rate percentage    |
| `%casino_roulette_wagered%` | Total wagered on Roulette       |
| `%casino_roulette_won%`     | Total won on Roulette           |
| `%casino_slots_spins%`      | Slot machine spins              |
| `%casino_slots_jackpots%`   | Jackpot (777) hits              |
| `%casino_slots_wagered%`    | Total wagered on Slots          |
| `%casino_slots_won%`        | Total won on Slots              |
| `%casino_bj_games%`         | Blackjack games played          |
| `%casino_bj_wins%`          | Blackjack wins                  |
| `%casino_bj_losses%`        | Blackjack losses                |
| `%casino_bj_blackjacks%`    | Natural blackjacks dealt        |
| `%casino_bj_winrate%`       | Blackjack win-rate percentage   |
| `%casino_bj_wagered%`       | Total wagered on Blackjack      |
| `%casino_bj_won%`           | Total won on Blackjack          |
| `%casino_scratch_used%`     | Scratch cards used              |
| `%casino_scratch_wins%`     | Scratch card wins               |
| `%casino_scratch_spent%`    | Total spent on scratch cards    |
| `%casino_scratch_won%`      | Total won from scratch cards    |

## Use cases

<CardGroup cols={2}>
  <Card title="Scoreboards" icon="list-ol">
    Display a player's real-time profit or win rate in a sidebar scoreboard using plugins like **FastBoard** or **TAB**.

    ```
    Net Profit: %casino_profit%
    BJ Winrate: %casino_bj_winrate%
    ```
  </Card>

  <Card title="Tab-list headers" icon="table-columns">
    Show top-level economy stats in the tab-list header or footer for a quick at-a-glance view.

    ```
    Wagered: %casino_total_wagered%
    Won:     %casino_total_won%
    ```
  </Card>

  <Card title="Holograms" icon="layer-group">
    Use **DecentHolograms** or **HolographicDisplays** to place floating stat boards above game areas.

    ```
    &6Jackpots hit: &e%casino_slots_jackpots%
    &aRoulette winrate: &f%casino_roulette_winrate%
    ```
  </Card>

  <Card title="Leaderboard plugins" icon="trophy">
    Feed values into ranking plugins such as **RankingPlugin** or **LeaderHeads** to display server-wide top-10 boards by profit or total wagered.
  </Card>
</CardGroup>

<Tip>
  The `%casino_profit%` placeholder returns a negative formatted value (e.g. `$-50,000`) when a player has lost more than they have won. Use your scoreboard plugin's conditional formatting features to colour it red or green accordingly.
</Tip>