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

Traduce 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.

Encuentra el sistema de configuración regional compatible

Lee la documentación del recurso y fxmanifest.lua. Busca directorios de configuración regional, diccionarios JSON/Lua, archivos de traducción NUI y una configuración de idioma. Usa el sistema que proporciona el creador. No añadas lua54 como una corrección de traducción; esa opción de manifiesto está obsoleta y no está relacionada con la localización.

Haz una copia de seguridad e inventaría las cadenas visibles

1. Copia el recurso o crea una rama de control de versiones.
2. Registra la versión exacta y el idioma configurado.
3. Enumera las etiquetas visibles para el jugador, las notificaciones, el texto del menú y los mensajes de ayuda.
4. Excluye 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.
5. Crea un glosario para los términos del framework, los trabajos, los objetos y la terminología del servidor.

Método manual: edita solo los valores

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

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

Para otro idioma, traduce Open garage y Price, pero conserva garage_open, price_label y %s. Mantén las secuencias de escape, comillas, comas, llaves, códigos de color como ~r~, y tokens de formato como %s, %d o {name} intactos.

Método con IA: envía un lote limitado que contenga solo los valores

Proporciona 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 de los jugadores ni la exportación de la base de datos. Indica el idioma de origen y el de destino, el glosario y los tokens invariables. Exige el mismo formato estructurado y pide al modelo que deje sin cambios las claves y todos los marcadores de posición.

La salida de la IA es un borrador. Los modelos pueden renombrar una clave, alterar la puntuación, traducir un comando, eliminar un marcador de posición o devolver JSON/Lua no válidos, aunque suenen muy convincentes. Revisa el diff entrada por entrada.

Valida antes de iniciar el recurso

• Analiza el JSON con un analizador JSON y el Lua con el flujo de trabajo de lint/pruebas admitido por el proyecto.
• Compara el conjunto completo de claves con la configuración regional de origen.
• Verifica la paridad exacta de marcadores de posición y códigos de control por entrada.
• Busca cambios accidentales en comandos, nombres de eventos y URL.
• Inspecciona el diff en busca de comentarios añadidos o delimitadores de código Markdown.

Prueba en la UI

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

Crea una memoria de traducción reutilizable

Almacena 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, compara la nueva configuración regional de origen con la versión anterior y traduce solo las claves añadidas o modificadas. Nunca sobrescribas una nueva configuración regional del proveedor a ciegas con un archivo completo antiguo.

Revierte de forma segura

Mantén disponibles la configuración regional y la configuración originales. Si el análisis, la interfaz o el comportamiento en tiempo de ejecución empeora, restaura los archivos que sabes que funcionan, reinicia el recurso y confirma que el idioma predeterminado funciona. Corrige la traducción en una versión nueva en lugar de editar producción sin comparar los cambios.