# Blackjack

**Blackjack** is a card game where players try to beat the dealer without going over 21.

## What game is it?

This implementation is classic casino blackjack with house rules defined in locale/config:

* Four standard 52-card decks.
* Dealer stands on soft 17.
* Split is allowed once (when opening two cards match in value).
* Double Down is available after initial deal (and after split when allowed).
* Seven-card Charlie is enabled (7 cards without bust = automatic win).

## How to play

1. Place a bet before the betting timer ends.
2. Receive two cards.
3. Choose action:
   * **Hit** to take another card.
   * **Stand** to keep your total.
   * **Double Down** to double bet and take one final card.
   * **Split** when initial cards are same value.
4. Dealer resolves hand according to dealer rules.
5. Hand is settled.

## Payout and settlement basics

* Blackjack (natural 21) pays **3:2**.
* Regular win pays **1:1** (even money).
* Push returns your stake.
* Bust (>21) loses the hand.

## Where to configure Blackjack

Main config file:

* `rcore_casino/configs/blackjack.lua`

Important sections:

* `BlackjackConfigs` (stakes, timers, limits, RTP/bias tuning)
* `Blackjacks` (table instances placed in world)
* `BlackjackPlayableHashes` (playable table models -> default config)
* `BlackjackSettings`, `BlackjackPedModels`, `BlackjackAmbientPeds`

Rules/welcome text displayed to players is localized in:

* `rcore_casino/locales/en.lua` (keys like `BLACKJACK_WELCOME`, `BLACKJACK_RULES_FULL`)

## Example config instance

```lua
Blackjacks = {
  ["bj1"] = {
    name = "Blackjack 1",
    coords = vec3(-80.811447, -822.497437, 325.175598),
    heading = 108.60414123535,
    model = "vw_prop_casino_blckjack_01",
    config = "normalstakes",
    pedModel = "S_F_Y_Casino_01",
    pedSkinId = 1,
    vip = false,
    societyEnabled = false,
    societyName = "Society Name",
    proximity = 5.0,
    loadInInterior = true,
    isAmbient = false
  }
}
```