# Controls

## Fields

Fields define amount of rewards, that wheel will hold. You can set unlimited amount of rewards, but we advice to use maximum of 12 if you want to connect it with texture and 30 if you dont mind about the texture

30 is our limit, bcs then the displays can cause lags. (internet drops/high ping for players)

## Roll time 

Roll time define the min and max time of wheel roll during max speed.

Roll time is defined in ticks. When roll time ends, wheel will start slowing.

## Max speed

Maximal speed, that can the wheel can make by tick. So it is something like angle step per tick. 

## Random on max

(this segment is used only if you are using RANDOM wheel type)

It randomly move with max speed during the roll time to randomize the wheel correctly. We recommend you to use at least 5.0 value

## Slowing factor

This value define how fast will the wheel stop after the roll time ends. \
Higher value == Faster slowing.

Some good presets: (from max speed 40)

```
Fast stop - 1.0
Ideal stop - 0.55
Slow stop - 0.3
```

## Reward display

Reward display is created with packet entites (Item displays). \
syntax:

```yaml
reward-display:
    use: true
    scale: 0.8
    distance: 2.0
    change-interval: 40
```

use - enables/disables the feature\
scale - size of the items\
distance - distance of the display from the middle of the wheel\
change-interval - time in ticks for animated icons change

## Custom arrow (From BETA-1.7)

Now you can set your own arrow texture using all item setting from [there](/fortunewheel/rewards/rewards-basics.md#material)\
syntax:

```yaml
custom-arrow:
  material: LEVER
```

## Win animations

These animations run after player receive reward when spin for something in the weel.

types:\
\- CANNON (Items cannon from the wheel)\
\- FIREWORKS (Fireworks fire from the sides of the wheel)\
\- REWARD\_RAIN (Rain of winned item)\
\- LIGHTNING (strike to the center of the wheel)

{% hint style="warning" %}
We recommend using a maximum of 2 animations per round!
{% endhint %}

{% tabs %}
{% tab title="Cannon" %}

```yaml
  win-animations:
    cannon:
      type: CANNON
      randomizer: 8.0
      amount: 2
      materials:
        - WHITE_CONCRETE
        - LIGHT_BLUE_CONCRETE
        - LIME_CONCRETE
        - RED_CONCRETE
        - PINK_CONCRETE
```

{% endtab %}

{% tab title="Fireworks" %}

```yaml
  win-animations:
    fireworks:
      type: FIREWORKS
      power: 2
      effects:
        "1":
          type: BALL
          color:
            r: 67
            g: 237
            b: 240
        "2":
          type: STAR
          flicker: true
          color:
            r: 242
            g: 36
            b: 180
          fade:
            r: 67
            g: 237
            b: 240
```

{% endtab %}

{% tab title="REWARD\_RAIN" %}

```yaml
  win-animations:
    fireworks:
      type: REWARD_RAIN
      particles: true
      radius: 4.0
```

{% endtab %}

{% tab title="Fireworks" %}

```yaml
  win-animations:
    fireworks:
      type: LIGHTNING
```

{% endtab %}

{% tab title="Particle Explode" %}

```yaml
PARTICLE_EXPLODE:
  type: PARTICLE_EXPLODE
  stripes: 20
  size: 1.2
  color: 
    r: 1
    g: 1
    b: 1
```

{% endtab %}
{% endtabs %}


---

# 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://wiki.gennario.eu/fortunewheel/wheels/controls.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.