View source for Developer Scope and Prerequisites/pt

'''Escopo e pré-requisitos''' explica para quem as páginas de conteúdo próprio e de addons foram escritas, as duas formas de expandir o DragonMineZ e as pastas e ferramentas de que você precisa antes de começar. Execute o DragonMineZ uma vez antes, para que os arquivos de configuração sejam criados.

<span id="Intended_audience"></span>
== Público-alvo ==
As páginas de conteúdo próprio e de addons foram escritas para:
* Pessoas que sabem editar JSON e recursos de pacotes de recursos.
* Pessoas que sabem usar ambientes de desenvolvimento de Minecraft Forge.
* Pessoas que querem contribuir com conteúdo compatível com o DMZ.
Elas não cobrem guias gerais para jogadores, lore nem a progressão no modo sobrevivência. Para isso, comece pelo [[Special:MyLanguage/Beginner's Guide|Guia para iniciantes]].

<span id="Two_ways_to_extend_DMZ"></span>
== Duas formas de expandir o DMZ ==

{| class="wikitable"
! Abordagem !! O que você precisa !! Por onde começar
|-
| '''Addons de dados''' (configurações, raças, formas, missões, desejos, pacotes de Esferas do Dragão, pacotes de recursos) || Um editor de texto e uma instância do DMZ || Esta página e depois as páginas de JSON indicadas abaixo e em [[Special:MyLanguage/Modding|Conteúdo próprio]]
|-
| '''Addons de código''' (seu próprio mod de Forge que se conecta aos eventos e às APIs do DMZ) || Um ambiente de desenvolvimento de Forge 1.20.1 || {{L|Add-on Getting Started}}
|}

<span id="Baseline_setup"></span>
== Configuração básica ==
{{See also|Configuration|General Server Config|General User Config|Entities Config}}
# Execute o DMZ uma vez para que os arquivos de configuração sejam gerados.
# Use <code>config/dragonminez</code> como raiz de configuração das suas instâncias de desenvolvimento locais.
# A configuração de cada raça fica em <code>config/dragonminez/races/<race_name>/</code> (<code>character.json</code>, <code>stats.json</code> e uma pasta <code>forms/</code>). Veja [[Special:MyLanguage/Custom Races|Raças personalizadas]].
# As formas acumuláveis compartilhadas ficam em <code>config/dragonminez/forms/</code>. Veja [[Special:MyLanguage/Custom Forms|Formas personalizadas]].
# Os atributos das entidades são configurados em <code>config/dragonminez/entities.json</code>.
# As configurações gerais do servidor ficam em <code>config/dragonminez/general-server.json</code>.
# As configurações gerais do usuário (cliente) ficam em <code>config/dragonminez/general-user.json</code>.
# Combate, treinamento, habilidades e técnicas de ki são configurados em <code>config/dragonminez/combat.json</code>, <code>config/dragonminez/training.json</code>, <code>config/dragonminez/skills.json</code> e <code>config/dragonminez/techniques.json</code>.
# As definições de incursões e torneios ficam em <code>config/dragonminez/raids/</code> e <code>config/dragonminez/tournaments/</code>, um arquivo JSON por incursão ou torneio; arquivos extras que você adicionar também são carregados.
# O layout da HUD, exclusivo do cliente e escrito pelo editor de HUD do jogo, é <code>config/dragonminez/hud_layout.json</code>.

Todos os arquivos de configuração, exceto <code>general-user.json</code> e <code>hud_layout.json</code>, são enviados do servidor para cada cliente ao entrar, então os clientes sempre usam os valores do servidor.

Arquivos de configuração desatualizados ou corrompidos não são descartados em silêncio: o DMZ move o arquivo antigo para <code>config/dragonminez/oldBackup/</code> (com o mesmo caminho relativo) e mescla suas edições com os novos valores padrão. Veja [[Special:MyLanguage/How to JSON|Como usar JSON]] e [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]].

<span id="World_save_data"></span>
=== Dados do save do mundo ===
Alguns sistemas ficam dentro da pasta do mundo em vez de <code>config/</code>:

{| class="wikitable"
! Pasta !! Conteúdo !! Página
|-
| <code><world>/dragonminez/sagas/</code>, <code>quests/</code>, <code>sidequests/</code> || Sagas da história, missões de saga e missões secundárias || {{L|Custom Quests}}
|-
| <code><world>/dragonminez/wishes/</code> || Desejos personalizados de cada mundo (um arquivo por dragão) || {{L|Custom Wishes}}
|-
| <code><world>/dragonminez/dialogues/</code> || Arquivos de diálogo de NPCs || {{L|NPC Dialogue}}
|-
| <code><world>/dragonminez/npcs/</code> || Posicionamentos de NPCs (<code>placements.json</code>) e regras de índole (<code>alignment_rules.json</code>) || {{L|NPC Placement and Alignment}}
|-
| <code><world>/dragonminez/playerdata_json/</code> || Dados dos jogadores quando o backend de armazenamento <code>JSON</code> está selecionado || {{L|General Server Config}}
|}

Os pacotes de addons de Esferas do Dragão (pastas ou arquivos <code>.zip</code>) vão na pasta <code>dragonballs</code> do diretório do jogo; veja [[Special:MyLanguage/Custom Wishes|Desejos personalizados]]. Não sabe onde fica uma pasta no seu computador? Veja [[Special:MyLanguage/Locating Specific Folders|Encontrar pastas]].

<span id="Reload_workflow"></span>
== Fluxo de recarga ==
Depois de alterar arquivos de configuração JSON, você pode recarregá-los no jogo com <code>/dmzreload [all|config|story|wishes]</code> (sem argumento equivale a <code>all</code>). O código do comando fica em <code>src/main/java/com/dragonminez/server/commands/ReloadCommand.java</code>. Veja [[Special:MyLanguage/Commands|Comandos]] e [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]] para saber o que cada seção recarrega.

Mudanças em pacotes de recursos (modelos e texturas) normalmente exigem uma recarga de recursos ou um reinício.

<span id="Finding_JSON_mistakes"></span>
=== Encontrar erros no JSON ===
{{Config|General Server Config|developer.reportJsonProblemsInChat}}
Quando um arquivo de configuração, missão ou desejo não carrega, o DMZ registra o arquivo, a linha e a coluna, e o caminho JSON do problema. O relatório é exibido no log do servidor e mostrado no chat aos jogadores quando eles entram. Donos de servidores podem desativar a mensagem no chat com <code>developer.reportJsonProblemsInChat = false</code> no <code>general-server.json</code>.

<span id="Translations"></span>
== Traduções ==
Todo o texto do jogo usa chaves de tradução. O arquivo-fonte em inglês é <code>assets/dragonminez/lang/en_us.json</code>; as traduções da comunidade são gerenciadas no Crowdin (veja [[Special:MyLanguage/Contributing|Como contribuir]]).

O DragonMineZ baixa automaticamente a tradução mais recente do Crowdin para o idioma do jogo que você escolheu (todos os idiomas exceto <code>en_us</code>), então as correções de tradução chegam aos jogadores sem atualizar o mod. Para desativar isso (por exemplo, para testar seu próprio arquivo de idioma), inicie o jogo com o argumento de JVM <code>-Ddmz.crowdin.enabled=false</code>.

Quando falta uma chave de tradução, algumas telas do DMZ mostram uma versão legível do id (por exemplo, textos de missões e nomes de formas viram palavras com iniciais maiúsculas). Para nomes próprios e outros idiomas, inclua suas próprias chaves em um pacote de recursos em <code>assets/<namespace>/lang/<locale>.json</code> e use essas chaves no seu JSON (por exemplo, o nome de uma forma usa <code>race.dragonminez.<race>.form.<group>.<form></code>).

{{Navbox Add-ons}}