Editing localization files

circle-info

ox_lib provides a built-in localization system using JSON files stored in the locales folder. The lib.locale() function is responsible for loading the appropriate localization file based on the server’s configuration.

Default Localization File

circle-info

By default, locales/ox:locale|en>.json is the primary localization file. However, this can be changed based on the server configuration.

Setting the Localization Language

circle-info

The server owner can specify a different localization file by setting the ox:locale value in server.cfg. The value assigned to ox:locale determines which file should be loaded.

For example:

set ox:locale "pt"

This configuration instructs ox_lib to load locales/pt.json instead of the default locales/en.json.

Adding a New Localization File

To support a new language, the server owner must:

  1. Create a new JSON file in the script locales folder, following the locales/en.json format.

  2. Ensure the correct ox:locale value is set in server.cfg.

  3. Populate the new JSON file with localized strings matching the existing structure.

Example: If the server's ox:locale is set to fr, then a corresponding locales/fr.json file should be created.