Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,14 @@ Todos los cambios importantes de ModpackES quedan en este archivo. El formato si

### Cambiado

- **Más contexto en los textos de los mods, sin costo extra:**
- Los textos van al motor en el orden del archivo y no en orden alfabético, así que un lote junta el nombre de un objeto con su tooltip y el título de una misión con su descripción.
- Un tooltip o una descripción dice de qué objeto habla («habla de «Teleporter»»).
- Un texto corto de un menú («Any», «Left») va con las claves vecinas del archivo («junto a «Source Only», «None»»).
- Si el inglés es igual a un texto del juego, la pista dice cómo lo traduce el juego («en el juego: «Alternar»»), para seguir el español de Minecraft.
- Al decidir un nombre propio o un término que se repite, el motor recibe una o dos frases donde aparece.
- Si el mismo texto sale con y sin espacios en los bordes, sus pistas se juntan en vez de pisarse.
- La versión de España recibe hasta 1.500 caracteres de la traducción latinoamericana como referencia (antes 400), así que también los párrafos largos de los libros conservan las mismas decisiones.
- **Controles de forma sin depender del modelo.** Atacan lo que más se corrigió en la revisión humana de 100 textos:
- Mayúsculas: un término del glosario que el original escribe como nombre propio («the Quantum Ring») sale con las mayúsculas del glosario («el Anillo Cuántico»). Los nombres del juego («Lingote de hierro», «Cofre») siguen en minúscula en medio de una frase.
- Nombres que no se traducen: los del juego («Creeper», «Redstone») y los de una palabra que el modelo dejó igual al traducir los mods («Arachnarch») se protegen. Si una misión los traduce, se reintenta.
Expand All @@ -78,6 +86,10 @@ Todos los cambios importantes de ModpackES quedan en este archivo. El formato si

### Corregido

- **El glosario exigía términos donde la palabra tenía otro sentido:** «lead the way» pedía «Correa», «the power signal» pedía «Poder» y «the target» pedía «Diana». Ahora la app mira en el inglés y el español del juego y de los mods cómo se traduce cada palabra cuando va en minúscula. Si casi nunca sale con el término del glosario, ese término solo se manda y se exige cuando el texto lo usa como nombre: es todo el texto, va con mayúscula a mitad de frase o el texto es un nombre en estilo título. Las palabras que sí se traducen igual («fire» → «fuego») se siguen exigiendo, y los términos del usuario siempre.
- **Términos de un mod a medio traducir** («Almacen Portable de Energía», «slot de los Muslos») ya no entran en el glosario: se descarta el término que deja en español una palabra inglesa que no sale en ningún texto en español del juego ni de los mods. Los nombres de los mods de la instancia («estilo Create») no cuentan.
- **Artículo con el género equivocado** al cambiar un término que quedó en inglés: «Usa el Wrench» pasa a «Usa la Llave inglesa», no a «el Llave inglesa». Si no se sabe el género, no se cambia y queda como duda.
- **Frases que volvían en inglés después del reintento** se guardaban en la memoria como si fueran la traducción. Ahora solo se acepta lo que parece un nombre propio («Bronze Dungeons»), marcado para revisarlo; el resto queda sin traducir y se vuelve a intentar en la próxima traducción.
- **Argumentos al revés:** si el modelo cambiaba de orden dos `%s` («%s was slain by %s» → «… mató a …»), el juego ponía los valores al revés sin aviso. Ahora, en los archivos de idioma se numeran (`%2$s mató a %1$s`), como hace el propio español de Minecraft; en scripts, misiones y libros el texto se rechaza y se reintenta.
- **Escapes `\uXXXX` en scripts de KubeJS y CraftTweaker:** el modelo veía «⟦0⟧00a7cWarning» y podía romper el escape. Ahora los de caracteres visibles se decodifican («§cWarning», «éxito») y los de control quedan protegidos enteros.
- **Códigos que el modelo inventa o desordena:** se rechaza la traducción que trae un código que no estaba («§a», «%s») o que deja el cierre de un formato (`§r`, `$()`, `</b>`) antes de su apertura. Con argumentos, un «%» suelto que escribió el modelo pasa a «%%».
Expand Down
51 changes: 51 additions & 0 deletions docs/calidad.md
Original file line number Diff line number Diff line change
Expand Up @@ -467,6 +467,57 @@ queda como duda en el CSV de dudosos.
(«Vidrio a prueba de Wither», «Nivel III»), así que solo se informan y no se cambian.
- Cada control tiene pruebas con textos correctos del español del juego que no deben marcarse (`tests/test_qa.py`).

## 15 de noviembre de 2026 · términos de una palabra con otro sentido

El glosario exigía «Diana» en «the position of the target», «Poder» en «other power solutions» y «Cambiante» en
«without changing the filter». La app ahora mira cómo traducen el juego y los mods cada palabra en minúscula. En el
español del juego, «target» en minúscula nunca es «Diana» (sale «objetivo») y «power» casi nunca es «Poder» (sale
«energía», «potencia»). Esas palabras solo se mandan y se exigen como término cuando el texto las usa como nombre.
Las que el juego sí traduce siempre igual («fire» → «fuego», «clock» → «reloj») se siguen exigiendo.

Con Gemini 3.8 Flash y dos corridas grabadas (US$ 0,12), cambiaron los términos de 6 textos de interfaz y 9 de
misiones:

| | chrF de los 6 textos de interfaz (corridas 1 y 2) |
|---|---|
| Antes | 68,6 · 67,1 |
| Ahora | 75,2 · 75,4 |

- Interfaz: «la diana» pasó a «el objetivo» en los tres textos. Ninguno empeoró.
- Misiones (sin referencia): «Otras soluciones de Poder» pasó a «de energía» y «sin hacerla Cambiante» a «sin
cambiar»; los demás quedaron igual.
- En todo el banco de interfaz, el chrF quedó en 74,8 · 73,8 (antes 74,8 · 73,3): el cambio toca pocos textos y el
ruido del modelo es mayor.

## 15 de noviembre de 2026 · contexto barato en la interfaz

Sin cambiar el prompt ni agregar pedidos:
- los textos van al motor en el orden del archivo y no en orden alfabético;
- un tooltip dice de qué objeto habla;
- un texto corto de un menú va con sus claves vecinas;
- si el inglés es igual a un texto del juego, la pista dice cómo lo traduce el juego.

Para medirlo, una copia del banco de interfaz lleva las pistas nuevas, calculadas con los mismos archivos del corpus
(41 de 399 textos cambian de pista). Gemini 3.8 Flash, dos corridas por condición (US$ 0,09 la condición nueva):

| | chrF (corridas 1 y 2) |
|---|---|
| Antes (ola 3) | 74,8 · 73,8 |
| Con el contexto | 75,6 · 75,8 |
| Diferencia pareada | **+1,37** (IC 95 %: +0,35 a +2,30) → mejora |

| Textos | Cuántos | chrF antes | chrF ahora |
|---|---|---|---|
| Con sus vecinas del menú («junto a…») | 26 | 66,8 | 69,6 |
| Con el nombre de su objeto («habla de…») | 8 | 83,6 | 85,0 |
| Igual a un texto del juego | 7 | 100 | 100 |
| Sin pista nueva (solo cambia el orden) | 350 | 74,1 | 75,3 |

- **Banco de libros:** solo cambia el orden de los lotes y las frases que acompañan a los nombres que se deciden
primero. Dio 67,1 contra 67,5: −0,46 (IC −1,14 a +0,21), no se distingue del ruido.
- **Descripciones de FTB Quests:** traducirlas como un bloque y no línea por línea queda para la ola de segmentación,
porque cambia cómo se escriben los archivos.

## Cómo repetirlo

```
Expand Down
12 changes: 10 additions & 2 deletions scripts/armar_banco_local.py
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@
import descargar_corpus as dc

from traductor_es.formatos import lang_json, lang_legacy
from traductor_es.modulos.mods import Mods, es_nombre
from traductor_es.modulos.mods import es_nombre, pista_con_contexto, textos_del_juego
from traductor_es.nucleo import terminos
from traductor_es.nucleo.glosario import Glosario
from traductor_es.nucleo.mascara import es_traducible
Expand Down Expand Up @@ -153,6 +153,14 @@ def main() -> int:
en_el_banco = {p.ingles for p in elegidos}
ejemplos = {p.ingles: p.castellano for p in todos if p.jar not in medir and p.ingles not in en_el_banco}
glosario = glosario_del_banco(todos, medir, args.glosario_ingenuo)
# Las pistas como las manda la app: con el objeto de un tooltip, las vecinas de un menú y lo que dice el juego
archivos = {(r.parts[-5], r.parts[-3]): _leer(r) for r in dc.RAIZ.glob("*/langs/*/assets/*/lang/en_[uU][sS].*")}
vanilla = dc.RAIZ / "vanilla"
juego = (
textos_del_juego(_leer(vanilla / "en_us.json"), _leer(vanilla / "es_mx.json"))
if (vanilla / "es_mx.json").is_file()
else {}
)
banco: dict[str, Any] = {
"descripcion": "Pares reales en/es de mods libres, solo para uso local (no se publica).",
"dialecto": "es_mx",
Expand All @@ -163,7 +171,7 @@ def main() -> int:
"original": p.ingles,
"referencia": p.castellano,
"jar": p.jar,
"pista": Mods.pista(p.namespace, p.clave),
"pista": pista_con_contexto(p.namespace, p.clave, archivos.get((p.jar, p.namespace), {}), juego),
}
for p in elegidos
],
Expand Down
12 changes: 12 additions & 0 deletions scripts/medir_calidad.py
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,17 @@ def nombres_del_juego(carpeta: Path, dialecto: str) -> dict[str, str]:
return salida


def usos_del_juego(carpeta: Path, dialecto: str) -> list[tuple[dict[str, str], dict[str, str]]]:
"""El archivo completo del juego en inglés y en el dialecto, para ver cómo se usan las palabras en minúscula."""
ruta = carpeta / f"{dialecto}.json"
if not ruta.is_file():
ruta = carpeta / "es_mx.json"
if not ruta.is_file():
return []
ingles: dict[str, str] = json.loads((carpeta / "en_us.json").read_text(encoding="utf-8"))
return [(ingles, json.loads(ruta.read_text(encoding="utf-8")))]


def main(argv: list[str] | None = None) -> int:
sys.stdout.reconfigure(encoding="utf-8", errors="replace") # pyright: ignore[reportAttributeAccessIssue]
ap = argparse.ArgumentParser(description=__doc__)
Expand Down Expand Up @@ -114,6 +125,7 @@ def main(argv: list[str] | None = None) -> int:
banco = medicion.Banco.leer(args.banco)
if args.vanilla is not None and not banco.juego:
banco.juego = nombres_del_juego(args.vanilla, banco.dialecto)
banco.usos = usos_del_juego(args.vanilla, banco.dialecto)
print(f"Nombres del juego: {len(banco.juego)}")
if args.sin_vecindad:
banco.casos = [medicion.Caso(c.ambito, c.original, c.referencia, quitar_vecindad(c.pista)) for c in banco.casos]
Expand Down
92 changes: 91 additions & 1 deletion src/traductor_es/modulos/mods.py
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,87 @@ def es_nombre(clave: str) -> bool:
return clave.startswith(_CLAVES_DE_NOMBRES) and not clave.endswith((".desc", ".description", ".tooltip", ".info"))


#: Hasta cuántos caracteres de un texto vecino van en la pista, y cuántas claves hermanas.
_LARGO_EN_PISTA = 60
_HERMANAS = 2
#: Un texto de menú de hasta estas palabras («Left», «Mode») es ambiguo sin sus hermanas.
_PALABRAS_CORTO = 3
_PREFIJOS_DE_MENU = ("gui.", "key.", "screen.", "container.", "config.", "options.", "button.", "tooltip.")
_SUFIJOS_DE_DESCRIPCION = (".desc", ".description", ".tooltip", ".info", ".lore")


def _corto(texto: str) -> str:
plano = " ".join(texto.split())
return plano if len(plano) <= _LARGO_EN_PISTA else plano[: _LARGO_EN_PISTA - 1] + "…"


def _nombre_del_objeto(clave: str, textos: Mapping[str, str]) -> str | None:
"""El nombre del objeto o bloque del que habla una descripción: «item.m.wrench.tooltip.0» → «item.m.wrench»;
«tooltip.m.wrench» → «item.m.wrench» o «block.m.wrench»."""
partes = clave.split(".")
for i in range(len(partes) - 1, 1, -1):
candidata = ".".join(partes[:i])
if candidata != clave and es_nombre(candidata) and textos.get(candidata):
return textos[candidata]
if partes[0] in ("tooltip", "desc", "description") and len(partes) >= 3:
for prefijo in ("item", "block"):
for i in range(len(partes), 2, -1):
candidata = ".".join((prefijo, *partes[1:i]))
if textos.get(candidata):
return textos[candidata]
return None


def _hermanas(clave: str, textos: Mapping[str, str]) -> list[str]:
"""Los textos de las claves vecinas en el archivo con el mismo padre («gui.m.mode.left» junto a
«gui.m.mode.right»): la de antes y la de después."""
padre = clave.rsplit(".", 1)[0] + "."
claves = list(textos)
if clave not in textos:
return []
i = claves.index(clave)
vecinas = [k for k in (claves[i - 1] if i else None, claves[i + 1] if i + 1 < len(claves) else None) if k]
return [
_corto(textos[k]) for k in vecinas if k.startswith(padre) and "." not in k[len(padre) :] and textos[k].strip()
][:_HERMANAS]


def textos_del_juego(ingles: Mapping[str, str], traducido: Mapping[str, str]) -> dict[str, str]:
"""{inglés: español} de los textos del juego que no son nombres y tienen una sola traducción («Done» → «Listo»)."""
vistos: dict[str, set[str]] = {}
for clave, en in ingles.items():
es = traducido.get(clave)
if es is not None and en.strip() and es.strip() and en != es and not es_nombre(clave):
vistos.setdefault(en.strip(), set()).add(es.strip())
return {en: next(iter(es)) for en, es in vistos.items() if len(es) == 1}


def pista_con_contexto(
namespace: str, clave: str, textos: Mapping[str, str], juego: Mapping[str, str] | None = None
) -> str:
"""La pista de `Mods.pista` y, si ayuda a elegir el sentido, un poco de contexto barato:

- una descripción o tooltip lleva el nombre de su objeto («de «Llave inglesa»»);
- un texto corto de un menú lleva una o dos claves hermanas («junto a «Right»»);
- si el inglés es igual a un texto del juego, cómo lo dice el juego («en el juego: «Listo»»).
"""
partes = [Mods.pista(namespace, clave)]
ingles = textos.get(clave, "")
bajo = clave.lower()
if not es_nombre(clave) and (bajo.endswith(_SUFIJOS_DE_DESCRIPCION) or bajo.split(".")[0] in ("tooltip", "desc")):
if (nombre := _nombre_del_objeto(clave, textos)) is not None:
partes.append(f"habla de «{_corto(nombre)}»")
elif (
bajo.startswith(_PREFIJOS_DE_MENU)
and 0 < len(ingles.split()) <= _PALABRAS_CORTO
and (hermanas := _hermanas(clave, textos))
):
partes.append("junto a " + ", ".join(f"«{h}»" for h in hermanas))
if juego and (del_juego := juego.get(ingles.strip())):
partes.append(f"en el juego: «{_corto(del_juego)}»")
return " · ".join(partes)


def _salto_nuevo(original: str, traduccion: str) -> bool:
return any(c in traduccion and c not in original for c in ("\r", "\n"))

Expand All @@ -103,7 +184,16 @@ def recolectar(self) -> list[Pieza]:
copiados = sum(1 for p in self._pendientes if p.existente is not None)
if copiados:
self.ctx.registro(f"{copiados} textos se copian de otra variante de español, sin gastar")
return [Pieza(p.ingles, self.pista(p.namespace, p.clave)) for p in self._pendientes if p.existente is None]
juego = textos_del_juego(tabla.textos("minecraft", "en_us"), tabla.textos("minecraft", self.ctx.dialecto))
por_mod: dict[str, Mapping[str, str]] = {}
piezas: list[Pieza] = []
for p in self._pendientes:
if p.existente is None:
textos = por_mod.get(p.namespace)
if textos is None:
textos = por_mod[p.namespace] = tabla.textos(p.namespace, "en_us")
piezas.append(Pieza(p.ingles, pista_con_contexto(p.namespace, p.clave, textos, juego)))
return piezas

def lugares(self) -> list[Lugar]:
"""Por mod (espacio de nombres), {clave: inglés} de lo que la app traduce (tras `recolectar`)."""
Expand Down
Loading
Loading