Changelog
Released version and their changes.
#Changes
- Inventory functions now normalize item names via Functions.getItem before using them, enabling alias or alternate name support.
- Context menu options now support a
closefield (default true). When set to false, selecting the option runs its action without closing the context menu.
#Files Affected
- formatting/formatItemInput/shared.lua
- functions/*
- interfaces/context/client.lua
- internals/items/client.lua
- internals/items/server.lua
- fxmanifest.lua
2026-06-07 18:45 CET
#Changes
- Missing translations for non-English languages now automatically fall back to the English (base) text, showing the English version instead of nothing or the raw translation key.
- The society table is now reset to empty on initialization rather than preserving any existing contents, preventing potential conflicts from other resources.
- The client and server
Functions.callback.awaitmethods are now marked as deprecated in favor of the newerFunctions.callback.requestmethod.
#Files Affected
- functions/callback/client.lua
- functions/callback/server.lua
- functions/society/server.lua
- translations.lua
- fxmanifest.lua
#Changes
- Added a custom progressbar component, instead of having to rely on ox_lib. Dependency override lets you choose if you want to use the old system.
- Added an optional timeout to the loadDict method.
- Added a "society" suite, which combines various society actions like adjusting money.
- Context menus that are disabled can be marked as readOnly to preserve the overall styling, but remain unclickable.
- Various helper methods.
#Files Affected
- nui/*
- README.md
- dependency_override.lua
- docs/context_menu.md
- functions/*
- interfaces/context/client.lua
- interfaces/progress/client.lua
- loader.lua
- systems/progressbar.lua
- fxmanifest.lua
#Changes
- Improved the drawText function with new customization options and a fix for left justification.
- Added an
rgbaparameter to set text color. - Added an
options.dropShadowoption to enable a drop shadow (off by default). - Added an
options.edgeoption to disable the text edge (on by default). - Added an
options.outlineoption to disable the text outline (on by default).
- Added an
- Added a clamp utility function to restrict a number within a given range.
#Files Affected
- functions/drawText/client.lua
- functions/numbers/shared.lua
- fxmanifest.lua
#Changes
- Added a native DUI management module for safe creation and resource tracking of runtime DUIs.
- Improved notification system with ox_lib routing support and new position parameter.
- Notification translations now return an optional 'position' field to control UI placement.
- Introduced a dependency override option to force a specific notification system (ox_lib, none, auto).
#Files Affected
- nui/*
- README.md
- dependency_override.lua
- functions/dui/client.lua
- functions/notify/client.lua
- functions/notify/server.lua
- loader.lua
- systems/notification.lua
- translations.lua
- fxmanifest.lua
#Changes
- Fixed context menu flickering when hovering over options that load images, by ensuring only the most recent hover request updates the selection.
- Fixed context menu options losing hover state when an image fails to load; the metadata popup now continues to show without the broken image.
- Fixed hover state not updating when context menu options change while the cursor is hovering over them.
- Fixed stale hover metadata staying visible when navigating between context menus (e.g., opening a submenu or going back).
- Improved image loading in the context menu: a placeholder icon is now shown while images load, replacing it only after a successful load to prevent empty spaces or abrupt appearances.
- Fixed disabled and read-only context menu options not visually indicating their state; icons now display with muted colors and reduced opacity for clearer distinction.
#Files Affected
- nui/*
- fxmanifest.lua
#Changes
- Fixed context menus not being scrollable when they contained many options.
- Preserved submenu callbacks so they are no longer lost when navigating back from a submenu.
- Added fallback icons for context menu options — options without a specified icon now show a default icon.
- Added hover callback support for context menu options, allowing custom actions when hovering over an option.
- Added a smoking icon to the icon registry for use in context menus.
- Improved item matching in
getItemby trying multiple string formats to reduce lookup failures. - Ensured webhook configurations now properly sync with the current selection.
#Files Affected
- nui/*
- docs/context_menu.md
- functions/getItem/shared.lua
- interfaces/context/client.lua
- webhooks/blacksmith.lua
- fxmanifest.lua
#Changes
- Added per-button onSelect callbacks to forms, allowing buttons to trigger custom actions without closing the form.
- Added hint text support for form fields to provide guidance.
- Added support for paragraph text and button timeouts in forms.
- Added the ability to clear an entire stash.
- Improved stash compatibility and integration with various inventory systems.
- Added getter and setter methods for item durability, enabling scripts to read and modify durability easily.
- Added a new context menu system with scrollable quantity selection, dynamic label updates, and optional hint text for user guidance.
- Added webhook notifications for the blacksmith crafting system.
- Fixed item name trimming to correctly handle underscores during imports.
- Ensured item imports continue fetching until successful, improving reliability when loading resources.
#Files Affected
- nui/*
- README.md
- functions/*
- imports.lua
- interfaces/context/client.lua
- interfaces/form/client.lua
- webhooks/blacksmith.lua
- fxmanifest.lua
#Changes
- Added support for multiple custom action buttons in forms, replacing the previous single submit button.
- A new
buttonsarray accepts objects withtext, optionalicon,color, and anactionstring. - The clicked button’s
actionis returned as_actionin the result, allowing the caller to distinguish which button was pressed. - The old
submitText,submitIcon, andsubmitColoroptions are deprecated but still functional.
- A new
- Improved the player selection dropdown to handle missing or invalid player data gracefully, preventing errors.
- Added detailed type annotations for form inputs, options, buttons, and results to aid developers.
#Files Affected
- nui/*
- interfaces/form/client.lua
- fxmanifest.lua
#Changes
- Fixed an error by swapping the invoked method for a context-agnostic native.
- Added explicit support for
wasabi_ambulance_v2as a death check system (setdeath = "wasabi_ambulance_v2"in dependency overrides to use it). - Added a warning when
canCarryItemis called with an item that doesn't exist in your inventory system.
#Files Affected
- dependency_override.lua
- functions/canCarryItem/server.lua
- functions/isPlayerDead/client.lua
- loader.lua
- systems/death.lua
- fxmanifest.lua
#Changes
- Started proper version tracking.
- Added a
getGendermethod that returns the player's gender, with framework-aware support for ESX and QB and a native fallback. - Fixed the textarea icon position to align to the top left instead of centering to the full height.
- Added a missing icon to the textarea component.
#Files Affected
- nui/*
- functions/getGender/client.lua
- fxmanifest.lua