# Slot Machine Odds & Payout Configuration

### High‑Level Concepts

#### RTP (Return to Player)

* RTP is the **long‑term average payout** of the machine.
* Example: **96% RTP** means that for every $100 wagered over time, $96 is paid back to players.
* **RTP is not affected by max bet size**.
  * Increasing max bet only increases *volatility* (bigger wins & losses).

👉 If players are winning too much *too fast*, the issue is **odds and multipliers**, not RTP alone.

***

### How Winning Works

A win occurs when:

1. A **payline** matches the same symbol across enough reels
2. The match count meets `paylineWinThreshold`
3. The corresponding **multiplier** is applied to the bet

***

### Key Configuration Sections

#### 1️⃣ `reels` — Symbol Appearance Odds

```lua
reels = {10, 10, 10, 10, 10}
```

* Each number represents the **relative chance** of that symbol appearing on each reel.
* **Higher number = higher chance**
* **Lower number = rarer symbol**

Example:

```lua
reels = {15, 12, 10, 10, 15}
```

* Reel 1 & 5 → more likely
* Reel 3 & 4 → less likely

📉 **Lowering these values reduces win frequency**.

***

#### 2️⃣ `pay` — Payout Multipliers (Per Reel Count)

```lua
pay = {0, 0, 0.2, 0.35, 1.25}
```

Each index represents the **multiplier based on how many matching reels you hit**:

| Matches | Multiplier |
| ------- | ---------- |
| 1       | 0x         |
| 2       | 0x         |
| 3       | 0.2x       |
| 4       | 0.35x      |
| 5       | 1.25x      |

#### Example Calculation

* Bet: $10
* Hit 3 symbols → `0.2x`
* Payout: `$10 × 0.2 = $2`

⚠️ This means **not every win is profitable** — low multipliers intentionally cause losses.

📉 **Lowering pay values reduces payout size**.

***

#### 3️⃣ Bonus Symbols & Bonus Odds

```lua
["Bonus Symbol"] = {
    image = "bonus.png",
    reels = {8, 8, 1, 1, 1},
    pay = {0, 0, 0, 0, 0},
}
```

**How Bonus Odds Work**

* Bonus symbols **use the same reel odds system**
* In this example:
  * Reels 1 & 2 → common
  * Reels 3–5 → rare

This creates a **"tease effect"** where players frequently see partial bonuses.

**Reducing Bonus Frequency**

To make bonuses harder to hit:

```lua
reels = {4, 4, 1, 1, 1}
```

✅ This **halves bonus chance**\
❌ Does NOT affect normal symbol odds

***

#### 4️⃣ `bonusFreeSpins`

```lua
bonusFreeSpins = 15
```

* Controls how many free spins are awarded
* Directly affects profitability

📉 Reducing this is one of the **safest ways** to lower payout without impacting normal gameplay.

***

#### 5️⃣ Paylines & Win Frequency

```lua
paylines = {
  {1,1,1,1,1},
  {0,0,0,0,0},
  {2,2,2,2,2},
  ...
}
```

* More paylines = more chances to win
* Fewer paylines = lower hit rate

📉 Removing high‑coverage paylines reduces win frequency.

***

### How to Reduce Player Profitability (Recommended Order)

If players are winning too much:

#### ✅ Best Options (Safe)

1. Lower **bonus symbol reel odds**
2. Reduce **bonusFreeSpins**
3. Slightly reduce **high‑tier multipliers** (4–5 matches)

#### ⚠️ Use Carefully

* Lowering base symbol odds too much can make machines feel "dead"
* Over‑nerfing RTP causes player churn

***

### Common Misconceptions

❌ "Max bet affects RTP"\
✔️ Max bet only affects volatility

❌ "You only win with 5 symbols"\
✔️ You can win with 3+, depending on `pay`

❌ "Pay is per reel"\
✔️ Pay is **based on total matching reels on a payline**

***

### TL;DR

* `reels` → controls **how often** symbols appear
* `pay` → controls **how much** they pay
* Bonus symbols use the same odds logic
* RTP stays constant unless you rebalance payouts

If bonuses are too profitable: **make them rarer, not bigger**.

***

If you want, this doc can be expanded with:

* RTP math examples
* Recommended default tuning values
* "High volatility" vs "casual" presets


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.picklemods.com/paid-resources/casinos/slot-machine-odds-and-payout-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
