ZFFortuneWheel

Wheel of Fortune:

A beautiful way to treat players (if luck is on their side) with bonuses.

The object **ZFFortuneWheel** can be placed anywhere you need using **ObjectBuilder**, for example.

How it works:
The player uses the **"Try Your Luck"** action, after which the wheel spins for a certain amount of time, gradually slowing down until it comes to a complete stop. The arrow then determines a number, the player receives a notification about the result, and a random item corresponding to the rolled category is awarded.

There is **sound accompaniment** (clicking sounds slowing down with the rotation, music during spinning, a sound signal when the category is determined, and a unique sound for the rarest **"Mega Prize"** category (the rarest since it appears on the wheel only **once**, unlike other categories)).
During the spin, **lights illuminate and blink**, and in the case of a **"Mega Prize"**, the **top lights will additionally blink**. The wheel itself has **glowing visual effects**, making it look beautiful and useful in the dark.

You can add **multiple items to each category**, specify **exact or random** amounts, as well as **exact or random** quantity for each item.

Example configuration:

"2": [
{
"itemName": "ACOGOptic", - class name
"countRange": [], - minimum, maximum. If left empty, it defaults to 1.
"quantityRange": [] - minimum, maximum. Can be left empty.
"attachments": [] - array of attachments for the item.
},
{ - For example, if this category is rolled and this item is selected, the player will receive from 1 to 4 magazines, each with between 5 and 30 rounds.
"itemName": "Mag_AK101_30Rnd",
"countRange": [
1,
4
],
"quantityRange": [
5,
30
]
}
]


Adding attachments to items:

{
"itemName": "AK101",
"countRange": [],
"quantityRange": [],
"attachments": [
"Mag_AK101_30Rnd",
"KashtanOptic"
]
}


You can also **add vehicles** as rewards – for this, you need to **specify spawn coordinates** in the configuration (parameter **positionForCarSpawn**).

The configuration file will be created upon the first **server launch** with the mod, located in your profile folder:
**ZFFortuneWheel → config.json**
Here, you can configure **rewards for each category**, specify **spawn coordinates for vehicles**, and set a **cooldown (in hours) between spins** for players.

**Repacking into your mod pack is prohibited.**