🤝OLRP Bossmenu

Overview

The OLRP Boss Menu is a comprehensive boss management system designed for FiveM servers using the QB-Core/QBox framework. It provides a modern, midnight red-themed interface for managing employees, handling society finances, and processing job applications.

Key Highlights

• 🎨 Modern Midnight Red UI - Sleek, dark theme with red accents

• 👥 Complete Employee Management - Hire, fire, and manage employee ranks

• 💰 Society Banking Integration - Deposit, withdraw, and transfer funds

• 📋 Job Application System - Review and manage job applications

• 🔐 Granular Permission System - Custom access control for employees

• 📊 Analytics Dashboard - Employee statistics and activity charts

• ⚙️ Highly Customizable - Multiple themes and settings

Features

Core Functionality

Employee Management

• Hire Employees: Add new members to your organization

• Fire Employees: Remove members with proper logging

• Rank Management: Promote/demote employees with salary adjustments

• Permission Control: Set custom permissions for each employee

• Playtime Tracking: Monitor how long employees have worked

Society Banking

• Deposit Funds: Add money to society accounts

• Withdraw Funds: Remove money from society accounts

• Transfer Money: Move funds between accounts

• Transaction History: Complete audit trail of all financial activities

• Multi-Banking Support: Compatible with various banking systems

Job Application System

• Custom Application Forms: Configure questions for each job

• Application Review: Accept or reject applications with notes

• Status Tracking: Monitor application progress

• Automated Notifications: Keep applicants informed

Analytics & Reporting

• Employee Statistics: Track performance and activity

• Financial Reports: Monitor society account balances

• Activity Charts: Visual representation of data

• Playtime Analytics: Employee work time tracking

Installation

Prerequisites

• QB-Core or QBox framework

• oxmysql database connector

• qb-target or ox_target system

1

Database Setup

Import the SQL file into your database:

-- Copy and paste the entire bossmenusql.sql file into your database management tool

The SQL file creates the following tables:

• job_applications - Stores job applications

• job_employee_permissions - Employee permission settings

• job_manager_settings - User interface settings

• job_playtime - Employee playtime tracking

• society - Society bank accounts

• society_transactions - Transaction history

2

Resource Installation

• Place the olrp_bossmenu folder in your resources directory

• Add ensure olrp_bossmenu to your server.cfg

• Restart your server

3

Dependencies

Ensure these resources are installed and running:

• qb-core or qbx_core

• oxmysql

• qb-target or ox_target

Configuration

Basic Configuration

The main configuration file is located at config.lua. Here are the key settings:

-- Banking System Selection
Config.BankingSystem = "renewed-banking"  -- Options: "qb-banking", "renewed-banking"

-- Target System Selection
Config.TargetSystem = "ox_target"  -- Options: "qb-target", "ox_target"

-- Job Application System
Config.EnableApplicationSystem = true  -- Set to false to disable

Job Ranks and Salaries

Configure job ranks and salaries in qb-core/shared/jobs.lua:

['police'] = {
    label = 'Law Enforcement',
    grades = {
        [0] = {
            name = 'Cadet',
            payment = 2000
        },
        [1] = {
            name = 'Officer',
            payment = 2500
        },
        [9] = {
            name = 'Assistant Chief',
            isboss = true,        -- Gives boss menu access
            payment = 6000
        },
        [10] = {
            name = 'Chief',
            isboss = true,        -- Gives boss menu access
            bankAuth = true,      -- Gives society banking access
            payment = 8000
        },
    },
},

Key Configuration Points:

• payment = Salary amount

• isboss = true = Gives access to boss menu

• bankAuth = true = Gives access to society banking

Database Setup

Table Structure

Job Applications Table

CREATE TABLE IF NOT EXISTS `job_applications` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `citizenid` varchar(50) NOT NULL,
  `job` varchar(50) NOT NULL,
  `name` varchar(100) NOT NULL,
  `answers` longtext NOT NULL,
  `status` varchar(20) NOT NULL DEFAULT 'pending',
  `date_submitted` timestamp NOT NULL DEFAULT current_timestamp(),
  `date_reviewed` timestamp NULL DEFAULT NULL,
  `reviewer_id` varchar(50) DEFAULT NULL,
  `notes` text DEFAULT NULL,
  PRIMARY KEY (`id`)
);

Society Table

CREATE TABLE IF NOT EXISTS `society` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(255) NOT NULL,
  `money` bigint(20) unsigned NOT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `name` (`name`)
);

Society Transactions Table

CREATE TABLE IF NOT EXISTS `society_transactions` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `society` varchar(255) NOT NULL,
  `type` varchar(50) NOT NULL,
  `amount` int(11) NOT NULL,
  `employee` varchar(255) DEFAULT NULL,
  `executor` varchar(255) DEFAULT NULL,
  `note` text DEFAULT NULL,
  `timestamp` int(11) NOT NULL,
  PRIMARY KEY (`id`)
);

Job Management

Adding New Jobs

1

Configure Job Locations

Add your job to Config.Locations in config.lua:

["yourjob"] = {
    label = "Your Job Name",
    logoImage = "yourjob.png",
    locations = {
        {
            coords = vector3(x, y, z), -- Your coordinates
            width = 1.0,
            length = 1.0,
            heading = 0,
            minZ = z - 1.0,
            maxZ = z + 1.0,
        }
    }
},

2

Add Logo Image

Place your job logo in html/images/yourjob.png (120x120px recommended)

3

Configure Job in QB-Core

Add your job configuration in qb-core/shared/jobs.lua with boss grades:

['yourjob'] = {
    label = 'Your Job',
    grades = {
        [0] = {
            name = 'Employee',
            payment = 1000
        },
        [1] = {
            name = 'Manager',
            isboss = true,
            payment = 2000
        },
    },
},

Pre-configured Jobs

The system comes with pre-configured locations for:

• Police - Law enforcement with multiple stations

• Ambulance - EMS with hospital locations

• Mechanic - Vehicle repair services

• Mechanic3 - OneLife Mechanics

• Bean Machine - Coffee shop chain

• Cat Cafe - Cat-themed cafe

• Up n Atom - Restaurant chain

• BurgerShot - Fast food restaurant

• Billiards - Pool hall

• Sky Bar - High-end bar

• Bahamas - Nightclub

• Skydiving - Adventure sports

• Lost MC - Motorcycle club

• Ballas - Gang territory

• Events - Event management

Employee Management

Hiring Employees

1

Access the boss menu at configured locations

2

Navigate to Employee Management

3

Click "Hire Employee"

4

Enter player information:

• Player ID or Citizen ID

• Desired rank/grade

• Starting salary

5

Confirm the hire

Managing Employee Ranks

1

Select an employee from the list

2

Click "Change Rank"

3

Choose new rank from available grades

4

Salary automatically updates based on rank configuration

5

Confirm the change

Setting Permissions

1

Select an employee

2

Click "Set Permissions"

3

Configure access levels:

• Society banking access

• Employee management rights

• Application review permissions

4

Save permissions

Firing Employees

1

Select the employee to fire

2

Click "Fire Employee"

3

Enter reason for termination

4

Confirm the action

Society Banking

Supported Banking Systems

The boss menu supports multiple banking systems:

• qb-banking (default)

• renewed-banking

• olrp-banking

Configure in config.lua:

Config.BankingSystem = "renewed-banking"

Banking Operations

1

Access society banking in the boss menu

2

Click "Deposit"

• Enter amount to deposit

• Add transaction note (optional)

• Confirm deposit

3

Click "Withdraw"

• Enter withdrawal amount

• Add transaction note

• Confirm withdrawal

4

Click "Transfer"

• Select destination society

• Enter transfer amount

• Add transfer note

• Confirm transfer

Transaction History

All financial activities are logged with:

• Transaction type (deposit/withdraw/transfer)

• Amount

• Employee who performed the action

• Timestamp

• Notes

Application System

Configuring Applications

Application Points

Set up application submission points in Config.ApplicationPoints:

Config.ApplicationPoints = {
    ["police"] = {
        coords = vector3(441.53604, -980.1955, 30.795989),
        width = 1.0,
        length = 1.0,
        heading = 0,
        minZ = 30.0,
        maxZ = 31.0,
        label = "Police Application"
    },
}

Application Questions

Configure custom questions for each job in Config.ApplicationQuestions:

Config.ApplicationQuestions = {
    ["police"] = {
        {
            question = "Why do you want to join the Police Department?",
            type = "text",
            required = true,
            min = 1,
            max = 1024
        },
        {
            question = "Do you have any previous law enforcement experience?",
            type = "select",
            options = {"Yes", "No"},
            required = true
        },
        {
            question = "How many years of experience do you have?",
            type = "number",
            required = false,
            min = 0,
            max = 50
        }
    }
}

Question Types

Text Questions

{
    question = "Your question here?",
    type = "text",
    required = true,
    min = 1,        -- Minimum characters
    max = 1024      -- Maximum characters
}

Select Questions

{
    question = "Choose an option:",
    type = "select",
    options = {"Option 1", "Option 2", "Option 3"},
    required = true
}

Number Questions

{
    question = "Enter a number:",
    type = "number",
    required = false,
    min = 0,        -- Minimum value
    max = 100       -- Maximum value
}

Processing Applications

1

For Bosses:

• Access boss menu

• Navigate to Applications

• Review submitted applications

• Accept or reject with notes

• Notify applicant of decision

2

For Applicants:

• Go to application point

• Interact with application marker

• Fill out application form

• Submit application

• Wait for review

UI Customization

Theme Configuration

The system supports multiple themes:

Midnight Red (Default)

:root {
    --primary: #dc2626;
    --primary-dark: #b91c1c;
    --primary-light: #ef4444;
    --secondary: #7c2d12;
    --accent: #f87171;
}

Available Themes

• Midnight Red - Dark theme with red accents

• Blue - Classic blue theme

• Purple - Purple accent theme

• Green - Green accent theme

• Orange - Orange accent theme

User Settings

Players can customize their experience:

Config.DefaultSettings = {
    darkMode = true,
    showAnimations = true,
    compactView = false,
    notificationSound = "default",
    themeColor = "midnight-red",
    refreshInterval = 60,
    showPlaytime = true,
    showLocation = true
}

Customizing Colors

To create a custom theme:

1. Edit html/style.css

2. Modify CSS variables:

:root {
    --primary: #your-color;
    --primary-dark: #your-dark-color;
    --primary-light: #your-light-color;
}

1. Update theme references in the code

API Reference

Client Events

Open Boss Menu

TriggerEvent('olrp-bossmenu:client:OpenBossMenu', jobName)

Close Boss Menu

TriggerEvent('olrp-bossmenu:client:CloseBossMenu')

Refresh Job Data

TriggerEvent('olrp-bossmenu:client:JobChanged', jobName)

Server Events

Get Job Data

QBCore.Functions.TriggerCallback('olrp-bossmenu:server:GetJobData', function(jobData)
    -- Handle job data
end, jobName)

Hire Employee

TriggerServerEvent('olrp-bossmenu:server:HireEmployee', citizenid, jobName, grade)

Fire Employee

TriggerServerEvent('olrp-bossmenu:server:FireEmployee', citizenid, jobName, reason)

Society Deposit

TriggerServerEvent('olrp-bossmenu:server:SocietyDeposit', society, amount, note)

Society Withdraw

TriggerServerEvent('olrp-bossmenu:server:SocietyWithdraw', society, amount, note)

Server Callbacks

Get Employee List

QBCore.Functions.TriggerCallback('olrp-bossmenu:server:GetEmployees', function(employees)
    -- Handle employee list
end, jobName)

Get Society Balance

QBCore.Functions.TriggerCallback('olrp-bossmenu:server:GetSocietyBalance', function(balance)
    -- Handle balance
end, society)

Get Applications

QBCore.Functions.TriggerCallback('olrp-bossmenu:server:GetApplications', function(applications)
    -- Handle applications
end, jobName)

Troubleshooting

Boss Menu Not Opening

Symptoms: Menu doesn't appear when interacting with target points

Solutions:

1. Check if player has isboss = true in their job grade

2. Verify coordinates in Config.Locations

3. Ensure target system is working properly

4. Check console for error messages

Society Banking Not Working

Symptoms: Banking operations fail or don't appear

Solutions:

1. Verify banking system configuration in config.lua

2. Check if society account exists in database

3. Ensure player has bankAuth = true in job grade

4. Verify banking resource is running

Applications Not Showing

Symptoms: Application system doesn't work

Solutions:

1. Check Config.EnableApplicationSystem = true

2. Verify application points configuration

3. Ensure questions are properly configured

4. Check database table exists

Database Connection Issues

Symptoms: Database errors in console

Solutions:

1. Ensure all tables are created properly

2. Check MySQL connection settings

3. Verify table permissions

4. Check oxmysql resource is running

Debug Mode

Enable debug mode in client/main.lua:

local DEBUG_MODE = true

This will provide detailed console output for troubleshooting.

Performance Optimization

Caching

• The system uses caching for player playtime data, society balances, employee lists, and application data

Refresh Intervals

refreshInterval = 60  -- seconds

Support

Getting Help

1. Check the troubleshooting section above

2. Review console logs for error messages

3. Verify configuration matches your setup

4. Contact OLRP development team

Reporting Issues

When reporting issues, include:

• Server console logs

• Client console logs

• Configuration files

• Steps to reproduce the problem

• Expected vs actual behavior

Updates

Keep your boss menu updated by:

1. Checking for new versions

2. Backing up your configuration

3. Following update instructions

4. Testing in a development environment

Credits

• Original Script: Adapted by OLRP

• Theme: Midnight red theme implementation

• Framework: QB-Core/QBox integration

• UI Design: Modern glass-morphism interface

• Database: Optimized MySQL schema

This documentation covers the complete OLRP Boss Menu system. For additional support or feature requests, please contact the OLRP development team.