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. ItemField2 through ItemField16 Exact class spawned when the matching normal field wins. ItemFieldJackpot Reward pool used when the wheel lands on field 1. One array entry is selected randomly. Reward Weighting To increase how often a normal reward appears, assign the same class to several normal fields. To weight a reward inside the jackpot pool, repeat its class: "ItemFieldJackpot": [ "NailBox", "NailBox", "SledgeHammer", "Whetstone" ] This gives NailBox two of four jackpot-pool entries. Never leave ItemFieldJackpot empty. WheelData.json This file stores: Server date used for last reset Steam64 IDs that already spun Documentation and Support Full documentation: RaG Wheel of Fortune Documentation Support: RaG Discord Please use Discord for support. Steam friend invitations are not accepted for troubleshooting. Donations: Support RaG Tyson on Ko-fi Permissions Do not repack, reupload, or redistribute this mod Do not monetize this mod or its contents Use on an approved monetized server is allowed when the mod itself is not part of monetization Repack requests will be ignored. Bohemia Interactive monetization rules: Server Monetization Information