Localization

illenium-appearance includes 16 languages out of the box.

Setting the Language

Set the locale via the server convar:


set illenium-appearance:locale "en"

Available Languages

Code	Language
`en`	English
`de`	German
`fr`	French
`es-ES`	Spanish
`it`	Italian
`nl`	Dutch
`pt-BR`	Portuguese (Brazil)
`ro-RO`	Romanian
`hu`	Hungarian
`cs`	Czech
`bg`	Bulgarian
`ar`	Arabic
`id`	Indonesian
`zh-CN`	Chinese (Simplified)
`zh-TW`	Chinese (Traditional)

Adding a New Language

Create a new file in locales/ (e.g., locales/ja.lua)
Copy the structure from locales/en.lua
Translate all string values
Add the file to fxmanifest.lua in shared_scripts (before @ox_lib/init.lua)
Set illenium-appearance:locale to your language code

Locale Structure

Each locale file defines a table with nested keys:


Locales["en"] = {
    UI = {
        -- NUI strings (sent to React frontend)
    },
    purchase = {
        store = {
            success = { title = "...", description = "..." },
            failure = { title = "...", description = "..." },
        },
        tattoo = { ... },
    },
    outfits = { ... },
    commands = { ... },
    -- etc.
}

The UI subtable is sent to the React NUI. All other keys are used by the Lua client/server code via the _L("key.path") function.