A downloadable game for Windows, macOS, Linux, and Android

🎰 Lucky Wheel Deluxe

A fully customizable multi-wheel spin game with auto-saving, chain linking, and special prize history — all running 100% client-side.

🧠 Overview

Lucky Wheel Deluxe is a web-based spin game and management tool that lets players create and play unlimited customizable spin wheels. It combines the fun of random luck with the flexibility of your own data system.

🎯 No backend, no login, no server — just open and play.

🎮 Gameplay

🌀 1. The Spin Wheel

Choose a wheel inside any folder.
Press SPIN to randomly select a segment.
The result is displayed with a message.
If that option is marked as Special, it is stored in the Special History section.
If that option is linked to another wheel, the game automatically switches to that wheel after 2 seconds — creating a chain-spin system.

🗂️ 2. Folder Management

Organize your wheels into folders.

Each folder contains multiple wheels.
You can add or delete folders.
When deleting a folder, any linked wheels inside it will be automatically unlinked from other options.
Each folder also keeps its own Special History and settings.

🎡 3. Wheel Management

Each wheel can have:

A custom name
Multiple options (each with its own label, color, and link)
Linked wheels for chain spins
Special tags for special prize tracking

You can:

➕ Create new wheels
❌ Delete wheels
🧩 Copy an existing wheel (duplicates all options with new IDs)

🧩 4. Option Management (LC)

Each wheel contains a list of “options”:

Add new options with a label and color.
Mark an option as Special (checkbox).
Link an option to another wheel (chain spin).
Delete or edit any option.

📜 5. History System

There are two independent history systems:

🔹 Normal History

Logs every spin result that isn’t special.
Shows newest entries on top.
“Clear” button to reset.

🔸 Special History

Logs only results from options marked “Special”.
Stored per folder (each folder has its own special log).
Includes a field “Max Records” (default 10, adjustable).
Results appear newest-first.
“Clear Special History” button available.

💾 6. Data Saving & Sharing

All data is saved automatically in your browser using LocalStorage:

Folders, wheels, options, history, and special settings.
No data loss on reload.
Export all data as a .json file.
Import data from a saved file to continue or share with friends.

🧱 Technical Overview

🧩 Technology Stack

HTML5 + JavaScript (ES Modules)
TailwindCSS (via CDN)
100% Client-side — no backend required.

⚙️ Data Structure

{   meta: "lucky_wheel_data_v2",   categories: [     {       id, name,       wheels: [         { id, name, options: [{ id, label, color, nextWheelId, isSpecial }] }       ],       specialHistory: [{ wheelName, result, timestamp }],       specialLimit: 10     }   ],   currentCategoryId,   currentWheelId,   history: [...] }

🧩 Key Functions

Draws the spin wheel on the canvas.
Executes random spin, triggers result display.
Displays and logs results.
Updates the normal history list.
Updates the special history panel.
Create new folders and wheels.
Duplicate the current wheel.
Mark or unmark an option as special.
Adjust the max number of special records per folder.
Persist all data automatically.

Purpose
drawWheel()
spin()
displayResult()
renderHistory()
renderSpecialHistory()
addNewCategory() / `addNewWheel()`
copyCurrentWheel()
toggleSpecialOption()
updateSpecialLimit()
saveDataToLocalStorage() / `loadDataFromLocalStorage()`

💡 Features Summary

✅ Multi-folder & multi-wheel system ✅ Full customization of colors, names, and links ✅ Special results tracking per folder ✅ Adjustable special history limit ✅ Copy / Export / Import data ✅ Fully offline ✅ Clean responsive UI built with TailwindCSS

💥 Future Ideas

🌀 Real spinning animation (physics-based easing)
🔊 Sound effects and victory jingle
📊 Statistics dashboard (counts, win rate, etc.)
🎮 “Chain Mode” with multiple wheels auto-connected
🌈 Themes and color presets

📦 Game Info

Title
Lucky Wheel Deluxe
Platform
Web (HTML5)
File
Engine
JavaScript (Vanilla + TailwindCSS)
Save System
LocalStorage (automatic)
Language
Vietnamese / English compatible
Compatibility
Chrome, Edge, Firefox, Safari

NOTE FOR OFF VERSION:style.css is needed to run the gameoff file (to run offline)

AFTER V3.6 LOCAL STORAGE HAS BEEN DELETED FOR MORE SECURE

OR YOU CAN DOWNLOAD FULLY OFFLINE VERSION-.ONLY NEED TO EXTRACT