Localizzare Final Fantasy XIV

Come funziona

Cinque passi portano una frase dal gioco al gioco, tradotta. Intervengono due repository, una pull request e un plugin. Nessun file del gioco viene modificato.

Via rapida

Nel browser

Quattro clic su GitHub. Niente da installare, niente git da imparare.

Vedi i quattro passi → Via completa

Con un clone e un editor

Clona i due repository e traduci nel tuo editor, con inglese, francese e giapponese accanto.

Vedi i quattro passi →

Via rapida

Nel browser

Tutto avviene su GitHub. Il primo clic crea un fork del repository, cioè la tua copia. Così chi non è proprietario di un progetto propone delle modifiche.

1

Apri il file su GitHub e premi la matita

Entra nel repository della lingua, nella cartella corpus/, e apri il file della conversazione. La matita in alto a destra apre l'editor. Se non sei collaboratore, GitHub ti chiede prima un fork del repository. Accetta.

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

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

Il fork viene creato in un secondo e l'editor si apre su di esso. Succede solo la prima volta.
Per trovare una riga, cerca il suo testo inglese in ffxiv-corpus-en. Il file ha lo stesso percorso nei due repository.

2

Scrivi target

Scrivi la traduzione nel campo target della riga. Non cambiare gameKey né hash: identificano la riga. Il testo tra parentesi angolari è una macro; copiala com'è.

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

    { "gameKey": "DefaultTalk#590415.20", "hash": "E38048F1B03D2DD9", "target": "Sono il capitano a contratto dell'Orion." },
    { "gameKey": "DefaultTalk#590415.21", "hash": "5869006EA8C4FD7E", "target": "" },

Puoi cambiare una riga o cento, in uno o più file. La pull request le porta tutte.
L'inglese, il francese e il giapponese della riga sono nello stesso file di ffxiv-corpus-en.

3

Commit changes e poi Propose changes

Commit changes apre una finestra. Scrivi un messaggio che dica cosa hai tradotto; GitHub crea il branch nel tuo fork. Propose changes porta alla pull request. Create pull request la apre verso il repository della lingua.

Propose changes

Messaggio del commitAhldskyf, capitano dell'Orion

Branchpatch-1 → mainPropose changes

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

Il messaggio deve dire quali righe hai tradotto. Le note della release vengono generate da lì.

4

Aspetta il check

Quando la pull request esiste, validate controlla ogni riga cambiata. Se è verde, la pull request si unisce da sola. Se la lingua ha un revisore, aspetta la sua approvazione. Se è rossa, il rapporto dice quale riga fallisce e perché. Correggila nello stesso branch e il check riparte.

ffxiv-language-pack-it· Pull request

✔validate controlla ogni riga cambiata: è cambiato solo target, il JSON è valido, le macro sono al loro posto e non ci sono segnapostovalidate

●Se la lingua ha un revisore, il merge aspetta la sua approvazione. Se non ce l'ha, non aspettaAuto-merge enabled

⛙Unita in main

La prima pull request di un account GitHub appena creato aspetta che il manutentore avvii il check. Le successive partono da sole.

Via completa

Con un clone e un editor

L'inglese è in un repository e la tua lingua in un altro. Entrambi hanno gli stessi file e le stesse righe. Con i due aperti in un editor, traduci con il francese e il giapponese sotto gli occhi.

1

Apri i due repository

Apri ffxiv-corpus-en e ffxiv-language-pack-it in Visual Studio Code o in un altro editor. Hanno la stessa struttura sotto corpus/: un file per conversazione e un file per foglio dell'interfaccia.

Visual Studio Code

EXPLORER

▾ ffxiv-corpus-en

▾ corpus

▾ quest

▾ 041

AktKba101_04102.json

▾ ffxiv-language-pack-it

▾ corpus

▾ quest

▾ 041

AktKba101_04102.json

ffxiv-language-pack-it ›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": "" },
    …

Fai un fork del repository della lingua su GitHub e clona il fork. Così puoi caricare il tuo branch.
ffxiv-corpus-en è di sola lettura. Clonalo o consultalo su GitHub. Non si modifica.

2

Trova lo stesso file in entrambi

Il percorso del file è lo stesso nei due repository, e così ogni gameKey. Il file inglese ha la riga in inglese, francese e giapponese. Il tuo ha la stessa chiave, un hash e un target vuoto.

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-it ›corpus / quest / 041 / AktKba101_04102.json

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

Dividi l'editor: l'inglese da un lato e il tuo file dall'altro.
Se hai dubbi, cerca per gameKey. È il dato che i due file condividono.

3

Traduci

Scrivi la traduzione in target. Parti dall'inglese, dal francese o dal giapponese, quello che capisci meglio. Il testo tra parentesi angolari è una macro che il gioco riempie quando mostra la riga: il nome del giocatore, un a capo, una variante per genere. Copia le macro come sono.

Visual Studio Code

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

{
  "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_02",
  "hash": "3C7D2A9E5B1F8E04",
  "target": "A guidare la ricerca della blasfemia è nientemeno che la Grande Veggente in persona, Kan<-->E<-->Senna."
}

Salva il file senza cambiare il formato: UTF-8 senza BOM e la stessa indentazione. Un editor che capisce JSON lo fa da solo.
Una conversazione è un file. Traducila intera, così le voci restano coerenti.

4

Commit, push, pull request

Crea un branch nel tuo fork. Fai un commit con un messaggio che dica cosa hai tradotto. Carica il branch e apri una pull request verso il repository della lingua. Puoi farlo dal terminale o dal pannello git dell'editor.

Terminal

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

Apri una pull request per gruppo di righe, non per riga. Le note della release elencano i suoi commit.
Da qui in poi il processo è lo stesso del browser: il check, il merge e la release.

Quello che non si tocca

Quattro regole, valide su entrambe le vie. Il check applica le prime tre. La quarta rende buona la traduzione.

gameKey · hash · gameVersionNon si modificano. Identificano la riga e la sua patch. Il check rifiuta qualsiasi modifica.
<--> <br> <if(…)>Si copiano com'è: le stesse dell'inglese, non una di più. Una macro aggiunta rompe la riga. Una macro tolta perde un nome o un a capo.
"target": ""Vuoto significa «non tradotto». Non scrivere segnaposto come TODO: il gioco li mostrerebbe.
fr · jaLeggili. Il francese mostra come si dice la riga. Il giapponese è l'originale e chiarisce che cosa significa.

Dopo la pull request

Nessuno interviene. Il check gira, il merge avviene, la release si costruisce e il plugin la propone a ogni giocatore all'avvio.

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

✔validate controlla ogni riga cambiata: è cambiato solo target, il JSON è valido, le macro sono al loro posto e non ci sono segnapostovalidate

●Se la lingua ha un revisore, il merge aspetta la sua approvazione. Se non ce l'ha, non aspettareview

⛙Unita in main

▲Release costruita e pubblicata. Ci vogliono due o tre minutirelease

◆Gubal Library propone la nuova versione all'avvio e mostra la tua rigaGubal Library

The Unending Codex in spagnolo, con la voce di Alphinaud — **The Unending Codex**Il pack spagnolo traduce le voci del Codice su personaggi, luoghi e concetti.

Dialogo di una missione nella finestra di conversazione del gioco, tradotto — **Quello che legge il giocatore**Il pack spagnolo nella finestra di conversazione. Il tuo ha lo stesso aspetto: il gioco disegna il tuo testo con il suo carattere, i corsivi e i colori.

Le lingue

Un repository per lingua. La percentuale tradotta si legge da ogni repository quando la pagina si carica.

Lingua	Repository	Tradotto	Una riga sbagliata?
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

Un'altra lingua? Chiedi su GitHub Discussions.