📂Wheel Filling

The Wheel Filling section defines how the rewards are distributed and managed inside the wheel. It allows you to control the winning logic, reward rotation, and timing — giving you full flexibility to create dynamic and engaging reward systems.

Syntax

wheel_filling:
  winning_mode: <mode>
  loadout:
    loadout_mode: <mode>
    rotate_settings:
      change_every: <time>
    data:
      "<your_id>":
        - reward: <reward_id>
          <variable_key>: <variable_value>
          chance: <decimal>% # only for chance mode
          capacity: <number> # only for capacitzy mode
        - ...

---

winning mode

Default: RANDOM

Determines how rewards are selected when a player spins the wheel.

Available modes:

• RANDOM – Rewards are picked completely at random, like a realistic spinning wheel.

• CHANCE – Each reward has its own chance value that determines the probability of being won.

• CAPACITY – Each reward can be configured to appear a fixed number of times within a total number of spins.

FOR CHANCE MODE

Chance mode requires each reward to have its own chance value (format: 0.00%) set

FOR CAPACITY MODE

Capacity mode requires each reward to have its own capacity value set

---

loadout mode

Default: STATIC

Loadout is a set of rewards in number of wheel fields, that can be loaded into the wheel and then used by players.

Available modes:

• STATIC – A simple, single loadout that never changes.

• ROTATING – The wheel automatically switches between different loadouts at a set interval.

---

rotation settings

Defines how often loadouts change (only used if loadout_mode is set to ROTATING).

option change every supports 2 different times of time value that defines how often will be the loadouts switched to other ones

Dynamic change:

• Time value will be automatically rounded to closest midnight so wheel resets at new day

• available values: DAY, WEEK. MONTH, YEAR

Fixed time:

• Specific time value that will loadout use after last reset

• example: 1d 10s (based on first run)

• Format: 0y 0m 0w 0d 0h 0s