> ## 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.

# Rock Paper Scissors PvP: Create Duels and Choose

> Challenge another player to a blind simultaneous Rock Paper Scissors duel, set your bet, and let the server announce the result to everyone online.

Rock Paper Scissors in LiricCasino is a fully player-vs-player duel game. One player creates a match and sets the bet amount, a second player joins, and both players make their choice simultaneously through an inventory GUI — neither player can see the other's pick until the server resolves the round. No physical blocks or signs are needed anywhere on the map; the entire game runs through chat and GUI interactions.

## How to Play

<Steps>
  <Step title="Open the game">
    Run `/rps` to open the Rock Paper Scissors lobby GUI. From here you can create a new duel or join one that another player has already started.
  </Step>

  <Step title="Create or join a duel">
    **Creating:** Set your desired bet amount in the GUI. The server broadcasts a server-wide message so other players know a duel is open.

    **Joining:** Click an open duel in the list. The bet amount you must match is displayed before you confirm.
  </Step>

  <Step title="Make your choice">
    Once two players are in the same duel, both players receive an inventory GUI at the same time. Select **Rock**, **Paper**, or **Scissors** — your choice is hidden from your opponent until both players have submitted.
  </Step>

  <Step title="Result is revealed">
    After both choices are locked in, the server resolves the round and broadcasts the outcome to the entire server.

    | Outcome  | Result                                            |
    | -------- | ------------------------------------------------- |
    | You win  | You receive the full pot (both bets combined)     |
    | You lose | Your opponent receives the full pot               |
    | Tie      | Both bets are returned to their respective owners |
  </Step>
</Steps>

<Note>
  The simultaneous blind pick system prevents either player from having an advantage — neither player can react to the other's choice before submitting their own.
</Note>

## Broadcasts

<CardGroup cols={2}>
  <Card title="Game Created" icon="megaphone">
    When a player creates a duel, a server-wide announcement tells everyone the creator's name and the bet amount, inviting others to join.
  </Card>

  <Card title="Result Announced" icon="trophy">
    When the round resolves, the server broadcasts both players' choices, who won (or that it was a tie), and the payout amount.
  </Card>
</CardGroup>

## Commands

| Command | Description                                                      |
| ------- | ---------------------------------------------------------------- |
| `/rps`  | Opens the Rock Paper Scissors lobby GUI to create or join a duel |

## Bet Limits

<CardGroup cols={3}>
  <Card title="Default Players" icon="user">
    **Min:** $100       **Max:** $500,000 per duel
  </Card>

  <Card title="VIP Players" icon="star">
    **Max:** \$1,000,000\
    (`casinoliric.bet.vip` permission)
  </Card>

  <Card title="Admin Players" icon="shield">
    **Max:** \$10,000,000\
    (`casinoliric.bet.admin` permission)
  </Card>
</CardGroup>

## Daily Use Limits

<CardGroup cols={2}>
  <Card title="Default Players" icon="user">
    Up to **15 duels** per day.
  </Card>

  <Card title="VIP Players" icon="star">
    Up to **50 duels** per day (`casinoliric.uses.vip` permission).
  </Card>
</CardGroup>

<Note>
  Admins with `casinoliric.uses.admin` have unlimited daily duels. All limits are configurable under `rps.uses` and `rps.bet` in `config.yml`.
</Note>

## Configuration Reference

<CodeGroup>
  ```yaml RPS settings theme={null}
  rps:
    active: true
    bet:
      default:
        min: 100.0
        max: 500000.0
      ranks:
        vip:
          permission: "casinoliric.bet.vip"
          max: 1000000.0
        admin:
          permission: "casinoliric.bet.admin"
          max: 10000000.0
    uses:
      default:
        max-uses-per-day: 15
      ranks:
        vip:
          permission: "casinoliric.uses.vip"
          max-uses-per-day: 50
        admin:
          permission: "casinoliric.uses.admin"
          max-uses-per-day: -1
  ```
</CodeGroup>

<Tip>
  If you want to apply a tax on RPS winnings, set `taxes.rps` in `config.yml` to your desired rate (e.g., `0.05` for 5 %). Taxes are only deducted from the winner's payout, not from returned bets on a tie.
</Tip>