# Orion Rewards- Premium Virtual Currency System for QBCore

Transform your FiveM server's economy with OrionRewards, a complete and professional virtual currency management system designed exclusively for QBCore Framework. Allow your players to earn, accumulate, and spend custom Rewards while administrators have full control through an intuitive management panel.

## Main Features

**Automatic Reward System** - Players receive Rewards passively at configurable time intervals, rewarding active playtime on your server

**Dual Menu System** - Separate interfaces for players and administrators, ensuring clean and role-appropriate experiences

**Real-Time Updates** - Administrative actions reflect instantly without requiring menu refresh or reconnection

**Advanced Admin Panel** - Select online players from dropdown, view current balances, and manage Rewards with precision

**Professional UI Design** - Modern, animated interface with custom color scheme and smooth transitions

**Flexible Configuration** - All settings accessible through a single config file, no code editing required

**Database Integration** - Full persistence using QBCore's money system and MySQL storage

**Permission System** - Integrated with QBCore permissions (admin/god) for secure access control

**Debug Mode** - Optional detailed logging for troubleshooting and monitoring system behavior

**Map Keybind Support** - Quick access via customizable keyboard shortcut

## Administrative Experience

Administrators can:

Access the management panel via dedicated command

View all online players with current coin balances

Select players from an organized dropdown menu

See real-time balance updates after each transaction

Add coins to reward players or run promotions

Remove coins for economy balancing or penalties

Receive instant confirmation notifications

Track all actions through optional debug logging

The system validates permissions server-side and provides clear feedback for every action, ensuring secure and reliable coin management.

## Player Experience

Players enjoy:

Easy access via command or keybind

Clean interface displaying current coin balance

Automatic passive rewards for active gameplay

Instant notifications when receiving coins

Custom branding with server logo support

Smooth animations and visual feedback

The system runs silently in the background, automatically tracking playtime and distributing rewards without player intervention.

## Configuration Options

Customize everything through config.lua:

Server logo URL for branding

User and admin command names

Keyboard shortcut for quick access

Menu titles and descriptions

Reward interval (in minutes)

Coins per reward cycle

Account type identifier

Notification messages

Debug mode toggle

## Technical Specifications

**Server-Side Security** - All transactions validated on server, preventing client-side exploits

**Automatic Cleanup** - Efficient resource usage with optimized update cycles

**QBCore Native** - Built using official QBCore functions and standards

**Modern Codebase** - Lua 5.4, organized file structure, commented code

**NUI Interface** - Responsive HTML/CSS/JS with smooth animations

**Database Ready** - Automatic integration with existing player data

## Requirements

QBCore Framework

MySQL Database (with coins money type configured)

FiveM Server

## Installation

Simple three-step setup:

Add coins money type to QBCore config

Execute the included SQL file

Configure and start the resource

Complete documentation included with purchase, including detailed installation guide and configuration examples.

## Security and Optimization

Permission validation on every admin action

Protected callbacks for data requests

Sanitized inputs and type checking

Optimized loops for reward distribution

Minimal performance impact

Compatible with standard QBCore player_vehicles and economy systems

## Perfect For

Servers running custom shops or marketplaces

Communities wanting to reward active players

Administrators needing flexible economy tools

Servers looking for professional, polished interfaces

OrionCoins provides everything you need to implement a complete virtual currency system with minimal setup and maximum flexibility. Enhance your server economy with a solution that's both powerful for administrators and seamless for players.