kirikiri · tutorial · engine
Cómo traducir una novela visual Kirikiri / KAG al español
Traduce novelas visuales Kirikiri / KAG al español con RuneTranslate — leyendo automáticamente los archivos .xp3 empaquetados, traduciendo escenarios KAG .ks y escenas PSB, y exportando un patch.xp3 que el juego carga automáticamente.
Kirikiri (吉里吉里) y su capa de escenario KAG impulsan una enorme porción de las novelas visuales japonesas. El inconveniente: Kirikiri empaqueta sus scripts, arte y audio en archivos .xp3, y muchos estudios usan encima su propia variante de archivo. Por eso Kirikiri tiene reputación de ser difícil de traducir. Esta guía recorre cómo hacerlo de principio a fin con RuneTranslate: leer el .xp3, traducir los escenarios KAG .ks y exportar un parche que el juego carga automáticamente.
Qué necesitas
- RuneTranslate para Windows o Linux — gratis, todos los motores y todos los proveedores excepto RuneLingua desbloqueados.
- Una carpeta de juego de Kirikiri — el directorio con el
.exedel juego y uno o más archivos.xp3(comúnmentedata.xp3,scenario.xp3, etc.). Las compilaciones firmadas de KirikiriZ con archivos.exe.emb/.xp3.sigtambién se reconocen. - Un idioma de destino — inglés, español, francés, alemán, portugués, ruso, chino, italiano, turco, vietnamita y 20+ más.
- Un proveedor de traducción. Las novelas visuales tienen muchos diálogos, así que un LLM (OpenAI / Anthropic) o DeepL suelen leer mejor; Google Translate gratuito funciona sin más.
Paso 1: Abre el juego y desempaqueta el XP3
Inicia RuneTranslate, haz clic en Nuevo proyecto y apúntalo al directorio del juego de Kirikiri. La detección del motor se ejecuta automáticamente. El lector de XP3 integrado abre el índice del archivo — incluida la cabecera de índice comprimido de 17 bytes que usan los archivos grandes — y extrae los archivos de escenario. Tus archivos originales nunca se modifican.
Los archivos empaquetados se abren automáticamente, incluido, en los títulos que RuneTranslate reconoce, el formato más reciente que usan algunos lanzamientos recientes. Unos pocos formatos raros todavía no se reconocen.
Paso 2: Cómo se extrae el diálogo de Kirikiri
Kirikiri almacena el diálogo en scripts de escenario KAG .ks. RuneTranslate los analiza y lista el texto traducible en el editor:
- Diálogo y narración — las líneas de escenario en bruto.
- Extracción inteligente de atributos — el texto legible dentro de etiquetas como
[ruby/],[ch text="..."],[name text="..."]y[button text="..."]se extrae y se traduce, mientras que la estructura de la etiqueta en sí se preserva.
Las etiquetas de control KAG en línea se enmascaran tras marcadores de posición numéricos [[K#]] antes de que nada llegue al proveedor, así que la máquina no puede romper el formato del motor. Algunos juegos de KirikiriZ también publican su escenario como un binario PSB .scn compilado (el formato PSB\0) — RuneTranslate analiza y reempaqueta también escenarios PSB estándar (versiones de formato 1 a 4), así que esos juegos se traducen igual que los scripts de texto.
Paso 3: Traduce y revisa
Elige un proveedor y ejecuta. Para la voz de los personajes y el habla estilizada, un LLM como OpenAI o Anthropic lee mejor; 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 cada ruta renderice los nombres de forma idéntica — consulta Glosario 101. En el nivel gratuito la traducción tiene un límite modesto — aproximadamente 2x más lenta en los proveedores de IA, menos en los proveedores gratuitos — con calidad de salida idéntica; los niveles de pago corren a máxima velocidad y añaden memoria de traducción.
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 una revisión de segundo pase consciente del contexto — valioso en rutas largas de VN.
Paso 4: Exporta un parche
Haz clic en Exportar. RuneTranslate escribe el escenario traducido como archivos sueltos más un hook de arranque y, donde ayuda, un patch.xp3 plano. Usa dos rutas de sobreescritura porque ninguna es universal por sí sola:
- Archivos sueltos + hook de arranque — la llamada
addAutoPathdel hook eleva los archivos sueltos por encima de los archivos del juego. Como distintas compilaciones ejecutan un punto de entrada de inicio diferente, RuneTranslate escribe el hook bajo los tres nombres que usan los juegos —AfterInit2.tjs,xAfterInit2.tjsyxAfterInit.tjs— así que el que llame el juego lo recoge. - patch.xp3 — Kirikiri monta automáticamente
patch.xp3/patch2.xp3con mayor prioridad que los propios archivos del juego («ganan las rutas posteriores»), así que sobrescribe incluso cuando un juego desactiva el hook de arranque. El parche se escribe en una forma que el juego acepta. Algunas compilaciones rechazan unpatch.xp3adicional, así que en esas el hook de archivos sueltos es la ruta que lleva la traducción.
La salida es tu traducción colocada junto al juego original. Lanza el .exe y se juega en tu idioma de destino.
Limitaciones conocidas
- Un formato de archivo empaquetado raro que la aplicación todavía no reconoce no tiene soporte. La mayoría de los juegos comerciales se abren, pero no todos los casos atípicos.
- Los escenarios PSB
.scnno estándar / comprimidos con MDF se saltan; solo hay soporte para PSB estándar (versiones 1–4). - El bytecode KAG
.kscompilado o tokenizado (binario / magicjkque no se decodifica a texto) se salta — solo se analizan los scripts KAG legibles y los escenarios PSB estándar. - El texto en imágenes (logos, interfaz dibujada a mano, subtítulos de CG) no forma parte de los scripts; tradúcelo en Image Studio, que lee las imágenes directamente de los archivos XP3 (TLG incluido) y entrega el arte traducido de la misma forma que los scripts.
Por qué esto es más fácil que la forma antigua
La ruta manual significaba identificar el formato de archivo, extraer el XP3 con una herramienta de desempaquetado aparte, encontrar a mano el texto legible dentro de las etiquetas KAG, traducirlo sin romper el marcado y luego reempaquetar o conectar una ruta de sobreescritura correctamente. RuneTranslate pliega toda la cadena — desempaquetar, extraer, enmascarar etiquetas, traducir, construir tanto el hook suelto como el patch.xp3 — en unos pocos clics, con el editor abierto para que tú controles la redacción.
Consulta la página del motor Kirikiri para la lista completa de funciones, lee la guía de Ren’Py para otro motor de novela visual, o descarga RuneTranslate y pruébalo en un juego real.
Lecturas relacionadas
¿Listo para probar RuneTranslate?
El plan gratuito desbloquea todos los motores y todos los proveedores de traducción salvo RuneLingua. Supporter ($3.99/mo) desbloquea la velocidad completa.
Descargar para Windows, Mac y Linux
