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

# Tic Tac Toe PvP: Bet-Based Board Game in Minecraft

> Wager real in-game currency on a PvP Tic Tac Toe match played on a 3×3 inventory GUI board — ties refund both players automatically.

Tic Tac Toe in LiricCasino brings the classic 3×3 strategy game into Minecraft as a PvP bet-based match. One player creates a game and sets a wager, another player joins and matches the bet, and then the two players take turns placing their marks on an inventory GUI board. No physical setup, signs, or blocks are required — everything is handled through the plugin's GUI system. When a match concludes, the server announces the result to all online players.

## How to Play

<Steps>
  <Step title="Open the game">
    Run `/ttt` to open the Tic Tac Toe lobby. From here you can start a new match or join an open challenge from another player.
  </Step>

  <Step title="Create or join a match">
    **Creating:** Enter your desired bet amount. The server sends a server-wide broadcast so other players can see your open challenge.

    **Joining:** Select an open match from the list. Your bet must match the creator's wager before you can enter.
  </Step>

  <Step title="Take turns on the board">
    The board appears as a 3×3 inventory GUI. Players alternate turns, clicking an empty cell to place their mark (X or O). You can only click during your own turn.
  </Step>

  <Step title="Win, lose, or tie">
    The round ends as soon as one player completes a row, column, or diagonal — or all nine cells are filled.

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

<Warning>
  If you disconnect while a match is in progress, your opponent wins the pot automatically. Make sure you have a stable connection before starting or joining a match.
</Warning>

## Broadcasts

<CardGroup cols={2}>
  <Card title="Match Created" icon="megaphone">
    When a player creates a Tic Tac Toe match, a server-wide announcement shows the creator's name and the bet amount so others can join.
  </Card>

  <Card title="Result Announced" icon="trophy">
    After the match ends, the server broadcasts the winner (or that it was a draw) and the payout to all online players.
  </Card>
</CardGroup>

## Commands

| Command | Description                                               |
| ------- | --------------------------------------------------------- |
| `/ttt`  | Opens the Tic Tac Toe lobby GUI to create or join a match |

## Bet Limits

<CardGroup cols={3}>
  <Card title="Default Players" icon="user">
    **Min:** $100       **Max:** $500,000 per match
  </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 **10 matches** per day.
  </Card>

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

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

## Configuration Reference

<CodeGroup>
  ```yaml Tic Tac Toe settings theme={null}
  ttt:
    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: 10
      ranks:
        vip:
          permission: "casinoliric.uses.vip"
          max-uses-per-day: 30
        admin:
          permission: "casinoliric.uses.admin"
          max-uses-per-day: -1
  ```
</CodeGroup>

<Tip>
  To apply a tax on Tic Tac Toe winnings, set `taxes.ttt` in `config.yml` to your desired rate (e.g., `0.05` for 5 %). The tax applies only to the winner's payout — ties are always refunded in full with no deduction.
</Tip>