Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-13T23:39:38Z

Translation sync from dragonminez-wiki repository

New page

'''Como contribuir''' explica como ajudar o DragonMineZ: reportar bugs, testar versões, sugerir recursos, melhorar a documentação ou trabalhar no código. Seja o que for que você queira fazer, a equipe terá prazer em colaborar com você. Siga estas diretrizes para que o processo seja tranquilo para todos os colaboradores. Se quiser fazer uma doação ao projeto, veja [[Special:MyLanguage/Contributing#Supporting the project on Patreon|Apoiar o projeto no Patreon]].


== Primeiros passos ==
# '''Leia o Código de Conduta.''' Ao contribuir, você concorda em respeitar o [https://github.com/DragonMineZ/DragonMineZ/blob/main/.github/CODE_OF_CONDUCT.md Código de Conduta].
# '''Confira as issues existentes.''' Veja as [https://github.com/orgs/DragonMineZ/projects/5 issues] para saber se alguém já reportou seu problema ou propôs sua ideia.
# '''Faça um fork do repositório''' e clone seu fork no seu ambiente local para testar e desenvolver (veja abaixo).
# '''Prepare seu ambiente''' com as ferramentas listadas abaixo.

Para clonar seu fork:

<syntaxhighlight lang="bash">
git clone https://github.com/your-username/DragonMineZ.git
</syntaxhighlight>

Verifique se você tem estas ferramentas instaladas:
* Java Development Kit (JDK) 17 (o build usa uma toolchain do Java 17)
* Git
* Uma IDE com suporte a Gradle (IntelliJ IDEA ou Eclipse)
Você não precisa instalar o Gradle nem o Forge por conta própria: o repositório inclui o wrapper do Gradle (<code>gradlew</code> / <code>gradlew.bat</code>), que baixa o Gradle, o Minecraft Forge (<code>1.20.1-47.4.10</code>) e todas as dependências no primeiro build.

Se você não vai fazer um fork do repositório nem criar um addon, pode pular o passo 3. Para desenvolver addons, veja [[Special:MyLanguage/Add-on Getting Started|Primeiros passos com addons]].


== Compilar e executar ==
Execute estes comandos a partir da raiz do repositório (<code>./gradlew</code> no Linux e no macOS, <code>.\gradlew.bat</code> no Windows):

{| class="wikitable"
! Comando !! O que faz
|-
| <code>./gradlew build</code> || Build completo. O jar distribuível é <code>build/libs/dragonminez-<version>.jar</code> (ele inclui as bibliotecas de banco de dados); o jar <code>-slim</code> não é feito para ser distribuído.
|-
| <code>./gradlew runClient</code> || Inicia um cliente de desenvolvimento (diretório de trabalho <code>run/</code>).
|-
| <code>./gradlew runServer</code> || Inicia um servidor dedicado de desenvolvimento (diretório de trabalho <code>run/</code>).
|-
| <code>./gradlew runData</code> || Executa a geração de dados (diretório de trabalho <code>run-data/</code>) e grava em <code>src/generated/resources/</code>. Execute depois de alterar os providers de datagen e revise o diff gerado.
|}

* '''Não há uma suíte de testes automatizados'''. Valide sua mudança com <code>build</code> e, quando ela afetar a jogabilidade, testando-a no <code>runClient</code> e/ou no <code>runServer</code>.
* Mods de desenvolvimento só de cliente (JEI runtime, shaders etc.) são adicionados apenas ao <code>runClient</code>. Mantenha assim, para que eles não vazem para os dados gerados nem para o servidor dedicado.
* A otimização de recursos (PackSquash) roda no CI e fica desativada por padrão nos builds locais. Force-a com <code>-PoptimizeResources=true</code> ou <code>-PoptimizeResources=false</code>.


== Traduções ==
* <code>src/main/resources/assets/dragonminez/lang/en_us.json</code> é o arquivo de idioma de origem. Adicione nele uma entrada para cada texto novo que os jogadores possam ver e mantenha estáveis as chaves existentes.
* Os outros idiomas são traduzidos pela comunidade no Crowdin. O arquivo em inglês é enviado ao Crowdin automaticamente quando muda na <code>main</code>.
* Antes de abrir um pull request, verifique se todos os arquivos de idioma são JSON válido com <code>scripts/check_lang.sh</code> (ele precisa do <code>jq</code>).


== Como contribuir ==


=== Reportar bugs ===
Se você encontrou um bug, abra um [https://github.com/DragonMineZ/DragonMineZ/issues/new?template=bug_report.yml relatório de bug] e inclua o máximo de detalhes possível:
* Uma descrição clara do problema
* Passos para reproduzi-lo
* Resultado esperado e resultado real
* Capturas de tela, logs ou relatórios de crash, se houver


=== Testar o jogo ===
Qualquer pessoa pode testar as versões públicas e compartilhar o que encontrar com a equipe: bugs, exploits, problemas de balanceamento, crashes ou qualquer outra coisa que pareça estranha. Você não precisa ser desenvolvedor nem abrir um pull request para ajudar dessa forma.
* Teste '''apenas versões públicas'''. Não teste versões internas ou não lançadas, a menos que tenha recebido acesso explícito.
* Compartilhe o que encontrar em um [https://github.com/DragonMineZ/DragonMineZ/issues/new?template=bug_report.yml relatório de bug] ou no Discord.
* Se o que você encontrar for uma '''vulnerabilidade de segurança''' (por exemplo, algo que possa ser explorado para prejudicar outros jogadores ou servidores), siga a [[Special:MyLanguage/Security Policy|Política de segurança]] em vez de abrir uma issue pública.


=== Sugerir recursos ===
Tem uma ótima ideia? Abra uma [https://github.com/DragonMineZ/DragonMineZ/issues/new?template=feature_request.yml sugestão de recurso] e inclua:
* Uma explicação clara e concisa do recurso
* Seus possíveis benefícios e impacto
* Alternativas ou conceitos relacionados
Você também pode sugerir recursos no servidor do Discord.


=== Enviar pull requests ===
'''Passo 1: Crie uma branch.''' A <code>main</code> contém a linha estável atual; a próxima versão é desenvolvida na sua própria branch de versão (por exemplo, <code>v2.2</code>). Baseie sua branch naquela a que sua mudança se destina; se não tiver certeza, pergunte no Discord. Use um nome de branch descritivo:

<syntaxhighlight lang="bash">
git checkout -b fix/short-description
</syntaxhighlight>

'''Passo 2: Faça suas mudanças.'''
* Escreva código limpo e conciso.
* Teste suas mudanças localmente para garantir que funcionam como esperado.
* Siga as convenções e padrões de código do projeto.

'''Passo 3: Faça commit das suas mudanças''' com uma mensagem de commit significativa:

<syntaxhighlight lang="bash">
git commit -m "Fix: Resolved issue with XYZ feature"
</syntaxhighlight>

'''Passo 4: Envie suas mudanças (push).'''

<syntaxhighlight lang="bash">
git push origin fix/short-description
</syntaxhighlight>

'''Passo 5: Abra um pull request.''' Vá ao seu fork no GitHub e envie um [https://github.com/DragonMineZ/DragonMineZ/pulls pull request].
* Descreva as mudanças e vincule as issues relacionadas.
* Esteja pronto para discutir e revisar seu código com base no feedback.
* Todo pull request é compilado automaticamente pelo workflow '''Compile Check''' (<code>./gradlew build</code>). Se falhar, seu pull request não será mesclado. As execuções de workflow de quem contribui pela primeira vez podem precisar da aprovação de um mantenedor antes de começar.


=== Verificações automáticas ===

{| class="wikitable"
! Workflow !! Quando roda !! O que faz
|-
| Compile Check || Todo pull request, e pushes para qualquer branch exceto <code>main</code> que mexam em código, recursos ou arquivos do Gradle || Executa <code>./gradlew build</code>
|-
| Java CI || Pull requests e pushes para a <code>main</code> que mexam em Java ou no <code>build.gradle.kts</code> || Executa <code>./gradlew build</code> e envia o grafo de dependências
|-
| Crowdin Check & Upload || Pushes para a <code>main</code> que mexam na pasta lang, a cada 2 dias ou manualmente || Valida os arquivos de idioma com <code>scripts/check_lang.sh</code> e envia o <code>en_us.json</code> ao Crowdin
|-
| CodeQL || Diariamente || Análise de segurança do código Java e dos workflows
|}

Os mantenedores publicam as versões no Modrinth e no CurseForge a partir da <code>main</code> com seus workflows de lançamento.


== Diretrizes para colaboradores ==
# '''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.
# '''Documentação'''
#* Atualize ou adicione documentação para recursos novos ou alterados.
#* Garanta que esta [[Special:MyLanguage/Main Page|wiki]] reflita as mudanças importantes.
# '''Testes'''
#* Teste a fundo nos cenários relevantes, incluindo um servidor dedicado (<code>runServer</code>) 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.
# '''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 <code>NetworkHandler.register()</code>, 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.
# '''Documentação do projeto'''
#* <code>CLAUDE.md</code> e a pasta <code>AI/</code> (<code>Agents.md</code>, <code>Context.md</code>, <code>Memory.md</code>, <code>QuestAddonAPI.md</code>) 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 <code>AI/Context.md</code> antes de mudanças maiores.


== Comunidade ==
Entre no [https://discord.gg/b5MgRNb3D7 servidor do Discord] para conversas em tempo real.


== Apoiar o projeto no Patreon ==
O DragonMineZ é um projeto movido pela comunidade, e seu apoio ajuda a equipe a continuar melhorando o mod e lançando novos recursos. Considere se tornar apoiador no [https://patreon.com/DragonMineZ Patreon] para apoiar o desenvolvimento e a manutenção do mod.
Os apoiadores recebem benefícios exclusivos, como:
* Acesso antecipado a novos recursos
* Novidades dos bastidores
* Reconhecimento na comunidade
Toda contribuição, por menor que seja, ajuda o DragonMineZ a continuar melhorando.


== Licença ==
Ao contribuir, você concorda que suas contribuições serão licenciadas sob a mesma [https://github.com/DragonMineZ/DragonMineZ/blob/main/LICENSE licença] que rege o projeto.


== Obrigado ==
A equipe está animada para ver suas contribuições e ideias. Se tiver alguma dúvida ou precisar de ajuda, fale com a equipe.

{{Navbox Add-ons}}

Contributing/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository