Motor compatible · Kirikiri / KAG
Traductor de Kirikiri — traduce novelas visuales KAG y archivos XP3
Kirikiri (y su capa de scripting KAG) es el motor dominante de novelas visuales japonesas — gran parte de los lanzamientos comerciales de VN de los últimos 15 años se asientan en él. RuneTranslate incluye un lector y escritor de XP3 completo que abre automáticamente los archivos empaquetados (incluido, en los títulos que reconoce, el formato más nuevo que usan algunos lanzamientos recientes), compatibilidad con archivos de escenario codificados y escenarios PSB (.scn) compilados, y extracción inteligente para anotaciones ruby, nombres de personajes, etiquetas de botón, texto glink y marcadores de posición de campos de edición. La compilación traducida emite archivos sueltos, más un hook de prioridad de rutas AfterInit2.tjs que le dice al motor que los cargue con preferencia sobre el contenido original del XP3, y un archivo de parche que el motor monta después del suyo en los juegos que se saltan el hook, así que nunca necesitas reempaquetar el archivo original. ¿La coherencia de nombres de personaje a lo largo de las docenas de escenarios que una VN de Kirikiri suele publicar? Para eso es la función Glosario de nivel Supporter — añade el nombre de la heroína una vez, cada archivo de escenario lo traduce igual.
Las VN de Kirikiri suelen repartir su diálogo a lo largo de docenas de archivos de escenario separados, cada uno traducido en su propio lote. Sin un glosario, eso es una receta para que el mismo nombre de personaje derive a lo largo de los capítulos. Añade cada hablante con nombre (especialmente los cuyo nombre usa kanji que los traductores automáticos cambian rutinariamente), los nombres de ubicación y la terminología característica de ataque/hechizo. Ventaja: las anotaciones ruby KAG en línea se enmascaran como etiquetas, así que las sustituciones del glosario aterrizan correctamente incluso en líneas con etiquetas [ruby] / [name] en línea.
Cómo traducir Kirikiri / KAG
- PASO 1
Abre la carpeta del juego de Kirikiri
Apunta RuneTranslate al directorio que contiene el .exe del motor (krkr.eXe, krkrZ.exe, etc.). La detección del motor busca archivos XP3 + el formato de escenario .ks. Los archivos XP3 empaquetados se abren automáticamente, sin nada que configurar.
- PASO 2
Extrae diálogo, ruby, nombres y etiquetas de botón
RuneTranslate analiza los escenarios .ks con un tokenizador consciente de KAG. Las cadenas traducibles se extraen de las líneas de diálogo, y de las etiquetas [ruby], [ch], [name], [title], [button], [checkbox] y [edit text="..."]. Las etiquetas KAG en línea ([r], [p], [改ページ], [font]) se enmascaran como marcadores de posición opacos para que el LLM las preserve.
- PASO 3
Traduce con el proveedor de tu elección
Elige un proveedor — DeepL es el caballo de batalla para los scripts largos de Kirikiri por su precio y su calidad JA→EN. OpenAI y Anthropic son los más fuertes para el diálogo con fuerte voz de personaje. Google Translate gratuito maneja las cadenas de menú de forma barata vía enrutamiento de proveedores en el nivel Supporter / Pro.
- PASO 4
Exporta archivos sueltos + hook AfterInit2.tjs
Al exportar, RuneTranslate escribe los scripts traducidos como archivos sueltos más un hook AfterInit2.tjs en la raíz del juego, y un patch.xp3 que el motor monta después de sus propios archivos. El hook pone los archivos sueltos primero en el orden de búsqueda y el parche cubre los juegos que se saltan el hook, así que los scripts traducidos ganan sobre el contenido empaquetado del XP3. El archivo original permanece intacto.
Admite
- Lectura y escritura de archivos XP3, con los archivos empaquetados abiertos automáticamente
- Lectura de archivos de escenario codificados
- Anotaciones ruby, nombres de personajes, etiquetas de botón
- Etiquetas [name], [title], [button], [checkbox], [edit text=...]
- Etiquetas KAG en línea ([r], [p], [改ページ], [font color=...]) preservadas
- Hook de prioridad de rutas AfterInit2.tjs más un patch.xp3 (sin necesidad de reempaquetar)
Limitaciones
- Un formato raro de archivo empaquetado que la app aún no reconoce no se lee
- El bytecode KAG compilado (.ks con magic `jk` que no se puede leer como texto) no está soportado
- El Kirikiri 1.x de motor original (no Z) no probado pero típicamente funciona

