Reward your players, run promotions, and boost server engagement with the most complete coupon system available for your FiveM server. Create unlimited coupon codes from an in-game admin panel, define exactly what players receive, control how many times each code can be used, and let players redeem their rewards instantly  all through a sleek, modern interface.

Features

• In-game creation UI, Create, manage, and delete coupons without ever touching a config file or database client.
• Coupon List & Status View: See all existing coupons with their code, description, total usage, expiration date, and active/inactive state.
• Enable / Disable Coupons: Temporarily deactivate any coupon without deleting it, then enable it again whenever needed.
• ACE Permission Protection: Restrict admin access with ACE permissions, making it easy to integrate into your existing permission structure.
• Configurable Commands: Change both the admin command and player redeem command from config.lua.
• Total Stock Limit: Define how many times a coupon can be redeemed globally across all players.
• Per-Player Limit: Define how many times the same person can redeem the same coupon.
• Expiration Date: Set a specific expiration date and time or leave it unlimited.
• Duplicate Protection: Prevent abuse by tracking how many times each player has redeemed each coupon.
• English and Spanish locale.
• Easy Language Expansion: Add new languages by creating a new JSON locale file
• Active State Validation: Inactive coupons are automatically rejected until they are enabled again.

Reward Types

• Item Rewards: Give any item directly to the player's inventory with a custom quantity.
• Money Rewards: Reward players with money. 
• Vehicle Rewards: Insert vehicles directly into the player's garage database with generated plate support and key delivery.
• Multiple Rewards Per Coupon: A single coupon can contain one or many rewards at the same time.

Dependencies

• Frameworks: Fully compatible with QBX, QBCore, and ESX.
• Inventory Support: Compatible with ox_inventory, qb-inventory, origen_inventory, and qs-inventory.
• Vehicle Key Support: Supports qb-vehiclekeys, Renewed-Vehiclekeys, and ys-vehiclekeys, but you can add more.
•  ox_lib
•  oxmysql

Installation Guide

1. Place the `ys_coupons` folder inside your `resources` directory.

2. Import `ys_coupons.sql` into your database — creates the two required tables.

3. Add `ensure ys_coupons` to your `server.cfg` **after** your framework, ox_lib, and inventory resource.

4. Grant the admin ACE permission in `server.cfg`:

   ```

   add_ace group.admin ys_coupons.admin allow

   ```

5. Open `config.lua` and set your `framework`, `inventory`, `notify`, and `language`.

6. Restart your server. Done.