UNIQERS‑EVENTPROMO

An ultra-advanced, limited-time Play → Earn → Stand Out reward event system. Set unlimited multi-tier rewards, watch players race a live leaderboard, and deliver won vehicles with a fully automated valet AI. Set the whole event up in-game — and every command, value and behavior below is fully editable in config.

Why This Script?

The things that actually matter when you run a live event.

🔑 Build Any Event In Seconds

Permission-locked to your staff groups. Open it with /eventpromo and design your entire campaign from a clean visual panel — no config editing required to launch an event.

▹ Unlimited multi-tier rewards — add as many reward tiers as you want to a single event, each with its own required playtime, so players unlock reward after reward the longer they play. Each tier gets its own unique reward ID.

▹ 3 reward types per tier — Vehicle, Item or Money. Money supports Bank or Cash accounts, items support any amount, vehicles use a spawn code and are added straight to the player's garage.

▹ 5 rarity ranks — flag each tier as Common, Uncommon, Rare, Epic or Legendary for instantly readable prestige on the promo page.

▹ Live 3D reward preview — attach an optional 3D prop model and see a real, rotating 3D preview of the reward right inside the panel (see the detailed section below).

▹ Full date/time scheduling — set start & end date and time, or run an Infinite Event with no date limit. Built-in validation blocks empty fields, past start dates and end-before-start ranges.

▹ Zero image hassle — 885 cars included — set a custom label, amount and image URL, or just type uniqers to auto-load the matching car from the 885 pre-packaged images. Item & Money fall back to their own included defaults.

▹ One-click save & Clear Event — saving wipes old data and activates the new event instantly; a Clear Event button resets the event and all player progress behind a confirmation guard so nothing happens by accident.

🧊 Live 3D Reward Preview — In Detail

Powered by screenshot-basic, the panel renders a real, continuously-updating 3D model of your reward prop — not a static image.

▹ The preview entity is spawned inside an isolated routing bucket, so no other player on the server ever sees it.

▹ A background thread streams frames live, so you can drag to rotate the model smoothly and inspect the reward from every angle.

▹ Everything is cleaned up automatically on close (entity, camera and bucket reset). The whole feature can be toggled off in config with a single line if you don't want it.

🎮 Play, Compete, Get Rewarded

Everything the player sees is polished, native and non-intrusive — designed to reward engagement, not spam.

🧠 Smart Valet System — In Detail

When a player wins a vehicle they get a 20-second choice modal: Call Valet or Send to Garage. Choose valet and the AI takes over completely.

▹ Valet spawns within a configurable distance, gets its own map blip, and drives to the player at a set speed.

▹ On arrival it walks up face-to-face, hands over the keys and charges the valet fee — then walks away and cleans up.

▹ Can't afford the fee? The vehicle is safely added to the garage instead — the player never loses their prize.

▹ Spawn distances, drive speed, arrival & interaction distances, fee, valet model, blip sprite/color/scale and garage name are all in config.

📡 Rich Discord Logging

Every reward delivery is logged to Discord with a full, professional embed.

▹ Reward-specific embeds — distinct messages and images for Vehicle, Money and Item rewards, showing player name, CitizenID/identifier, server ID, vehicle plate, total time played and the reward earned.

▹ Full avatar sync — pulls the player's Steam or Discord avatar; Discord bot token support enables live Discord CDN avatar fetching (great for ESX). The included SQL adds the needed discord_id / steamhex columns automatically.

▹ Fully branded — custom webhook, username, avatar URL, thumbnail, footer icon, colors and default reward images — all set in config. Toggle logging on/off with one line.

🎨 Seasonal Theme Engine

12 built-in themes, each with its own color palette and a unique animated particle effect (snow, falling leaves, petals, rising bubbles, embers, floating hearts, sparkles). Switch the entire look of the event UI right from the admin panel — one theme for every season and holiday.

⚙️ Performance: Async, optimized callbacks keep the script at 0.00ms idle during normal play. The optional live 3D reward preview renders a real model, so resource usage rises only while that preview is open in the admin panel — it drops back to 0.00ms the moment you close it, and can be disabled entirely in config.

⚡ Plug & Play Setup

1 Import the included SQL and add ensure uniqers-eventpromo to your server.cfg (start screenshot-basic before it if you'll use 3D preview).

2 Open config.lua, set your framework (or leave auto), notify style, garage, valet settings and Discord webhook.

3 Restart the server and type /eventpromo to open the admin panel.

4 Build your event, add tiers, pick a theme, hit save — and it's live. That's it!

The One Who Plays Wins. The One Who Wins Shines.

The best choice for holiday events, seasonal promos and server-wide play-to-win campaigns. Launch your next event in minutes.

Need help? Join our support Discord for setup assistance and lifetime updates.