Cómo traducir un juego de TyranoBuilder / TyranoScript al inglés

TyranoBuilder y el motor subyacente TyranoScript impulsan un amplio catálogo de novelas visuales japonesas indie — la alternativa de tecnología web (HTML5 / JavaScript) a Kirikiri y Ren’Py, publicada ya sea como carpetas HTML5 independientes o como ejecutables envueltos en Electron. Sus escenarios usan la misma sintaxis .ks al estilo KAG que Kirikiri, así que el texto es fácil de alcanzar una vez que sabes dónde vive. Esta guía recorre la traducción de un juego de TyranoBuilder de principio a fin con RuneTranslate, incluida la parte que la mayoría de las herramientas se saltan: los nombres de visualización de los personajes.

Qué necesitas

• RuneTranslate para Windows — gratis, todos los motores y proveedores desbloqueados.
• Un juego de TyranoBuilder: una carpeta HTML5 independiente (directorios data/ y tyrano/ sueltos) o una compilación de Electron (un resources/app.asar que contiene tyrano/tyrano.js y data/scenario/*.ks). RuneTranslate detecta ambos.
• Un idioma de destino — inglés, español, francés, alemán, chino y 30+ más.
• Un proveedor. Las novelas visuales tienen muchos diálogos, así que un LLM (OpenAI / Anthropic) o DeepL leen mejor; Google Translate gratuito funciona sin más.

Paso 1: Abre la carpeta del juego

Inicia RuneTranslate, haz clic en Nuevo proyecto y apúntalo al directorio del juego (o a la carpeta que contiene el .exe para compilaciones de Electron). La detección reconoce TyranoBuilder por su motor de ejecución tyrano/ más los scripts data/scenario/; para compilaciones de Electron lee el app.asar directamente, así que nunca desempaquetas nada. Tu juego original nunca se modifica.

Paso 2: Cómo se extraen las cadenas

RuneTranslate extrae texto traducible de todas partes donde TyranoBuilder lo almacena:

• Scripts de escenario — cada archivo data/scenario/**/*.ks, incluidos _preview.ks y los espejos system/_*.ks de los que dependen las compilaciones cifradas.
• Interfaz y configuración — tyrano/lang.js y data/system/Config.tjs.
• Nombres de visualización de personajes — las etiquetas de hablante mostradas encima del diálogo (siguiente sección).

Las etiquetas KAG en línea — saltos de línea [r], esperas de clic [p], saltos de página [改ページ], [font color=...] y etiquetas con nombre japonés — se enmascaran tras marcadores de posición numéricos [[U#]] antes de que nada llegue al proveedor, y luego se restauran al exportar, así que el formato sobrevive intacto. Los archivos .ks binarios o cifrados se detectan mediante un olfateo de UTF-8 y nunca se sobrescriben.

Paso 3: Nombres de personajes — la parte específica de Tyrano

Los escenarios a menudo se dirigen a un hablante con un atajo en línea como [yuki] — un ID de personaje, no texto de visualización. RuneTranslate nunca reescribe esas referencias (eso rompería la búsqueda de personajes del motor y haría fallar la escena). En su lugar, traduce el nombre de visualización e inyecta una entrada [chara_new name=... jname=...] adecuada en data/system/chara_define.ks al exportar. El nombre que se muestra en pantalla se traduce; el ID que usa el script permanece intacto.

Paso 4: Traduce y revisa

Elige un proveedor y ejecuta. Un LLM (OpenAI / Anthropic) lee mejor para la voz de los personajes; DeepL es rápido y limpio para la narración; Google Translate gratuito cubre los menús. Pon en el glosario a tu reparto y los términos recurrentes primero para que los nombres se rendericen de forma idéntica en todas las rutas — consulta Glosario 101. Cada línea cae en el editor junto a su origen; edita en línea (se guarda al perder el foco o con Ctrl+Enter), usa buscar y reemplazar, o ejecuta el refinador de IA opcional para un segundo pase consciente del contexto. El nivel gratuito tiene un límite modesto de velocidad — aproximadamente la mitad del rendimiento de pago en los proveedores de IA — con calidad de salida idéntica.

Paso 5: Exporta una versión jugable

Haz clic en Exportar. Para juegos HTML5 independientes, RuneTranslate escribe los scripts .ks traducidos, lang.js, la configuración y el chara_define.ks inyectado en una copia del juego. Para compilaciones de Electron reempaqueta un app.asar modificado. En cualquier caso obtienes una copia completa y ejecutable en la ubicación que elijas — lánzala y se juega en tu idioma de destino.

Limitaciones conocidas

• Los archivos .ks cifrados (detectados como no UTF-8) se dejan intactos, así que los escenarios de una compilación cifrada no se traducirán.
• El texto en imágenes (logos, interfaz dibujada a mano, subtítulos de CG) queda fuera del alcance de la traducción automática.
• Los plugins personalizados que construyen diálogo en tiempo de ejecución pueden necesitar una rápida corrección manual en el editor.

Por qué esto es más fácil que la forma antigua

La ruta manual significaba desempaquetar el app.asar, encontrar cada archivo .ks (incluidos los espejos de sistema fáciles de pasar por alto), traducir sorteando las etiquetas KAG a mano, resolver la inyección de nombres de personajes y luego reempaquetar el asar sin corromperlo. RuneTranslate pliega toda la cadena en unos pocos clics, con el editor abierto para que tú controles la redacción.

Consulta la página del motor TyranoBuilder para la lista completa de funciones, lee la guía de Kirikiri para el motor KAG relacionado, o descarga RuneTranslate y pruébalo en un juego real.