> 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/config-reference/tweaking-games/slots.md).

# Slots

Slot machine presets, bet levels, symbols and the progressive jackpot pot.

Individual machine placement, VIP, society and which preset a machine uses are set on the [Slots editor page](https://documentation.rcore.cz/paid-resources/rcore_casino/features/editor/slots.md). This page covers the settings that shape every preset: bet limits, the paytable, reel odds and the shared jackpot pool.

Main config file: `configs/games/slots.lua`, table `SlotPresets`.

## Presets

Each entry in `SlotPresets` is one machine type's ruleset. The editor's Preset dropdown picks one of these for a given machine; add a new entry here to create a new ruleset.

<table data-full-width="false"><thead><tr><th>Preset field</th><th>Info</th></tr></thead><tbody><tr><td><code>name</code></td><td>Display name shown in the editor's Preset list.</td></tr><tr><td><code>symbols</code></td><td>Exactly 8 symbols, in the fixed order below.</td></tr><tr><td><code>themedSymbol</code></td><td>This preset's special symbol. Falls back to the 4th entry in <code>symbols</code> if left out.</td></tr><tr><td><code>jackpotSymbol</code></td><td>This preset's jackpot symbol. Falls back to the 5th entry in <code>symbols</code> if left out.</td></tr><tr><td><code>profile</code></td><td>Which shared reel weight table this preset uses: <code>SlotProfile.Steady</code>, <code>.Balanced</code> or <code>.Swingy</code>. More in <a href="#reel-odds">Reel odds</a>.</td></tr><tr><td><code>maxBet</code></td><td>The top bet level. More in <a href="#bet-limits">Bet limits</a>.</td></tr><tr><td><code>targetRtp</code></td><td>The payback this machine is tuned to, as a fraction. <code>0.80</code> means 80%. This is the main dial. More in <a href="#payback">Payback</a>.</td></tr></tbody></table>

## Symbols

`symbols` must list exactly 8 entries, in this order:

<table data-full-width="false"><thead><tr><th width="90">Position</th><th width="200">Role</th><th width="350">Symbol</th></tr></thead><tbody><tr><td>1</td><td>Seven</td><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-ab76c194a91b52be93ccfb138ff2c4f27b7cb9e8%2Fseven.png?alt=media" alt="" data-size="original"></td></tr><tr><td>2</td><td>Plum</td><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-ea4a45c7bc527307bd7d4d527799eae4e00cdb5e%2Fplum.png?alt=media" alt="" data-size="original"></td></tr><tr><td>3</td><td>Melon</td><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-60b773f4b76496d1cc85ff0312ea247b9578c4f9%2Fmelon.png?alt=media" alt="" data-size="original"></td></tr><tr><td>4</td><td>Special (<code>themedSymbol</code>)</td><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-2abe8c3ef063dc9ee63e2569f6705d9a96dac18c%2Fspecials_strip.png?alt=media" alt="" data-size="original"></td></tr><tr><td>5</td><td>Jackpot (<code>jackpotSymbol</code>)</td><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-dc3075836f19b9371a067676d434bb996edc4371%2Fjackpot_strip.png?alt=media" alt="" data-size="original"></td></tr><tr><td>6</td><td>Cherry</td><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-a04a873b5e872467fa578f0eacc49972c9b8375d%2Fcherries.png?alt=media" alt="" data-size="original"></td></tr><tr><td>7</td><td>Bell</td><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-313101d0d66ffd3370404957c0f3c6d22e828547%2Fbell.png?alt=media" alt="" data-size="original"></td></tr><tr><td>8</td><td>Blank</td><td>-</td></tr></tbody></table>

Positions 4 and 5 are the two a preset chooses for itself. The strips show every symbol the default presets use in those two positions.

{% hint style="danger" %}
This order is what maps each entry to its payout multiplier and its reel weight. Reordering `symbols`, or leaving an entry out, changes which symbol behaves how even if the symbol names themselves are unchanged.
{% endhint %}

### Default presets

<table data-full-width="false"><thead><tr><th>Preset key</th><th>Max bet</th><th>Profile</th><th>Special</th><th>Jackpot</th></tr></thead><tbody><tr><td><code>angel_knight</code></td><td>500</td><td>Balanced</td><td>Star</td><td>Piano</td></tr><tr><td><code>impotent_rage</code></td><td>125</td><td>Balanced</td><td>Flash</td><td>Face</td></tr><tr><td><code>space_rangers</code></td><td>125</td><td>Balanced</td><td>Bottle</td><td>Medal</td></tr><tr><td><code>fame_or_shame</code></td><td>25</td><td>Steady</td><td>Microphone</td><td>Text</td></tr><tr><td><code>deity_of_the_sun</code></td><td>2500</td><td>Swingy</td><td>Ankh</td><td>Pharaoh</td></tr><tr><td><code>twilight_knife</code></td><td>500</td><td>Balanced</td><td>Knife</td><td>Saw</td></tr><tr><td><code>diamond_miner</code></td><td>2500</td><td>Swingy</td><td>Diamond</td><td>Diamonds</td></tr><tr><td><code>evacuator</code></td><td>25</td><td>Steady</td><td>Soldier</td><td>Rocket</td></tr></tbody></table>

## Bet limits

A machine offers five bet levels, each a fifth of its preset's `maxBet`. There is no separate minimum. If `maxBet` doesn't divide by five, each level is rounded down on its own, so `maxBet = 26` gives 5, 10, 15, 20 and 26.

With `maxBet = 500` the levels are 100, 200, 300, 400 and 500.

## Paytable

What a spin pays is shared by every preset. Only the artwork differs; the multipliers below are fixed in `const.lua` (`SlotPayoutMultipliers`).

<table data-full-width="false"><thead><tr><th>Role</th><th>Three of a kind pays</th></tr></thead><tbody><tr><td>Seven</td><td>250 × bet</td></tr><tr><td>Bell</td><td>100 × bet</td></tr><tr><td>Melon</td><td>75 × bet</td></tr><tr><td>Plum</td><td>50 × bet</td></tr><tr><td>Cherry</td><td>25 × bet</td></tr><tr><td>Special</td><td>500 × bet</td></tr><tr><td>Jackpot</td><td>1000 × bet, but only through the jackpot pool below, never as a natural three of a kind. More in <a href="#reel-odds">Reel odds</a>.</td></tr><tr><td>Blank</td><td>Nothing</td></tr></tbody></table>

The special symbol also pays on a partial match: 1 symbol pays 2 × bet, 2 symbols pay 5 × bet (`SlotThemedPartialMultipliers` in `const.lua`). A spin is resolved in this order: a partial or full match on the special symbol first; otherwise three of a kind on whichever symbol matched all three reels; otherwise nothing.

## Payback

`targetRtp` is the share of everything wagered on a machine that comes back to players over the long run. Set it to the payback you want:

```lua
targetRtp = 0.80,   -- 80% payback
```

{% hint style="info" %}
The figure includes the jackpot. An 80% machine's reels pay about 77.5%, and the casino's jackpot pool pays the other 2.5%.
{% endhint %}

### Accepted values

Accepted values run from `0.5` to `0.98` - 50% to 98% payback (`SlotTargetRtpRange` in `const.lua`). A preset with no `targetRtp` uses `SlotDefaultTargetRtp`, which is `0.80`.

Anything else is ignored. The machine falls back to the profile's shipped weights and says so in the server console:

```
[Casino] slot preset 'angel_knight': targetRtp 0.3 rejected, using the shipped weights
```

## Reel odds

A preset's `profile` field picks one of three characters. All three pay back whatever `targetRtp` says. What changes is how that payback arrives. The hit rates below are at the default 80% payback.

<table data-full-width="false"><thead><tr><th width="160">Profile</th><th width="140">Pays on</th><th>Feel</th></tr></thead><tbody><tr><td><code>SlotProfile.Steady</code></td><td>27% of spins</td><td>Frequent small wins. Suits low bet machines where players spin a lot.</td></tr><tr><td><code>SlotProfile.Balanced</code></td><td>24% of spins</td><td>The middle ground.</td></tr><tr><td><code>SlotProfile.Swingy</code></td><td>18% of spins</td><td>Long dry spells, bigger payouts. Suits high bet machines.</td></tr></tbody></table>

{% hint style="danger" %}
The weight tables behind these profiles are in `const.lua` and are best left alone. The script rescales them to hit `targetRtp`, so editing them doesn't change payback. If it can't hit the target with your table, the machine uses your table as it is.
{% endhint %}

## Progressive jackpot

The jackpot isn't per machine. Every slot machine in a casino, whatever preset it's running, pays into and can pay out from that casino's pool. Each casino has its own pool, and a new casino starts with a fresh one. Settings live in `SlotJackpotSettings` in `const.lua`.

<table data-full-width="false"><thead><tr><th>Setting</th><th>Default</th><th>Effect</th></tr></thead><tbody><tr><td><code>ContributionRate</code></td><td>0.025</td><td>Share of every real money bet, on every machine, added to the pool. Free spins add nothing.</td></tr><tr><td><code>GapMin</code></td><td>0.5</td><td>Earliest the jackpot can fall due again, as a multiple of the pool's average payout.</td></tr><tr><td><code>GapMax</code></td><td>1.5</td><td>Latest it can fall due, measured the same way.</td></tr><tr><td><code>PayoutSmoothing</code></td><td>0.15</td><td>How quickly the pool's idea of its own average payout reacts to a new win. Higher reacts faster.</td></tr></tbody></table>

Each time the jackpot is won the pool sets itself a new target: what is left in the pool plus somewhere between `GapMin` and `GapMax` times its average payout. Once the balance passes that target and can cover 1000x the current bet, the jackpot symbol lands on all three reels on the next paid spin. Free spins never trigger it.

## Other settings

`SlotSettings.SwitchToFirstPerson` switches the camera to first person while a player sits at a machine, and back when they leave. Default `true`.
