> ## 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 Permissions, Rank Limits, and Boosters

> Full guide to LiricCasino permission nodes, three-tier rank limits, per-game daily-use caps, max-bet thresholds, and economy booster multipliers.

LiricCasino uses a three-tier permission model — **Default**, **VIP**, and **Admin** — to control how many times a player can use each game per day, how large their bets can be, and whether their winnings receive an economy booster. Every limit is defined in `config.yml`, so you can tune each tier independently per game without touching any permission plugin config files.

## Permission nodes

| Permission                   | Default Holder | Purpose                                                                                                                |
| ---------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `casino.admin`               | OP             | Full admin access: setup/delete/purge objects, `forcestart`, `give` tickets, `reload` configs, unlimited uses and bets |
| `casinoliric.roulette.vip`   | —              | Elevated daily-use limit for Roulette                                                                                  |
| `casinoliric.roulette.admin` | —              | Unlimited daily uses (`-1`) for Roulette specifically                                                                  |
| `casinoliric.bet.vip`        | —              | Elevated max-bet limit across all bet-based games                                                                      |
| `casinoliric.uses.vip`       | —              | Elevated daily-use limit across Blackjack, Slots, Scratch, Lottery, CoinFlip, RPS, TTT, Racing, and Poker              |
| `casinoliric.uses.admin`     | —              | Unlimited daily uses (`-1`) across Blackjack, Slots, Scratch, Lottery, CoinFlip, RPS, TTT, Racing, and Poker           |
| `casinoliric.bet.admin`      | —              | Max bet of `$10,000,000` across all games                                                                              |

<Note>
  The permission names are configured directly inside `config.yml` under each game's `ranks` block, so you can rename them freely to match your server's existing rank structure.
</Note>

## Three-tier model

<CardGroup cols={3}>
  <Card title="Default" icon="user">
    All players start here. Conservative daily limits and bet caps apply. No booster to winnings.
  </Card>

  <Card title="VIP" icon="star">
    Assign `casinoliric.bet.vip` and/or `casinoliric.uses.vip` (or the game-specific variant) for higher caps and an optional economy booster.
  </Card>

  <Card title="Admin" icon="shield">
    Assign `casino.admin` for unlimited daily uses, a \$10 M max bet ceiling, and all administrative sub-commands.
  </Card>
</CardGroup>

## Per-game daily-use and max-bet limits

The table below lists the **default** values shipped with LiricCasino. Every row is independently editable in `config.yml`.

| Game                | Default uses/day | VIP uses/day | Admin uses/day | Default max bet | VIP max bet | Admin max bet |
| ------------------- | ---------------- | ------------ | -------------- | --------------- | ----------- | ------------- |
| Roulette            | 2                | 10           | ∞              | \$200,000       | —           | —             |
| Blackjack           | 10               | 50           | ∞              | \$100,000       | \$500,000   | \$10,000,000  |
| Slots 777           | 20               | 100          | ∞              | \$100,000       | \$500,000   | \$10,000,000  |
| Scratch Cards       | 5                | 25           | ∞              | \$100,000       | \$500,000   | \$10,000,000  |
| Lottery             | 5                | 10           | ∞              | \$100,000       | \$500,000   | \$10,000,000  |
| CoinFlip            | 15               | 50           | ∞              | \$500,000       | \$1,000,000 | \$10,000,000  |
| Rock Paper Scissors | 15               | 50           | ∞              | \$500,000       | \$1,000,000 | \$10,000,000  |
| Tic Tac Toe         | 10               | 30           | ∞              | \$500,000       | \$1,000,000 | \$10,000,000  |
| Horse Racing        | 5                | 20           | ∞              | \$100,000       | \$500,000   | \$10,000,000  |
| Poker               | 5                | 20           | ∞              | \$100,000       | \$500,000   | \$10,000,000  |

<Note>
  Roulette uses its own permission nodes (`casinoliric.roulette.vip` and `casinoliric.roulette.admin`) instead of the shared `casinoliric.uses.*` nodes. Roulette also has a single flat `max-bet` setting rather than per-rank bet tiers, so the VIP and Admin max-bet columns do not apply to it.
</Note>

<Tip>
  Set any `max-uses-per-day` value to `-1` to grant that rank unlimited daily plays for that game.
</Tip>

## Economy boosters

Boosters multiply a player's **gross winnings** by a configurable factor. You define the booster amount and the permission node that triggers it inside the top-level `boosters` block of `config.yml`. Any number of booster tiers can be added.

| Booster tier | Default permission | Default multiplier |
| ------------ | ------------------ | ------------------ |
| VIP          | `vip.boost`        | 2.0×               |
| MVP          | `mvp.boost`        | 3.0×               |

### Example config snippet

```yaml theme={null}
# ─── Economy Boosters ────────────────────────────────────────
boosters:
  vip:
    booster: 2.0
    permiso: "vip.boost"
  mvp:
    booster: 3.0
    permiso: "mvp.boost"
```

You can add further tiers (e.g. `elite`, `legend`) by following the same pattern. The permission string under `permiso` must match what your permission plugin assigns to those players.

## Per-game limit config snippet

Below is a representative excerpt showing how daily-use and bet limits are structured. All other games follow the identical pattern.

```yaml theme={null}
blackjack:
  bet:
    default:
      min: 100.0
      max: 100000.0
    ranks:
      vip:
        permission: "casinoliric.bet.vip"
        max: 500000.0
      admin:
        permission: "casinoliric.bet.admin"
        max: 10000000.0
  uses:
    default:
      max-uses-per-day: 10
    ranks:
      vip:
        permission: "casinoliric.uses.vip"
        max-uses-per-day: 50
      admin:
        permission: "casinoliric.uses.admin"
        max-uses-per-day: -1  # unlimited
```

After editing `config.yml`, run `/casino reload` to apply all changes immediately — no server restart required.