PK Bonus - FiveM Playtime Reward System

A FiveM resource that rewards players with in-game currency based on their playtime. Compatible with QB-Core, ESX, and custom frameworks.

Features

• 🕒 Configurable playtime-based rewards
• 💰 Multiple bonus tiers with different rewards
• 🎮 Support for QB-Core, ESX, and custom frameworks
• ⚡ Real-time visual timers
• 🔄 Auto-save system
• 💤 AFK detection
• ⚙️ Highly configurable settings

Installation

1. Download the resource
2. Place it in your FiveM resources folder
3. Add ensure pk_bonus to your server.cfg

Configuration

Edit the shared/config.lua file to customize:

• Framework selection (QB-Core, ESX, or custom)
• AFK detection settings
• Timer display options
• Bonus tiers and rewards
• Save intervals

Basic Configuration

Config.Framework = Config.SupportedFrameworks.qb  -- Choose: qb, esx, or custom
Config.AFKMinutes = 180                          -- AFK detection time (seconds)
Config.Command = "bonus"                         -- Command to toggle timer display
Config.ShowTimers = true                         -- Show timers by default

Bonus Configuration

Configure multiple bonus tiers in config.lua:

Config.Bonuses = {
    {
        name = "Bonus 1",
        time = 3000,        -- Time in seconds
        reward = 80000,     -- Money reward
        reset = true,       -- Reset on disconnect
        show = true         -- Show timer
    },
    -- Add more bonus tiers as needed
}

Commands

• /bonus - Toggle the visibility of bonus timers

Framework Support

• QB-Core (qb-core)
• ESX (es_extended)
• Custom frameworks (requires additional setup)

Dependencies

• QB-Core or ESX (depending on chosen framework)
• FiveM server

License

This project is licensed under the GNU General Public License v3.0 (GPLv3) - see the LICENSE file for details.

This means you are free to:

• Use this software for any purpose
• Change the software to suit your needs
• Share the software with your friends and neighbors
• Share the changes you make

Under the following conditions:

• You must disclose source code when you share the software
• You must share modifications under the same license
• You must state changes made to the code
• You must include the license and copyright notice with the code