> ## Documentation Index
> Fetch the complete documentation index at: https://lationscripts.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Modern UI - Changelog

> A chronological log of every release, feature addition, and bug fix

<Update label="2.1.1" description="Jul 16, 2026">
  * **"Font Scale" renamed to "UI Scale"**
    * Renamed the theme editor's Font Scale slider to UI Scale, since it scales the whole interface, not just text. Floor lowered from 0.75 to 0.5 so 4K players can pull the UI back down further if desired.
  * **Radial menu icon clipping**
    * Fixed radial menu wedge icons clipping/getting cut off at high resolutions (1440p and 4K) - icons now scale exactly with the wheel at every resolution instead of overflowing their box.
  * **Menus with no options**
    * Menus and list menus registered with zero options/items now open and display normally, instead of silently refusing to show (with a console warning) when there was nothing to list.
  * **List menu closing animation**
    * Fixed the list menu flashing/jumping to the top-left corner for a frame when closing. It now closes smoothly in place, using the same animation as the regular menu.
</Update>

<Update label="2.1.0" description="Jul 10, 2026">
  * **Panel opacity fix**
    * Fixed the Panel Opacity setting not applying to the Drawer, Radial Menu, Notifications, Text UI, and Timeline.
    * Hover/selected highlights now follow panel opacity too, instead of appearing as solid blocks on translucent panels.
  * **Color picker manual input fix**
    * Fixed being unable to type a hex code in the theme editor's color pickers - only copy/paste worked. Typed codes now apply as soon as they're valid.
  * **Theme persistence on upgrades**
    * The resource no longer ships a default `data/theme.json`, so updating will not reset your server's saved theme (if doing drag-drop-replace). The file is created automatically when an admin saves a theme in-game. *See Important Notes below.*
  * **Semantic colors per component**
    * Added Success, Error, and Warning color controls to every component section of the theme editor - customize the Skill Check success zone, Timeline task statuses, and more without affecting the rest of your theme.
  * **List Menu** *(yes, finally)*
    * Added the long-requested keyboard list menu - a drop-in replacement for ox\_lib's `lib.registerMenu`/`lib.showMenu` with the same behavior, callbacks, and keybinds. Existing scripts port with a simple rename.
    * Goes beyond ox\_lib: update an open menu's options live (no re-register or re-open needed), menus remember scroll and checkbox state between opens, and options can now be `disabled`.
    * Cleaner presentation too - built-in description panel and key hints instead of a tooltip, plus a live position counter.
  * **Resolution-aware scaling**
    * The entire UI (all components, theme editor, etc) now *properly* scales with your screen resolution. Replaces the old partial scaling system. Feels x100 better on all resolutions.
</Update>

<Update label="2.0.0" description="Jul 6, 2026">
  * **Full Theming System with In-Game Editor**
    * Every color, corner radius, font, font scale, shadow, border width, and panel opacity is now customizable - globally or per component - through a brand new in-game editor with live previews of the *real* components as you edit. Admins run `/uitheme` (requires the `lation_ui.admin` ACE permission) to style the UI server-wide; the theme is saved to `data/theme.json` and automatically replicated to every player.
  * **Personal Player Themes**
    * Set `setr lation_ui:allowUserThemes 1` and players can run `/uisettings` to personalize their own UI. Personal themes are stored client-side per player (no database required) and layer on top of your server theme - anything a player doesn't customize inherits from it.
  * **Theme Share Codes**
    * The editor includes Share Theme / Import Theme actions that produce a single copy-paste code containing an entire theme. Paste a code from any player or server and get their exact look instantly.
  * **Preset Themes & Font Picker**
    * The editor ships with a set of distinct preset themes as starting points, plus a font picker with curated font options. Default fonts are now bundled with the resource instead of loading from a CDN.
  * **Refined Default Look**
    * The same identity you know, polished: improved depth, contrast, and typography across every component. Change nothing and it simply looks a little better.
  * **Keyboard Navigation**
    * Menus support Arrow Up/Down, Enter, and Home/End; submenus keep Backspace navigation; the radial menu supports Arrow Left/Right and Enter; dialogs keep Tab focus contained.
  * **Faster Load**
    * The UI bundle was restructured so the core loads in a fraction of its previous size, with icon packs moved to a lazily-loaded chunk.
  * **New Theme Exports**
    * Added `getTheme` / `setTheme` (client) and `getServerTheme` / `setServerTheme` (server) for scripts that want to read or apply themes programmatically.
  * **Full Localization Coverage**
    * The theme editor and every other new v2 string is fully localized across all 13 locale files, and several previously untranslated strings were translated.
  * **BREAKING: `init.lua` Removed**
    * The old `init.lua` ox\_lib compatibility bridge has been removed (as announced over the past several months). If you use our [ox\_lib fork](https://github.com/IamLation/ox_lib/releases/latest), no action is needed - it forwards `lib.*` calls automatically. Any script still referencing `@lation_ui/init.lua` should switch to the fork or call the exports directly. Nothing else changed: no payload shapes, export names, or NUI callbacks.
</Update>