Start here
Use this edition as the shared ox_lib foundation for resources that rely on OX callbacks, zones, menus, notifications, progress tools, and other client/server helpers. The compiled custom interface is already included.
The familiar OX foundation with a refreshed interface.
Use this edition as the shared ox_lib foundation for resources that rely on OX callbacks, zones, menus, notifications, progress tools, and other client/server helpers. The compiled custom interface is already included.
Download or clone the repository into your server resources as ox_lib.
Confirm the server artifact requirement and enable OneSync.
Ensure ox_lib before every resource that imports or depends on it.
Use the README test commands to review the customized UI in-game.
ensure ox_libThe folder must be named ox_lib. Dependent resources reference that exact name when importing the shared initializer.
Use FXServer artifact 7290 or newer with OneSync enabled. The resource uses Lua 5.4 and should start before every resource that consumes it.
Use the ox:locale and ox:userLocales convars for server-wide locale behavior. Players can open /ox_lib to adjust their notification position, audio, and locale preferences.
Add the shared initializer to the fxmanifest of a resource that consumes ox_lib.
shared_script '@ox_lib/init.lua'Run the included preview commands in-game to check each UI surface after installation.
/oxtestui
/oxnotify
/oxctx
/oxmenu
/oxradial
/oxskill
/oxprog
/oxcircle
/oxtext
/oxhidetextUse the public OX API reference for callbacks, zones, points, keybinds, menus, dialogs, and progress tools, while checking that each page still applies to this 3.39.0-based fork.
Confirm the folder is named ox_lib, the resource is ensured first, and the consumer imports @ox_lib/init.lua.
Check the client console for NUI errors, confirm the bundled web build is still present, and test the complete /oxtestui suite.
Verify the FXServer artifact is new enough and OneSync is enabled before changing the resource itself.