ModpackES

Traduce modpacks de Minecraft al español: misiones, libros guía, scripts de KubeJS y los textos de todos los mods, con un par de clics.

Descargar el instalador · versión portable · Cómo se usa · Preguntas frecuentes · Cambios

ModpackES lee tu modpack, encuentra todo lo que sigue en inglés y lo traduce con Gemini de Google o con cualquier motor compatible con OpenAI, incluidos modelos que corren gratis en tu PC (LM Studio, Ollama). Funciona con cualquier versión (de 1.7.10 a 26.x), cualquier loader (Forge, NeoForge, Fabric, Quilt) y cualquier lanzador, y escribe a la vez las siete variantes de español del juego.

• No modifica los jars de los mods. Lo de los mods va en un resource pack aparte.
• Todo tiene copia de seguridad. Un botón devuelve el modpack a su texto original.
• No se paga dos veces. Lo ya traducido queda en una memoria que se reutiliza, también entre modpacks.
• Respeta los formatos. Colores, enlaces, variables y comandos llegan intactos; lo que no pasa las reglas de calidad se reintenta o queda en inglés antes que romper algo.

Lo que el mod ya trae en español no se toca, y si existe una variante (por ejemplo es_es) se copia a las demás sin gastar. Los libros antiguos de Patchouli que guardan el texto dentro del jar no se pueden traducir sin modificar el mod: la app avisa cuáles son.

1. Descarga e instala ModpackES-instalador.exe: se instala solo para tu usuario, sin pedir permisos de administrador, y arranca más rápido. Si prefieres no instalar nada, usa la versión portable ModpackES.exe.
2. Cierra Minecraft y abre ModpackES.
3. Elige la instancia en la barra de la izquierda: cada tarjeta muestra la versión de Minecraft, el loader y si ya está traducida. Salen las de Prism Launcher, MultiMC, CurseForge, Modrinth, ATLauncher, GDLauncher y el launcher oficial; si no aparece, arrastra su carpeta a la ventana o usa «Elegir carpeta…».
4. Elige el motor con la ficha de arriba a la derecha (ver Motores). Con Gemini, pulsa «Guardar clave…» y pega tu clave de aistudio.google.com/apikey; se guarda en el Administrador de credenciales de Windows, nunca en un archivo. Con LM Studio u Ollama no hace falta clave: enciende su servidor y pulsa «Probar conexión» para elegir el modelo.
5. Pulsa Analizar (gratis). Las tarjetas de mods, libros, misiones y scripts muestran cuántos textos faltan, y el botón, cuánto costaría. Desmarca lo que no quieras traducir.
6. Pulsa Traducir. Al terminar activa el pack y pone el juego en español (se puede cambiar en «Opciones avanzadas»).

Si se corta o lo cancelas, analiza de nuevo y vuelve a traducir: sigue donde quedó. Los pasos de arriba (Motor, Analizar, Traducir, Listo) dicen en cuál estás, y Ctrl+Enter pulsa el botón principal.

El engranaje de arriba cambia el tema (como Windows, oscuro o claro) y el aviso de versiones nuevas.

El campo Ambientación (opcional) le cuenta al motor de qué va el modpack: «granja acogedora, tono amable; “Bells” es la moneda del pueblo». Ayuda con el tono y con los términos propios del pack, y se guarda por instancia.

Revisión automática (opcional, en «Opciones avanzadas», solo misiones y libros): después de traducir, otro pedido al motor juzga cada traducción nueva al estilo de GEMBA-MQM (exactitud, terminología, fluidez y estilo, con gravedad leve, grave o crítica) y las graves se vuelven a traducir indicando el error. La nueva traducción tiene que pasar las mismas reglas; si no, queda la anterior. Tus correcciones nunca se revisan. Sube el costo de esos textos (el análisis lo incluye) y sus marcas no son infalibles: sirven para decidir qué rehacer, no como nota de calidad.

Más ▸ Restaurar el original devuelve misiones, scripts y libros propios al texto del modpack. Para quitar la traducción de los mods basta con desactivar el resource pack.

Más ▸ Correcciones… busca cualquier texto en la memoria (en inglés o en español) y te deja corregir su traducción a mano. La corrección manda sobre todo lo demás, vale para todas las misiones, libros y mods donde aparezca ese texto y se aplica la próxima vez que traduzcas, sin costo. Si a la corrección le falta un código del original (%s, §a, $(l)…), no se guarda, para que no rompa el juego.

Todos los motores reciben las mismas instrucciones y pasan por las mismas reglas de calidad: lo que pierde un código o vuelve en inglés se descarta. Con modelos locales pequeños (menos de unos 7 000 millones de parámetros) es más probable que fallen el formato JSON y que queden más textos en inglés; LM Studio advierte lo mismo en su documentación.

Con gemini-3.8-flash un modpack grande (unos 800 000 caracteres por traducir) cuesta alrededor de 1,5 a 2 dólares, y la mitad con la opción «Más barato, pero tarda más» (Batch API), que puede tardar desde minutos hasta horas. Un modpack pequeño cuesta centavos. Son estimaciones con los precios de Google de noviembre de 2026; el botón «Analizar» calcula el de tu modpack antes de gastar nada.

La capa gratuita de Gemini sirve para probar, pero tiene límites de peticiones por minuto y por día que un modpack grande supera enseguida. Con la facturación activada (nivel 1) se traduce de una vez.

Las misiones y los scripts de servidor los lee el servidor. «Más ▸ Kit de servidor…» arma un .zip con esos archivos ya traducidos, el resource pack para los jugadores y las instrucciones. «Exportar pack…» saca solo el resource pack, para compartirlo con quien juegue el mismo modpack.

Desde el código fuente (ver Desarrollo):

uv run modpackes instancias
uv run modpackes analizar "RUTA DE LA INSTANCIA"
uv run modpackes traducir "RUTA" [--dialecto es_es] [--solo misiones,libros] [--lotes] [--modelo gemini-3.5-flash-lite] [--contexto "granja acogedora"] [--revisar]
uv run modpackes restaurar "RUTA"
uv run modpackes clave guardar [--motor openrouter]
uv run modpackes modelos [--motor ollama]

Con otro motor: --motor openrouter|deepseek|lmstudio|ollama|personalizado, --modelo NOMBRE y, para el personalizado, --direccion http://servidor/v1. La clave también se puede pasar por variable de entorno: GEMINI_API_KEY o MODPACKES_CLAVE_<MOTOR> (por ejemplo MODPACKES_CLAVE_OPENROUTER).

traducir --simular hace una prueba completa sin la API (antepone «ES» a cada texto); úsalo en una copia.

• Los códigos de formato (%s, §a, &c, $(l), {image:…}, ${…}, comandos, ids, enlaces) se cambian por marcadores antes de enviar el texto. Una traducción que pierde o inventa un marcador se descarta.
• Cada traducción pasa reglas de calidad: no puede estar vacía, seguir en inglés, tener un largo raro o meter saltos de línea nuevos. Lo que no pasa se reintenta y, si sigue mal, queda en inglés.
• Los archivos se reescriben sin pérdidas: solo cambian los textos traducidos y todo lo demás queda byte a byte igual.
• Un glosario con los nombres oficiales de Minecraft y de los mods mantiene los mismos términos en misiones, libros y scripts.
• Con un banco de 148 textos de referencia, Gemini 3.8 Flash tradujo el 100 % con un chrF de 85 y respetó todos los términos del glosario: detalle y límites de la medición en docs/calidad.md.

Requisitos: uv (instala Python 3.13 solo) y, para las pruebas con los parsers del juego, un JDK 17 o superior (sirve el de Prism Launcher).

uv sync
uv run python scripts/verificar.py            # ruff, pyright estricto, compileall y pytest con cobertura
uv run python scripts/verificar.py --rapido   # sin las pruebas de Java ni el corpus real
uv run python scripts/construir_exe.py        # dist/ModpackES.exe (portable)
uv run python scripts/construir_exe.py --instalador  # dist/ModpackES-instalador.exe (necesita Inno Setup 6.3+)
uv run python scripts/probar_exe.py           # arranca el .exe y analiza un modpack de prueba
uv run python scripts/probar_exe.py --instalador  # instala en una carpeta temporal, prueba y desinstala

Los datos de la app (memoria, glosario, preferencias y registro.log) van a %LOCALAPPDATA%\traductor-es; la variable TRADUCTOR_ES_DATOS los lleva a otra carpeta. Las pruebas con Java buscan Gson en las bibliotecas de Prism Launcher o usan el jar que indique TRADUCTOR_ES_GSON (así corren en el CI). Lee CONTRIBUTING.md y el código de conducta antes de mandar cambios.

Ideas tomadas de MinecraftModsLocalizer (MIT), MineAI Modpack Translator (MIT), mc-questing-mod-localizer (MIT), mc_translator (GPL-3.0, la ambientación del modpack) y AutoTranslation (AGPL, solo ideas: correcciones del usuario y modelos locales). La revisión automática sigue el método GEMBA-MQM (Kocmi y Federmann, WMT 2023). No se copió código de ninguno. Los formatos de cada mod se comprobaron en su código fuente (FTB Quests, BetterQuesting, HQM, Heracles, Patchouli, Mantle, GuideME, Lavender). Las bibliotecas que usa la app están en THIRD-PARTY-NOTICES.md.

© 2026 Cristian. ModpackES es software libre bajo la GNU General Public License v3.0 o posterior: puedes usarlo, estudiarlo, modificarlo y compartirlo, siempre que las versiones que distribuyas sigan siendo libres, con su código fuente y esta misma licencia.

ModpackES no está afiliado a Mojang Studios, Microsoft ni Google. Minecraft es una marca de Mojang Studios.