Localizar Final Fantasy XIV

Como funciona

Cinco passos levam uma frase do jogo de volta ao jogo, traduzida. Participam dois repositórios, um pull request e um plugin. Nenhum arquivo do jogo é modificado.

Caminho rápido

No navegador

Quatro cliques no GitHub. Nada para instalar, nenhum git para aprender.

Ver os quatro passos → Caminho completo

Com um clone e um editor

Clone os dois repositórios e traduza no seu editor, com o inglês, o francês e o japonês ao lado.

Ver os quatro passos →

Caminho rápido

No navegador

Tudo acontece no GitHub. O primeiro clique cria um fork do repositório, ou seja, a sua própria cópia. É assim que qualquer pessoa que não é dona de um projeto propõe mudanças nele.

1

Abra o arquivo no GitHub e clique no lápis

Entre no repositório do idioma, na pasta corpus/, e abra o arquivo da conversa. O lápis no canto superior direito abre o editor. Se você não for colaborador, o GitHub pede antes um fork do repositório. Aceite.

ffxiv-language-pack-pt-br/ corpus / flat / DefaultTalk.json✎

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

O fork é criado em um segundo e o editor abre sobre ele. Isso só acontece na primeira vez.
Para encontrar uma linha, procure o texto inglês dela em ffxiv-corpus-en. O arquivo tem o mesmo caminho nos dois repositórios.

2

Escreva target

Escreva a tradução no campo target da linha. Não mude gameKey nem hash: eles identificam a linha. O texto entre colchetes angulares é uma macro; copie como está.

github.com · ffxiv-language-pack-pt-br · DefaultTalk.json

    { "gameKey": "DefaultTalk#590415.20", "hash": "E38048F1B03D2DD9", "target": "Sou o capitão contratado do Orion." },
    { "gameKey": "DefaultTalk#590415.21", "hash": "5869006EA8C4FD7E", "target": "" },

Você pode mudar uma linha ou cem, em um ou em vários arquivos. O pull request leva todas.
O inglês, o francês e o japonês da linha estão no mesmo arquivo de ffxiv-corpus-en.

3

Commit changes e depois Propose changes

Commit changes abre uma janela. Escreva uma mensagem que diga o que você traduziu; o GitHub cria o branch no seu fork. Propose changes leva ao pull request. Create pull request o abre contra o repositório do idioma.

Propose changes

Mensagem do commitAhldskyf, capitão do Orion

Branchpatch-1 → mainPropose changes

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

A mensagem deve dizer quais linhas você traduziu. As notas da release são geradas a partir dela.

4

Espere o check

Quando o pull request existe, validate confere cada linha alterada. Se estiver verde, o pull request faz o merge sozinho. Se o idioma tiver revisor, ele espera a aprovação. Se estiver vermelho, o relatório diz qual linha falha e por quê. Corrija no mesmo branch e o check roda de novo.

ffxiv-language-pack-pt-br· Pull request

✔validate confere cada linha alterada: só target mudou, o JSON é válido, as macros estão no lugar e não há marcadoresvalidate

●Se o idioma tiver revisor, o merge espera a aprovação dele. Se não tiver, não esperaAuto-merge enabled

⛙Mesclado em main

O primeiro pull request de uma conta do GitHub recém-criada espera o mantenedor iniciar o check. Os seguintes rodam sozinhos.

Caminho completo

Com um clone e um editor

O inglês está em um repositório e o seu idioma em outro. Os dois têm os mesmos arquivos e as mesmas linhas. Com os dois abertos em um editor, você traduz com o francês e o japonês à vista.

1

Abra os dois repositórios

Abra ffxiv-corpus-en e ffxiv-language-pack-pt-br no Visual Studio Code ou em outro editor. Os dois têm a mesma estrutura em corpus/: um arquivo por conversa e um arquivo por planilha da interface.

Visual Studio Code

EXPLORER

▾ ffxiv-corpus-en

▾ corpus

▾ quest

▾ 041

AktKba101_04102.json

▾ ffxiv-language-pack-pt-br

▾ corpus

▾ quest

▾ 041

AktKba101_04102.json

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

Faça um fork do repositório do idioma no GitHub e clone o fork. Assim você pode enviar seu branch.
ffxiv-corpus-en é somente leitura. Clone ou consulte no GitHub. Ele não é editado.

2

Encontre o mesmo arquivo nos dois

O caminho do arquivo é o mesmo nos dois repositórios, e cada gameKey também. O arquivo inglês tem a linha em inglês, francês e japonês. O seu tem a mesma chave, um hash e um target vazio.

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

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

Divida o editor: o inglês de um lado e o seu arquivo do outro.
Na dúvida, procure pela gameKey. É o dado que os dois arquivos compartilham.

3

Traduza

Escreva a tradução em target. Parta do inglês, do francês ou do japonês, o que você entender melhor. O texto entre colchetes angulares é uma macro que o jogo preenche ao mostrar a linha: o nome do jogador, uma quebra de linha, uma variante por gênero. Copie as macros como estão.

Visual Studio Code

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

{
  "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_02",
  "hash": "3C7D2A9E5B1F8E04",
  "target": "A busca pela blasfêmia é liderada por ninguém menos que a própria Grande Vidente, Kan<-->E<-->Senna."
}

Salve o arquivo sem mudar o formato: UTF-8 sem BOM e a mesma indentação. Um editor que entende JSON faz isso sozinho.
Uma conversa é um arquivo. Traduza inteira para que as vozes fiquem coerentes.

4

Commit, push, pull request

Crie um branch no seu fork. Faça um commit com uma mensagem que diga o que você traduziu. Envie o branch e abra um pull request contra o repositório do idioma. Você pode fazer isso pelo terminal ou pelo painel git do editor.

Terminal

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

Abra um pull request por lote de linhas, não por linha. As notas da release listam seus commits.
A partir daqui, o processo é igual ao do navegador: o check, o merge e a release.

O que não se toca

Quatro regras, válidas nos dois caminhos. O check aplica as três primeiras. A quarta faz a tradução ficar boa.

gameKey · hash · gameVersionNão são editados. Identificam a linha e o patch dela. O check rejeita qualquer mudança neles.
<--> <br> <if(…)>Copiadas como estão: as mesmas que o inglês tem, nenhuma a mais. Uma macro a mais quebra a linha. Uma macro a menos perde um nome ou uma quebra de linha.
"target": ""Vazio significa «não traduzido». Não escreva marcadores como TODO: o jogo os mostraria.
fr · jaLeia-os. O francês mostra como a linha é dita. O japonês é o original e esclarece o que ela significa.

Depois do pull request

Ninguém intervém. O check roda, o merge acontece, a release é construída e o plugin a oferece a cada jogador na inicialização.

ffxiv-language-pack-pt-br· Pull request → Release

✔validate confere cada linha alterada: só target mudou, o JSON é válido, as macros estão no lugar e não há marcadoresvalidate

●Se o idioma tiver revisor, o merge espera a aprovação dele. Se não tiver, não esperareview

⛙Mesclado em main

▲Release construída e publicada. Leva dois ou três minutosrelease

◆O Gubal Library oferece a nova versão na inicialização e mostra a sua linhaGubal Library

The Unending Codex em espanhol, com a entrada de Alphinaud — **The Unending Codex**O pacote espanhol traduz as entradas do códice sobre personagens, lugares e conceitos.

Diálogo de missão na janela de conversa do jogo, traduzido — **O que o jogador lê**O pack espanhol na janela de conversa. O seu fica igual: o jogo desenha o seu texto com a própria fonte, itálicos e cores.

Os idiomas

Um repositório por idioma. A porcentagem traduzida é lida de cada repositório quando a página carrega.

Idioma	Repositório	Traduzido	Linha errada?
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

Outro idioma? Pergunte em GitHub Discussions.