AH LOYALTYCARDS — Loyalty Cards & Stamps System (Bars / Restaurants / Businesses)
ESX / QBCore / ox_core • ox_inventory / qb-inventory / qs-inventory • Tebex Escrow Ready
Bring a real, immersive loyalty program to your FiveM server with AH_LOYALTYCARDS.
Players can collect a lifetime loyalty card for each business and earn stamps per purchase. Employees stamp cards using a unique company stamp item, creating a smooth RP loop that encourages repeat visits, boosts business activity, and makes the economy feel alive.
This is a fully optimized, lightweight system, built for modern servers and delivered ready for Tebex / Cfx.re Asset Escrow.
SHOWCASE VIDEO
Core Features
Lifetime Loyalty Cards (Per Business)
-
Each business can have its own loyalty card item.
-
Cards are designed to be non-stackable and persist forever in the player inventory.
-
Cards store progress using item metadata / item info, so it stays saved through restarts.
10 Stamps System (5×2 Grid)
-
Built-in stamp grid: 10 stamps (perfectly aligned and clean UI).
-
Ideal for offers like: “10 purchases = 11th free”.
-
Stamps appear visually on the card (nice, readable, RP-friendly).
“Show Card” Interaction (RP-Oriented)
-
Card owners can open the card and show it to a nearby employee.
-
Employees stamp only when they are close enough, creating a natural RP scene.
Unique Stamp Item Per Business
-
Each business has a stamp item (e.g.
loyalty_stamp_asgard). -
To stamp a card, the employee must:
-
be authorized (job/group rules), and
-
have the stamp item in inventory
-
-
Prevents abuse and keeps it realistic.
Anti-Abuse Rules (Configurable)
-
An employee cannot stamp their own card (anti-self farm).
-
Optional job/group verification:
- only employees of that business can stamp
-
If you want a simpler system, you can disable job checks and allow stamping purely by holding the stamp item.
Redeem / Reward Flow (Optional)
-
When a card reaches its last stamp:
- You can enable a redeem / reset mechanic (configurable).
-
Perfect for businesses to roleplay: “Free drink / free meal” after 10 purchases.
Persistency & Stability
-
Stamps persist through:
-
reconnects
-
restarts
-
inventory moves (give cards to another players maintain the stamps)
-
-
Uses safe server callbacks and clean metadata handling.
Fully Optimized
-
No heavy loops
-
UI opens only when needed
-
Minimal server load even with many players and many businesses
Compatibility
Frameworks Supported
-
ESX
-
QBCore (qb-core)
-
ox_core
-
Can also run standalone-style if you disable job checks (stamping requires only stamp item)
Inventories Supported
-
ox_inventory (recommended)
-
qb-inventory
-
qs-inventory
The script includes adapters to normalize metadata and slot access across inventories.
In-Game Workflow (Example)
- Player receives the Asgard Loyalty Card.
- Player buys something at Asgard.
- Player opens the card and shows it to the bartender.
- Bartender has the Asgard Stamp item and is authorized by job/group rules.
- Bartender stamps one slot.
- At 10 stamps → player can redeem the offer (free item / discount / reward RP).
This creates repeat business, natural roleplay, and easy engagement.
Customizable & Scalable
-
**Included ready-to-use cards & stamps: **This resource comes with pre-made loyalty cards and matching stamp items for Asgard, Unicorn, Burger Shot, and Pearls, so you can install and start using the system immediately (cards + stamps included).
-
Add unlimited businesses (bars, restaurants, clubs, shops, etc.)
-
Each business can define:
-
card item name
-
stamp item name
-
business job/group name
-
display labels & UI texts
-
-
Includes PNG templates so servers can let businesses create their own custom card designs easily.
Included Assets / Templates (Bonus)
Inside extras/templates/ you’ll find:
-
Transparent overlay templates (1280×720):
-
frames only (no filter)
-
filter + frames
-
glossy “FiveM style” variants
-
-
Stamp templates (512×512):
- normal + glossy
Perfect for servers offering customization to businesses without needing a graphic designer.
Requirements
Required
- ox_lib (mandatory)
Inventory (choose one)
-
ox_inventory (recommended)
-
qb-inventory
-
qs-inventory
Framework (optional)
Framework is only needed if you want job/group-based stamping:
-
ESX →
es_extended -
QBCore →
qb-core -
ox_core →
ox_core
If you don’t want job checks, simply disable them in config and the script works by stamp-item-only rules.
Configuration (Quick)
In shared/config.lua:
-
Config.Framework = 'auto'(recommended) -
Config.Inventory = 'auto'(recommended) -
Config.RequireJobMatch = true/false-
true = only correct job/group can stamp
-
false = anyone with stamp item can stamp
-
Business setup is centralized for easy scaling.
Installation (Summary)
-
Drop
ah_loyaltycardsinto your resources folder -
Add to
server.cfg:-
ensure ah_loyaltycards
-
-
Add items:
-
ox_inventory → use
extras/ox_inventory_items.lua -
QBCore/qs → use
extras/qbcore_items.lua
-
-
Restart server
Full details are included in README.md + INSTALL.md.
Tebex / Asset Escrow Ready
This resource is delivered structured for Tebex Asset Escrow:
-
Config, docs, templates and UI can remain editable for buyers (via
escrow_ignore) -
Core logic can be protected through escrow encryption
Upload the ZIP, enable escrow, sell.
Support
Full support is available via Discord:
No Refund Policy
No refunds will be issued because this is a digital product with instant download delivery.
If you encounter any issue, support is available on Discord.
Tebex Ready + Licensing
Prepared for Tebex / Cfx asset delivery.
-
Script by: AH Scripts— Do not resell / redistribute / modify without explicit written consent.
-
Full support is provided via Discord (setup help, troubleshooting, and updates).
-
No refunds will be issued, as this is an instantly downloadable digital package. Full support for any issues is available via Discord : https://discord.gg/6kS659NYfZ