Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T10:28:49Z

Translation sync from dragonminez-wiki repository

New page

Os '''destinos da Cápsula Espacial''' são os lugares para onde um jogador pode viajar pelo menu da [[Special:MyLanguage/Space Pod|Cápsula Espacial]]. Eles são um sistema de datapacks, não um arquivo de <code>config/dragonminez</code>, o que os torna ideais para datapacks e addons que querem adicionar seus próprios destinos (por exemplo, um mod de dimensões personalizadas que adiciona sua própria entrada).

Carregador: <code>SpacePodDestinationRegistry</code> (<code>src/main/java/com/dragonminez/common/spacepod/SpacePodDestinationRegistry.java</code>), um <code>SimpleJsonResourceReloadListener</code> do vanilla sobre a pasta <code>spacepod</code>. Ele recarrega com o <code>/reload</code> do vanilla ou ao reiniciar, '''não''' com o <code>/dmzreload</code>, e é sincronizado com os clientes automaticamente quando os datapacks são sincronizados.


== Local do arquivo ==

<syntaxhighlight lang="text">
data/<namespace>/spacepod/destinations.json
</syntaxhighlight>

Qualquer namespace pode contribuir com um <code>destinations.json</code> (ou qualquer outro nome de arquivo dentro dessa pasta). Todos são carregados juntos, ordenados por resource location. O arquivo que vem com o DragonMineZ é <code>data/dragonminez/spacepod/destinations.json</code>.


== Destinos incluídos ==
O <code>data/dragonminez/spacepod/destinations.json</code> incluído no DragonMineZ usa <code>"replace": true</code> e contém:

{| class="wikitable"
! <code>id</code> !! Nome no menu !! Dimensão !! Chega em !! Regra de desbloqueio
|-
| <code>overworld</code> || [[Special:MyLanguage/Earth|Terra]] || <code>minecraft:overworld</code> || Mesmas X/Y/Z do jogador || <code>ALWAYS</code>
|-
| <code>namek</code> || [[Special:MyLanguage/Namek|Namekusei]] || <code>dragonminez:namek</code> || Mesmas X/Y/Z do jogador || <code>ALWAYS</code>
|-
| <code>otherworld</code> || [[Special:MyLanguage/Otherworld|Outro Mundo]] || <code>dragonminez:otherworld</code> || 54, 210, 1082 || <code>OTHERWORLD_ENABLED</code> '''e''' a missão secundária <code>bulma_otherworld_drive</code> (''Propulsor do Outro Mundo'')
|-
| <code>sacredkaiplanet</code> || [[Special:MyLanguage/Sacred Kai Planet|Mundo Sagrado dos Kai]] || <code>dragonminez:sacredkaiplanet</code> || Mesmas X/Y/Z do jogador || Missão de saga <code>buu_saga:23</code> ([[Special:MyLanguage/Buu Saga|Saga Boo]])
|-
| <code>cereal</code> || Planeta Cereal || <code>dragonminez:cereal_planet</code> || Mesmas X/Y/Z do jogador || <code>NEVER</code> (reservado para uma dimensão de addon)
|-
| <code>beerus</code> || Planeta de Bills || <code>dmzsuper:beerus_planet</code> || Mesmas X/Y/Z do jogador || <code>NEVER</code> (reservado para uma dimensão de addon)
|-
| <code>time_chamber</code> || [[Special:MyLanguage/Hyperbolic Time Chamber|Sala do Tempo]] || <code>dragonminez:time_chamber</code> || 0.5, 130, 0.5 || Missão secundária <code>bulma_time_chamber_link</code> (''Comunicador Temporal'')
|-
| <code>demon_realm</code> || [[Special:MyLanguage/Demon Realm|Reino Demoníaco]] || <code>dragonminez:demon_realm</code> || 160.5, 745, 0.5 (acima do Terceiro Mundo Demoníaco) || Missão de saga <code>daima_saga:3</code> (''Rumo ao Reino Demoníaco'', [[Special:MyLanguage/Daima Saga|Saga Daima]])
|}

Todas as entradas incluídas usam <code>"show_when_locked": true</code>, então os mundos bloqueados aparecem em cinza. Veja [[Special:MyLanguage/Dimensions|Dimensões]] para saber o que cada mundo oferece.

{{Note|type=warning|title=A ordem de carregamento importa|text=Os arquivos são aplicados na ordem de resource location, e o arquivo incluído no DragonMineZ usa <code>"replace": true</code>. Um arquivo em um namespace que vem '''antes''' de <code>dragonminez</code> na ordem (por exemplo, <code>addon:</code>) é apagado por ele: use um namespace que venha depois de <code>dragonminez</code>, ou coloque seu próprio <code>data/dragonminez/spacepod/destinations.json</code> em um datapack para substituir a lista do DragonMineZ. As entradas não são mescladas por <code>id</code>: adicionar uma entrada com um id que já existe não altera a existente.}}


== Estrutura geral ==

<syntaxhighlight lang="text">
{
"replace": false,
"destinations": [ ... ]
}
</syntaxhighlight>

<code>replace</code> é opcional e o padrão é <code>false</code>. Se for <code>true</code>, ele apaga todos os destinos carregados antes deste arquivo e depois adiciona os seus. Use-o se quiser que seu pacote seja a única fonte da lista de destinos, em vez de se somar aos outros.


== Campos de um destino ==

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>id</code> || Texto || Id único do destino.
|-
| <code>name</code> || Texto || Chave de tradução, ou um texto literal se <code>translate</code> for <code>false</code>.
|-
| <code>translate</code> || Booleano || O padrão é <code>true</code> (trata <code>name</code> como uma chave de tradução).
|-
| <code>dimension</code> || Texto || Id da dimensão de destino.
|-
| <code>icon_index</code> || Inteiro || Índice na folha de ícones embutida da Cápsula Espacial. É obrigatório exatamente um entre <code>icon_index</code> e <code>icon_texture</code>.
|-
| <code>icon_texture</code> || Texto || Resource location de uma textura personalizada, como alternativa a <code>icon_index</code>.
|-
| <code>x</code>, <code>y</code>, <code>z</code> || Número || Coordenadas de destino. Informe '''as três''', ou '''apenas <code>y</code>''' (um caso especial que mantém o X e o Z atuais do jogador e muda só o Y), ou não informe nenhuma. Informar só <code>x</code> ou só <code>z</code> sem as outras é um erro.
|-
| <code>show_when_locked</code> || Booleano || O padrão é <code>true</code>. Se for <code>true</code>, um destino bloqueado continua aparecendo (em cinza); se for <code>false</code>, ele fica totalmente oculto até ser desbloqueado.
|-
| <code>unlock_rules</code> || Texto ou objeto || A condição de desbloqueio (veja [[Special:MyLanguage/Space Pod Destinations#Unlock rules|Regras de desbloqueio]]).
|}


== Regras de desbloqueio ==

=== Primitivas ===
As primitivas são textos simples:

{| class="wikitable"
! Regra !! Desbloqueia quando
|-
| <code>"ALWAYS"</code> || Sempre.
|-
| <code>"NEVER"</code> || Nunca. Na prática, desativa o destino, a menos que outro pacote o substitua.
|-
| <code>"KAIO_UNLOCKED"</code> || O jogador desbloqueou o planeta do Rei Kai.
|-
| <code>"OTHERWORLD_ENABLED"</code> || A geração do Outro Mundo está ativada na configuração do servidor.
|}


=== Condições ===
As condições são objetos:

{| class="wikitable"
! Regra !! Formato !! Desbloqueia quando
|-
| Missão || <code>{ "quest": "<quest_id>" }</code> || O jogador concluiu essa missão. Funcionam tanto ids de missões secundárias quanto de missões de saga (por exemplo, <code>"buu_saga:23"</code>).
|-
| Nível || <code>{ "level": N }</code> || O nível do jogador é pelo menos <code>N</code>.
|-
| Raça || <code>{ "race": "<race_name>" }</code> || A raça do jogador corresponde (sem diferenciar maiúsculas e minúsculas).
|-
| Tag || <code>{ "tag": "<player_tag>" }</code> || O jogador tem esta tag do scoreboard do Minecraft.
|-
| Dimensão visitada || <code>{ "visited_dimension": "<dimension_id>" }</code> || O jogador já visitou essa dimensão antes.
|-
| Estatística || <code>{ "stat": { "name": "<STAT_NAME>", "min": N } }</code> || A estatística do jogador (por exemplo, <code>STRENGTH</code>) é pelo menos <code>N</code>.
|}


=== Operadores compostos ===
Os operadores compostos podem ser aninhados em qualquer profundidade, misturando livremente primitivas, condições e outros operadores compostos:

<syntaxhighlight lang="text">
{ "and": [ <rule>, <rule>, ... ] }
{ "or": [ <rule>, <rule>, ... ] }
{ "not": <rule> }
</syntaxhighlight>


== Exemplos ==
Sempre disponível:

<syntaxhighlight lang="json">
{
"id": "overworld",
"name": "gui.dragonminez.spacepod.overworld",
"dimension": "minecraft:overworld",
"icon_index": 0,
"unlock_rules": "ALWAYS"
}
</syntaxhighlight>

Bloqueado por um AND entre uma opção global e uma missão, com coordenadas fixas:

<syntaxhighlight lang="json">
{
"id": "otherworld",
"name": "gui.dragonminez.spacepod.otherworld",
"dimension": "dragonminez:otherworld",
"icon_index": 2,
"x": 54.0,
"y": 210.0,
"z": 1082.0,
"unlock_rules": {
"and": ["OTHERWORLD_ENABLED", { "quest": "bulma_otherworld_drive" }]
}
}
</syntaxhighlight>

Bloqueado por uma única missão de saga, com coordenadas fixas (a entrada incluída do Reino Demoníaco):

<syntaxhighlight lang="json">
{
"id": "demon_realm",
"name": "gui.dragonminez.spacepod.demon_realm",
"dimension": "dragonminez:demon_realm",
"icon_index": 6,
"x": 160.5,
"y": 745.0,
"z": 0.5,
"unlock_rules": { "quest": "daima_saga:3" }
}
</syntaxhighlight>

Bloqueado por uma missão secundária, com o formato de coordenadas "manter X e Z, mudar só Y" (<code>my_pack:sky_island</code> é um exemplo inventado):

<syntaxhighlight lang="json">
{
"id": "sky_island",
"name": "My Sky Island",
"translate": false,
"dimension": "my_pack:sky_island",
"icon_index": 2,
"y": 130.0,
"unlock_rules": { "quest": "bulma_time_chamber_link" }
}
</syntaxhighlight>

Um destino que nunca pode ser desbloqueado por este pacote (útil se você quer que ele fique oculto, a menos que outro pacote o substitua):

<syntaxhighlight lang="json">
{
"id": "cereal",
"name": "gui.dragonminez.spacepod.cereal",
"dimension": "dragonminez:cereal_planet",
"icon_index": 4,
"unlock_rules": "NEVER"
}
</syntaxhighlight>

Um exemplo mais aninhado que combina nível ou raça com a exclusão de uma tag:

<syntaxhighlight lang="json">
{
"unlock_rules": {
"and": [
{ "or": [{ "level": 10 }, { "race": "saiyan" }] },
{ "not": { "tag": "tutorial_skipped" } }
]
}
}
</syntaxhighlight>


== Tela do cliente ==
Os jogadores navegam pelos destinos em <code>SpacePodScreen</code> (lado do cliente), que mostra até 7 entradas por vez e deixa em cinza ou oculta as bloqueadas de acordo com <code>show_when_locked</code>.


== Recarregar e validar ==
# Adicione ou edite <code>data/<namespace>/spacepod/destinations.json</code>.
# Valide a sintaxe JSON (veja [[Special:MyLanguage/How to JSON|Como usar JSON]]).
# Execute o <code>/reload</code> do vanilla ou reinicie. Isso não é coberto pelo <code>/dmzreload</code> (veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]]).
# Abra o menu da Cápsula Espacial no jogo e confira se o destino aparece e é desbloqueado como esperado.

{{Navbox Modding}}

Space Pod Destinations/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository