View source for Custom Wishes/pt

Os '''desejos personalizados''' mudam o que um dragão concede quando é invocado, só com JSON e sem Java. O JSON dos desejos fica em dois lugares diferentes, conforme o que você quer fazer:

{| class="wikitable"
! Objetivo !! Onde !! Formato
|-
| Substituir a lista de desejos de um dragão ([[Special:MyLanguage/Shenron|Shenlong]], [[Special:MyLanguage/Porunga|Porunga]] ou um dragão de addon) em um mundo. || <code><world save>/dragonminez/wishes/<dragon_id>.json</code> || Um '''array''' JSON simples de objetos de desejo.
|-
| Distribuir um '''dragão novo''', ou desejos como parte de um pacote distribuível. || Um pacote de addon (pasta ou <code>.zip</code>) em <code><game dir>/dragonballs/</code> || Um '''objeto''' JSON com os campos <code>dragon</code> e <code>wishes</code>.
|}

Os dois formatos usam por dentro os mesmos objetos de desejo; só muda o invólucro externo. Datapacks comuns '''não''' são lidos para dragões ou desejos: use um pacote de addon. Para saber como os jogadores invocam dragões e escolhem desejos, veja [[Special:MyLanguage/Dragons and Wishes|Dragões e desejos]].

<span id="How_the_wish_lists_are_merged"></span>
== Como as listas de desejos são combinadas ==
# Primeiro são carregadas as listas de desejos dos pacotes de addon (uma lista por dragão).
# Todo dragão conhecido sem lista recebe uma vazia.
# Depois, cada arquivo em <code><world save>/dragonminez/wishes/</code> '''substitui''' a lista inteira do dragão cujo nome está no nome do arquivo.

<span id="Base_fields_of_every_wish"></span>
== Campos base de todo desejo ==

<syntaxhighlight lang="json">
{
  "type": "attributes",
  "name": "wish.shenron.attributes.name",
  "description": "wish.shenron.attributes.desc",
  "amount": 100
}
</syntaxhighlight>

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>type</code> || Texto || Um dos [[Special:MyLanguage/Custom Wishes#Wish types|tipos de desejo]] abaixo.
|-
| <code>name</code> || Texto || Chave de tradução do nome exibido do desejo.
|-
| <code>description</code> || Texto || Chave de tradução da descrição do desejo.
|-
| <code>repeatable</code> || Booleano || Opcional. Dragões que concedem vários desejos (Porunga) deixam o jogador escolher o mesmo desejo mais de uma vez por invocação. Defina como <code>false</code> para permitir o desejo só uma vez. Quando ausente, o desejo pode ser repetido.
|}

Origem: <code>Wish.java</code> (classe base), <code>WishTypeAdapterFactory.java</code> (mapeamento de tipo para classe).

<span id="Wish_types"></span>
== Tipos de desejo ==

{| class="wikitable"
! <code>type</code> !! Campos extras !! O que faz
|-
| <code>item_list_wish</code> || <code>items</code>: lista de objetos de item || Concede um ou mais itens descritos como objetos de item tipados (veja abaixo). Exemplo: <code>{ "type": "item_list_wish", "name": "wish.shenron.senzu.name", "description": "wish.shenron.senzu.desc", "items": [{ "itemType": "generic_item", "itemId": "dragonminez:senzu_bean", "count": 16 }] }</code>
|-
| <code>item</code> || <code>itemId</code>, <code>count</code> || Concede uma pilha de itens. Exemplo: <code>{ "type": "item", "name": "...", "description": "...", "itemId": "dragonminez:senzu_bean", "count": 16 }</code>
|-
| <code>multi_wish</code> || <code>items</code>: lista de <code>{ "a": "<item_id>", "b": <count> }</code> || Concede várias pilhas de itens. Exemplo: <code>{ "type": "multi_wish", "name": "...", "description": "...", "items": [{ "a": "dragonminez:kikono_shard", "b": 32 }, { "a": "minecraft:iron_ingot", "b": 64 }] }</code>
|-
| <code>attributes</code> || <code>amount</code> || Concede <code>amount</code> Atributos, divididos entre Pontos de Atributo e os TP que esses pontos custariam ao jogador naquele momento (veja [[Special:MyLanguage/Stats and Attributes|Estatísticas e atributos]]). Os desejos '''Aumento de Poder''' padrão usam este tipo. Exemplo: <code>{ "type": "attributes", "name": "...", "description": "...", "amount": 100 }</code>
|-
| <code>attributepoints</code> || <code>amount</code> || Concede apenas <code>amount</code> Pontos de Atributo. Exemplo: <code>{ "type": "attributepoints", "name": "...", "description": "...", "amount": 50 }</code>
|-
| <code>tps</code> || <code>amount</code> || Concede uma quantidade fixa de pontos de treino. Exemplo: <code>{ "type": "tps", "name": "...", "description": "...", "amount": 5000 }</code>
|-
| <code>skill</code> || <code>skill</code>, <code>level</code> || Sobe uma habilidade pelo menos até <code>level</code>, por exemplo <code>{ "type": "skill", "name": "...", "description": "...", "skill": "kaioken", "level": 2 }</code>. É ignorado se o jogador já estiver nesse nível.
|-
| <code>command</code> || <code>commands</code>: array de textos, em que <code>%player%</code> é substituído pelo nome do jogador || Executa comandos. Exemplo: <code>{ "type": "command", "name": "...", "description": "...", "commands": ["effect give %player% minecraft:regeneration 60 1"] }</code>
|-
| <code>revive</code> || <code>maxTargets</code> (padrão <code>1</code>) || Revive de verdade até <code>maxTargets</code> jogadores mortos, escolhidos na tela de desejos. Veja [[Special:MyLanguage/Otherworld|Outro Mundo]].
|-
| <code>passivereset</code> || Nenhum || Redefine os bônus das habilidades passivas raciais (Zenkai, Assimilação e Absorção).
|-
| <code>recustomize</code> || Nenhum || Abre a tela de personalização do personagem.
|-
| <code>relocatestats</code> || Nenhum || Permite ao jogador redistribuir os pontos de estatísticas que gastou.
|-
| <code>changedifficulty</code> || Nenhum || Permite ao jogador escolher de novo a dificuldade da história.
|-
| <code>resetstory</code> || Nenhum || Redefine todo o progresso das missões da história.
|}

<code>item_list_wish</code> é o tipo usado pelos desejos padrão. Cada entrada de <code>items</code> é um objeto de item tipado, então um desejo também pode conceder equipamento encantado, poções ou armaduras com acabamento:

<syntaxhighlight lang="json">
{
  "type": "item_list_wish",
  "name": "wish.shenron.strongest.name",
  "description": "wish.shenron.strongest.desc",
  "items": [
    { "itemType": "enchanted_item", "itemId": "minecraft:diamond_sword", "count": 1, "enchantments": { "minecraft:sharpness": 5 } },
    { "itemType": "potion", "itemId": "minecraft:potion", "count": 1, "potion": "minecraft:strong_healing" }
  ]
}
</syntaxhighlight>

Os campos de cada objeto de item (<code>generic_item</code>, <code>enchanted_item</code>, <code>enchanted_book</code>, <code>potion</code>, <code>splash_potion</code>, <code>lingering_potion</code>, <code>tipped_arrow</code>, <code>trimmed_armor</code>) estão em [[Special:MyLanguage/Custom Quests#Item objects|Missões personalizadas]].

Origem: as classes em <code>src/main/java/com/dragonminez/common/wish/wishes/</code> e a tabela de despacho em <code>WishTypeAdapterFactory.java</code>.

<span id="Overriding_a_dragon&#039;s_wishes"></span>
== Substituir os desejos de um dragão ==
Coloque um arquivo com o id do dragão como nome em <code><world save>/dragonminez/wishes/</code>, por exemplo <code>shenron.json</code> ou <code>porunga.json</code>. É um '''array simples''', sem objeto invólucro:

<syntaxhighlight lang="json">
[
  {
    "type": "item_list_wish",
    "name": "wish.shenron.senzu.name",
    "description": "wish.shenron.senzu.desc",
    "items": [ { "itemType": "generic_item", "itemId": "dragonminez:senzu_bean", "count": 16 } ]
  },
  {
    "type": "attributes",
    "name": "wish.shenron.attributes.name",
    "description": "wish.shenron.attributes.desc",
    "amount": 100
  },
  {
    "type": "revive",
    "name": "wish.shenron.revive.name",
    "description": "wish.shenron.revive.desc",
    "maxTargets": 3
  }
]
</syntaxhighlight>

{{Note|type=warning|title=O arquivo substitui a lista inteira|text=Este arquivo '''substitui completamente''' a lista de desejos desse dragão; ele não é somado aos desejos dos pacotes de addon. Se você só quer adicionar um desejo e manter o resto, copie primeiro a lista de desejos completa atual do dragão e depois adicione o seu.}}

Se <code>shenron.json</code> ou <code>porunga.json</code> ainda não existirem, o DragonMineZ os cria com a lista de desejos padrão na primeira vez que os desejos são carregados, então você sempre tem um exemplo funcional para começar. Qualquer outro nome de arquivo que você criar aqui define a lista de desejos desse id de dragão; ela só aparece se existir um dragão com esse id (veja [[Special:MyLanguage/Custom Wishes#Adding a new dragon|Adicionar um dragão novo]]).

Cada desejo é verificado quando o arquivo carrega: um <code>type</code> desconhecido ou uma chave desconhecida é reportado no relatório de carregamento de JSON. Um arquivo que não pode ser lido (JSON quebrado, um objeto de item inválido) é ignorado por inteiro e reportado, então o dragão mantém os desejos do pacote de addon até você corrigi-lo.

Origem: <code>WishManager.loadWishes()</code> e <code>loadWishConfig()</code>.

<span id="Adding_a_new_dragon"></span>
== Adicionar um dragão novo ==
Um arquivo de substituição de desejos sozinho só funciona para um id de dragão que já tenha uma '''definição de dragão''' (entidade, conjunto de esferas e regras de invocação). Um dragão, conjunto de esferas ou radar novo vem de um pacote de addon em <code><game dir>/dragonballs/</code>: uma pasta ou um arquivo <code>.zip</code> com esta estrutura:

<syntaxhighlight lang="text">
<pack_name>/
  definitions/
    dragon.json
    ballset.json
    radar.json
    wishes.json
  assets/
    dragon.json
    ballset.json
    radar.json
</syntaxhighlight>

Os pacotes são carregados em ordem alfabética e combinados por id sobre as definições incluídas: um pacote cujo <code>dragon.json</code> usa um id de dragão existente sobrescreve a definição desse dragão. Dragões, conjuntos de esferas e radares registram sua entidade, blocos e itens quando o jogo inicia, então '''os novos precisam reiniciar o jogo'''. Veja [[Special:MyLanguage/Locating Specific Folders|Encontrar pastas]] para o mapa completo de pastas.

<span id="Dragon_definition"></span>
=== Definição do dragão ===
<code>definitions/dragon.json</code>:

<syntaxhighlight lang="json">
{
  "id": "my_dragon",
  "entity_registry_name": "my_dragon",
  "entity_width": 3.0,
  "entity_height": 17.0,
  "dimensions": ["minecraft:overworld"],
  "ball_set": "my_ball_set",
  "wish_screen_id": "my_dragon",
  "wish_count": 1,
  "asset_definition": "my_dragon"
}
</syntaxhighlight>

{| class="wikitable"
! Campo !! O que faz
|-
| <code>id</code> || Id do dragão.
|-
| <code>entity_registry_name</code> || Nome de registro da entidade do dragão (<code>dragonminez:<name></code>). Mantenha igual ao <code>id</code>: a invocação procura a entidade pelo id do dragão.
|-
| <code>entity_width</code>, <code>entity_height</code> || Tamanho da entidade.
|-
| <code>dimensions</code> || Dimensões em que o dragão pode ser invocado.
|-
| <code>ball_set</code> || Id do conjunto de esferas que o invoca.
|-
| <code>wish_screen_id</code> || Id da lista de desejos que o dragão oferece (o valor <code>dragon</code> em <code>wishes.json</code> e o nome do arquivo de uma substituição por mundo).
|-
| <code>wish_count</code> || Quantos desejos são concedidos por invocação.
|-
| <code>asset_definition</code> || Id opcional de uma entrada de <code>assets/dragon.json</code> (<code>id</code>, <code>renderer_type</code>, <code>model</code>, <code>texture</code>, <code>animation</code>).
|}

<span id="Ball_set_definition"></span>
=== Definição do conjunto de esferas ===
<code>definitions/ballset.json</code> aceita estas chaves: <code>id</code>, <code>dimensions</code>, <code>copies</code> (padrão <code>5</code>), <code>spawn_range</code>, <code>summon_radius</code> (quão perto as outras esferas precisam estar daquela em que você clica com o botão direito), <code>blocks</code> (número de estrelas para o nome de registro do bloco), <code>asset_definition</code>, <code>display_name</code> e <code>natural_spawn</code> (opcional, padrão <code>true</code>).
* Um conjunto está completo quando '''todas as estrelas listadas em <code>blocks</code>''' estão colocadas dentro de <code>summon_radius</code>, então um conjunto não precisa ter sete esferas.
* Com <code>"natural_spawn": false</code>, as esferas do conjunto nunca são espalhadas pelo mundo (nem na criação do mundo, nem depois de um desejo, nem com <code>/dmzdragonballs</code>): elas só existem se você mesmo as entregar, por exemplo como recompensas de missões ou de chefes de mundo.

<span id="Radar_definition"></span>
=== Definição do radar ===
<code>definitions/radar.json</code> aceita estas chaves: <code>id</code>, <code>item_registry_name</code>, <code>dimensions</code>, <code>ball_set</code>, <code>tooltip_key</code>, <code>ranges</code>, <code>recipe_definition</code>, <code>chip_item</code>, <code>cpu_item</code>, <code>chip_model_item</code>, <code>cpu_model_item</code>, <code>asset_definition</code> e <code>display_name</code>. Um radar com <code>chip_item</code> e <code>cpu_item</code> e sem <code>recipe_definition</code> recebe uma receita de fabricação com esses dois itens. Veja [[Special:MyLanguage/Dragon Radar|Radar do Dragão]] para o radar incluído.

<span id="Pack_wish_list"></span>
=== Lista de desejos do pacote ===
<code>definitions/wishes.json</code> usa um objeto invólucro. Este é o formato de pacote de addon, diferente do formato de array por mundo acima:

<syntaxhighlight lang="json">
{
  "dragon": "my_dragon",
  "wishes": [
    { "type": "tps", "name": "wish.my_dragon.tps.name", "description": "wish.my_dragon.tps.desc", "amount": 5000 }
  ]
}
</syntaxhighlight>

Cada chave destes arquivos é verificada contra as listas acima, e as chaves desconhecidas são reportadas no relatório de carregamento de JSON.

Origem: <code>DragonBallPackManager.java</code>, <code>DragonDefinition.java</code>, <code>DragonBallSetDefinition.java</code>, <code>DragonRadarDefinition.java</code>, <code>DragonWishRegistry.java</code>.

<span id="Translation_keys"></span>
== Chaves de tradução ==
A convenção é <code>wish.<dragon_id>.<wish_key>.name</code> / <code>wish.<dragon_id>.<wish_key>.desc</code>, por exemplo <code>wish.shenron.senzu.name</code>. Adicione estas chaves ao seu <code>en_us.json</code> ou ao seu próprio arquivo de idioma. As traduções personalizadas se combinam com as do Crowdin do mesmo jeito que nas [[Special:MyLanguage/Custom Races#Step 4: Add translation keys|raças personalizadas]].

<span id="Reload_and_validate"></span>
== Recarregar e validar ==
# Salve seus arquivos de substituição de desejos em <code><world save>/dragonminez/wishes/</code>, ou seu pacote de addon em <code><game dir>/dragonballs/</code>.
# Valide a sintaxe JSON (veja [[Special:MyLanguage/How to JSON|Como usar JSON]]).
# Para as substituições por mundo, execute <code>/dmzreload wishes</code> (ou <code>/dmzreload all</code>); veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]]. As listas de desejos dentro dos pacotes de addon são lidas de novo pelo <code>/reload</code> vanilla; execute <code>/dmzreload wishes</code> depois para que as substituições por mundo sejam aplicadas por cima de novo. Dragões, conjuntos de esferas e radares novos precisam de uma reinicialização completa.
# Invoque o dragão no jogo e confira se a lista de desejos é a que você espera.

{{Navbox Modding}}