Lumo Docs

Interface Suite changelog ​

1.2.2 — 2026-10-26 ​

  • Chat: the chat now follows the Circle preset and its accent on Qbox, ESX and any stock chat resource (it stayed lime there). lumo-chat-theme 1.1.4 sends the preset and the HUD row to the chat page by itself, so you no longer need to edit chat. The Circle HUD also slides clear while you type.

1.2.1 — 2026-10-19 ​

  • Chat: lumo-chat-theme now ships in the download (it was missing, so servers kept FiveM's default chat look). Ensure it after chat, and stop any other chat theme.
  • /me shows the character name on QBCore, Qbox and ESX (it used to fall back to the FiveM name off QBCore). New export GetCharacterName(source).

1.2.0 — 2026-10-19 ​

  • ESX: two new shims, esx_progressbar and esx_textui, so ESX.Progressbar, ESX.TextUI and ESX.HideUI are drawn by lumo-ui (with esx_notify, all three ESX UI calls now use the Lumo look).
  • New docs/INSTALLATION.md: step-by-step install for QBCore, Qbox, ESX and standalone: what to remove, the exact notify edits for qb-core and qbx_core, target/radial choices on Qbox and ESX, affected resources and a troubleshooting table.
  • /uirestart also restarts the new ESX shims.
  • Radar masks: lumo-ui ships its own round and square masks (stream/lumo_ui_{circle,square}mask.ytd), so the square map no longer shows behind the ring and the square radar is no longer cut off on servers without circlemap/squaremap textures (ESX, Qbox). The radar also refreshes the first time it shows after login, so the round radar is no longer blank until the pause map is opened.
  • GTA's own weapon icon and ammo count are hidden while armed (Hud.HideNativeAmmo); the Lumo weapon panel shows the ammo. QBCore hid them through qb-smallresources; ESX and Qbox showed both.
  • Lumo products (inventory, clothing, spawn, multicharacter) draw their progress bars and notifications with lumo-ui on every framework, not ox_lib.

1.1.0 — 2026-10-09 ​

  • Lumo Interact 2.1.0 is now included as its own resource next to lumo-ui: walk-up key prompts on coords, entities and models, drawn by lumo-ui. Its Lua is readable in both editions. See its CHANGELOG.

1.0.0 — 2026-10-09 ​

First release as Lumo UI (previously the Lumo HUD UI).

  • One React page draws everything: HUD, notifications, target eye, radial menu, context menu, input dialog, progress bar, text UI, timers and minigame bars. No more separate browser frames per module.
  • Built-in target eye: box, circle, polygon, entity and combo zones without PolyZone; models, entities, vehicle bones, global peds/vehicles/objects/players; job, gang, item and citizen gates; passive hints on the Circle preset.
  • Built-in radial menu: config items, per-job items, a seated vehicle menu, items from other resources (cleared when they stop), a downed-only mode.
  • Built-in context menu, input dialog, progress bar (animations, props, control locks) and 2D/3D text prompts.
  • HUD runs on QBCore, Qbox, ESX and standalone: status, stress, fuel, seatbelt, cruise, harness, nitrous, aircraft, compass, voice, crosshair, square/circle minimap.
  • [compat] shims for qb-target (and qtarget), qb-menu, qb-input, qb-radialmenu, progressbar, esx_notify and the old lumo-hud-ui name.
  • Debug and test commands only exist with LumoUiConfig.Debug = true.
  • Player /ui choices start from the defaults once, because the resource has a new name.