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
| Framework | Tested |
|---|---|
| QBCore | ✓ |
Game build: 2189+
Dependencies: qb-core, ox_lib, ox_inventory, oxmysql
Quick install
- Drop into
resources/[activities]/ACWheel/ - Add
ensure ACWheeltoserver.cfg - Run the included SQL files (3 tables:
acwheel_prize_pool,acwheel_lb_reward_tiers,acwheel_bans) - Add
add_ace group.admin command.acwheel.admin allowto ACE permissions - Edit
config.lua: prize pool seeds, cooldown, animation duration, theme colour - Open the admin tab in-game (
/myped → Admin) and configure prizes/leaderboard tiers - Restart the server
Deeper guides (Theme customisation, Prize pool design, Leaderboard tier strategy, Troubleshooting) will land soon.
