Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Importando traduções

Jogos e internacionalização

A comunidade de jogos não é monolíngue ou monocultural. Ela é composta por muitos idiomas e culturas diferentes - assim como a comunidade do Godot! Se você deseja permitir que os jogadores experimentem seu jogo no idioma deles, uma das coisas que você precisará fornecer são as traduções de texto, às quais o Godot oferece suporte via texto internacionalizado.

Em aplicações desktop ou mobile regulares, internacionalização de texto é normalmente localizada em arquivos de recursos (ou arquivos .po para GNU). Jogos, no entanto, podem utilizar muito mais texto do que aplicações, então devem suportar métodos eficientes para lidar com grande quantidade de textos em múltiplos idiomas.

Existem duas abordagens para gerar jogos e aplicações multi-idiomas. Ambas são baseadas em um sistema de chave:valor. O primeiro é utilizar uma das linguagens como chave (normalmente Inglês), o segundo é usar um identificador específico. A primeira abordagem é provavelmente mais fácil para desenvolver se o jogo for lançado primeiro em inglês, e depois em outros idiomas, mas um completo pesadelo se estiver trabalhando com muitos idiomas ao mesmo tempo.

Em geral, jogos usam a segunda abordagem e um ID único é utilizado para cada string. Isto permite que você revise o texto enquanto ele está sendo traduzido para outros idiomas. O ID único pode ser um número, uma string, ou uma string com número (que é uma string de qualquer forma).

Formatos suportados

Para completar o cenário e permitir suporte eficiente a traduções, o Godot possui um importador especial capaz de ler arquivos CSV. A maioria dos editores de planilhas pode exportar para esse formato, portanto o único requisito é que os arquivos tenham uma organização específica. Consulte Localização utilizando planilhas para informações detalhadas sobre formatação e importação de CSVs.

Se você precisar de um formato de arquivo mais poderoso, o Godot também suporta carregar traduções escritas no formato gettext .po. Veja Localização usando gettext (arquivos PO) para detalhes.