Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T08:13:48Z

Translation sync from dragonminez-wiki repository

New page

'''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 ==
<code>config/dragonminez/</code> 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 [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]]).

{| class="wikitable"
! Caminho !! Finalidade
|-
| <code>config/dragonminez/general-server.json</code> || Opções de jogabilidade do servidor inteiro (veja [[Special:MyLanguage/General Server Config|Configuração do servidor]]).
|-
| <code>config/dragonminez/general-user.json</code> || '''Apenas cliente.''' Configurações pessoais do cliente, nunca enviadas pelo servidor (veja [[Special:MyLanguage/General User Config|Configuração do cliente]]).
|-
| <code>config/dragonminez/hud_layout.json</code> || '''Apenas cliente.''' Estilo da HUD e layout dos elementos (veja [[Special:MyLanguage/HUD|HUD]]).
|-
| <code>config/dragonminez/radial_layout.json</code> || Ordem das entradas dos menus radiais no cliente, salva quando você as reorganiza.
|-
| <code>config/dragonminez/combat.json</code> || Valores de ajuste do combate (veja [[Special:MyLanguage/Combat Config|Configuração de combate]]).
|-
| <code>config/dragonminez/skills.json</code> || Custos, recargas e requisitos das habilidades, e as habilidades que cada raça e mestre oferece; as duas coisas ficam neste único arquivo (veja [[Special:MyLanguage/Skills Config|Configuração de habilidades]]).
|-
| <code>config/dragonminez/training.json</code> || Ajuste dos minigames de treinamento de TP (veja [[Special:MyLanguage/Training Points and Mastery|pontos de treino e domínio]]).
|-
| <code>config/dragonminez/techniques.json</code> || Ajuste dos ataques de ki e dos ataques de golpe (veja [[Special:MyLanguage/Skills Config|Configuração de habilidades]]).
|-
| <code>config/dragonminez/entities.json</code> || Estatísticas base de cada entidade e valores padrão das transformações de saga (veja [[Special:MyLanguage/Entities Config|Configuração de entidades]]).
|-
| <code>config/dragonminez/races/<race>/character.json</code> || Identidade da raça e valores padrão da aparência (veja [[Special:MyLanguage/Custom Races|Raças personalizadas]]).
|-
| <code>config/dragonminez/races/<race>/stats.json</code> || Estatísticas base da raça e escalonamento para cada classe.
|-
| <code>config/dragonminez/races/<race>/forms/*.json</code> || Formas que pertencem apenas a essa raça.
|-
| <code>config/dragonminez/forms/*.json</code> || Formas acumuláveis compartilhadas, que se somam às formas próprias de uma raça (veja [[Special:MyLanguage/Custom Forms|Formas personalizadas]]).
|-
| <code>config/dragonminez/raids/*.json</code> || Definições de incursões (veja [[Special:MyLanguage/Raids|Incursões]]).
|-
| <code>config/dragonminez/tournaments/*.json</code> || Definições de torneios (veja [[Special:MyLanguage/Tournaments|Torneios]]).
|-
| <code>config/dragonminez/oldBackup/</code> || Cópias dos arquivos de configuração que o DragonMineZ atualizou ou regenerou, com a mesma estrutura relativa (por exemplo, <code>oldBackup/races/saiyan/stats.json</code>). O DragonMineZ nunca volta a lê-las.
|}

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

Código-fonte: <code>ConfigManager.java</code> (<code>loadGeneralConfigs</code>, <code>loadAllRaces</code>, <code>createOrLoadStackForms</code>, <code>loadRaids</code>, <code>loadTournaments</code>).


== Pasta do save do mundo ==
<code><world save>/dragonminez/</code> 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: <code>saves/<world>/dragonminez/</code>
* Servidor: <code><server>/<level-name>/dragonminez/</code>
* Ambiente de desenvolvimento: <code>run/saves/<world>/dragonminez/</code>

{| class="wikitable"
! Caminho !! Finalidade
|-
| <code>dragonminez/sagas/</code> || Manifestos das sagas (o ponteiro <code>questFolder</code> e os metadados da saga).
|-
| <code>dragonminez/quests/<questFolder>/</code> || Arquivos de missões de uma saga, carregados em ordem alfabética (<code>01_...json</code>, <code>02_...json</code>, ...).
|-
| <code>dragonminez/sidequests/</code> || Missões secundárias independentes, carregadas quando as missões secundárias estão ativadas.
|-
| <code>dragonminez/wishes/*.json</code> || Lista de desejos de cada dragão (<code>shenron.json</code>, <code>porunga.json</code>, ...; veja [[Special:MyLanguage/Custom Wishes|Desejos personalizados]]).
|-
| <code>dragonminez/dialogues/*.json</code> || Árvores de diálogo de NPCs (veja [[Special:MyLanguage/NPC Dialogue|Diálogos de NPCs]]). Na primeira vez, um <code>_example.json</code> é criado; arquivos cujo id de NPC começa com <code>_</code> não são carregados.
|-
| <code>dragonminez/npcs/placements.json</code> || Posições de spawn dos NPCs mestres e treinadores (veja [[Special:MyLanguage/NPC Placement and Alignment|Posicionamento e índole de NPCs]]).
|-
| <code>dragonminez/npcs/alignment_rules.json</code> || Limites de índole e hostilidade de cada NPC (veja [[Special:MyLanguage/NPC Placement and Alignment|Posicionamento e índole de NPCs]]).
|-
| <code>dragonminez/playerdata_json/<uuid>.json</code> || Dados salvos dos jogadores, usados apenas quando <code>storageType</code> é <code>JSON</code>.
|-
| <code>dragonminez/oldBackup/</code> || 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.
|-
| <code>dragonminez/quest_update_report.txt</code> || Resumo da última atualização das missões padrão: valores atualizados e conflitos em que suas edições foram mantidas.
|}

Código-fonte: <code>QuestRegistry.loadAll(server)</code>, <code>WishManager.loadWishes(server)</code>, <code>DialogueRegistry.loadAll(server)</code>.


=== Arquivos de história padrão ===
{{Config|General Server Config|gameplay}}
O 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 <code>general-server.json</code> (<code>storyModeEnabled</code> e <code>createDefaultSagas</code> para sagas e missões de saga, <code>createDefaultSideQuests</code> para missões secundárias). Com <code>autoUpdateQuests</code> 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 <code>dragonminez/oldBackup/</code>. Arquivos criados por você nunca são alterados. Veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]].


=== Arquivos de dados do mundo ===
Parte do estado do DragonMineZ é guardada como "saved data" do vanilla: arquivos <code>.dat</code> na pasta <code>data/</code> do mundo, ou na pasta <code>data/</code> própria de uma dimensão. Esses arquivos são binários e não foram feitos para serem editados à mão: <code>dragon_balls_data</code> (posições das Esferas do Dragão), <code>dragonminez_mutants</code>, <code>dragonminez_parties</code>, <code>dragonminez_pothala_pairs</code>, <code>dragonminez_raids</code>, <code>dragonminez_raid_sites</code>, <code>dragonminez_structure_plan</code>, <code>dragonminez_worldbosses</code>, <code>dragonminez_npc_placements</code>, <code>dragonminez_tournaments</code> e <code>dragonminez_otherworld_tournament</code>.


== Pasta de pacotes de Esferas do Dragão ==
<code><game dir>/dragonballs/</code> 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 <code>.zip</code>. O DragonMineZ também procura uma pasta <code>dragonballs</code> no diretório de trabalho atual e na pasta acima do diretório do jogo. Os pacotes são carregados pelo <code>DragonBallPackManager</code>; veja [[Special:MyLanguage/Custom Wishes|Desejos personalizados]].


== Cache de partituras do Ritmo ==
<code><game dir>/dragonminez/rhythm_charts/</code> é 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 (<code>data/<namespace>/...</code>) em vez de ficar em <code>config/</code> ou no save do mundo:
* <code>spacepod/*.json</code>: a lista de destinos da [[Special:MyLanguage/Space Pod|Cápsula Espacial]] (veja [[Special:MyLanguage/Space Pod Destinations|Destinos da Cápsula Espacial]]).
* <code>weapon_attributes/*.json</code>: definições de atributos de armas (veja [[Special:MyLanguage/Weapon Attributes|Atributos de armas]]).
* <code>structure_npcs/*.json</code>: NPCs colocados dentro de estruturas do DragonMineZ (veja [[Special:MyLanguage/NPC Placement and Alignment#Structure NPCs|Posicionamento e índole de NPCs]]).
* <code>rhythm_charts/*.json</code>: partituras do minigame de treinamento Ritmo.
Eles são recarregados pelo <code>/reload</code> do vanilla, não pelo <code>/dmzreload</code>. As definições de Esferas do Dragão e de desejos '''não''' são lidas de datapacks: use um pacote de addon em <code><game dir>/dragonballs/</code> ou a pasta <code>dragonminez/wishes/</code> do mundo. Veja [[Special:MyLanguage/Reloading and Updating Changes|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 <code>customModel</code>) ficam no namespace normal do pacote de recursos, por exemplo:
* <code>assets/dragonminez/geo/entity/races/</code>
* <code>assets/dragonminez/lang/en_us.json</code> (o arquivo de idioma-fonte)
Eles exigem uma recarga de recursos ({{Key|F3}} + {{Key|T}} no cliente) ou um reinício. Veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]] e [[Special:MyLanguage/Custom Models and Assets|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: <code>config/dragonminez/</code>
* Adicionar ou editar conteúdo de história, desejos, diálogos ou o posicionamento de NPCs '''deste mundo''': <code><world save>/dragonminez/</code>
* Distribuir um pacote de Esferas do Dragão: <code><game dir>/dragonballs/</code>
* Destinos da Cápsula Espacial, atributos de armas, partituras de ritmo: um datapack
* Adicionar um modelo, textura ou animação: <code>assets/dragonminez/...</code> em um pacote de recursos

{{Navbox Modding}}

Locating Specific Folders/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository