23 online 3 members  + Join RP Base  +
FreeScript

dirk_lib

by DirkScripts-FiveM  ·  version 2026.10.27  ·  updated 3 days ago

No reviews yet

Downloads
0
Reviews
0
Size
12.8 MB
Code check
Checked
Licence
LGPL-3.0
Released
Nov 2026

A collection of utils, bridging and more designed to make it easier for script creation within the FiveM platform.

dirk_lib
DIRK LIB
A useful library for script developement, includes all the standards set by ox_lib and improves on them with support for multiple types of target, inventory, framework, vehicle keys and more.

📖Documentation
🦜Discord
Convars
**The theme below will apply to all UI created by DirkScripts utilising the lib themes.**
**Theme starts at 0 and goes to 9**
**0 is the lightest color and 9 is the darkest**
**You can set the primary color to custom and set the customTheme to your own colors**
**Use this generator in order to make your own custom color palettes https://mantine.dev/colors-generator/?color=7b36b5**
**Default mantine colors can be found here https://mantine.dev/theming/colors/#default-colors**
setr dirk_lib:primaryColor dirk # Set to custom to use customTheme
setr dirk_lib:primaryShade 9 # 0-9
setr dirk_lib:customTheme [
  "#e5f8ff",
  "#d0ecff",
  "#a0d7fc",
  "#6dc1fa",
  "#47aef9",
  "#32a2f9",
  "#259cfa",
  "#1888df",
  "#0179c8",
  "#0068b1"
]

setr dirk_lib:language en
setr dirk_lib:debug true
setr dirk_lib:currency $
setr dirk_lib:serverName DirkRP
setr dirk_lib:logo https://via.placeholder.com/150
**Configure the resources you want to use**
setr dirk_lib:framework qbx_core
setr dirk_lib:inventory dirk_inventory
setr dirk_lib:itemImgPath nui://dirk_inventory/web/images/
setr dirk_lib:primaryIdentifier license
setr dirk_lib:target ox_target
setr dirk_lib:interact sleepless_interact
setr dirk_lib:time dirk_weather
setr dirk_lib:phone lb-phone

setr dirk_lib:keys dirk_keys
setr dirk_lib:garage dirk_vehicles
setr dirk_lib:fuel dirk_fuel

setr dirk_lib:ambulance dirk_ambulance
setr dirk_lib:prison dirk_prison
setr dirk_lib:dispatch dirk_dispatch
**NOTIFICATIONS**
setr dirk_lib:notify dirk_lib
setr dirk_lib:notifyPosition top-right
setr dirk_lib:notifyAudio true
**Context Menu**
setr dirk_lib:contextMenu dirk_lib
setr dirk_lib:contextClickSounds true
setr dirk_lib:contextHoverSounds true
**Dialog**
setr dirk_lib:dialog dirk_lib
setr dirk_lib:dialogClickSounds true
setr dirk_lib:dialogHoverSounds true
**showTextUI**
setr dirk_lib:showTextUI dirk_lib
setr dirk_lib:showTextPosition bottom-center
**progressBar**
setr dirk_lib:progress dirk_lib
setr dirk_lib:progBarPosition bottom-center
**Groups**
setr dirk_groups:maxMembers 5
setr dirk_groups:maxDistanceInvite 5
setr dirk_groups:inviteValidTime 5
setr dirk_groups:maxLogOffTime 5

Hot-reloading settings in consumer resources
lib.onSettings(key | keys, cb, options?) fires whenever the named keys on
lib.settings change. Works across resources: dirk_lib broadcasts every
scriptConfig change, consumers mutate their local lib.settings in place and
forward the patch to their NUI as UPDATE_DIRK_LIB_SETTINGS (handled by
DirkProvider in dirk-cfx-react >= 1.1.63).

lib.onSettings('currency', function(new, old)
  print(('currency: %s -> %s'):format(old.currency, new.currency))
end)

lib.onSettings({ 'primaryColor', 'primaryShade' }, function(new)
  refreshHud(new.primaryColor, new.primaryShade)
end, { immediate = true }) -- fire once with current values

**IMPORTANT: we mutate lib.settings IN PLACE**
Do not replace lib.settings or any of its subtables with a new reference —
other files capture subtable references at load time (e.g.
local groups = lib.settings.groups) and a fresh reference leaves those
captures pointing at stale data. src/onSettings.lua wipes + refills existing
tables instead of swapping them; match that pattern if you add new code that
writes to lib.settings.
API-sync between the two lib definitions
Anything added to the public init.lua lib table that dirk_lib's own
modules rely on must also exist in src/init.lua's lib definition (e.g.
lib.onCache). Both are loaded in different VMs but share module code, so a
missing field in src/init.lua crashes dirk_lib mid-module-load.