RaG_Wheel_Of_Fortune

RaG Wheel of Fortune

RaG Wheel of Fortune adds a server-placed prize wheel with configurable rewards, spinning animations, sounds, confetti, jackpot effects, and persistent daily player tracking.

Each player receives one recorded spin per server day across every Wheel of Fortune placed on the server.

HOW IT WORKS Approach wheel → Select Spin Wheel → Wheel spins for random duration → Physical field determines reward → Prize appears on ground → Daily spin is recorded

Required Mod

RaG Core

RaG Wheel of Fortune and RaG Core are required on both server and clients.

Addon dependencies are declared through CfgPatches.requiredAddons. Server command-line mod order does not control PBO loading.

Features

• Animated 16-field prize wheel
• 15 configurable normal rewards
• Separate configurable jackpot reward pool
• Random configurable spinning duration
• One recorded spin per Steam64 ID and server day
• Daily spin history survives server restarts
• Shared eligibility across every placed wheel
• Custom spinning, result, and jackpot sounds
• Confetti for normal rewards
• Red fireworks effect for jackpots
• Optional global jackpot notification
• Support for vanilla and modded ItemBase rewards

Player Guide

1. Approach the Wheel

Stand within normal interaction range and select:

Spin Wheel

No item is required in your hands.

A wheel cannot be used while it is already spinning or during its five-second result cooldown.

2. Your Spin Is Recorded

Your Steam64 ID is recorded immediately when the spin begins.

The daily limit is shared across the entire server:

• Using another wheel does not grant another spin
• Changing character does not bypass the limit
• Reconnecting does not grant another spin
• Restarting the server does not restore a same-day spin

A second attempt displays:

You have already spun the wheel today.

3. The Wheel Selects a Reward

The wheel spins for a random duration between the configured minimum and maximum times.

When it stops, the physical field under the arrow determines the result.

The wheel contains:

• Field 1 — Jackpot
• Fields 2–16 — Normal rewards

There are no published percentage values for individual fields. Result comes from the wheel's physical landing position.

4. Collect the Prize

A successful reward appears on the ground beside the wheel.

Important:

• Prize is not inserted into player inventory
• Prize is not reserved for the winner
• Another player can pick it up
• Prize needs clear ground around the wheel

Normal rewards play the result sound and confetti effect.

Jackpots play a separate sound, create a red fireworks effect, and can broadcast the winner and prize globally.

Fireworks are cosmetic and cause no explosion damage.

Daily Reset Behavior

Daily eligibility uses the server machine's calendar date—not client time or accelerated in-game time.

CURRENT LIMITATION Date reset is checked when the spin manager starts. A server left running across midnight does not automatically recheck the date. For predictable daily resets, schedule a normal server restart after server-local midnight.

Server Setup

Place the following class as a static world object using your map editor, object loader, admin mapping tool, or mission code:

RaG_Wheel_Of_Fortune

The internal animated wheel is created and locked automatically:

RaG_Fortune_Wheel

Do not place or distribute the internal wheel separately.

Adding only the main class to types.xml does not provide usable map placement. This is a static building object, not normal economy loot.

Multiple wheels can be placed. Each has its own animation and cooldown, but every wheel shares the same daily player list.

Server Configuration

Main reward configuration:

$profile:\RaG_Core\Configs\RaG_Wheel_Of_Fortune\RaG_Wheel_Of_Fortune.json

Daily runtime data:

$profile:\RaG_Core\Configs\RaG_Wheel_Of_Fortune\WheelData.json

Stop the server before editing either file.

Default Reward Configuration

{
    "Version": 1,
    "MinSpinningTime": 7.0,
    "MaxSpinningTime": 18.0,
    "EnableAnnounceJackpot": 1,
    "ItemField2": "GorkaHelmet",
    "ItemField3": "Canteen",
    "ItemField4": "DuffelBagSmall_Green",
    "ItemField5": "BandageDressing",
    "ItemField6": "TetracyclineAntibiotics",
    "ItemField7": "HuntingOptic",
    "ItemField8": "MedievalBoots",
    "ItemField9": "BDUJacket",
    "ItemField10": "Hammer",
    "ItemField11": "Wrench",
    "ItemField12": "SledgeHammer",
    "ItemField13": "Hatchet",
    "ItemField14": "Screwdriver",
    "ItemField15": "LugWrench",
    "ItemField16": "NailBox",
    "ItemFieldJackpot": [
        "NailBox",
        "SledgeHammer",
        "Hacksaw",
        "Whetstone"
    ]
}

Settings

MinSpinningTime Minimum spinning duration in seconds.

Default:

7.0

MaxSpinningTime Maximum spinning duration in seconds.

Default:

18.0

A random duration between both values is selected for each spin.

Keep both values non-negative and make sure:

MinSpinningTime <= MaxSpinningTime

EnableAnnounceJackpot

• 1 — Broadcast winner name and jackpot prize
• 0 — Disable global jackpot notification

This only controls the notification. Jackpot prize, sound, and fireworks remain active.