Description

op-crime
↓
ps-gangs
↓
op-gangs
↓
esx_gang
↓
qbx_core
↓
qb-core
↓
ND_Core

Module{}

Lib.done()

Lib.on()
Lib.off()
Lib.emit()

Lib.onReady(function()

end)

modules/mymodule/
├── init.lua
├── client.lua
└── server.lua

Module{}

Lib.done('mymodule')

Lib.done('mymodule')

rps_lib
│
├── fxmanifest.lua
│
├── config
│   └── config.lua
│
├── core
│   ├── shared.lua
│   ├── client.lua
│   ├── server.lua
│   ├── exports_client.lua
│   └── exports_server.lua
│
└── modules
    ├── _template
    ├── framework
    ├── inventory
    ├── notify
    ├── fuel
    ├── radial
    ├── dispatch
    ├── target
    ├── doorlock
    └── gang

ensure rps_lib

dependencies {
    'rps_lib'
}

local Lib = exports['rps_lib']:GetLib()

local Lib = exports['rps_lib']:GetLib()

Features

• **Core**
• - ✅ Auto-detects running resources on server start
• - ✅ Pin any module to a specific resource in config
• - ✅ Disable any module with `false` in config
• - ✅ Boot report shows every module status on start
• - ✅ No silent fallback when a pinned resource is not running
• - ✅ Lazy bridge resolution — config always read before detection
• - ✅ Bridge results cached after first call — zero repeated overhead
• - ✅ Internal event bus on both client and server
• - ✅ Client ready gate prevents startup race conditions
• - ✅ 37 Lua files, all syntax-verified
• **Framework**
• - ✅ Get player job name, grade, and label
• - ✅ Get player money by account (cash, bank, black_money)
• - ✅ Get player citizen identifier
• - ✅ Check player job with optional minimum grade
• - ✅ Accept a single job or list of jobs for job checks
• - ✅ Server: add and remove money with insufficient funds check
• **Inventory**
• - ✅ Get item count
• - ✅ Check player has minimum quantity of an item
• - ✅ Get all inventory items as normalised list
• - ✅ Open stash and vehicle trunk
• - ✅ Server: add and remove items with optional metadata
• - ✅ Server: register usable item callback
• - ✅ Server: register persistent stash
• **Notifications**
• - ✅ Success, error, info, and warning notifications
• - ✅ Progress bar with animation and cancel support
• - ✅ Input dialog with multiple field types
• - ✅ Server: send to player, broadcast to all, broadcast to job
• - ✅ Native GTA fallback if no system found
• **Fuel**
• - ✅ Get, set, add, and remove fuel
• - ✅ Low fuel threshold check
• - ✅ Drain thread with custom rate — returns a stop function
• - ✅ Server: set and add fuel by vehicle network id
• - ✅ Native fallback if no system found
• **Radial Menu**
• - ✅ Add and remove item groups
• - ✅ Sub-menu support (ox_lib)
• - ✅ Enable and disable the wheel
• - ✅ Auto-register qb-radialmenu callbacks
• - ✅ Server: push and remove items per player or globally
• **Dispatch**
• - ✅ Send alerts with code, blip, plate, weapon, and priority
• - ✅ Shorthand for police, EMS, and fire
• - ✅ Multi-job alert support
• - ✅ Server relay fallback when no dispatch resource found
• **Target**
• - ✅ Entity, box zone, sphere zone, and model targets
• - ✅ Job and item restrictions per option
• - ✅ Auto-register qb-target callbacks
• - ✅ Remove entity, zone, and model targets
• - ✅ Server: push and remove zones and models per player or globally
• **Door Locks**
• - ✅ Register, lock, unlock, and toggle doors
• - ✅ Authorised job and grade per door
• - ✅ Server: door states synced to all clients
• - ✅ Server: new players receive all door states on join
• - ✅ Native entity freeze fallback if no system found
• **Gang**
• - ✅ Get gang name, grade, grade label, and display label
• - ✅ Check if player is boss, in a gang, or matches specific gangs
• - ✅ Minimum grade check on gang membership
• - ✅ Normalised data table — consistent keys across all bridges
• - ✅ op-crime detected before qb-core (correct op-framework name)
• - ✅ Standalone gang systems always checked before framework built-ins
• - ✅ Listen for gang changes via event
• - ✅ Server: set and remove gang, get online members and bosses
• - ✅ Server: notify all members or bosses of a gang