Docs

Locales

Name: Atlas Framework
Availability: PreOrder
Author: Atlas Framework

Player-facing strings live in the Atlas locales hub.

Hub

All player-facing strings live in:

text

resources/[atlas]/atlas_extras/locales/<lang>/<namespace>.json

Do not add new locales/ trees on individual Atlas resources.

Common namespaces

File	Used by
`extras.json`	`atlas_extras` modules
`easytime.json`	weather / time module
`garages.json`	`atlas_garages`
`multichar.json`	`atlas_multichar`
`admin.json`	`atlas_admin`
`hud.json`	`atlas_hud`
`fuel.json`	fuel surfaces
`chat.json`	`atlas_chat`
`ui.json`	shared UI chrome
`common.json` / `core.json`	shared gameplay / core
`ox_lib.json` / `ox_inventory.json` / `ox_target.json`	ox stack
`community_bridge.json` / `illenium-appearance.json`	bridge / appearance
`airdrops.json`	`atlas_airdrops`
`fishing.json`	`atlas_fishing`
`coinshop.json`	`atlas_coinshop`
`playtimeshop.json`	`atlas_playtimeshop`
`rage.json`	`atlas_rage` (Atlas Main hub)
`dailyrewards.json`	`atlas_dailyrewards`
`weeklyquest.json`	`atlas_weeklyquest`
`family.json`	`atlas_family`

Add a language by copying locales/en/<namespace>.json → locales/<code>/.

Lua API

lua

shared_script '@atlas_extras/imports.lua'

L('chat.ui.placeholder')
L('garages.takeOut')

local T = AtlasLocale.ns('garages')
T('takeOut', plate)

AtlasLocale.table('admin') -- full pack for NUI

NUI

Push after ready and on atlas_locale:changed:

lua

AtlasLocale.pushNui('chat')

HTML:

html

<script src="nui://atlas_extras/web/nui_locale.js"></script>
<input data-i18n="ui.placeholder" data-i18n-attr="placeholder">

Checklist

Keys in atlas_extras/locales/en/<namespace>.json
Client pushes pack on open/ready
UI reads via AtlasUI / pushed locale — no hardcoded English for new strings