Translations:Contributing/53/pt

From DragonMineZ Wiki
Revision as of 23:21, 13 October 2026 by Shokkoh (talk | contribs) (Translation sync from dragonminez-wiki repository)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
  1. Padrões de código
    • Use nomes descritivos para variáveis e métodos.
    • Formate o código de forma consistente (indentação, espaçamento etc.).
    • Escreva comentários para a lógica complexa.
  2. Documentação
    • Atualize ou adicione documentação para recursos novos ou alterados.
    • Garanta que esta wiki reflita as mudanças importantes.
  3. Testes
    • Teste a fundo nos cenários relevantes, incluindo um servidor dedicado (runServer) quando sua mudança mexer em classes do cliente, rede ou lógica do servidor.
    • Corrija qualquer problema de linting ou de compilação antes de enviar seu pull request.
  4. Compatibilidade
    • Muitos sistemas leem JSON que jogadores, donos de servidores e autores de addons editam (configurações, missões, desejos, pacotes de Esferas do Dragão). Não renomeie nem remova chaves de configuração, campos JSON, chaves de salvamento NBT ou nomes de registro sem discutir antes: mundos e configurações antigos precisam continuar carregando.
    • Os pacotes de rede são identificados pela ordem de registro: adicione pacotes novos no final de NetworkHandler.register(), nunca no meio.
    • Valide no servidor tudo o que um cliente envia; nunca confie no cliente para estatísticas, desbloqueios, missões, desejos ou progresso.
  5. Documentação do projeto
    • CLAUDE.md e a pasta AI/ (Agents.md, Context.md, Memory.md, QuestAddonAPI.md) descrevem em detalhes a arquitetura, os sistemas de dados, o build e a automação de lançamentos. Foram escritos para assistentes de programação com IA, mas são igualmente úteis para colaboradores humanos: leia AI/Context.md antes de mudanças maiores.