ACWheel

CS:GO-style daily lucky wheel + weekly playtime leaderboard. Server-authoritative, fully admin-managed.

Daily-login retention loops are a known driver for RP servers — but every off-the-shelf wheel either trusts the client to compute the result (trivially exploitable) or can't be themed to match server branding.

ACWheel is server-authoritative — the prize is decided server-side and broadcast to the NUI after the animation, so a tampered client cannot force a result. Pairs the daily wheel with a weekly playtime leaderboard that ranks players by total weekly playtime and rewards the top tiers each Sunday rollover.

Daily reason to log in even on slow days, plus a passive weekly competition that rewards consistent presence without forcing anyone to grind. CS:GO-style horizontal ticker animation, custom HTML/CSS/JS (pink theme by default, fully recolourable). Admin tab with full CRUD for prize pool, leaderboard tier rewards, and per-player bans (with a duration picker — 1d / 7d / 30d / Permanent).

What's in the box

  • CS:GO-style ticker animation — horizontal ticker with custom HTML/CSS/JS, fully recolourable
  • Server-authoritative spin — prize decided server-side, anti-exploit by design
  • Weekly playtime leaderboard — configurable reward tiers, Sunday rollover
  • Admin-managed prize pool — cash, items, vehicles, account flags
  • Persisted on spin start — cooldowns + history saved immediately, survives disconnect mid-spin
  • Per-player ban system — duration picker (1d / 7d / 30d / Permanent)
  • Initials-based avatars — deterministic colour palette for the leaderboard
  • Pretty admin tab — full CRUD for prizes / tiers / bans
  • Database persisted — 3 tables (prize pool, leaderboard reward tiers, bans)
  • Themed UI — pink default theme, fully recolourable via CSS
  • Sound effects + notifications — clean audio feedback on spins and wins
  • Console commands/acwheel_reset_cooldown, /acwheel_toggle

Compatibility

FrameworkTested
QBCore

Game build: 2189+ Dependencies: qb-core, ox_lib, ox_inventory, oxmysql

Quick install

  1. Drop into resources/[activities]/ACWheel/
  2. Add ensure ACWheel to server.cfg
  3. Run the included SQL files (3 tables: acwheel_prize_pool, acwheel_lb_reward_tiers, acwheel_bans)
  4. Add add_ace group.admin command.acwheel.admin allow to ACE permissions
  5. Edit config.lua: prize pool seeds, cooldown, animation duration, theme colour
  6. Open the admin tab in-game (/myped → Admin) and configure prizes/leaderboard tiers
  7. Restart the server
Documentation in progress

Deeper guides (Theme customisation, Prize pool design, Leaderboard tier strategy, Troubleshooting) will land soon.