Configuração

O DragonMineZ é configurado por arquivos JSON que donos de servidores, anfitriões de partidas de um jogador e autores de addons podem editar. A maioria fica na pasta config/dragonminez da instância do jogo ou do servidor e é gerada na primeira vez que o DMZ inicia; já os dados de história, desejos e NPCs ficam dentro do save de cada mundo. O servidor envia seus arquivos de configuração a cada jogador que entra, então, em um servidor, todos jogam com os valores do servidor.

Esta seção da wiki documenta cada arquivo de configuração, as gamerules e os nós de permissão que o DMZ adiciona, e como aplicar e manter suas alterações com segurança.

Configuração do servidor

Progressão, TP, geração de mundo, a história, habilidades raciais, chefes de mundo e armazenamento.

Configuração do cliente

Ajustes pessoais do cliente: comportamento da HUD, câmeras, auras e tutoriais.

Configuração de combate

Bloqueio, parry, mitigação, Velocidade, Surto de Ki, voo de combate e armas de ki.

Configuração de habilidades

Custos de habilidades, qual mestre ensina o quê e ajuste de técnicas.

Configuração de entidades

Estatísticas base das criaturas do DMZ e transformações dos inimigos das sagas.

Configuração de gravidade

Gravidade das dimensões, o Dispositivo de Gravidade e as zonas de treino com peso.

Crescimento dinâmico

Crescimento de estatísticas pela prática e suas regras contra farm.

Gamerules

Destruição com ki e proteção de construções para o terreno e as arenas.

Permissões

Cada nó de permissão dos comandos e como as verificações são resolvidas.

Aviso para donos de servidores

Backups, atualizações e dicas para multijogador antes de editar qualquer coisa.

Recarregar e atualizar mudanças

O que o /dmzreload cobre e como as atualizações do DMZ atualizam seus arquivos.

Onde fica a configuração

Veja também: Encontrar pastas

A pasta config/dragonminez/ pertence à instância, não a um mundo: todos os mundos jogados nessa instância usam os mesmos arquivos. Exceto pelos arquivos só do cliente marcados abaixo, o servidor envia cada arquivo desta pasta aos clientes que entram.

Arquivo	O que contém	Documentado em
`general-server.json`	Ajustes de jogabilidade para todo o servidor: progressão, TP, geração de mundo, a história, habilidades raciais, Crescimento dinâmico, gravidade, chefes de mundo, armazenamento.	Configuração do servidor
`general-user.json`	Só cliente. Ajustes pessoais do cliente; o servidor nunca os envia.	Configuração do cliente
`hud_layout.json`	Só cliente. Estilo da HUD e disposição dos elementos, gravados pelo editor da HUD.	HUD
`radial_layout.json`	Ordem, no lado do cliente, das entradas dos menus radiais; é salva quando você as reordena.
`combat.json`	Valores de ajuste do combate.	Configuração de combate
`skills.json`	Custos e requisitos das habilidades, e qual mestre oferece cada habilidade.	Configuração de habilidades
`techniques.json`	Ajuste das técnicas de ataque de ki, golpe e evasão.	Configuração de habilidades
`training.json`	Ajuste dos minijogos de treinamento.	Pontos de treino e domínio
`entities.json`	Estatísticas base por entidade e valores padrão das transformações de saga.	Configuração de entidades
`races/<race>/character.json`	Identidade da raça e valores padrão de aparência.	Raças personalizadas
`races/<race>/stats.json`	Estatísticas base da raça e seu escalonamento por classe.	Raças personalizadas
`races/<race>/forms/*.json`	Formas que pertencem só a essa raça.	Formas personalizadas
`forms/*.json`	Formas acumuláveis compartilhadas que se somam às formas próprias de uma raça.	Formas personalizadas
`raids/*.json`	Definições de incursões.	Incursões
`tournaments/*.json`	Definições de torneios.	Torneios
`oldBackup/`	Cópias dos arquivos de configuração que o DMZ atualizou ou regenerou, com a mesma estrutura relativa (por exemplo `oldBackup/races/saiyan/stats.json`). O DMZ nunca volta a lê-las.	Como usar JSON

As raças padrão geradas em races/ são human, saiyan, namekian, frostdemon, bioandroid, majin e glind. Qualquer outra pasta dentro de races/ é carregada como raça personalizada.

As regras de jogo que não são arquivos JSON são explicadas em Gamerules (destruição com ki e construção em arenas) e Permissões (quem pode usar cada comando). As pastas de cada mundo (sagas, missões, missões secundárias, desejos, diálogos, posicionamento de NPCs e dados de jogador em JSON) estão listadas em Encontrar pastas.

Como a configuração chega aos clientes

Artigo principal: Recarregar e atualizar mudanças

Quando um jogador entra, o servidor envia a ele todos os arquivos de config/dragonminez, exceto general-user.json e hud_layout.json. Enquanto estiver conectado, o cliente usa os valores do servidor para tudo o que esses arquivos controlam.
O servidor envia os arquivos do jeito que estão no disco. Depois de editar um arquivo, sempre execute /dmzreload config; até fazer isso, o servidor continua rodando com os valores antigos, enquanto os jogadores que entrarem depois já recebem o arquivo editado.
/dmzreload config e /dmzconfig reenviam os arquivos para todos que estão online.
Ao se desconectar, o cliente descarta a cópia do servidor e volta a usar seus próprios arquivos locais.

Editar a configuração com segurança

Veja também: Como usar JSON, Aviso para donos de servidores

Mantenha os arquivos como JSON válido. Um arquivo com erro de sintaxe nunca é sobrescrito: o DMZ usa os valores padrão desse arquivo durante a sessão e informa o arquivo, a linha e a coluna no log (e no chat ao entrar).
Não edite configVersion. O DMZ o usa para atualizar o arquivo depois de uma atualização do mod: o arquivo antigo é movido para oldBackup/, os novos valores padrão são gravados e os valores que você alterou são mesclados de volta.
Comentários e anotações dentro dos arquivos são removidos sempre que o DMZ os reescreve, então guarde suas anotações em outro lugar.
Faça seu próprio backup antes de edições em massa em um servidor ativo.