> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_casino/features/welcome-bonuses.md).

# Welcome Bonuses

Configuring Welcome Bonuses for First-Time Casino Players

<figure><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-7f01a152f3ff68aacabd3a3efda224ec080d6471%2Fcapt_bonuses.png?alt=media" alt=""><figcaption></figcaption></figure>

New players get a starter pack of bonuses the first time they join the casino, so they can try the games without buying anything.

## Where to configure

Set it in `WelcomePack` in `configs/config.lua`:

```lua
WelcomePack = {
    ["wheeltickets"] = 3,
    ["horsetickets"] = 1,
    ["chips"] = 5000,
},
```

## Bonus types

These are the five bonus keys the casino knows about. Any of them can be used in `WelcomePack`.

<table data-full-width="false"><thead><tr><th>Bonus key</th><th>Used for</th><th>Notes</th></tr></thead><tbody><tr><td><code>chips</code></td><td>Casino chip balance bonus</td><td>Held as a separate bonus-chip balance and spent before the player's regular chips</td></tr><tr><td><code>wheeltickets</code></td><td>Lucky Wheel ticket count</td><td>Spends one ticket for a free spin on wheels that have <code>canUseFreeSpins</code> enabled</td></tr><tr><td><code>horsetickets</code></td><td>Inside Track ticket count</td><td>Spends one ticket for a free Inside Track bet</td></tr><tr><td><code>slotspins</code></td><td>Free slot spins</td><td>Spends one free spin instead of paying for the spin</td></tr><tr><td><code>drinks</code></td><td>Free drinks at the bar</td><td>Spends one drink on any bar item with <code>canBuyWithBonus = true</code>. This is what the Lucky Wheel's DRINKS slice awards</td></tr></tbody></table>

{% hint style="info" %}
Bonuses are not limited to the welcome pack. Players also get bonus chips from the cashier's daily bonus and bonuses from Lucky Wheel rewards, and admins can give them in the admin console or with `GivePlayerBonus` on the `GetCasinoControl` export.
{% endhint %}

### Bonus chips belong to one casino

Bonus chips can only be spent in the casino that gave them. Welcome pack chips belong to the default casino, the `general` preset in the editor. More in [Presets](https://documentation.rcore.cz/paid-resources/rcore_casino/features/editor.md#presets).

Wheel tickets, horse tickets, free spins and drinks work in every casino.

### Bonus chips cannot be traded in

Bonus chips can never be exchanged for money at the cashier. Trade-in counts real chips only, so a player holding nothing but bonus chips has nothing to cash out, whatever total the HUD is showing.

The only way to turn a bonus chip into something withdrawable is to bet it. Winnings are always credited as real chips no matter what was staked, so a bonus chip that wins comes back as a real chip, and real chips trade in normally.
