CR Bonus Claim – One-Time Player Reward System with Ingame money.

Reward your players with a clean, configurable, one-time bonus system if they join the game.

CR Command Bonus is a modern FiveM script designed for ESX, QBCore, or standalone servers. It allows players to claim a configurable one-time reward using a simple command — perfect for welcoming new players, they will get ingame money as a bonus grab.

Documentation

Showcase

Config-Driven Commands

- Fully customizable command names, descriptions, and arguments through config.lua.
- Auto-generated chat suggestions for all players.

Framework Support

- Compatible with ESX, QBCore, and Standalone servers.
- Automatically detects your framework and handles payouts accordingly.

Multiple Notification Systems

- Select your preferred notification type in the config:
• ESX Notify
• QBCore Notify
• Ox_Lib
• OkokNotify
• Wasabi Notify
• Codem-Notification
• Default GTA notifications

Clean Visual Feedback

- Customizable scaleform messages when claiming bonuses.
- Visual cues for success, errors, and already-claimed states.

Discord Logging

- Automatic webhook messages for all actions:
• Bonus Claimed
• Double Claim Attempt
• Admin Reset
• Bonus Check

Admin Tools

- /resetbonus \ → reset a player’s bonus (admin only)
- /checkbonus \ → view a player’s claim status and timestamp
- Built-in permission checks for ESX and QBCore admin systems

Database Integration (OxMySQL)

- Saves claim data in a lightweight bonus_claims table.
- Prevents duplicate claims and tracks claim timestamps.

Performance Optimized

- Uses client-server event structure with minimal overhead.
- Efficient SQL queries and dynamic loading.

Commands Overview

/claimbonus – Claim your one-time bonus reward. (Everyone)
/resetbonus \ – Reset another player’s bonus claim. (Admin Only)
/checkbonus \ – Check the claim status of a player. (Admin Only)

Configuration Highlights

Config.Framework = "esx" -- esx | qbcore | none
Config.MoneyAmount = 25000
Config.MoneyAccount = "bank"
Config.Notification = { Type = "oxlib" } -- esx, qbcore, oxlib, okok, wasabi, codem, gta

Compatibility

- Frameworks: ESX, QBCore, or Standalone
- Dependencies: OxMySQL (required), Ox_Lib (optional)
- Chat Systems: Default GTA chat or any custom replacement

Visual Preview

Includes scaleform messages such as:

- BONUS CLAIMED!
- You have already claimed your reward.
- Error while giving money.

Security

- Players can only claim once (saved by identifier)
- Admin-only reset and check commands
- Secure server-side validation for all events

Logging & Debugging

- Detailed Discord logging with custom titles and emojis

Included

- client/cl_main.lua
- server/sv_main.lua
- shared/config.lua
- fxmanifest.lua
- SQL auto-created table (no manual import required)

Support

Need help or want to request features?

Join our Discord