[Free] LXR-PromoCode | One-Time Promo Code Redemption System [All Frameworks]
LXR-PromoCode
One-time promo code redemption system with full SQL persistence for RedM.
Give out promo codes for streamer events, community giveaways, welcome bonuses, or seasonal promotions. Every code is redeemed once per player — permanently tracked in the database across restarts.
Store: https://www.lxrcore.com
Discord: discord.gg/CrKcWdfd3A
Documentation: Included in the resource (docs/ folder)
Preview
(Coming Soon)
Features
- SQL-persistent redemptions — claims survive server restarts permanently. No file-based storage, no JSON, no data loss.
- One redemption per player per code — enforced by a 5-layer anti-exploit guard system (memory cache → cooldown lock → DB SELECT → INSERT IGNORE → UNIQUE constraint)
- Global use limits — optionally cap total redemptions per code (e.g. first 50 players only)
- Enable/disable codes on the fly — toggle codes in config without removing them
- Configurable rewards — set custom dollar amounts per code
- Discord webhook logging — every redemption logged with player name, identifier, code, and reward amount
- Multi-framework support — auto-detects your framework or set it manually
- Localization ready — ships with English and Georgian locale files, easy to add your own
- Auto table creation — the SQL table is created on first boot, no manual import required
- Resource name enforcement — escrow-protected guard prevents folder renaming exploits
- 0.00ms idle — server-authoritative command handler, no tick loops, no polling, zero idle performance cost
- Lua 5.4 — modern Lua with
lua54 'yes'
Supported Frameworks
| Framework | Status |
|---|---|
| LXR-Core |  Full support |
| RSG-Core | Full support |
| VORP Core | Full support |
| RedEM:RP | Supported |
| QBR-Core | Supported |
| QR-Core | Supported |
| Standalone | License identifier fallback |
Auto-detection order: LXR → RSG → VORP → RedEM:RP → QBR → QR → Standalone. First found wins. Override manually in config.lua if needed.
How It Works
- Define promo codes in
config.luawith reward amounts, enabled state, and optional global use limits - Players type
/redeem CODEin chat - Server validates the code through 5 layers of protection before granting the reward
- Redemption is permanently stored in MySQL — code cannot be reused by that player, ever
Anti-Exploit: 5-Layer Guard System
Every redemption passes through all five layers before money is awarded:
- DatabaseReady flag — blocks all commands until SQL cache is fully loaded on boot
- Per-player cooldown lock — prevents rapid command spam and race conditions
- In-memory cache check — fast-path rejection, no DB query needed for repeat attempts
- Direct SQL SELECT — catches stale cache edge cases after restarts
- INSERT IGNORE + UNIQUE constraint — database-level final wall, mathematically impossible to bypass
If the money add fails after DB insert, the row is rolled back automatically.
Installation
- Place
lxr-promocodein yourresourcesfolder — folder name must be exactlylxr-promocode - Add to
server.cfg:
ensure oxmysql
ensure lxr-promocode
- Edit
config.lua— add your promo codes, set framework, optionally add Discord webhook - Start/restart the server — SQL table is created automatically
Configuration Example
Config.PromoCodes = {
{
code = 'WELCOME100',
reward = 100,
enabled = true,
maxUses = 0, -- 0 = unlimited (still 1 per player)
},
{
code = 'STREAMER500',
reward = 500,
enabled = true,
maxUses = 50, -- first 50 players only
},
}
Dependencies
- oxmysql (required)
- Any supported framework listed above (or standalone)
Accessible Files (Escrow)
This resource uses the Asset Escrow system. The following files are not escrowed and fully accessible to buyers:
config.lua— all configurationfxmanifest.lua— resource manifestREADME.md— documentationdocs/**— full documentation (install guide, config reference, framework compatibility, events, troubleshooting, changelog)locales/**— English and Georgian locale filessql/**— manual SQL import file
Core logic files (server/server.lua, client/client.lua, shared/framework.lua) are escrow-protected.
Store
Support
Join the Discord for setup help and support:
discord.gg/CrKcWdfd3A
| Code is accessible | Partly (config, locales, docs, SQL) |
| Subscription-based | No |
| Lines (approximately) | ~920 |
| Requirements & dependencies | oxmysql |
| Support | Yes |
LXR-PromoCode — Changelog