Localizar Final Fantasy XIV

Cómo funciona

Cinco pasos llevan una frase desde el juego hasta el juego, ya traducida. Intervienen dos repositorios, un pull request y un plugin. Ningún fichero del juego se modifica.

Vía rápida

En el navegador

Cuatro clics en GitHub. No hace falta instalar nada ni saber git.

Ver los cuatro pasos → Vía completa

Con un clon y un editor

Clona los dos repositorios y traduce en tu editor, con el inglés, el francés y el japonés al lado.

Ver los cuatro pasos →

Vía rápida

En el navegador

Todo ocurre en GitHub. El primer clic crea un fork del repositorio, es decir, tu propia copia. Así propone cambios cualquiera que no es el dueño de un proyecto.

1

Abre el fichero en GitHub y pulsa el lápiz

Entra en el repositorio del idioma, en la carpeta corpus/, y abre el fichero de la conversación. El lápiz de arriba a la derecha abre el editor. Si no eres colaborador, GitHub te pide antes un fork del repositorio. Acéptalo.

ffxiv-language-pack-es-es/ corpus / flat / DefaultTalk.json✎

●You need to fork this repository to propose changesFork this repository

El fork se crea en un segundo y el editor se abre sobre él. Solo ocurre la primera vez.
Para encontrar una línea, busca su texto inglés en ffxiv-corpus-en. El fichero tiene la misma ruta en los dos repositorios.

2

Escribe target

Escribe la traducción en el campo target de la fila. No cambies gameKey ni hash: identifican la línea. El texto entre ángulos es un macro; cópialo tal cual.

github.com · ffxiv-language-pack-es-es · DefaultTalk.json

    { "gameKey": "DefaultTalk#590415.20", "hash": "E38048F1B03D2DD9", "target": "Soy el capitán contratado del Orion." },
    { "gameKey": "DefaultTalk#590415.21", "hash": "5869006EA8C4FD7E", "target": "" },

Puedes cambiar una fila o cien, en uno o en varios ficheros. El pull request las lleva todas.
El inglés, el francés y el japonés de la fila están en el mismo fichero de ffxiv-corpus-en.

3

Commit changes y después Propose changes

Commit changes abre un diálogo. Escribe un mensaje que diga qué has traducido; GitHub crea la rama en tu fork. Propose changes lleva al pull request. Create pull request lo abre contra el repositorio del idioma.

Propose changes

Mensaje del commitAhldskyf, capitán del Orion

Ramapatch-1 → mainPropose changes

✔Able to merge. These branches can be automatically merged.Create pull request

El mensaje debe decir qué líneas has traducido. Las notas de la release se generan a partir de él.

4

Espera al check

Cuando el pull request existe, validate comprueba cada fila cambiada. Si está en verde, el pull request se fusiona solo. Si el idioma tiene revisor, espera su aprobación. Si está en rojo, el informe dice qué fila falla y por qué. Corrígela en la misma rama y el check vuelve a ejecutarse.

ffxiv-language-pack-es-es· Pull request

✔validate comprueba cada fila cambiada: solo cambió target, el JSON es válido, los macros están en su sitio y no hay marcadoresvalidate

●Si el idioma tiene revisor, el merge espera su aprobación. Si no lo tiene, no esperaAuto-merge enabled

⛙Fusionado en main

El primer pull request de una cuenta de GitHub recién creada espera a que el mantenedor inicie el check. Los siguientes se ejecutan solos.

Vía completa

Con un clon y un editor

El inglés está en un repositorio y tu idioma en otro. Los dos tienen los mismos ficheros y las mismas líneas. Con los dos abiertos en un editor, traduces con el francés y el japonés a la vista.

1

Abre los dos repositorios

Abre ffxiv-corpus-en y ffxiv-language-pack-es-es en Visual Studio Code o en otro editor. Los dos tienen la misma estructura en corpus/: un fichero por conversación y un fichero por hoja de interfaz.

Visual Studio Code

EXPLORER

▾ ffxiv-corpus-en

▾ corpus

▾ quest

▾ 041

AktKba101_04102.json

▾ ffxiv-language-pack-es-es

▾ corpus

▾ quest

▾ 041

AktKba101_04102.json

ffxiv-language-pack-es-es ›corpus / quest / 041 / AktKba101_04102.json

{
  "conversation": "quest/041/AktKba101_04102",
  "gameVersion": "2026.08.11.0000.0000",
  "entries": [
    { "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_00", "hash": "6100EBD3346502DA", "target": "" },
    { "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_01", "hash": "A91C0F3E6D2B7C10", "target": "" },
    …

Haz un fork del repositorio del idioma en GitHub y clona el fork. Así puedes subir tu rama.
ffxiv-corpus-en es de solo lectura. Clónalo o consúltalo en GitHub. No se edita.

2

Busca el mismo fichero en los dos

La ruta del fichero es la misma en los dos repositorios, y cada gameKey también. El fichero inglés tiene la línea en inglés, francés y japonés. El tuyo tiene la misma clave, un hash y un target vacío.

Visual Studio Code

ffxiv-corpus-en ›corpus / quest / 041 / AktKba101_04102.json

{
  "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_02",
  "en": "The effort to find the blasphemy is being led by none other than the Elder Seedseer herself, Kan-E-Senna.",
  "macro": "The effort to find the blasphemy is being led by none other than the Elder Seedseer herself, Kan<-->E<-->Senna.",
  "fr": "Les recherches du blasphème sont menées par la Grande Prophétesse en personne, Kan-E-Senna.",
  "ja": "ブラスフェミーの捜索は、カヌ・エ・センナ様が自ら指揮を執っている。",
  "hash": "3C7D2A9E5B1F8E04"
}

ffxiv-language-pack-es-es ›corpus / quest / 041 / AktKba101_04102.json

{
  "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_02",
  "hash": "3C7D2A9E5B1F8E04",
  "target": ""
}

Divide el editor: el inglés a un lado y tu fichero al otro.
Si dudas, busca por gameKey. Es el dato que los dos ficheros comparten.

3

Traduce

Escribe la traducción en target. Parte del inglés, del francés o del japonés, el que entiendas mejor. El texto entre ángulos es un macro que el juego rellena al mostrar la línea: el nombre del jugador, un salto de línea, una variante por género. Copia los macros tal cual.

Visual Studio Code

ffxiv-language-pack-es-es ›corpus / quest / 041 / AktKba101_04102.json

{
  "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_02",
  "hash": "3C7D2A9E5B1F8E04",
  "target": "La búsqueda de la blasfemia la dirige nada menos que la Gran Vidente en persona, Kan<-->E<-->Senna."
}

Guarda el fichero sin cambiar el formato: UTF-8 sin BOM y la misma sangría. Un editor que entiende JSON lo hace solo.
Una conversación es un fichero. Tradúcela entera para que las voces sean coherentes.

4

Commit, push, pull request

Crea una rama en tu fork. Haz un commit con un mensaje que diga qué has traducido. Sube la rama y abre un pull request contra el repositorio del idioma. Puedes hacerlo desde la terminal o desde el panel de git del editor.

Terminal

$ git checkout -b ahldskyf
$ git commit -am "Ahldskyf, capitano dell'Orion"
$ git push -u origin ahldskyf
$ gh pr create --fill

Abre un pull request por tanda de líneas, no por línea. Las notas de la release listan sus commits.
A partir de aquí, el proceso es igual que en el navegador: el check, el merge y la release.

Lo que no se toca

Cuatro reglas, válidas en las dos vías. El check aplica las tres primeras. La cuarta hace buena la traducción.

gameKey · hash · gameVersionNo se editan. Identifican la línea y su parche. El check rechaza cualquier cambio en ellos.
<--> <br> <if(…)>Se copian tal cual: los mismos que tiene el inglés, ni uno más. Un macro añadido rompe la línea. Un macro quitado pierde un nombre o un salto de línea.
"target": ""Vacío significa «sin traducir». No escribas marcadores como TODO: el juego los mostraría.
fr · jaLéelos. El francés muestra cómo se dice la línea. El japonés es el original y aclara qué significa.

Después del pull request

No interviene nadie. El check se ejecuta, el merge se hace, la release se construye y el plugin la ofrece a cada jugador al arrancar.

ffxiv-language-pack-es-es· Pull request → Release

✔validate comprueba cada fila cambiada: solo cambió target, el JSON es válido, los macros están en su sitio y no hay marcadoresvalidate

●Si el idioma tiene revisor, el merge espera su aprobación. Si no lo tiene, no esperareview

⛙Fusionado en main

▲Release construida y publicada. Tarda dos o tres minutosrelease

◆Gubal Library ofrece la versión nueva al arrancar y muestra tu líneaGubal Library

El Códice Interminable en español, con la entrada de Alphinaud — **El Códice Interminable**El pack español traduce las entradas del Códice sobre personajes, lugares y conceptos.

Diálogo de misión en la ventana de conversación del juego, en español — **Lo que lee el jugador**La ventana de conversación con el pack en español. El juego dibuja tu texto con su letra, sus cursivas y sus colores.

Los idiomas

Un repositorio por idioma. El porcentaje traducido se lee de cada repositorio al cargar la página.

Idioma	Repositorio	Traducido	¿Una línea mal?
Español (España)	ffxiv-language-pack-es-es	—	issues
Italiano	ffxiv-language-pack-it	—	issues
Português (Brasil)	ffxiv-language-pack-pt-br	—	issues
Polski	ffxiv-language-pack-pl	—	issues

¿Otro idioma? Pregunta en GitHub Discussions.