Cómo traducir scripts FiveM de forma segura (manual + IA)

Traduzca los valores de configuración regional existentes del recurso conservando las claves, los marcadores de posición, los códigos de control y la sintaxis del archivo. La edición manual ofrece el máximo control; la IA puede acelerar un lote revisado. Ninguno de los métodos hace que sea seguro traducir cada cadena entre comillas en el código fuente.

Revisado el 9 de agosto de 2026 según el Cfx.re oficial referencia del manifiesto de recursos y guía de sandbox, más el actual manual de Notepad++ y documentación de DeepL.

Encuentre el sistema de configuración regional compatible

Lea la documentación del recurso y fxmanifest.lua. Busque directorios de configuración regional, diccionarios JSON/Lua, archivos de traducción NUI y una configuración de idioma. Utilice el sistema que el creador envía. No agregue lua54 como una corrección de traducción; esa opción de manifiesto está obsoleta y no está relacionada con la localización.

Haga una copia de seguridad e inventario de las cadenas visibles

Copie el recurso o cree una rama de control de versiones.
Registre la versión exacta y el idioma configurado.
Enumere las etiquetas visibles para el jugador, las notificaciones, el texto del menú y los mensajes de ayuda.
Excluya claves, nombres de eventos, comandos, columnas de bases de datos, rutas de archivos e identificadores a menos que la documentación los marque explícitamente como traducibles.
Cree un glosario para términos de framework, trabajos, elementos y terminología del servidor.

Método manual: editar solo valores

En un editor con reconocimiento de sintaxis como Notepad++, cambie el valor legible por humanos en el lado derecho mientras mantiene la clave y la estructura intactas.

{
  "garage_open": "Open garage",
  "price_label": "Price: %s"
}

Para otro idioma, traduzca Open garage y Price, pero conservar garage_open, price_label y %s. Mantenga las secuencias de escape, comillas, comas, llaves, códigos de color como ~r~, y tokens de formato como %s, %d o {name} exacto.

Método de IA: enviar un lote de valores restringidos

Proporcione solo las entradas de configuración regional necesarias para la traducción, no todo el recurso privado, la configuración del servidor, la clave de licencia, el webhook, los datos del jugador o la exportación de la base de datos. Indique el idioma de origen y de destino, el glosario y los tokens invariantes. Requerir el mismo formato estructurado y pedirle al modelo que deje las claves y todos los marcadores de posición sin cambios.

La salida de la IA es un borrador. Los modelos pueden cambiar el nombre de una clave, alterar la puntuación, traducir un comando, eliminar un marcador de posición o devolver JSON/Lua no válidos mientras suenan seguros. Revise la diferencia entrada por entrada.

Validar antes de iniciar el recurso

Analice JSON con un analizador JSON y Lua con el flujo de trabajo de lint/prueba compatible con el proyecto.
Compare el conjunto completo de claves con la configuración regional de origen.
Compruebe la paridad exacta de los marcadores de posición y los códigos de control por entrada.
Busque cambios accidentales en comandos, nombres de eventos y URL.
Inspeccione la diferencia en busca de comentarios añadidos o vallas de Markdown.

Pruebe en el UI

Inicie la configuración regional traducida en el entorno de prueba y recorra cada flujo visible: menú, notificación, error, confirmación, validación de entrada y texto de ayuda. Compruebe el recorte, los saltos de línea, los caracteres acentuados, los errores de plural/contexto y el comportamiento de derecha a izquierda cuando corresponda. Revise el navegador/NUI, F8 y los registros del servidor.

Cree una memoria de traducción reutilizable

Almacene los pares de origen/valor aprobados, las decisiones del glosario y las notas del revisor fuera del paquete del proveedor. Cuando el recurso se actualice, compare la nueva configuración regional de origen con la versión anterior y traduzca solo las claves añadidas o modificadas. Nunca sobrescriba una nueva configuración regional del proveedor a ciegas con un archivo completo antiguo.

Revierta de forma segura

Mantenga la configuración regional y la configuración originales disponibles. Si el análisis, UI o el comportamiento en tiempo de ejecución retrocede, restaure los archivos conocidos como buenos, reinicie el recurso y confirme que el idioma predeterminado funciona. Corrija la traducción en una nueva versión en lugar de editar la producción sin una diferencia.