AcTePuKc/bg-game-translation-qa

QA de Localização de Jogos em Búlgaro

Use esta habilidade para trabalho de localização de jogos em búlgaro, onde preservar o formato do arquivo é tão importante quanto melhorar o texto. Faça alterações mínimas e seguras e prefira patches focados a reescrever arquivos inteiros, a menos que o usuário peça explicitamente uma reescrita completa.

Fluxo de Trabalho Principal

1. Identifique o formato do arquivo e os campos traduzíveis antes de editar.
2. Preserve toda a estrutura, ordenação, delimitadores, citações, escape, comentários, chaves, IDs e metadados.
3. Traduza ou edite apenas o texto voltado para o jogador.
4. Preserve placeholders, tags de formatação, variáveis, sequências de escape e quebras de linha exatamente, a menos que o usuário peça explicitamente para alterá-los.
5. Siga qualquer glossário do projeto, base de termos, guia de estilo ou memória de tradução existente fornecida pelo usuário ou presente no projeto.
6. Relate cadeias de caracteres incertas separadamente, em vez de adivinhar silenciosamente.
7. Resuma o que mudou, o que permaneceu inalterado e quaisquer riscos ou dúvidas.

Conteúdo Não Traduzível

Não traduza ou normalize identificadores internos, nomes de enumerações, nomes de arquivos, caminhos de arquivos, nomes de classes, nomes de funções, nomes de objetos, nomes de assets, nomes de eventos, comandos de console, chaves de configuração, IDs ou metadados técnicos, a menos que o usuário os marque explicitamente como texto voltado para o jogador.

Para arquivos estruturados, mantenha a contagem de linhas, ordem das chaves, aninhamento, separadores e codificação intactos. Para tabelas CSV/TSV, preserve a estrutura exata das colunas. Para arquivos JSON/XML/INI/PO, preserve a sintaxe e o escape.

Placeholders e Tags

Preserve placeholders e tags de formatação byte por byte, incluindo maiúsculas/minúsculas, pontuação, aninhamento, espaçamento e ordem. Não traduza texto dentro de variáveis, a menos que seja claramente um texto de exibição voltado para o jogador.

Sempre proteja padrões como:

• {PLAYER}
• {0}
• %s
• %d
• <color=...>
• </color>
• <b>
• </b>
• \n
• \t
• [br]
• [[...]]
• $VARIABLE
• ${variable}

Leia references/placeholders.md quando a tarefa incluir tokens desconhecidos, rich text, marcação de UI, sintaxe de script ou placeholders específicos de formato.

Estilo de Localização em Búlgaro

Use frases naturais em búlgaro, não ordem de palavras literal do inglês. Mantenha o texto da UI conciso e legível, especialmente para botões, menus, conquistas, dicas de ferramentas e mensagens de combate.

Prefira tradução culturalmente apropriada em búlgaro em vez de transliteração quando possível, mas mantenha os termos de jogo estabelecidos e as escolhas do glossário do projeto consistentes. Preserve a voz do personagem no diálogo e evite formalizar demais a fala casual ou humorística.

Quando o gênero do falante ou jogador for desconhecido, evite frases forçadas de gênero onde o búlgaro permite uma construção neutra. Não introduza frases com som russo ou ucraniano. Evite capitalização desnecessária copiada de títulos em inglês, nomes de itens ou rótulos de UI, a menos que o estilo do projeto exija.

Termos Técnicos e Empréstimos

Não traduza um termo técnico mecanicamente só porque ele está visível na fonte. Primeiro, determine se é um identificador interno, um termo especializado estabelecido ou prosa voltada para o jogador.

• Mantenha nomes de API, comandos, chaves de configuração, nomes de classe e outros identificadores inalterados.
• Para texto voltado para o jogador, prefira uma descrição natural em búlgaro da função em vez de um empréstimo literal.
• Se a fonte não estabelecer o papel técnico com precisão, não invente um. Use uma frase funcional neutra ou relate a cadeia de caracteres como incerta.
• Siga o glossário do projeto quando ele definir um termo, mesmo quando outra opção búlgara também for possível.

Exemplos:

Termo fonte	Texto voltado para o jogador	Explicação técnica	Não assuma
hook	механизъм / точка за включване	обработчик / точка за разширяване	que significa um módulo ou кука
compatibility hook	механизъм за съвместимост	обработчик за съвместимост ou точка за включване за съвместимост	que модул, кука ou прихващач está sempre correto
fix	поправка / корекция	поправка за съвместимост	que a gíria фикс se encaixa no público
handler	descreva sua ação se necessário	обработчик	que deve ser transliterado como хендлър

Por exemplo, traduza The journal level label was corrected through the compatibility hook. como Надписът за нивото в дневника е коригиран чрез механизма за съвместимост. para um changelog voltado para o jogador. Não use кука за съвместимост por padrão.

Termos de Jogo Repetidos

Quando um conceito de mecânica de jogo ou UI se repete, decida seu nome em búlgaro na primeira ocorrência clara e registre-o no glossário do projeto. Não agrupe termos relacionados em uma única palavra búlgara apenas porque soam semelhantes em inglês.

Termos fonte a distinguir	Escolhas búlgaras possíveis	Risco de QA
skill, ability, perk, trait, feat	умение, способност, привилегия, черта	diferentes sistemas de progressão se tornam indistinguíveis
buff, debuff, status effect	положителен ефект, отрицателен ефект, ефект на състояние	o jogador não consegue distinguir um bônus de uma condição
cooldown, charge, stack	време за изчакване, заряд, натрупване	tempo, recurso e mecânicas de acumulação são confundidos
loot, drop	плячка, изпуснат предмет	um pool de recompensas é confundido com um item produzido por um evento ou inimigo
spawn, despawn, trigger	появяване, изчезване, задействане	eventos mundiais e condições de interação se tornam vagos
crafting, recipe, blueprint, upgrade	изработка, рецепта, чертеж, подобрение	criação, desbloqueios e melhorias perdem sua distinção mecânica
save, load, save slot	запазване, зареждане, място за запазена игра	a ação, o jogo salvo e sua localização são confundidos

Revise também palavras técnicas sensíveis ao contexto, como support, state, patch, build, release e slot. Por exemplo, support pode significar съвместимост, поддръжка ou помощ; patch pode ser поправка, корекция ou обновление.

Tratamento e Registro

Não use por padrão o tratamento formal Вие / -те para UI de jogo voltada para o jogador, tutoriais, instruções, objetivos ou mensagens genéricas do sistema. Prefira o singular informal ти / -ш ou uma construção neutra natural, a menos que o glossário do projeto, a voz do personagem, o cenário ou o contexto da fonte exijam claramente tratamento formal.

Sinalize tratamento/registro incompatível como um problema de QA, especialmente quando o inglês you foi traduzido como búlgaro formal sem evidência de que o jogo usa tratamento formal para o jogador.

Exemplos:

• You have to do this. -> prefira Трябва да направиш това. ou Това трябва да се направи. dependendo do contexto
• evite usar Вие трябва да направите това. por padrão em UI normal voltada para o jogador
• mantenha o tratamento formal para nobres, oficiais, UI do tipo serviço de atendimento ao cliente, narrativa intencionalmente distante ou projetos cujo estilo estabelecido usa Вие

Lastro de Tradução

Sinalize frases fonte que são tecnicamente traduzidas, mas adicionam peso desnecessário ao texto da UI em búlgaro. Trate-as como avisos de QA para revisão manual, não correções automáticas.

Use severidade low e ação manual review para possíveis lastros de tradução. Mantenha a frase quando ela carregar informações reais de jogabilidade, espaciais, de alvo, de tempo ou mecânicas.

Exemplos comuns:

• through the air após verbos como shoot, fire, throw ou launch
  • shoots arrows through the air -> изстрелва стрели
  • sinalize variantes excessivamente literais como изстрелва стрели във въздуха a menos que o deslocamento aéreo seja mecanicamente relevante
• nearby quando a proximidade já está implícita na frase búlgara
  • when enemies are nearby -> когато има врагове наблизо
  • when senses lifeforms nearby -> когато усети живи същества наблизо
  • mantenha наблизо quando definir raio de detecção, alvo, alcance de acionamento ou localização
• into pieces / apart após verbos que já implicam quebrar
  • smashing things apart -> разбиване на неща
  • evite frases forçadas como разбиване на неща на парчета a menos que fragmentos/partes importem
• on the ground, in front of you, with your hands ou by hand quando o verbo ou contexto búlgaro já implica a informação
  • mantenha-os quando carregarem restrições reais de posição, entrada, criação ou interação

Leia references/bg-text.md para orientação prática de estilo búlgaro e references/glossary-template.md ao criar ou estender um glossário de projeto.

Relação com o bg-text

Quando a habilidade bg-text estiver disponível ou o usuário pedir para usá-la, use-a como referência complementar para tipografia búlgara, clareza, pontuação, gramática e qualidade editorial geral. Aplique primeiro as restrições de localização de jogos desta habilidade: nunca deixe que a limpeza de tipografia ou estilo altere estrutura protegida, chaves, IDs, placeholders, tags, sequências de escape, quebras de linha ou terminologia do projeto.

Para arquivos de jogo, trate bg-text como orientação de qualidade linguística, não permissão para reescrever arquivos inteiros ou normalizar sintaxe específica do mecanismo.

Lista de Verificação de QA

Antes do resultado final, verifique se há:

• placeholders quebrados, alterados, reordenados ou ausentes
• tags de formatação ausentes, malformadas ou desbalanceadas
• chaves, IDs, nomes de arquivos, caminhos ou metadados alterados
• linhas ausentes ou forma de tabela alterada
• IDs duplicados introduzidos ou perdidos
• inglês não traduzido em campos traduzidos
• restos de ucraniano
• restos de russo
• termos de glossário inconsistentes
• termos técnicos traduzidos mecanicamente ou inconsistentemente
• mecânicas de jogo relacionadas agrupadas em um termo sem uma decisão de glossário
• búlgaro excessivamente literal
• tratamento formal/informal incompatível, especialmente Вие desnecessário em UI voltada para o jogador
• possível lastro de tradução / frase literal que deve ser revisada manualmente
• texto de UI obviamente muito longo para seu controle provável

Leia references/qa-checklist.md para uma passagem de revisão final prática.

Expectativas de Saída

Prefira mudanças no estilo de patch e correções focadas. Explique brevemente mudanças significativas de tradução ou QA. Liste cadeias de caracteres incertas separadamente com a chave/ID ou localização, o problema e o tratamento sugerido mais seguro.

Se o arquivo for grande, inspecione contexto circundante suficiente para evitar desvio de terminologia, depois edite apenas o escopo solicitado. Se uma alteração solicitada arriscar danificar a estrutura ou placeholders, pare e peça esclarecimentos.