API delle locale

Tutto questo viene da bs_core/shared/sh_locale.lua. Come preparare una resource alla traduzione è spiegato in Lingue. Questa pagina è il riferimento.

Lingue: en, pt, de, pl, tr, es, fr, it, ru. Le chiavi mancanti ripiegano su en, poi sulla chiave stessa.

Includerlo

shared_scripts { '@bs_core/shared/sh_locale.lua' }
files { 'locales/*.lua' }

Ogni locales/<lang>.lua restituisce una tabella piatta:

return {
    ['shop.title'] = 'Trader',
    ['shop.bought'] = 'You bought {item} for ${price}',
}

I placeholder sono {name}. Un placeholder sconosciuto viene lasciato com’è, così gli errori di battitura si vedono invece di sparire.

Funzioni Lua

Funzione	Lato	Cosa fa
L(key, vars)	client	Testo nella lingua del giocatore locale
L(key, vars)	server	Testo nella lingua predefinita del server
L(src, key, vars)	server	Testo nella lingua di quel giocatore
Lp(src, key, vars)	server	Come sopra, prende sempre un source
BSLocale.T(lang, key, vars)	entrambi	Testo in una lingua che indichi
BSLocale.Lang()	entrambi	Lingua del giocatore locale (client) o quella predefinita (server)
BSLocale.LangOf(src)	entrambi	Lingua di un giocatore, ripiega su quella predefinita
BSLocale.Default()	entrambi	Predefinita del server (GlobalState.bs_defaultLang, altrimenti en)
BSLocale.IsValid(lang)	entrambi	Se è uno dei nove codici
BSLocale.Dict(lang)	entrambi	L’intera tabella con en sotto, per NUI
BSLocale.OnChange(fn)	client	fn(lang) gira quando la lingua cambia
BSLocale.Set(lang)	client	Chiede a bs_core di cambiare la lingua del giocatore
BSLocale.Languages, BSLocale.Native	entrambi	L’elenco dei codici e i nomi nativi

Export del server: exports.bs_core:GetLanguage(src).

Sul server passa sempre il source del giocatore quando il testo va a un solo giocatore. L('key') senza source usa la lingua predefinita del server, che per una notifica è sbagliata.

TriggerClientEvent('bs:ui:notify', src, { type = 'success', message = L(src, 'shop.bought', { item = label, price = 50 }) })

Stato

• Scelta del giocatore: state bag bs_lang sul giocatore.
• Predefinita del server: GlobalState.bs_defaultLang (F1 Global.defaultLanguage, o la convar bs_defaultLanguage).
• Salvata per account in bs_users.language.
• Cambiarla scatena l’evento server bs_core:setLanguage.

NUI

Se la resource ha una ui_page, lo script di locale risponde al callback NUI bs_i18n con { lang, dict } e invia la nuova tabella quando la lingua cambia. Carica l’helper e marca il tuo HTML:

<script src="nui://bs_ui/html/js/i18n.js"></script>
<span data-i18n="ui.level">LEVEL</span>

In JS: t('key', vars) e BSI18n.onChange(fn). Dettagli in Lingue.