# 🎡 Wheel of Fortune — The Ultimate FiveM Game Show Script
Bring the classic TV game show to your city. Players spin a real 3D wheel (or jump in instantly with `/wof`), guess letters, buy vowels, and race to solve the puzzle before their opponents — with card power-ups, bots, achievements, and even **live Twitch chat voting**.
---
## 🎥 Preview
[Paste your YouTube showcase video link here — Discourse will auto-embed it]
## 📷 Screenshots
[Add 3–6 screenshots here: the physical wheel, the NUI board, card pack opening, the placement editor, the Twitch vote overlay]
---
## ✨ Features
**🎮 Two Ways to Play**
- Real 3D physical wheel prop — place it anywhere on the map, players walk up and actually spin it, synced across a big wall screen and a table screen
- Instant command mode — `/wof` opens a 2–3 player table anywhere, no physical prop required
**🟣 Twitch Integration**
- Streamers connect their channel right from the menu
- Hit "Ask Chat" and viewers vote on the next letter by typing `!letter A` in chat (command is translatable)
**🤖 Bots**
- Fill empty seats with AI opponents
- Easy / Normal / Hard difficulty, each with its own reaction time and accuracy rate
**🃏 Card System**
- 10 unique cards across 5 rarities (Common → Legendary)
- Openable packs (Basic / Premium / Legendary) with pull animations
- Effects: extra time, score multipliers, free vowels, bankrupt shield, reveal letter, answer peek, and more
**🏆 Progression**
- 20 built-in, fully configurable achievements
- Leveling/XP with configurable per-level rewards
- Leaderboards (wins, earnings, streaks, level, achievements) with daily/weekly/monthly/never reset options
- 7-day daily login bonus cycle
**🎯 Classic Wheel Segments**
- Money, Bankrupt, Free Play, Lose a Turn, Mystery, Wild Card
- Bonus Round with its own free-letter set and prize multiplier
**👀 Spectator Mode**
- Configurable max spectator count
- Betting system — spectators can bet on players before a round opens
**🧠 AI Puzzle Generation**
- Optional auto-refresh: generates new puzzles on a schedule, or on demand from the admin panel
- Falls back to a large built-in puzzle/category list if disabled
**🌍 24+ Languages**
- EN, TR, DE, FR, ES, PT, IT, NL, PL, RU, AR, HE, ZH, JA, KO, TH, HI, EL, CS, RO, HU, SV, DA, NO, FI
- Full RTL support (Arabic/Hebrew) and native keyboard layouts per language (Cyrillic, Hangul, Katakana, Devanagari, Thai…)
- Missing translations automatically fall back to English instead of breaking
**🛠️ Admin Tools**
- In-game drag-and-drop placement editor (`/editboardcoords`) — reposition everything live, no restart, saved straight to disk
- Framework-aware admin groups (QBCore/QBox/ESX/Standalone) plus ACE permission support
- Discord webhook alerts for admin actions, security events, and AI puzzle refresh results
**🔐 Built for Big Servers**
- Configurable broadcast intervals, spectator caps, and invite cooldowns
- Chat message sanitizing (length cap, HTML stripping)
- Big-screen cooldown system (with admin bypass toggle) so one group can't hog the physical wheel
- Anti-AFK kick/warning timers
---
## 🧩 How It Plays
1. A puzzle category and phrase are chosen (from your own list, or AI-generated)
2. On their turn, a player spins the wheel for a cash value or a special segment
3. They guess a consonant — correct guesses reveal it on the board and pay out; a wrong guess or landing on Bankrupt passes the turn
4. Vowels can be bought once a player has enough round score
5. Any player can attempt to solve the full phrase at any time
6. After all rounds, the highest score wins a real payout — or takes a shot at the Bonus Round multiplier
---
## 🛠️ Compatibility
| | |
|---|---|
| **Frameworks** | QBCore, QBox, ESX, or Standalone (built-in economy + identifiers) |
| **Dependencies** | [ox_lib](), [oxmysql]() |
| **Framework detection** | Automatic (or force one manually in `config.lua`) |
---
## ⚙️ Configuration
Everything lives in a single, heavily commented `config.lua` — framework, notifications, game timing, wheel segments, mystery prizes, card rarities/packs, achievements, rewards, bot difficulty, admin groups, per-event sounds, placement, and a `Config.Debug` master switch that silences every internal debug log until you need it.
