Wiki en construcción. Muchos conceptos de aquí provienen de la alpha 0.2 y todavía pueden cambiar. La wiki se finalizará para la versión 1.0 — por ahora está para ayudar a los testers cerrados y, más adelante, a los jugadores del acceso anticipado a orientarse. Para la información más actual y fiable, únete al Discord — es donde se anuncian los cambios primero y donde puedes preguntar directamente.

Únete al Discord para las últimas novedades

Packs de idioma

Traducir el juego a un idioma nuevo — el formato del archivo, el Editor de idiomas sin conexión, qué recae en inglés y qué alfabetos cubren las fuentes incluidas.

En esta página

El juego sale en seis idiomas — inglés, francés, español, italiano, alemán y portugués — y se puede añadir cualquier otro sin escribir una sola línea de código: una traducción es un archivo de texto que dejas en el lang/ de tu carpeta de mods (%APPDATA%\TheUndercut\mods\lang\ en Windows — ver dónde van los archivos).

mods/
  lang/
    pl.txt      ← todo el pack de idioma

En cuanto el archivo está ahí, el idioma aparece en Ajustes → Idioma, con su bandera. El cambio es instantáneo, tanto en carrera como desde el menú principal.


El inglés es la clave

No hay identificadores de cadenas. La frase inglesa escrita en el juego es la clave de traducción, y un pack asocia líneas inglesas con las tuyas:

#name: Polski
#flag: pl

>New Career
=Nowa kariera

>Lap {} / {}
=Okrążenie {} / {}
  • > abre una clave (la cadena inglesa), = da la traducción, # es un comentario.
  • #name: es el nombre que se muestra en el selector, #flag: el código de país de dos letras de su bandera.
  • Los marcadores {} y {named} hay que conservarlos: el juego sustituye en ellos por orden.
  • Una entrada es una línea física. Un texto de varias líneas (el cuerpo de un correo) escribe sus saltos como un \n literal.
«New Career» la cadena en el juego tu pack ¿está traducida la clave? sí no «Nowa kariera» «New Career» recae en inglés

Un pack a medias es perfectamente jugable. Todo lo que no hayas traducido se muestra en inglés: no hay estado roto ni marcas de cadena ausente, y puedes publicar un pack al 40 % y terminarlo más adelante.


El Editor de idiomas

Menú principal → Herramientas de modding → Editor de idiomas (o abre lang-editor/index.html en la carpeta del juego). Igual que el Editor de mods, funciona sin conexión en tu navegador, desde el propio archivo.

  1. Se listan todas las cadenas traducibles: el inglés a la izquierda, tu traducción a la derecha. La traducción francesa se muestra como segunda referencia — ocúltala con el interruptor si te estorba.
  2. Rellena la cabecera: el nombre del idioma que se ve en el juego, el código del archivo (pl → pl.txt) y el código de la bandera.
  3. Traduce. El editor marca una fila en rojo cuando sus marcadores dejan de coincidir con la clave inglesa: ese es el único error que merece la pena cazar, porque un marcador roto se nota en el juego.
  4. Guardar pack (Ctrl+S) en mods/lang/. Chrome y Edge escriben directamente en el archivo; Firefox lo descarga.
  5. En el juego: Ajustes → Idioma → tu bandera.

Solo sin traducir y el contador de progreso muestran lo que falta. Reabrir un pack existente retoma donde lo dejaste, y las cadenas de otra versión del juego se conservan al final del archivo en lugar de descartarse.


Traducir sin el editor

La lista de cadenas es un archivo de texto plano, lo que hace sencilla la traducción masiva, también con una IA. Trabaja en bloques de 200–300 entradas con una sola regla:

Rellena las líneas =, no toques nunca las líneas >.

La clave inglesa se compara byte a byte en tiempo de ejecución. Una clave reescrita —un espacio de más, un acento cambiado— no es un error: es una operación silenciosa sin efecto que deja esa cadena en inglés para siempre. Conserva cada {marcador} exactamente como aparece.


Lo que un pack no puede hacer

  • No puede tapar un idioma integrado. Los seis incorporados ganan siempre; un pack tiene que traer un código nuevo.
  • No traduce nombres propios. Pilotos, equipos, patrocinadores y circuitos son contenido generado y se quedan como están.
  • La voz en off del tutorial sigue en inglés. Solo se traduce su texto en pantalla.
  • Los correos conservan el idioma en que llegaron. Un correo se traduce al escribirse y se guarda así, de modo que cambiar de idioma a mitad de carrera deja el correo antiguo tal cual.

Alfabetos y fuentes

Las fuentes de pantalla del juego cubren el latino y, mediante un recambio automático, el latino extendido y el cirílico: cuando un idioma cargado usa letras que le faltan a la fuente elegida, el juego cambia esa fuente por otra que sí las cubre y devuelve la original al salir. Así, los packs de polaco, checo, turco, ruso o ucraniano se ven correctamente sin trabajo extra.

El chino, el japonés y el coreano aún no están soportados: necesitan una fuente que el juego no incluye. Un pack CJK se cargará, pero los glifos no se dibujarán.


Compartir

Envía el archivo .txt y se deja caer en el mods/lang/ de cualquiera. Para publicarlo como objeto suscribible, consulta la guía del Workshop: un pack de idioma va en la raíz del objeto (como <código>.txt) o dentro de una carpeta lang/. Tu propio archivo gana siempre frente a uno suscrito con el mismo código, que es como pruebas un cambio sin cancelar la suscripción.