🌍Localization

NOVA Framework has built-in multi-language support. Currently supports Portuguese (PT) and English (EN).

Core Localization

Using Translations

In any core module or script that depends on nova_core:

-- Server-side or shared (inside nova_core)
local text = _L('player_loaded')
local formatted = _L('admin_give_item', 'bread', 5, 'PlayerName')

Adding Core Translations

Portuguese: nova_core/config/locales/pt.lua

NovaLocale.RegisterLocale('pt', {
    ['my_key'] = 'Minha tradução',
    ['welcome_msg'] = 'Bem-vindo ao servidor, %s!',
})

English: nova_core/config/locales/en.lua

NovaLocale.RegisterLocale('en', {
    ['my_key'] = 'My translation',
    ['welcome_msg'] = 'Welcome to the server, %s!',
})

Setting the Language

In nova_core/config/main.lua:

Config.Locale = 'pt'  -- or 'en'

Script Localization

Each launch script has its own locales.lua file with a self-contained system.

Structure

-- nova_bank/locales.lua

local Locales = {
    ['pt'] = {
        ['not_enough_cash'] = 'Dinheiro insuficiente!',
        ['deposit_success'] = 'Depósito de $%s realizado!',
        -- NUI labels
        ['nui_deposit'] = 'Depositar',
        ['nui_withdraw'] = 'Levantar',
    },
    ['en'] = {
        ['not_enough_cash'] = 'Not enough cash!',
        ['deposit_success'] = '$%s deposited successfully!',
        -- NUI labels
        ['nui_deposit'] = 'Deposit',
        ['nui_withdraw'] = 'Withdraw',
    },
}

local currentLocale = nil

local function getLocale()
    if not currentLocale then
        local ok, cfg = pcall(function()
            return exports['nova_core']:GetConfig()
        end)
        currentLocale = (ok and cfg and cfg.Locale) or 'pt'
    end
    return currentLocale
end

function BankL(key, ...)
    local lang = getLocale()
    local str = (Locales[lang] and Locales[lang][key])
        or (Locales['pt'] and Locales['pt'][key])
        or key
    if select('#', ...) > 0 then
        return string.format(str, ...)
    end
    return str
end

function BankGetAllStrings()
    local lang = getLocale()
    return Locales[lang] or Locales['pt'] or {}
end

Using in Lua

-- In server or client scripts
local msg = BankL('not_enough_cash')
local msg2 = BankL('deposit_success', 5000)

Using in NUI (JavaScript)

Pass all strings to the NUI when opening:

-- client/main.lua
SendNUIMessage({
    action = 'open',
    locale = BankGetAllStrings(),
    -- other data...
})

Then apply in JavaScript:

var locale = {};

window.addEventListener('message', function(event) {
    var d = event.data;
    if (d.action === 'open') {
        locale = d.locale || {};
        applyLocale();
    }
});

function applyLocale() {
    var map = {
        'i18n-deposit': 'nui_deposit',
        'i18n-withdraw': 'nui_withdraw',
    };
    for (var id in map) {
        var el = document.getElementById(id);
        if (el && locale[map[id]]) {
            el.textContent = locale[map[id]];
        }
    }
}

Adding a New Language

1. Add translations to nova_core/config/locales/ (e.g., es.lua for Spanish)

2. Add translations to each script's locales.lua

3. Set Config.Locale = 'es' in the core config

-- nova_core/config/locales/es.lua
NovaLocale.RegisterLocale('es', {
    ['player_loaded'] = '¡Personaje cargado!',
    -- ... all keys
})