# Poker

This casino poker mode is **Three Card Poker** against the dealer.

## What game is it?

Players can bet:

* **Ante** (main bet)
* **Pair Plus** (side bet)
* or both

After cards are dealt, players who placed Ante choose whether to continue with a **Play** bet (equal to Ante) or fold.

## How to play

1. Place Ante, Pair Plus, or both.
2. Receive three cards.
3. If Ante was placed, either:
   * Place **Play** bet equal to Ante, or
   * Fold (lose Ante).
4. Dealer reveals hand and must qualify with **Queen high or better**.
5. Bets resolve by hand comparison and payout tables.

## Payout basics

* Ante + Play win pays **1:1** when player beats dealer.
* If dealer does not qualify, Ante pays **1:1** and Play is returned.
* Pair Plus is independent of dealer hand and pays from **Pair** or better.
* Ante Bonus is paid for **Straight** or better.

Pair Plus examples:

* Straight Flush: **40:1**
* Three of a Kind: **30:1**
* Straight: **6:1**
* Flush: **4:1**
* Pair: **1:1**

## Where to configure Poker

Main config file:

* `rcore_casino/configs/poker.lua`

Important sections:

* `PokerConfigs` (bet limits, timers, unlucky round, RTP/bias tuning)
* `Pokers` (table instances placed in world)
* `PokerPlayableHashes` (playable table models -> default config)
* `PokerSettings`, `PokerPedModels`, `PokerAmbientPeds`

Rules/welcome text shown to players is localized in:

* `rcore_casino/locales/en.lua` (keys like `POKER_WELCOME`, `POKER_RULES`)

## Example config instance

```lua
Pokers = {
  ["pk1"] = {
    name = "Poker Table 1",
    coords = vec3(-79.481476, -817.966919, 325.175537),
    heading = 108.60414123535,
    model = "vw_prop_casino_3cardpoker_01",
    config = "normalstakes",
    pedModel = "S_F_Y_Casino_01",
    pedSkinId = 1,
    isMap = false,
    vip = false,
    societyEnabled = false,
    societyName = "Society Name",
    proximity = 5.0,
    loadInInterior = true,
    isAmbient = false
  }
}
```