Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T09:49:11Z

Translation sync from dragonminez-wiki repository

New page

Nem toda mudança precisa reiniciar o servidor, mas nem toda mudança pode ser aplicada ao vivo. Esta página explica o que o <code>/dmzreload</code> faz, como os valores de configuração chegam aos clientes, quando ainda é preciso reiniciar ou recarregar os recursos, e o que acontece com seus arquivos quando o próprio DragonMineZ é atualizado.


== O comando /dmzreload ==
{{See also|Commands|Permissions}}
O <code>/dmzreload [target]</code> é definido em <code>ReloadCommand.java</code>. Ele exige o nó de permissão <code>dragonminez.dmz.reload</code>, <code>dragonminez.admin</code> ou o nível de operador 2 (veja [[Special:MyLanguage/Permissions|Permissões]]). O console sempre pode executá-lo.

<syntaxhighlight lang="text">
/dmzreload -> reloads everything (same as "all")
/dmzreload all -> config + story + wishes
/dmzreload config -> config files, raids, storage, NPC rules and placements
/dmzreload story -> quests, sagas, side quests and NPC dialogues
/dmzreload wishes -> dragon wishes only
</syntaxhighlight>

{| class="wikitable"
! Alvo !! O que recarrega
|-
| <code>config</code> || Todos os arquivos de <code>config/dragonminez</code> (geral, combate, treinamento, habilidades, técnicas, entidades, raças, formas, formas acumuláveis, incursões, torneios), os tipos de incursão, o backend de armazenamento de jogadores (<code>StorageManager.reload()</code>), as regras de índole de NPCs e o posicionamento de NPCs (gerando de novo os NPCs configurados). Depois, todos os arquivos de configuração são reenviados a cada jogador online, e os limites de habilidades e a progressão deles são ressincronizados.
|-
| <code>story</code> || <code>QuestRegistry.loadAll(server)</code>, que relê as sagas, missões e missões secundárias do save do mundo (executando a atualização automática de missões descrita abaixo), e <code>DialogueRegistry.loadAll(server)</code> para os diálogos de NPCs. Depois, o registro de missões é reenviado a cada jogador online.
|-
| <code>wishes</code> || <code>WishManager.loadWishes(server)</code>; depois, os desejos são reenviados a cada jogador online.
|-
| <code>all</code> || Tudo o que está acima, nessa ordem.
|}

Depois de um recarregamento, os jogadores conectados são ressincronizados automaticamente; eles não precisam sair e entrar de novo. O console também mostra o relatório de carregamento de JSON (arquivos que falharam ao carregar e arquivos atualizados automaticamente).


=== Tela de configuração no jogo ===
A entrada '''DragonMineZ''' da tela ''Mods'' do Forge tem uma tela de configuração que lista todos os arquivos de <code>config/dragonminez</code> e permite editá-los no jogo; enquanto você está em um mundo, ela também tem um botão de recarregar que executa <code>/dmzreload</code>. Ela edita os arquivos da '''sua própria''' pasta do jogo, então é pensada para o modo um jogador e anfitriões de LAN. Em um servidor dedicado, edite os arquivos do servidor.


== Alterar um valor ao vivo com /dmzconfig ==
<code>/dmzconfig <file> <key> <value></code> ou <code>/dmzconfig <file> <section> <key> <value></code> (permissão: <code>dragonminez.admin</code> ou nível de operador 2) altera um único valor, salva o arquivo e o reenvia a cada jogador online. Exemplos:

<syntaxhighlight lang="text">
/dmzconfig general-server gameplay tpGainMultiplier 2.0
/dmzconfig general-server worldGen generateDragonBalls false
</syntaxhighlight>

Ele só edita valores simples (números, <code>true</code>/<code>false</code>, texto) direto no arquivo ou a um nível de seção; listas e objetos mais profundos precisam ser editados no arquivo. Ele grava o arquivo como está, sem a atualização de versão descrita abaixo.


== Como a configuração chega aos clientes ==
{{See also|Configuration}}
* Quando um jogador entra, o servidor envia a ele '''todos''' os arquivos de <code>config/dragonminez</code>, exceto os só do cliente <code>general-user.json</code> e <code>hud_layout.json</code>, um pacote comprimido por arquivo. Enquanto estiver conectado, o cliente usa os valores do servidor para tudo o que esses arquivos controlam (estatísticas, formas, habilidades, valores de combate mostrados nos menus etc.).
* <code>/dmzreload config</code> e <code>/dmzconfig</code> enviam os arquivos de novo para todos que estão online.
* O servidor envia os arquivos '''do jeito que estão no disco'''. Se você editar um arquivo e não recarregar, o servidor continua rodando com os valores antigos enquanto os jogadores que entrarem depois recebem seu arquivo editado. Sempre execute <code>/dmzreload config</code> depois de editar.
* Ao se desconectar, o cliente descarta a cópia do servidor e volta a usar seus próprios arquivos locais.


== O que o /dmzreload cobre ==
* <code>config/dragonminez/general-server.json</code>, <code>combat.json</code>, <code>training.json</code>, <code>skills.json</code>, <code>techniques.json</code>, <code>entities.json</code>
* <code>config/dragonminez/races/<race>/character.json</code>, <code>stats.json</code> e <code>forms/*.json</code>, e <code>config/dragonminez/forms/*.json</code> (formas acumuláveis)
* <code>config/dragonminez/raids/*.json</code> e <code>config/dragonminez/tournaments/*.json</code>
* <code><world save>/dragonminez/{sagas,quests,sidequests}</code> e <code><world save>/dragonminez/dialogues</code> (com <code>story</code> ou <code>all</code>)
* <code><world save>/dragonminez/wishes/*.json</code> (com <code>wishes</code> ou <code>all</code>); veja [[Special:MyLanguage/Custom Wishes|Desejos personalizados]]
* <code><world save>/dragonminez/npcs/{placements.json,alignment_rules.json}</code> (com <code>config</code> ou <code>all</code>); veja [[Special:MyLanguage/NPC Placement and Alignment|Posicionamento e índole de NPCs]]


== O que o /dmzreload não cobre ==
* '''<code>general-user.json</code> e <code>hud_layout.json</code>''': são arquivos do cliente. Os jogadores os alteram pela tela de Configuração no jogo e pelo editor da HUD; edições à mão exigem reiniciar o jogo.
* '''Recursos de resource packs''' (modelos, texturas, animações em <code>assets/dragonminez/...</code>). Eles exigem um recarregamento de recursos no cliente ({{Key|F3}} + {{Key|T}}), já que são carregados no cliente, não pela configuração do servidor.
* '''Listeners de recarregamento de datapacks''': <code>spacepod/*.json</code> (veja [[Special:MyLanguage/Space Pod Destinations|Destinos da Cápsula Espacial]]), <code>weapon_attributes/*.json</code> (veja [[Special:MyLanguage/Weapon Attributes|Atributos de armas]]) e <code>rhythm_charts/*.json</code>. Eles seguem as regras dos datapacks vanilla: use o <code>/reload</code> vanilla ou reinicie o servidor.
* '''Pacotes de addons externos de Esferas do Dragão''' em <code><game dir>/dragonballs/</code>. Eles são relidos pelo <code>/reload</code> vanilla (conjuntos de esferas, radares, dragões e os desejos do pacote). Execute <code>/dmzreload wishes</code> depois para que os arquivos de desejos de cada mundo sejam mesclados de novo por cima dos desejos recarregados do pacote.
* '''Troca de backend de armazenamento''' (<code>NBT</code> ↔ <code>JSON</code> ↔ <code>DATABASE</code>): <code>/dmzreload config</code> salva os jogadores online e reinicia o backend de armazenamento com os novos ajustes, mas trocar de backend com jogadores online não é algo para fazer de qualquer jeito; prefira fazer isso com o servidor vazio.
* '''Código Java novo ou jars de addons''': sempre exigem reiniciar.


== Atualizar o DragonMineZ ==
Quando você instala uma versão nova do DMZ, seus arquivos são atualizados automaticamente na próxima inicialização.


=== Arquivos de configuração ===
{{See also|How to JSON}}
Cada arquivo de configuração carrega um <code>configVersion</code> (por exemplo <code>"2.2.0"</code>). Quando ele é mais antigo que a versão do mod, o DMZ move o arquivo antigo para <code>config/dragonminez/oldBackup/<same path></code>, grava os novos padrões e mescla seus valores de volta: valores que você nunca mexeu adotam o novo padrão, valores que você alterou são mantidos e chaves novas são adicionadas. Os detalhes estão em [[Special:MyLanguage/How to JSON|Como usar JSON]].


=== Missões, sagas e missões secundárias ===
{{See also|Custom Quests|Sagas}}
Com <code>autoUpdateQuests</code> ativado em [[Special:MyLanguage/General Server Config|Configuração do servidor]] (o padrão), os arquivos padrão de missões, sagas e missões secundárias que o DMZ gerou no seu mundo são atualizados da mesma forma quando o servidor inicia (e com <code>/dmzreload story</code>):

* Cada arquivo gerado carrega um <code>"defaultsVersion"</code>. Arquivos que já estão na versão atual são ignorados.
* Um campo que você nunca editou adota o novo padrão, então as correções de balanceamento chegam ao seu mundo.
* Um campo que você editou mantém o seu valor. Se a nova versão também mudou esse campo, isso é registrado como '''conflito''', e o seu valor continua vencendo.
* Chaves que você adicionou são mantidas. Listas (objetivos, recompensas) só são mescladas entrada por entrada quando a estrutura ainda corresponde; caso contrário, sua lista inteira é mantida e informada como conflito.
* Antes de um arquivo ser alterado, uma cópia vai para <code><world>/dragonminez/oldBackup/<same path></code>. Um resumo do que mudou é gravado em <code><world>/dragonminez/quest_update_report.txt</code> e aparece no relatório de carregamento de JSON.
* Arquivos de missões que você mesmo criou nunca são alterados.

Com <code>autoUpdateQuests</code> definido como <code>false</code>, os arquivos padrão só são gravados quando estão faltando.

{{Note|type=danger|title=Recomeçar do zero com os padrões|text=Para descartar os arquivos de história do seu mundo e começar com os padrões atuais, use <code>/dmzrestoreupdate</code>. Ele '''apaga''' tudo em <code><world>/dragonminez/wishes</code>, <code>sagas</code> e <code>quests</code> e depois executa <code>/dmzreload all</code> para regenerá-los (as missões secundárias não são alteradas). Antes, ele pede confirmação: clique no botão ou execute <code>/dmzrestoreupdate confirm</code> em até 15 segundos.}}


== Fluxo de trabalho prático ==
# Edite seu arquivo ou arquivos JSON.
# Valide a sintaxe do JSON (veja [[Special:MyLanguage/How to JSON|Como usar JSON]]).
# Execute o <code>/dmzreload <target></code> mais específico que cubra sua mudança: <code>config</code> para edições de balanceamento, raças, formas e incursões, <code>story</code> para edições de missões, sagas e diálogos, <code>wishes</code> para edições de desejos.
# Confira o log do servidor (ou o relatório de carregamento de JSON no chat). Uma mensagem <code>malformed JSON</code> significa que o DMZ não conseguiu ler seu arquivo: ele está usando os padrões desse arquivo e seu arquivo ficou intacto. Corrija e recarregue de novo.
# Para mudanças em resource packs ou datapacks, faça em vez disso um recarregamento de recursos no cliente ou um <code>/reload</code> vanilla.

Na dúvida, o <code>/dmzreload all</code> pode ser executado com segurança a qualquer momento: ele só refaz todos os caminhos de recarregamento e ressincroniza todo mundo.

{{Navbox Configuration}}

Reloading and Updating Changes/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository