Cómo traducir un juego de Ren’Py al inglés (tutorial completo)

Ren’Py es el motor basado en Python detrás de la mayoría de las novelas visuales occidentales y japonesas — desde diminutas jams de itch.io hasta títulos comerciales de DLsite. Es uno de los motores más limpios de traducir: RuneTranslate nunca sobrescribe el guion original, superpone la traducción encima para que el juego se mantenga intacto. Esta guía recorre la traducción de un juego de Ren’Py al inglés (o a cualquier idioma) de principio a fin con RuneTranslate, incluidas las tres formas en que se publica un juego de Ren’Py — código fuente .rpy suelto, solo compilado .rpyc y archivado .rpa.

Qué necesitas

• RuneTranslate para Windows — gratis, todos los motores y proveedores desbloqueados.
• Una carpeta de juego de Ren’Py. Es el directorio que contiene el .exe del juego más una subcarpeta game/ (que contiene archivos .rpy, .rpyc y/o .rpa).
• 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. Google Translate gratuito funciona sin más; DeepL tiene un nivel gratuito; OpenAI, Anthropic, un modelo local (Ollama / LM Studio) y cualquier API compatible con OpenAI requieren tu propia clave. Las novelas visuales tienen muchos diálogos y son sensibles al tono, así que un LLM (OpenAI / Anthropic) o DeepL suelen leer mejor.

Paso 1: Abre la carpeta del juego

Inicia RuneTranslate, haz clic en Nuevo proyecto y apúntalo al directorio del juego de Ren’Py (la carpeta con el .exe, o la carpeta interna game/). La detección del motor se ejecuta automáticamente y reconoce el proyecto como Ren’Py en cuanto ve un árbol game/.

Cómo se lee el texto depende de lo que publicó el desarrollador:

• Juegos con código fuente — scripts .rpy sueltos bajo game/. RuneTranslate los analiza directamente. Este es el caso ideal.
• Juegos solo compilados — solo bytecode .rpyc. Un sidecar unrpyc incluido los descompila de vuelta a .rpy legible primero, y luego los analiza con normalidad.
• Juegos archivados — scripts empaquetados en un archivo .rpa. RuneTranslate lo desempaqueta con un rpatool incluido y parcheado en un espacio de trabajo por proyecto bajo %APPDATA%/RuneTranslate/renpy-workspace/<projectId>/, descompila y luego analiza. Nuestro fork de rpatool detecta automáticamente las claves de archivo RPA-x.y ofuscadas y personalizadas por proveedor, así que abre muchos archivos que las herramientas originales rechazan.

Tu carpeta de juego original nunca se modifica.

Paso 2: Cómo se extrae el texto de Ren’Py

RuneTranslate extrae las declaraciones say (diálogo), las opciones de menu y el texto de interfaz traducible del script y los lista en el editor, agrupados por archivo. El marcado de texto de Ren’Py — {b}, {color=#fff}, esperas {w}, cursivas {i} e interpolaciones de variables al estilo [player_name] — se enmascara tras marcadores de posición numéricos [[R#]] antes de que nada llegue al proveedor, y luego se restaura a la salida. La máquina nunca ve las etiquetas, así que no puede estropearlas, eliminarlas ni traducirlas.

Paso 3: Traduce

Elige un proveedor y ejecuta. Para una novela visual de longitud media (~8.000–15.000 líneas) en el nivel Supporter:

• OpenAI / Anthropic — lo mejor para la voz de los personajes, los chistes y el habla estilizada; aproximadamente unos pocos dólares de coste de API para un juego completo. El editor muestra una estimación de tokens + USD antes de que te comprometas.
• DeepL — rápido y limpio para la narración; el nivel gratuito cubre 500.000 caracteres/mes.
• Google Translate gratuito — $0, va bien para menús y líneas cortas, más flojo en diálogo.

Pon en el glosario a tu reparto y los términos recurrentes desde el principio para que cada escena 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 raspadores gratuitos (menor concurrencia, lotes más pequeños, una breve pausa entre lotes) — con calidad de salida idéntica. Los niveles de pago corren a máxima velocidad y añaden memoria de traducción y enrutamiento de proveedores.

Paso 4: Revisa en el editor

Cada línea cae en la tabla junto a su origen — japonés por defecto, o el idioma que hayas configurado en el proyecto (chino, coreano, inglés y más). Edita en línea cualquier cosa que la máquina se equivocó (se guarda automáticamente al perder el foco o con Ctrl+Enter), usa buscar y reemplazar para un término que renombraste, o ejecuta el refinador de IA opcional para una revisión de segundo pase consciente del contexto. Como el diálogo de Ren’Py es de formato largo, aquí es donde ocurre el pulido.

Paso 5: Exporta una versión jugable

Haz clic en Exportar. RuneTranslate no depende de que Ren’Py prefiera un .rpy suelto en tl/ — eso solo funciona para el texto indexado por ids de diálogo, que los juegos compilados no reparten de forma fiable. En su lugar, deja unos archivos en game/ y aplica la traducción en tiempo de ejecución:

• rt_translations.json — un mapa de texto-de-origen → traducción para cada línea de diálogo y de menú.
• zzz_runetranslate_language.rpy — un pequeño hook de tiempo de ejecución que instala un config.say_menu_text_filter. Empareja cada línea que el juego está a punto de mostrar con el mapa e intercambia tu traducción, y fuerza el idioma activo del juego al traducido para que el texto de pantalla e interfaz siga.
• tl/translated/translation.rpy — contiene solo las cadenas de interfaz / pantalla _() (botones, menús, tooltips), que Ren’Py sí resuelve de forma fiable por su propio mecanismo.
• Una fuente incluida más zzz_runetranslate_font.rpy cuando el idioma de destino la necesita — consulta la nota sobre no latinos abajo.

Ejecuta el .exe del juego y se juega en tu idioma de destino, con los scripts y archivos originales intactos. Para volver atrás, elimina los archivos que RuneTranslate añadió — rt_translations.json, zzz_runetranslate_language.rpy, la fuente incluida y su .rpy, y tl/translated/.

Idiomas no latinos

La mayoría de los juegos de Ren’Py publican una fuente solo latina, así que el chino, el coreano, el japonés, el tailandés o el árabe de otro modo se renderizarían como recuadros en blanco. Cuando apuntas a uno de esos, RuneTranslate incluye una fuente adecuada (NanumGothic / Noto Sans) y enruta cada fuente que usa el juego a través del config.font_replacement_map de Ren’Py, para que el texto traducido se muestre correctamente sin editar los propios recursos del juego.

Limitaciones conocidas

• Los archivos estándar RPA-2 / RPA-3 / RPA-3.2 / RPA-4.0 y los comúnmente ofuscados por proveedor se abren automáticamente; un contenedor genuinamente no estándar o una clave retenida externamente pueden no desempaquetarse.
• El texto incrustado en imágenes (logos de título, interfaz dibujada a mano, subtítulos de CG) es trabajo de píxeles y no se traduce — fuera del alcance de la traducción automática.
• Las pantallas con mucho scripting que construyen cadenas en tiempo de ejecución a partir de variables pueden necesitar un rápido pase de corrección manual en el editor.

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

La ruta manual significaba descompilar .rpyc a mano, ejecutar rpatool sobre el archivo y luego, o bien traducir el código fuente en el sitio (y volver a romperlo en la siguiente actualización del juego), o bien crear a mano bloques tl/ línea por línea — y aun así pelearse con fuentes que faltan en idiomas no latinos. RuneTranslate hace la cadena de descompilar + desempaquetar + extraer + hook-de-tiempo-de-ejecución en unos pocos clics, mientras mantiene el editor abierto para que tú controles la redacción.

Consulta la página del motor Ren’Py para la lista completa de funciones, lee la guía de novelas visuales de Kirikiri para un motor de VN diferente, o descarga RuneTranslate y pruébalo en un juego real.