SHOPPING CART

Onex

Command Palette

Search for a command to run...

LOCALIZATION#

The locales configuration (config/locales.lua) allows you to customize all UI text for your server's language or branding.

Overview#

All text displayed in the creation menu UI can be customized through the Locales table. This enables full localization and custom branding.

UI Labels#

config/locales.lua
Locales = { -- Header text subHeader = 'CREATE YOUR DESIRED LOOK', -- Parent selection labels Father_text = 'FACE 1', Mother_text = 'FACE 2', -- Item labels Item_text = 'ITEM', Texture_text = 'TEXTURE', Opacity_text = 'OPACITY', -- Button labels discard = 'DISCARD', default_text = 'DEFAULT', blank_text = 'BLANK', -- Help text clothes_on_of_help_text = 'put clothes off/on', Expand_help_text = 'CLICK HERE TO EXPAND...', Shrink_help_text = 'CLICK AGAIN TO SHRINK...' }

Header Text#

The main subtitle shown at the top of the creation menu:

config/locales.lua
Locales.subHeader = 'CREATE YOUR DESIRED LOOK'

Examples:

  • English: 'CREATE YOUR DESIRED LOOK'
  • Spanish: 'CREA TU LOOK DESEADO'
  • German: 'ERSTELLE DEINEN LOOK'
  • French: 'CRÉEZ VOTRE LOOK'

Parent Selection#

Labels for the heritage/face selection:

config/locales.lua
Locales.Father_text = 'FACE 1' Locales.Mother_text = 'FACE 2'
LocaleDefaultDescription
Father_text'FACE 1'First parent face label
Mother_text'FACE 2'Second parent face label

Alternative labels:

  • 'FATHER' / 'MOTHER'
  • 'PARENT 1' / 'PARENT 2'
  • 'HERITAGE 1' / 'HERITAGE 2'

Item Labels#

Labels for clothing/appearance selection:

config/locales.lua
Locales.Item_text = 'ITEM' Locales.Texture_text = 'TEXTURE' Locales.Opacity_text = 'OPACITY'
LocaleDefaultUsed For
Item_text'ITEM'Clothing item selection
Texture_text'TEXTURE'Texture/color variant
Opacity_text'OPACITY'Overlay opacity slider

Button Labels#

Action button text:

config/locales.lua
Locales.discard = 'DISCARD' Locales.default_text = 'DEFAULT' Locales.blank_text = 'BLANK'
LocaleDefaultDescription
discard'DISCARD'Cancel/discard changes button
default_text'DEFAULT'Reset to default option
blank_text'BLANK'Empty/none option

Help Text#

Instructional text shown in the UI:

config/locales.lua
Locales.clothes_on_of_help_text = 'put clothes off/on' Locales.Expand_help_text = 'CLICK HERE TO EXPAND...' Locales.Shrink_help_text = 'CLICK AGAIN TO SHRINK...'
LocaleDefaultDescription
clothes_on_of_help_text'put clothes off/on'Toggle clothes tooltip
Expand_help_text'CLICK HERE TO EXPAND...'Expand section hint
Shrink_help_text'CLICK AGAIN TO SHRINK...'Collapse section hint

Language Examples#

Spanish#

config/locales.lua
Locales = { subHeader = 'CREA TU LOOK DESEADO', Father_text = 'PADRE', Mother_text = 'MADRE', Item_text = 'ARTÍCULO', Texture_text = 'TEXTURA', Opacity_text = 'OPACIDAD', discard = 'DESCARTAR', default_text = 'PREDETERMINADO', blank_text = 'VACÍO', clothes_on_of_help_text = 'quitar/poner ropa', Expand_help_text = 'CLIC PARA EXPANDIR...', Shrink_help_text = 'CLIC PARA REDUCIR...' }

German#

config/locales.lua
Locales = { subHeader = 'ERSTELLE DEINEN LOOK', Father_text = 'VATER', Mother_text = 'MUTTER', Item_text = 'ARTIKEL', Texture_text = 'TEXTUR', Opacity_text = 'DECKKRAFT', discard = 'VERWERFEN', default_text = 'STANDARD', blank_text = 'LEER', clothes_on_of_help_text = 'Kleidung an/aus', Expand_help_text = 'KLICKEN ZUM ERWEITERN...', Shrink_help_text = 'KLICKEN ZUM VERKLEINERN...' }

French#

config/locales.lua
Locales = { subHeader = 'CRÉEZ VOTRE LOOK', Father_text = 'PÈRE', Mother_text = 'MÈRE', Item_text = 'ARTICLE', Texture_text = 'TEXTURE', Opacity_text = 'OPACITÉ', discard = 'ANNULER', default_text = 'DÉFAUT', blank_text = 'VIDE', clothes_on_of_help_text = 'enlever/mettre vêtements', Expand_help_text = 'CLIQUEZ POUR AGRANDIR...', Shrink_help_text = 'CLIQUEZ POUR RÉDUIRE...' }

Portuguese#

config/locales.lua
Locales = { subHeader = 'CRIE SEU VISUAL', Father_text = 'PAI', Mother_text = 'MÃE', Item_text = 'ITEM', Texture_text = 'TEXTURA', Opacity_text = 'OPACIDADE', discard = 'DESCARTAR', default_text = 'PADRÃO', blank_text = 'VAZIO', clothes_on_of_help_text = 'tirar/colocar roupa', Expand_help_text = 'CLIQUE PARA EXPANDIR...', Shrink_help_text = 'CLIQUE PARA REDUZIR...' }

Custom Branding#

You can customize text for your server's branding:

config/locales.lua
Locales = { subHeader = 'WELCOME TO MYSERVER - CHARACTER CREATION', Father_text = 'GENETICS A', Mother_text = 'GENETICS B', -- ... etc }

NUI Localization#

The web UI also has localization support in the TypeScript files:

web/src/component/userConfigFn/locales.ts
export class="token keyword">const locales = { en: { save: class="token string">"Save", cancel: class="token string">"Cancel", class="token comment">// ... more strings }, es: { save: class="token string">"Guardar", cancel: class="token string">"Cancelar", class="token comment">// ... more strings } }

For full NUI localization, you may need to modify the TypeScript files in web/src/ and rebuild the UI.

Best Practices#

  1. Keep labels short - UI space is limited
  2. Use UPPERCASE - Matches the default style
  3. Test in-game - Ensure text fits properly
  4. Be consistent - Use same terminology throughout
  5. Consider RTL - Right-to-left languages may need UI adjustments

Next Steps#