PONEGLYPHSTUDIOS

Referencia

Idiomas

Cinco idiomas integrados (EN/ES/FR/DE/PT) y como anadir o editar uno mediante los archivos de idioma abiertos.

PSTUDIOS-HUD viene con cinco idiomas de fabrica. Eliges uno con Config.Locale y puedes editar o anadir mas, porque los archivos de idioma quedan abiertos en el escrow.

Idiomas integrados

  • Ingles ('en')
  • Espanol ('es')
  • Frances ('fr')
  • Aleman ('de')
  • Portugues ('pt')

Define el idioma activo en config.lua. El valor por defecto es 'es'. Consulta Configuración (config.lua) para ver dónde está esta opción.

Config.Locale = 'es'  -- 'es' / 'en' / 'fr' / 'de' / 'pt'
Eleccion del idioma del HUD en config.lua.

Archivos de idioma editables (escrow_ignore)

Cuando el recurso se protege con el escrow de keymaster, todo se cifra EXCEPTO los archivos listados en escrow_ignore. Los archivos de idioma se dejan abiertos a proposito, asi que puedes traducir y anadir idiomas sin tocar el codigo protegido.

escrow_ignore {
    'config.lua',         -- el cliente ajusta todo desde aqui
    'locales/*.lua',      -- traducciones editables / anadir idiomas
    'README.md',
    'CHANGELOG.md',
}
Del fxmanifest.lua: locales/*.lua queda editable para traducir y anadir idiomas.

Que se puede traducir

Cada archivo de idioma define dos grupos de cadenas: las descripciones de teclas (mostrar/ocultar HUD, cinturon, control de crucero, abrir ajustes) y las cadenas de la NUI (textos de sin ruta y destino, etiquetas de unidades para km/h, mph y nudos, y las etiquetas del menu de ajustes). Los puntos cardinales de la brujula usan la convencion internacional N/NE/E y no se traducen.

Como anadir un idioma nuevo

  1. Copia locales/en.lua a locales/xx.lua (sustituye xx por tu codigo de idioma).
  2. Traduce las cadenas de dentro, manteniendo las claves sin cambios.
  3. Registra el archivo nuevo en fxmanifest.lua dentro de client_scripts.
  4. Define Config.Locale = 'xx' y reinicia el recurso.
Locales = Locales or {}
Locales['es'] = {
    key_togglehud = 'PSTUDIOS-HUD: mostrar/ocultar HUD',
    key_seatbelt  = 'PSTUDIOS-HUD: cinturon',
    key_cruise    = 'PSTUDIOS-HUD: control de crucero',
    key_menu      = 'PSTUDIOS-HUD: abrir ajustes',

    nui = {
        noRoute = 'SIN RUTA',
        waypoint = 'DESTINO',
        kmh = 'KM/H', mph = 'MPH', knots = 'NUDOS',
        km  = 'KM',   mi  = 'MI',  nm    = 'MN',
    },
}
Estructura de un archivo de idioma (locales/es.lua), abreviado. Manten las claves; traduce los valores.
⚠️Un archivo de idioma nuevo debe estar listado en fxmanifest.lua. El cargador i18n y los archivos de idioma deben cargarse antes que utils/seatbelt/main, que usan _U(...) en el momento de carga (RegisterKeyMapping), asi que mantenlos en ese orden.