View source for Custom Quests/pt

As '''missões personalizadas''' são sagas, missões de saga e missões secundárias que você mesmo escreve apenas com JSON, sem código Java nem um jar de addon. O conteúdo da história são dados de cada mundo (diferente das raças e formas, que ficam em <code>config/dragonminez</code>), então esses arquivos ficam dentro do save do mundo.

<span id="Where_files_go"></span>
== Onde ficam os arquivos ==

<syntaxhighlight lang="text">
<world save>/dragonminez/
  sagas/                     # saga manifests
  quests/<questFolder>/      # quest files for one saga, loaded alphabetically
  sidequests/                # standalone side quests (any subfolder layout, e.g. sidequests/<category>/)
</syntaxhighlight>

Código-fonte: <code>QuestRegistry.loadAll(server)</code> (<code>src/main/java/com/dragonminez/common/quest/QuestRegistry.java</code>). Veja [[Special:MyLanguage/Locating Specific Folders|Encontrar pastas]] para o mapa completo de pastas.

<span id="Story_toggles"></span>
=== Opções da história ===
{{Config|General Server Config|gameplay}}
Estas opções ficam em <code>general-server.json</code> → <code>gameplay</code>, e todas são <code>true</code> por padrão:

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>storyModeEnabled</code> || Booleano || Chave geral do sistema de sagas e missões.
|-
| <code>createDefaultSagas</code> || Booleano || Gera os arquivos padrão de sagas e missões de saga do DragonMineZ (também precisa de <code>storyModeEnabled</code>).
|-
| <code>sideQuestsEnabled</code> || Booleano || Chave geral do sistema de missões secundárias.
|-
| <code>createDefaultSideQuests</code> || Booleano || Gera os arquivos padrão de missões secundárias do DragonMineZ.
|-
| <code>autoUpdateQuests</code> || Booleano || Atualiza no lugar os arquivos padrão do DragonMineZ quando uma nova versão do DragonMineZ os altera (veja [[Special:MyLanguage/Custom Quests#Default file upgrades|Atualização dos arquivos padrão]]).
|}

Os arquivos padrão são gerados um a um, pelo nome do arquivo, sempre que estão faltando, então um arquivo padrão que você apagar volta na próxima carga enquanto a opção <code>createDefault...</code> correspondente estiver ativada. Seus próprios arquivos (qualquer outro nome de arquivo) nunca são alterados.

<span id="Step_1:_Create_a_saga_manifest"></span>
== Passo 1: crie um manifesto de saga ==
Crie um arquivo por saga em <code>dragonminez/sagas/</code>, por exemplo <code>my_saga.json</code>:

<syntaxhighlight lang="json">
{
  "id": "my_saga",
  "name": "dmz.saga.my_saga",
  "requirements": {
    "previousSaga": "saiyan_saga"
  },
  "questFolder": "saga_my_saga"
}
</syntaxhighlight>

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>id</code> || Texto || Id único da saga.
|-
| <code>name</code> || Texto || Chave de tradução do nome exibido da saga.
|-
| <code>requirements.previousSaga</code> || Texto || Id da saga que precisa ser concluída antes, ou <code>""</code> se não houver nenhuma.
|-
| <code>questFolder</code> || Texto || Nome da subpasta dentro de <code>dragonminez/quests/</code> que guarda os arquivos de missões desta saga.
|}

Os ids de saga padrão são <code>classic_saga</code>, <code>saiyan_saga</code>, <code>frieza_saga</code>, <code>android_saga</code>, <code>future_saga</code>, <code>buu_saga</code>, <code>movies_saga</code>, <code>gt_saga</code> e <code>daima_saga</code> (veja [[Special:MyLanguage/Sagas|Sagas]]).

Código-fonte: <code>SagaDefaults.java</code>, <code>Saga.java</code>.

<span id="Step_2:_Add_quest_files"></span>
== Passo 2: adicione arquivos de missões ==
Dentro de <code>dragonminez/quests/saga_my_saga/</code>, adicione um arquivo por missão, com nomes que ordenem os arquivos na ordem de jogo (<code>01_...json</code>, <code>02_...json</code>, ...). A ordem dos nomes de arquivo '''é''' a ordem das missões dentro da saga.

<syntaxhighlight lang="json">
{
  "id": 1,
  "title": "dmz.quest.my_saga1.name",
  "description": "dmz.quest.my_saga1.desc",
  "type": "SAGA",
  "category": "saga_my_saga",
  "parallel_objectives": false,
  "party_scaling": true,
  "secret": false,
  "claim_mode": "TREE_OR_NPC",
  "requirements": {
    "operator": "AND",
    "conditions": [
      { "type": "LEVEL", "minLevel": 1 },
      { "type": "DIMENSION", "dimension": "minecraft:overworld" }
    ]
  },
  "objectives": [
    { "type": "KILL", "entity": "dragonminez:saga_raditz", "count": 1, "health": 450.0, "meleeDamage": 22.0, "kiDamage": 39.0 }
  ],
  "rewards": [
    { "type": "ATTRIBUTES", "amount": 10 },
    { "type": "ITEM", "item": "dragonminez:senzu_bean", "count": 1 }
  ]
}
</syntaxhighlight>

Uma missão de saga é identificada como <code><sagaId>:<id></code> (por exemplo, <code>my_saga:1</code>), usando o <code>id</code> numérico, não o nome do arquivo. Dois arquivos com o mesmo <code>id</code> em uma pasta sobrescrevem um ao outro.

Para '''inserir''' uma missão entre duas existentes, dê a ela um <code>id</code> novo e não usado e um nome de arquivo que fique entre elas na ordenação. As sagas do próprio DragonMineZ fazem isso: a missão 17 da Saga Freeza é <code>01b_scout_the_ruined_village.json</code>, entre <code>01_...</code> e <code>02_...</code>. Renumerar as missões existentes quebraria o progresso salvo e todas as condições <code>SAGA_QUEST</code> ou requisitos de forma que apontam para elas.

<span id="Quest_fields"></span>
== Campos de uma missão ==
As missões de saga e as missões secundárias compartilham exatamente o mesmo esquema, então estes campos valem para as duas.

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>id</code> || Número ou texto || '''Numérico''' para missões de saga. As missões secundárias usam um id de '''texto'''.
|-
| <code>title</code> / <code>description</code> || Texto || Chaves de tradução (texto simples também funciona).
|-
| <code>type</code> || Texto || <code>SAGA</code>, <code>SIDEQUEST</code>, <code>DAILY</code> ou <code>EVENT</code>. Uma missão <code>DAILY</code> pode ser repetida uma vez por dia real (fuso horário do servidor).
|-
| <code>category</code> || Texto || Rótulo de agrupamento livre. Padrão: <code>"general"</code>.
|-
| <code>parallel_objectives</code> || Booleano || Se for <code>true</code>, todos os objetivos avançam ao mesmo tempo, em vez de um depois do outro.
|-
| <code>party_scaling</code> || Booleano || Se for <code>true</code>, as quantidades de itens e de abates aumentam para cada membro extra do grupo (<code>defaultQuestPartyMultiplier</code> no <code>general-server.json</code>, padrão <code>1.45</code>), e os inimigos da missão ganham mais vida e dano para cada membro extra (<code>enemyHealthPerPartyPlayer</code> <code>1.25</code>, <code>enemyDamagePerPartyPlayer</code> <code>1.1</code>).
|-
| <code>secret</code> || Booleano || Esconde a missão do registro de missões até que ela seja iniciada ou fique disponível.
|-
| <code>claim_mode</code> || Texto || <code>TREE_OR_NPC</code> (resgatada pela tela de missões ou por um NPC) ou <code>NPC_ONLY</code> (o jogador precisa falar com o NPC de entrega).
|-
| <code>quest_giver</code> || Texto ou <code>null</code> || Id do NPC que oferece a missão (veja [[Special:MyLanguage/Custom Quests#Quest giver and turn-in NPCs|NPCs que dão e recebem missões]]).
|-
| <code>turn_in</code> || Texto ou <code>null</code> || Id do NPC que recebe a missão concluída.
|-
| <code>prerequisites</code> || Objeto || Decide se a missão pode ser '''desbloqueada'''. Mesmo esquema de <code>requirements</code> (veja [[Special:MyLanguage/Custom Quests#Prerequisites and requirements|Pré-requisitos e requisitos]]).
|-
| <code>requirements</code> || Objeto || Decide se a missão pode ser '''iniciada''' neste momento (por exemplo, a dimensão, o bioma ou o nível atuais).
|-
| <code>repeatable</code> || Booleano || Se for <code>true</code>, a missão pode ser iniciada de novo depois de concluída. Padrão: <code>false</code>.
|-
| <code>repeat_cooldown_seconds</code> || Inteiro || Segundos reais até que uma missão repetível possa ser iniciada de novo. <code>0</code> (o padrão) significa imediatamente.
|-
| <code>time_limit_seconds</code> || Inteiro || Tempo limite depois de aceitar a missão, em segundos do jogo. Quando ele acaba, a missão falha. <code>0</code> (o padrão) significa sem limite.
|-
| <code>objectives</code> || Array || Veja [[Special:MyLanguage/Custom Quests#Objective types|Tipos de objetivos]].
|-
| <code>rewards</code> || Array || Veja [[Special:MyLanguage/Custom Quests#Reward types|Tipos de recompensas]].
|-
| <code>defaultsVersion</code> || Texto || Usado apenas nos arquivos padrão do próprio DragonMineZ (veja [[Special:MyLanguage/Custom Quests#Default file upgrades|Atualização dos arquivos padrão]]).
|}

Quando uma missão repetível ou diária é iniciada de novo, o progresso dos objetivos e os resgates de recompensas são zerados, então as recompensas podem ser resgatadas outra vez.

Código-fonte: <code>QuestParser.parseQuest</code>, <code>Quest.java</code>.

<span id="Objective_types"></span>
== Tipos de objetivos ==
Cada entrada em <code>objectives</code> precisa de um <code>type</code> mais os campos desse tipo. Os campos marcados com <code>*</code> são opcionais e têm valores padrão razoáveis.

{| class="wikitable"
! <code>type</code> !! Campos !! O que faz
|-
| <code>ITEM</code> || <code>item</code>, <code>count</code> || Ter esta quantidade de um item no inventário. Os itens não são retirados; para isso, use <code>DELIVER</code>.
|-
| <code>KILL</code> || <code>entity</code>, <code>count</code>, <code>health</code>*, <code>meleeDamage</code>*, <code>kiDamage</code>*, <code>spawn</code>*, <code>count_mode</code>*, <code>AITier</code>*, <code>TextureVariant</code>*, <code>canTransform</code>*, <code>TransformHealth</code>*, <code>TransformMeleeDamage</code>*, <code>TransformKiDamage</code>*, <code>TransformHealthMultiplier</code>*, <code>TransformMeleeDamageMultiplier</code>*, <code>TransformKiMultiplier</code>*, <code>TransformTriggerPercent</code>* || <code>entity</code> pode ser um id de registro ou uma tag de entidade (<code>#minecraft:zombies</code>; os spawns da missão escolhem um membro aleatório). <code>health</code>, <code>meleeDamage</code> e <code>kiDamage</code> têm padrão <code>20</code>, <code>1</code> e <code>1</code>. <code>spawn</code>: <code>QUEST</code> (padrão, gerados quando a missão começa) ou <code>NATURAL</code>. <code>count_mode</code>: <code>QUEST_SPAWNED_ONLY</code> (padrão) ou <code>ANY_MATCHING</code>. Veja [[Special:MyLanguage/Custom Quests#Kill objective: AI tier and transformations|Objetivo de abate: nível de IA e transformações]].
|-
| <code>SPAR</code> || Igual a <code>KILL</code>, sem os campos <code>Transform*</code> || Uma luta não letal: quando um parceiro gerado pela missão ficaria abaixo de 15% de vida, a luta termina, conta como vitória para o grupo inteiro e o parceiro vai embora.
|-
| <code>INTERACT</code> || <code>entity</code>*, <code>entityName</code>* || Interagir com clique direito com uma entidade correspondente.
|-
| <code>TALK_TO</code> || <code>npcId</code> || O jogador precisa falar com um NPC ou mestre específico.
|-
| <code>DELIVER</code> || <code>item</code>, <code>count</code>* (padrão <code>1</code>), <code>npcId</code> (aliases <code>npc_id</code> e <code>npc</code>) || Clique com o botão direito no NPC para entregar os itens. Eles são retirados do inventário, e entregas parciais contam.
|-
| <code>STRUCTURE</code> || <code>structure</code> || O jogador precisa entrar em uma estrutura gerada.
|-
| <code>BIOME</code> || <code>biome</code> || O jogador precisa estar neste bioma (ou tag de bioma).
|-
| <code>DIMENSION</code> || <code>dimension</code> || O jogador precisa estar nesta dimensão.
|-
| <code>COORDS</code> || <code>x</code>, <code>y</code>, <code>z</code>, <code>radius</code>* || O jogador precisa estar a até <code>radius</code> blocos (padrão <code>10</code>) de um ponto.
|-
| <code>CHECKPOINT_RACE</code> || <code>checkpoints</code> (lista de <code>{ "x", "y", "z" }</code>), <code>radius</code>* (padrão <code>8</code>) || Chegar a cada checkpoint em ordem.
|-
| <code>SURVIVE_WAVES</code> || <code>entity</code>, <code>waves</code>* (padrão <code>3</code>), <code>mobs_per_wave</code>* (padrão <code>3</code>), <code>wave_delay_seconds</code>* (padrão <code>10</code>), <code>health</code>*, <code>meleeDamage</code>*, <code>kiDamage</code>*, <code>AITier</code>*, <code>TextureVariant</code>*, <code>CanTransform</code>* || Ondas de inimigos aparecem ao redor do jogador; a próxima chega após uma breve pausa quando uma onda é eliminada. Cada onda eliminada conta como uma etapa de progresso.
|-
| <code>ESCORT</code> || <code>entity</code>, <code>x</code>, <code>y</code>, <code>z</code>, <code>radius</code>* (padrão <code>6</code>), <code>health</code>* || Um escoltado aparece ao lado do jogador e o segue; leve-o até <code>radius</code> do alvo. Se ele morrer, a missão falha. <code>health</code> substitui a vida máxima dele.
|-
| <code>DRAGON_SUMMON</code> || <code>dragon</code>*, <code>ball_set</code>* || O jogador precisa invocar um dragão e/ou um conjunto de esferas específico (aliases: <code>dragon_id</code> e <code>dragonId</code>; <code>ballSet</code>, <code>ball_set_id</code>, <code>ballSetId</code> e <code>set</code>).
|-
| <code>SKILL</code> || <code>skill</code>, <code>level</code>* || O jogador precisa atingir um nível de habilidade (aliases: <code>skillId</code> e <code>id</code>; <code>minLevel</code> e <code>required</code>; nível padrão <code>1</code>).
|}

Código-fonte: <code>QuestParser.parseObjective</code> e as classes em <code>common/quest/objectives/</code>.

Enquanto um objetivo <code>COORDS</code>, <code>ESCORT</code> ou <code>CHECKPOINT_RACE</code> está sendo acompanhado, a HUD de missões mostra a distância e a direção até o alvo (ou até o próximo checkpoint).

Em uma missão com <code>parallel_objectives: false</code>, objetivos de abate que vêm um logo após o outro são liberados juntos, então um par "abater A, abater B" pode ser enfrentado em qualquer ordem. Os objetivos dos outros tipos continuam indo um de cada vez.

<span id="Kill_objective:_AI_tier_and_transformations"></span>
=== Objetivo de abate: nível de IA e transformações ===
* <code>AITier</code> é opcional: <code>1</code> Novato, <code>2</code> Inteligente, <code>3</code> Elite, <code>4</code> Especialista. Se for omitido (ou definido como <code>0</code> ou um valor negativo), o nível vem da dificuldade em que a missão foi iniciada: <code>EASY</code> dá 1, <code>NORMAL</code> dá 2, <code>HARD</code> dá 3, e <code>HARD</code> contra o chefe final de uma saga dá 4. Defina <code>AITier</code> explicitamente para forçar um nível específico independentemente da dificuldade.
* <code>TextureVariant</code> escolhe uma das texturas das entidades que têm várias.
* <code>canTransform</code> (booleano, padrão <code>true</code>) controla se o inimigo pode se transformar no meio da luta. Defina como <code>false</code> para impedir totalmente que o inimigo se transforme; isso é aplicado no servidor, não é só visual. <code>SURVIVE_WAVES</code> o lê como <code>CanTransform</code>.
* Quando <code>canTransform</code> é <code>true</code>, os sete campos <code>Transform*</code> ajustam as estatísticas do inimigo '''transformado''' sem mexer nos padrões da configuração global. Todos são opcionais (<code>null</code> usa os padrões globais de transformação do <code>entities.json</code>):
** <code>TransformHealth</code>, <code>TransformMeleeDamage</code>, <code>TransformKiDamage</code>: valores absolutos das estatísticas da forma transformada.
** <code>TransformHealthMultiplier</code>, <code>TransformMeleeDamageMultiplier</code>, <code>TransformKiMultiplier</code>: multiplicadores aplicados às estatísticas base (antes de se transformar) em vez de valores absolutos.
** Valores absolutos têm prioridade sobre multiplicadores quando os dois são definidos para a mesma estatística.
** <code>TransformTriggerPercent</code>: fração da vida máxima (<code>0.0</code>–<code>1.0</code>) em que o inimigo ativa sua transformação.

<syntaxhighlight lang="json">
{ "type": "KILL", "entity": "dragonminez:saga_vegeta", "count": 1, "health": 900.0, "meleeDamage": 40.0, "kiDamage": 60.0,
  "canTransform": true, "TransformTriggerPercent": 0.5, "TransformHealthMultiplier": 1.8, "TransformMeleeDamageMultiplier": 1.6 }
</syntaxhighlight>

<span id="How_a_quest_can_fail"></span>
=== Como uma missão pode falhar ===
Uma missão que falhou perde o progresso dos objetivos, e os inimigos e escoltados gerados por ela são removidos. Ela pode ser iniciada de novo pelo registro de missões ou pelo NPC dela (os requisitos de início são verificados outra vez).
* '''Grupo derrotado:''' quando o jogador (ou todos os membros do grupo dele) morre, as missões aceitas com um objetivo <code>KILL</code>, <code>SPAR</code>, <code>SURVIVE_WAVES</code> ou <code>ESCORT</code> falham.
* '''Escoltado morreu:''' o alvo do <code>ESCORT</code> foi morto.
* '''O tempo acabou:''' passou <code>time_limit_seconds</code> desde que a missão foi aceita.

<span id="Reward_types"></span>
== Tipos de recompensas ==
Cada entrada em <code>rewards</code> precisa de um <code>type</code> mais os campos dele. Todo tipo de recompensa também aceita um campo opcional <code>difficulty</code> que restringe as dificuldades em que ela é concedida (veja abaixo).

{| class="wikitable"
! <code>type</code> !! Campos !! O que faz
|-
| <code>ITEM</code> || <code>item</code>, <code>count</code>* (padrão <code>1</code>) || Concede uma pilha de itens.
|-
| <code>GENERIC_ITEM</code> || <code>itemReward</code> (um objeto de item) || Concede um item com encantamentos, dados de poção ou um acabamento de armadura. Veja [[Special:MyLanguage/Custom Quests#Item objects|Objetos de item]].
|-
| <code>ATTRIBUTES</code> || <code>amount</code> || Concede Atributos, a recompensa que todas as missões padrão usam: <code>amount × attributeRewardPointRatio</code> (por padrão a metade, arredondada para baixo) como Pontos de Atributo, e o resto como o TP que esses pontos de estatística custariam ao jogador no momento do resgate. Esse TP não recebe bônus de novo nem é compartilhado com o grupo. A dica de ferramenta mostra a divisão. Veja [[Special:MyLanguage/Stats and Attributes|Estatísticas e atributos]].
|-
| <code>ATTRIBUTE_POINTS</code> || <code>amount</code> || Concede apenas Pontos de Atributo (que o jogador distribui no menu de estatísticas).
|-
| <code>TPS</code> || <code>amount</code> || Concede uma quantidade fixa de pontos de treino (passa pelos bônus de TP <code>STORY</code> do servidor).
|-
| <code>ALIGNMENT</code> || <code>amount</code> || Ajusta a índole do jogador (pode ser negativo). Veja [[Special:MyLanguage/Alignment|Índole]].
|-
| <code>SKILL</code> || <code>skill</code>, <code>level</code> || Eleva uma habilidade até pelo menos este nível.
|-
| <code>TRANSFORMATION</code> || <code>formGroup</code>, <code>formName</code>, <code>mastery</code>* (padrão <code>100.0</code>), <code>stack</code>* (padrão <code>false</code>) || Desbloqueia uma forma da raça do jogador (ou uma forma acumulável se <code>stack</code> for <code>true</code>): evolui a habilidade de forma do grupo até essa forma e concede pelo menos esse domínio. As formas listadas no <code>formRequisite</code> da forma também sobem até o domínio que exigem. Aliases: <code>form_group</code> e <code>group</code>; <code>form_name</code> e <code>form</code>.
|-
| <code>KI_TECHNIQUE</code> || <code>code</code> || Concede uma técnica de ki a partir de um código de técnica exportado (aliases: <code>techniqueCode</code> e <code>technique_code</code>). Veja [[Special:MyLanguage/Techniques|Técnicas]].
|-
| <code>COMMAND</code> || <code>command</code>, <code>translationKey</code>* || Executa um comando no servidor (nível de operador), com <code>%player%</code> substituído pelo nome do jogador. <code>translationKey</code> é o texto mostrado na lista de recompensas no lugar do comando.
|}

As recompensas <code>TRANSFORMATION</code> e <code>SKILL</code> agem sobre os grupos de raça e as habilidades do próprio jogador. Para dar recompensas específicas de raça ou classe, coloque-as em missões bloqueadas por uma condição <code>RACE</code> ou <code>CLASS</code> (veja [[Special:MyLanguage/Custom Quests#Prerequisites and requirements|Pré-requisitos e requisitos]]).

Código-fonte: <code>QuestParser.parseReward</code>, as classes em <code>common/quest/rewards/</code>, <code>Difficulty.java</code>.

<span id="Restricting_a_reward_by_difficulty"></span>
=== Restringir uma recompensa por dificuldade ===
O campo opcional <code>difficulty</code> de uma recompensa é um '''conjunto permitido''' das dificuldades em que essa recompensa é concedida (aliases: <code>difficulties</code>, <code>difficultyType</code> e <code>minDifficulty</code>). Ele aceita um array JSON (<code>["NORMAL","HARD"]</code>), um texto separado por vírgulas ou espaços (<code>"NORMAL, HARD"</code>) ou um único valor (<code>"HARD"</code>). Os valores válidos são <code>EASY</code>, <code>NORMAL</code> e <code>HARD</code>. Quando omitido ou vazio, a recompensa é concedida em todas as dificuldades.
É uma verificação de pertencimento ao conjunto, '''não''' um limite mínimo: <code>"EASY"</code> sozinho significa apenas Fácil, e <code>["EASY","HARD"]</code> (pulando Normal) é válido. Valores desconhecidos são descartados.

<syntaxhighlight lang="json">
{ "type": "ITEM", "item": "dragonminez:senzu_bean", "count": 1, "difficulty": ["NORMAL", "HARD"] }
</syntaxhighlight>

{{Note|title=Arquivos antigos|text=Arquivos de missões antigos escreviam a dificuldade como prefixo do tipo (<code>"hard:ITEM"</code>, <code>"normal:ITEM"</code>). Esses arquivos ainda carregam: <code>hard:</code> significa apenas Difícil e <code>normal:</code> significa Fácil e Normal, a menos que a recompensa também tenha um campo <code>difficulty</code>. Arquivos novos devem usar o campo <code>difficulty</code>.}}

<span id="Reward_scaling"></span>
=== Escalonamento de recompensas ===
As quantidades de <code>ITEM</code>, <code>GENERIC_ITEM</code>, <code>TPS</code>, <code>ATTRIBUTES</code>, <code>ATTRIBUTE_POINTS</code> e <code>ALIGNMENT</code> são escalonadas pelo multiplicador de recompensas de missões da dificuldade em que a missão foi iniciada (<code>easyModeQuestRewardMultiplier</code> e <code>hardModeQuestRewardMultiplier</code> no <code>general-server.json</code>). As recompensas <code>TPS</code>, <code>ATTRIBUTES</code> e <code>ATTRIBUTE_POINTS</code> também são multiplicadas por <code>storyResetTPMultiplier</code> (padrão <code>0.5</code>) uma vez a cada reinício da história. <code>SKILL</code>, <code>TRANSFORMATION</code>, <code>KI_TECHNIQUE</code> e <code>COMMAND</code> são recompensas de desbloqueio e nunca são escalonadas.
'''As recompensas são por jogador.''' Cada membro do grupo resgata as próprias recompensas quando a missão é concluída (pelo registro de missões, ou pelo NPC de entrega com <code>claim_mode: NPC_ONLY</code>).

<span id="Item_objects"></span>
=== Objetos de item ===
As recompensas <code>GENERIC_ITEM</code> (e os desejos <code>item_list_wish</code>, veja [[Special:MyLanguage/Custom Wishes|Desejos personalizados]]) descrevem itens com um objeto tipado. <code>itemType</code> escolhe o tipo de item; <code>itemId</code> e <code>count</code> estão sempre disponíveis.

{| class="wikitable"
! <code>itemType</code> !! Campos extras !! O que faz
|-
| <code>generic_item</code> (padrão) || — || Qualquer item.
|-
| <code>enchanted_item</code> || <code>enchantments</code> || <code>enchantments</code> é um mapa de id de encantamento para nível, por exemplo <code>{ "minecraft:sharpness": 3 }</code>.
|-
| <code>enchanted_book</code> || <code>enchantments</code> || Encantamentos armazenados em um livro encantado (<code>itemId</code> <code>minecraft:enchanted_book</code>).
|-
| <code>potion</code>, <code>splash_potion</code>, <code>lingering_potion</code>, <code>tipped_arrow</code> || <code>potion</code>*, <code>mobEffects</code>* || <code>potion</code> é um id de poção (por exemplo, <code>minecraft:strong_healing</code>). <code>mobEffects</code> é uma lista de <code>{ "effect", "duration", "amplifier", "ambient", "visible", "showIcon" }</code> (duração em ticks, pelo menos <code>1</code>). Defina <code>itemId</code> como o item vanilla correspondente (<code>minecraft:potion</code>, <code>minecraft:splash_potion</code>, <code>minecraft:lingering_potion</code> ou <code>minecraft:tipped_arrow</code>).
|-
| <code>trimmed_armor</code> || <code>material</code>, <code>pattern</code>, <code>enchantments</code>* || Armadura com acabamento, por exemplo <code>"material": "minecraft:gold"</code> e <code>"pattern": "minecraft:coast"</code>.
|}

<code>itemId</code> é obrigatório e <code>count</code> precisa ser pelo menos <code>1</code>. Um objeto de item inválido (sem <code>itemId</code>, um <code>itemType</code> desconhecido, um nível ou duração incorretos) faz o arquivo da missão inteiro falhar ao carregar, e o arquivo é indicado no relatório de carregamento do JSON. Ids de encantamento, poção ou efeito desconhecidos só fazem pular aquela entrada, com um aviso no log.

<syntaxhighlight lang="json">
{ "type": "GENERIC_ITEM", "itemReward": {
    "itemType": "enchanted_item", "itemId": "minecraft:diamond_sword", "count": 1,
    "enchantments": { "minecraft:sharpness": 5, "minecraft:unbreaking": 3 } } }
</syntaxhighlight>

Código-fonte: <code>src/main/java/com/dragonminez/common/util/types/items/</code>, <code>GenericItemTypeAdapterFactory.java</code>.

<span id="Prerequisites_and_requirements"></span>
== Pré-requisitos e requisitos ==
Tanto <code>prerequisites</code> (se a missão pode ser desbloqueada em algum momento) quanto <code>requirements</code> (se ela pode ser iniciada agora) usam o mesmo esquema de árvore de condições:

<syntaxhighlight lang="json">
{
  "operator": "AND",
  "conditions": [
    { "type": "LEVEL", "minLevel": 30 },
    { "type": "SAGA_QUEST", "sagaId": "saiyan_saga", "questId": 8 },
    { "operator": "OR", "conditions": [ ... ] }
  ]
}
</syntaxhighlight>

<code>operator</code> é <code>AND</code> ou <code>OR</code>. <code>conditions</code> pode aninhar outro bloco <code>{ "operator": ..., "conditions": [...] }</code>.

{| class="wikitable"
! <code>type</code> !! Campos
|-
| <code>SAGA_QUEST</code> || <code>sagaId</code>, <code>questId</code> (int): uma missão de saga específica precisa estar concluída.
|-
| <code>QUEST</code> || <code>questId</code> (string): uma missão secundária específica precisa estar concluída.
|-
| <code>LEVEL</code> || <code>minLevel</code>
|-
| <code>STAT</code> || <code>stat</code> (<code>STR</code>, <code>SKP</code>, <code>RES</code>, <code>VIT</code>, <code>PWR</code> ou <code>ENE</code>), <code>minValue</code>
|-
| <code>RACE</code> || <code>race</code> (aliases: <code>raceName</code> e <code>race_name</code>): o id da raça do jogador, sem diferenciar maiúsculas e minúsculas. Ids embutidos: <code>human</code>, <code>saiyan</code>, <code>namekian</code>, <code>frostdemon</code>, <code>bioandroid</code>, <code>majin</code>, <code>glind</code>. '''Atenção:''' é <code>frostdemon</code> (não <code>frieza</code> nem <code>colddemon</code>) e <code>bioandroid</code> (não <code>android</code> nem <code>cell</code>). Raças personalizadas usam o nome da pasta delas em <code>config/dragonminez/races/</code>.
|-
| <code>CLASS</code> || <code>class</code> (aliases: <code>className</code>, <code>class_name</code> e <code>characterClass</code>): o id da classe do jogador, sem diferenciar maiúsculas e minúsculas.
|-
| <code>SKILL</code> || <code>skill</code>, <code>minLevel</code>* (aliases: <code>skillId</code> e <code>id</code>; <code>level</code> e <code>required</code>)
|-
| <code>BIOME</code> || <code>biome</code>
|-
| <code>DIMENSION</code> || <code>dimension</code>
|-
| <code>STRUCTURE</code> || <code>structure</code>, <code>hint</code>* (<code>{ "dimension", "x", "y", "z" }</code>, todos opcionais; ajuda a guiar o jogador até a estrutura)
|-
| <code>ALIGNMENT</code> || <code>min</code>*, <code>max</code>*
|-
| <code>TIME</code> || <code>mode</code> (<code>GAME_TIME</code> com <code>ticks</code>, ou <code>REAL_TIME</code> com <code>milliseconds</code>): tempo decorrido desde que a missão ficou disponível.
|}

Código-fonte: <code>QuestParser.parseCondition</code>, <code>QuestPrerequisites.java</code>. Os mesmos blocos de condições controlam as opções em [[Special:MyLanguage/NPC Dialogue|Diálogos de NPCs]].

<span id="Side_quests"></span>
== Missões secundárias ==
As missões secundárias podem ficar em qualquer lugar dentro de <code>dragonminez/sidequests/</code> (as subpastas também são examinadas) e usam o '''mesmo esquema de missão''' das missões de saga, com algumas diferenças práticas:
* <code>"id"</code> é um '''texto''' em vez de um número (por exemplo, <code>"bulma_gero_blueprints"</code>).
* <code>"type"</code> é <code>"SIDEQUEST"</code> (ou <code>"DAILY"</code> ou <code>"EVENT"</code>) em vez de <code>"SAGA"</code>.
* Não existe pasta de saga nem manifesto que as agrupe: cada arquivo é independente.
* <code>quest_giver</code> e <code>turn_in</code> são usados com muito mais frequência, já que as missões secundárias costumam girar em torno de NPCs.
* <code>prerequisites</code> costuma usar condições <code>SAGA_QUEST</code> ou <code>QUEST</code> para bloquear uma missão secundária até certo progresso da história.

Exemplo (<code>dragonminez/sidequests/collection/bulma_gero_blueprints.json</code>):

<syntaxhighlight lang="json">
{
  "id": "bulma_gero_blueprints",
  "title": "dmz.sidequest.bulma_gero.name",
  "description": "dmz.sidequest.bulma_gero.desc",
  "type": "SIDEQUEST",
  "category": "collection",
  "parallel_objectives": false,
  "party_scaling": true,
  "secret": false,
  "claim_mode": "TREE_OR_NPC",
  "quest_giver": "bulma",
  "turn_in": "bulma",
  "prerequisites": {
    "operator": "AND",
    "conditions": [
      { "type": "SAGA_QUEST", "sagaId": "android_saga", "questId": 6 }
    ]
  },
  "objectives": [
    { "type": "STRUCTURE", "structure": "dragonminez:gero_lab" },
    { "type": "ITEM", "item": "minecraft:redstone", "count": 32 },
    { "type": "ITEM", "item": "dragonminez:kikono_shard", "count": 8 },
    { "type": "TALK_TO", "npcId": "bulma" }
  ],
  "rewards": [
    { "type": "ATTRIBUTES", "amount": 25 }
  ]
}
</syntaxhighlight>

Uma tarefa repetível, entregue a um NPC:

<syntaxhighlight lang="json">
{
  "id": "my_market_run",
  "title": "dmz.sidequest.my_market_run.name",
  "description": "dmz.sidequest.my_market_run.desc",
  "type": "SIDEQUEST",
  "category": "collection",
  "quest_giver": "bulma",
  "turn_in": "bulma",
  "repeatable": true,
  "repeat_cooldown_seconds": 3600,
  "objectives": [
    { "type": "DELIVER", "item": "minecraft:emerald", "count": 12, "npcId": "bulma" },
    { "type": "TALK_TO", "npcId": "bulma" }
  ],
  "rewards": [
    { "type": "ITEM", "item": "dragonminez:senzu_bean", "count": 2 }
  ]
}
</syntaxhighlight>

<span id="Quest_giver_and_turn-in_NPCs"></span>
== NPCs que dão e recebem missões ==
<code>quest_giver</code> e <code>turn_in</code> referenciam um NPC pelo id: o mesmo id usado pelas entidades de NPCs de missões e pelos NPCs mestres e treinadores (os objetivos <code>TALK_TO</code> e <code>DELIVER</code> usam os mesmos ids). O DragonMineZ indexa as missões pelos dois campos, então um NPC pode mostrar marcadores de "missão disponível" e aceitar entregas sem nenhuma ligação extra da sua parte. Os dois campos são opcionais: omita-os ou defina como <code>null</code> se a missão não estiver ligada a um NPC (por exemplo, uma missão de saga que só envolve explorar ou abater inimigos).

Falar com quem dá a missão abre o diálogo dele, onde a opção '''Missões''' lista as missões que ele oferece, as que estão em andamento e as que estão prontas para entregar, além das missões '''bloqueadas''': passar o cursor sobre uma mostra o que falta (por exemplo, a missão de saga ou a missão secundária que precisa ser concluída antes), e uma missão <code>repeatable</code> concluída mostra uma contagem regressiva até poder ser pega de novo. Missões <code>secret</code> bloqueadas não aparecem. A lista é ordenada por quando cada missão fica disponível na história (ordem de saga, depois ordem de missão, depois requisito de nível), então as primeiras missões de um NPC aparecem primeiro.

Se quem dá a missão é um mestre com requisito de índole, as missões dele só podem ser iniciadas enquanto a índole do jogador se encaixar, em qualquer tela; missões já em andamento ainda podem ser entregues. [[Special:MyLanguage/Goku|Goku]], [[Special:MyLanguage/Gohan|Gohan]], [[Special:MyLanguage/King Kai|Rei Kai]], [[Special:MyLanguage/Old Kai|Velho Kaioshin]], [[Special:MyLanguage/Master Roshi|Mestre Kame]] e [[Special:MyLanguage/Krillin|Kuririn]] precisam de uma índole de '''61 ou mais''', e [[Special:MyLanguage/Cell|Cell]] e [[Special:MyLanguage/Frieza|Freeza]] de '''40 ou menos'''. Veja [[Special:MyLanguage/Masters|Mestres]].

<span id="Unknown_and_misspelled_keys"></span>
== Chaves desconhecidas ou escritas errado ==
Toda missão, saga, objetivo, recompensa, condição de pré-requisito ou requisito e dica de estrutura é comparada com uma lista explícita de campos permitidos (<code>QuestParser.validate</code> e <code>validateSaga</code>). Qualquer chave não reconhecida (um erro de digitação, maiúsculas erradas, um campo que sobrou de um esquema antigo) '''não''' é descartada em silêncio: ela é registrada no log e mostrada aos jogadores no relatório de carregamento do JSON no jogo ao entrar (controlado por <code>developer.reportJsonProblemsInChat</code>, ativado por padrão), além do console do servidor. A entrada ainda carrega com o resto dos campos válidos; só a chave não reconhecida é sinalizada. Use isso para pegar erros de digitação (por exemplo, <code>CanTransfrom</code> em vez de <code>canTransform</code>) em vez de ter um campo que silenciosamente não faz nada. Um arquivo com sintaxe JSON quebrada é ignorado e relatado da mesma forma.

Chaves que começam com <code>_</code>, <code>$</code> ou <code>//</code> são tratadas como comentários e nunca são sinalizadas, então você pode deixar anotações para si mesmo direto no JSON.

<span id="Custom_objective_and_reward_types"></span>
== Tipos de objetivos e recompensas personalizados ==
Addons em Java podem registrar seus próprios <code>type</code>s de objetivos e recompensas por meio de <code>QuestObjectiveRegistry</code> e <code>QuestRewardRegistry</code>. Depois de registrados, eles são escritos no JSON das missões igual aos tipos embutidos. Veja [[Special:MyLanguage/Implementation and Events#Custom quest objectives and rewards|Implementação e eventos]] e [[Special:MyLanguage/Creating a DMZ Addon|Criar um addon de DMZ]].

<span id="Default_file_upgrades"></span>
== Atualização dos arquivos padrão ==
{{Config|General Server Config|gameplay.autoUpdateQuests}}
Todo arquivo de missão, saga e missão secundária gerado recebe um campo <code>defaultsVersion</code> (um texto semver, atualmente <code>"2.2.0"</code>). O <code>QuestUpgrader</code> cuida dele automaticamente e o usa para fazer uma mesclagem de três vias das suas edições com os padrões que vêm no DragonMineZ sempre que o conteúdo embutido muda:
* Um campo que você nunca alterou recebe o novo padrão.
* Um campo que você alterou mantém o seu valor. Se o DragonMineZ também o alterou, isso é registrado como conflito, e o seu valor continua valendo.
* As chaves que você adicionou são mantidas.
* Quando a mesclagem muda algo, o arquivo anterior é copiado antes para <code><world>/dragonminez/oldBackup/</code>.
Um resumo é gravado em <code><world>/dragonminez/quest_update_report.txt</code> e mostrado no relatório de carregamento do JSON. Desative o sistema inteiro com <code>autoUpdateQuests: false</code>. Você não precisa definir <code>defaultsVersion</code> no seu próprio conteúdo personalizado. Veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]] para saber como as atualizações são relatadas.

<span id="Translation_keys"></span>
== Chaves de tradução ==
Siga a convenção de nomes existente para que seu conteúdo combine com o resto da história:
* Nome da saga: <code>dmz.saga.<saga_id></code>
* Título e descrição de uma missão de saga: <code>dmz.quest.<key>.name</code> / <code>dmz.quest.<key>.desc</code>
* Título e descrição de uma missão secundária: <code>dmz.sidequest.<key>.name</code> / <code>dmz.sidequest.<key>.desc</code>
Adicione essas chaves ao seu <code>en_us.json</code> ou ao seu próprio arquivo de idioma. As traduções próprias se combinam com as do Crowdin da mesma forma que nas [[Special:MyLanguage/Custom Races#Step 4: Add translation keys|raças personalizadas]].

<span id="Reload_and_validate"></span>
== Recarregar e validar ==
# Salve o JSON da sua saga, missão ou missão secundária na pasta <code>dragonminez/</code> do mundo.
# Valide a sintaxe JSON (veja [[Special:MyLanguage/How to JSON|Como usar JSON]]).
# Execute <code>/dmzreload story</code> (ou <code>/dmzreload all</code>); veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]].
# Abra o registro de missões no jogo e confira se sua saga, missão ou missão secundária aparece com os requisitos, objetivos e recompensas corretos.

{{Navbox Modding}}