Encontrar pastas
Encontrar pastas mostra onde o DragonMineZ guarda seus dados editáveis. Os arquivos ficam divididos entre algumas raízes diferentes, dependendo de a quem os dados pertencem e de quando eles são lidos. Saber de qual raiz você precisa evita muita confusão, principalmente porque algumas pastas só aparecem depois que você executa o servidor ou o cliente pelo menos uma vez.
Pasta de configuração do mod
config/dragonminez/ guarda a configuração do mod. Ela pertence à instância do jogo, não a um mundo, e é gerada na primeira vez que o DragonMineZ inicia. É aqui que você ajusta o balanceamento e as estatísticas, e adiciona raças, formas e entidades personalizadas. Exceto pelos dois arquivos exclusivos do cliente indicados abaixo, o servidor envia todos os arquivos desta pasta aos clientes que entram (veja Recarregar e atualizar mudanças).
| Caminho | Finalidade |
|---|---|
config/dragonminez/general-server.json |
Opções de jogabilidade do servidor inteiro (veja Configuração do servidor). |
config/dragonminez/general-user.json |
Apenas cliente. Configurações pessoais do cliente, nunca enviadas pelo servidor (veja Configuração do cliente). |
config/dragonminez/hud_layout.json |
Apenas cliente. Estilo da HUD e layout dos elementos (veja HUD). |
config/dragonminez/radial_layout.json |
Ordem das entradas dos menus radiais no cliente, salva quando você as reorganiza. |
config/dragonminez/combat.json |
Valores de ajuste do combate (veja Configuração de combate). |
config/dragonminez/skills.json |
Custos, recargas e requisitos das habilidades, e as habilidades que cada raça e mestre oferece; as duas coisas ficam neste único arquivo (veja Configuração de habilidades). |
config/dragonminez/training.json |
Ajuste dos minigames de treinamento de TP (veja pontos de treino e domínio). |
config/dragonminez/techniques.json |
Ajuste dos ataques de ki e dos ataques de golpe (veja Configuração de habilidades). |
config/dragonminez/entities.json |
Estatísticas base de cada entidade e valores padrão das transformações de saga (veja Configuração de entidades). |
config/dragonminez/races/<race>/character.json |
Identidade da raça e valores padrão da aparência (veja Raças personalizadas). |
config/dragonminez/races/<race>/stats.json |
Estatísticas base da raça e escalonamento para cada classe. |
config/dragonminez/races/<race>/forms/*.json |
Formas que pertencem apenas a essa raça. |
config/dragonminez/forms/*.json |
Formas acumuláveis compartilhadas, que se somam às formas próprias de uma raça (veja Formas personalizadas). |
config/dragonminez/raids/*.json |
Definições de incursões (veja Incursões). |
config/dragonminez/tournaments/*.json |
Definições de torneios (veja Torneios). |
config/dragonminez/oldBackup/ |
Cópias dos arquivos de configuração que o DragonMineZ atualizou ou regenerou, com a mesma estrutura relativa (por exemplo, oldBackup/races/saiyan/stats.json). O DragonMineZ nunca volta a lê-las.
|
As raças padrão geradas aqui são human, saiyan, namekian, frostdemon, bioandroid, majin e glind. Qualquer outra pasta dentro de races/ é carregada como raça personalizada.
Código-fonte: ConfigManager.java (loadGeneralConfigs, loadAllRaces, createOrLoadStackForms, loadRaids, loadTournaments).
Pasta do save do mundo
<world save>/dragonminez/ fica dentro do save do mundo, então o conteúdo pertence a um único mundo, não à instância inteira. É por isso que as mudanças em missões e sagas não aparecem até você editar a pasta do save certo:
- Um jogador:
saves/<world>/dragonminez/ - Servidor:
<server>/<level-name>/dragonminez/ - Ambiente de desenvolvimento:
run/saves/<world>/dragonminez/
| Caminho | Finalidade |
|---|---|
dragonminez/sagas/ |
Manifestos das sagas (o ponteiro questFolder e os metadados da saga).
|
dragonminez/quests/<questFolder>/ |
Arquivos de missões de uma saga, carregados em ordem alfabética (01_...json, 02_...json, ...).
|
dragonminez/sidequests/ |
Missões secundárias independentes, carregadas quando as missões secundárias estão ativadas. |
dragonminez/wishes/*.json |
Lista de desejos de cada dragão (shenron.json, porunga.json, ...; veja Desejos personalizados).
|
dragonminez/dialogues/*.json |
Árvores de diálogo de NPCs (veja Diálogos de NPCs). Na primeira vez, um _example.json é criado; arquivos cujo id de NPC começa com _ não são carregados.
|
dragonminez/npcs/placements.json |
Posições de spawn dos NPCs mestres e treinadores (veja Posicionamento e índole de NPCs). |
dragonminez/npcs/alignment_rules.json |
Limites de índole e hostilidade de cada NPC (veja Posicionamento e índole de NPCs). |
dragonminez/playerdata_json/<uuid>.json |
Dados salvos dos jogadores, usados apenas quando storageType é JSON.
|
dragonminez/oldBackup/ |
Cópias dos arquivos padrão de missões, sagas e missões secundárias feitas antes de o DragonMineZ atualizá-los, com a mesma estrutura relativa. |
dragonminez/quest_update_report.txt |
Resumo da última atualização das missões padrão: valores atualizados e conflitos em que suas edições foram mantidas. |
Código-fonte: QuestRegistry.loadAll(server), WishManager.loadWishes(server), DialogueRegistry.loadAll(server).
Arquivos de história padrão
gameplayO DragonMineZ cria seus arquivos padrão de sagas, missões e missões secundárias apenas quando eles não existem e as opções de geração padrão estão ativadas no general-server.json (storyModeEnabled e createDefaultSagas para sagas e missões de saga, createDefaultSideQuests para missões secundárias). Com autoUpdateQuests ativado (o padrão), os arquivos gerados pelo DragonMineZ são atualizados no lugar quando uma nova versão do DragonMineZ os altera: suas edições são mantidas e antes uma cópia vai para dragonminez/oldBackup/. Arquivos criados por você nunca são alterados. Veja Recarregar e atualizar mudanças.
Arquivos de dados do mundo
Parte do estado do DragonMineZ é guardada como "saved data" do vanilla: arquivos .dat na pasta data/ do mundo, ou na pasta data/ própria de uma dimensão. Esses arquivos são binários e não foram feitos para serem editados à mão: dragon_balls_data (posições das Esferas do Dragão), dragonminez_mutants, dragonminez_parties, dragonminez_pothala_pairs, dragonminez_raids, dragonminez_raid_sites, dragonminez_structure_plan, dragonminez_worldbosses, dragonminez_npc_placements, dragonminez_tournaments e dragonminez_otherworld_tournament.
Pasta de pacotes de Esferas do Dragão
<game dir>/dragonballs/ fica ao lado dos seus mundos e da instância (não dentro do save do mundo). Ela guarda definições externas e distribuíveis de Esferas do Dragão: conjuntos de esferas, radares, dragões e seus desejos. Cada pacote de addon pode ser uma pasta comum ou um arquivo .zip. O DragonMineZ também procura uma pasta dragonballs no diretório de trabalho atual e na pasta acima do diretório do jogo. Os pacotes são carregados pelo DragonBallPackManager; veja Desejos personalizados.
Cache de partituras do Ritmo
<game dir>/dragonminez/rhythm_charts/ é criada no cliente pelo minigame de treinamento Ritmo para as partituras que ele gera a partir das músicas. É um cache, não configuração.
Datapacks
Alguns sistemas são reload listeners comuns do Forge ou do vanilla. Eles seguem as regras normais dos datapacks (data/<namespace>/...) em vez de ficar em config/ ou no save do mundo:
spacepod/*.json: a lista de destinos da Cápsula Espacial (veja Destinos da Cápsula Espacial).weapon_attributes/*.json: definições de atributos de armas (veja Atributos de armas).structure_npcs/*.json: NPCs colocados dentro de estruturas do DragonMineZ (veja Posicionamento e índole de NPCs).rhythm_charts/*.json: partituras do minigame de treinamento Ritmo.
Eles são recarregados pelo /reload do vanilla, não pelo /dmzreload. As definições de Esferas do Dragão e de desejos não são lidas de datapacks: use um pacote de addon em <game dir>/dragonballs/ ou a pasta dragonminez/wishes/ do mundo. Veja Recarregar e atualizar mudanças para o detalhamento completo.
Recursos de pacotes de recursos
Os modelos, texturas e animações referenciados pela configuração (os campos customModel) ficam no namespace normal do pacote de recursos, por exemplo:
assets/dragonminez/geo/entity/races/assets/dragonminez/lang/en_us.json(o arquivo de idioma-fonte)
Eles exigem uma recarga de recursos (F3 + T no cliente) ou um reinício. Veja Recarregar e atualizar mudanças e Modelos e recursos próprios.
Guia rápido de decisão
- Ajustar estatísticas, dano ou custos, ou adicionar uma raça, forma, entidade ou incursão:
config/dragonminez/ - Adicionar ou editar conteúdo de história, desejos, diálogos ou o posicionamento de NPCs deste mundo:
<world save>/dragonminez/ - Distribuir um pacote de Esferas do Dragão:
<game dir>/dragonballs/ - Destinos da Cápsula Espacial, atributos de armas, partituras de ritmo: um datapack
- Adicionar um modelo, textura ou animação:
assets/dragonminez/...em um pacote de recursos