Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T07:01:28Z

Translation sync from dragonminez-wiki repository

Nova página

'''Implementação e eventos''' descreve a superfície de hooks que o DragonMineZ oferece aos addons: seus eventos, como ler o estado do jogador, os registros de extensão e onde conectar sua própria rede e seus próprios registros. Leia quando seu addon já compilar contra o DMZ (veja [[Special:MyLanguage/Add-on Getting Started|Primeiros passos com addons]]).


== Escutar um evento do DMZ ==
Todos os eventos de servidor e comuns são classes estáticas aninhadas de <code>com.dragonminez.common.events.DMZEvent</code>, publicadas no barramento de eventos padrão do Forge (<code>MinecraftForge.EVENT_BUS</code>). Cada classe aninhada estende diretamente o <code>Event</code> do Forge (o próprio <code>DMZEvent</code> é só o contêiner), então inscreva-se na classe aninhada específica:

<syntaxhighlight lang="java">
@Mod.EventBusSubscriber(modid = "your_addon_modid", bus = Mod.EventBusSubscriber.Bus.FORGE)
public class DmzHooks {
@SubscribeEvent
public static void onTpGain(DMZEvent.TPGainEvent event) {
int boosted = Math.round(event.getTpGain() * 1.10f);
event.setTpGain(boosted);
}

@SubscribeEvent
public static void onFormChange(DMZEvent.FormChangeEvent event) {
if (event.isTransform()) {
// player transformed into event.getNewGroup() / event.getNewForm()
}
}
}
</syntaxhighlight>

Os eventos marcados abaixo como '''canceláveis''' têm a anotação <code>@Cancelable</code> do Forge: <code>event.setCanceled(true)</code> bloqueia a ação subjacente. Os campos marcados como ''editáveis'' têm um setter (<code>setTpGain</code>, <code>setAmount</code>, ...), e o DMZ usa o valor resultante depois que todos os listeners rodam. Todos os getters seguem os nomes dos campos (<code>getPlayer()</code>, <code>getOldValue()</code>, ...); campos booleanos usam <code>is...</code> (<code>isParry()</code>, <code>isBlocked()</code>).


== Lista de eventos ==
Origem: <code>src/main/java/com/dragonminez/common/events/DMZEvent.java</code>.


=== Estatísticas, recursos e progresso ===

{| class="wikitable"
! Evento !! Cancelável !! Disparado quando !! Campos principais
|-
| <code>StatChangeEvent</code> || Sim || Uma estatística (STR, SKP, RES, VIT, PWR ou ENE) muda por uma chamada a <code>Stats.set*()</code>: comandos, itens, menus, e também quando as estatísticas são carregadas ou copiadas (tanto no servidor quanto no cliente). || <code>player</code>, <code>stat</code> (<code>STRENGTH</code>, <code>STRIKE_POWER</code>, <code>RESISTANCE</code>, <code>VITALITY</code>, <code>KI_POWER</code> ou <code>ENERGY</code>), <code>oldValue</code>, <code>newValue</code>
|-
| <code>TPGainEvent</code> || Sim || Antes que uma quantidade positiva de pontos de treino seja adicionada (<code>Resources.addTrainingPoints</code>). || <code>player</code>, <code>oldValue</code>, <code>tpGain</code> (editável), <code>shareWithParty</code> (editável); auxiliar <code>getNewTpsValue()</code>
|-
| <code>KiChargeEvent</code> || Sim || Uma vez por segundo enquanto o jogador está carregando ki ativamente. Cancele-o para impedir o ganho de ki daquele segundo. || <code>player</code>, <code>currentEnergy</code>, <code>maxEnergy</code>; auxiliar <code>isEnergyFull()</code>
|-
| <code>HealthRegenEvent</code> / <code>EnergyRegenEvent</code> / <code>StaminaRegenEvent</code> || Sim || Antes de aplicar a regeneração por segundo de vida, ki ou estâmina. Eles compartilham a base <code>ResourceRegenEvent</code>. || <code>player</code>, <code>statsData</code>, <code>amount</code> (editável)
|-
| <code>FormChangeEvent</code> / <code>StackFormChangeEvent</code> || Não || Depois que a forma de raça ou a forma acumulável do jogador muda (lado do servidor). || <code>player</code>, <code>oldGroup</code>, <code>oldForm</code>, <code>newGroup</code>, <code>newForm</code>; auxiliares <code>isTransform()</code> e <code>isUntransform()</code>
|-
| <code>PlayerDataSaveEvent</code> || Não || Os dados do jogador estão prestes a ser gravados no backend de armazenamento <code>JSON</code> ou <code>DATABASE</code>. Você pode adicionar suas próprias chaves a <code>data</code>. || <code>player</code>, <code>data</code>
|-
| <code>PlayerDataLoadEvent</code> || Não || Os dados do jogador foram lidos do backend <code>JSON</code> ou <code>DATABASE</code>, logo antes de serem aplicados ao jogador. || <code>player</code>, <code>data</code>
|}

{{Note|title=StatChangeEvent e o carregamento de dados|text=<code>StatChangeEvent</code> também é disparado enquanto o DMZ carrega os dados salvos e aplica as sincronizações do cliente. Se você cancelá-lo, verifique antes <code>event.getPlayer().level().isClientSide()</code> e suas próprias condições, ou pode impedir que as estatísticas salvas de um jogador sejam carregadas.}}

{{Note|title=Backends de armazenamento|text=<code>PlayerDataSaveEvent</code> e <code>PlayerDataLoadEvent</code> não são disparados com o backend <code>NBT</code> padrão, em que o vanilla salva os dados do DMZ junto com o arquivo do jogador. Veja [[Special:MyLanguage/General Server Config|Configuração do servidor]] para as opções de <code>storage</code>.}}


=== Combate ===

{| class="wikitable"
! Evento !! Cancelável !! Disparado quando !! Campos principais
|-
| <code>DamageModifyEvent</code> || Sim || Cálculo do dano antes da mitigação, para um golpe dado por um jogador (golpes corpo a corpo e Ataques de Golpe). Cancele-o para não causar dano do DMZ. || <code>attacker</code>, <code>victim</code>, <code>amount</code> (editável), <code>defensePenetration</code> (editável), <code>sourceType</code> (<code>MELEE</code> ou <code>STRIKE</code>)
|-
| <code>DamageDealtEvent</code> || Não || Depois que o bloqueio de um golpe corpo a corpo de um jogador é resolvido (quantidade antes da mitigação). || <code>attacker</code>, <code>victim</code>, <code>amount</code>, <code>blocked</code>, <code>parried</code>, <code>sourceType</code>
|-
| <code>PlayerDamageMitigatedEvent</code> || Não || Depois que o DMZ termina de mitigar um golpe recebido por um jogador. Somente leitura: não altere o dano aqui. || <code>victim</code>, <code>source</code> (<code>DamageSource</code>), <code>rawDamage</code>, <code>defenseMitigated</code>, <code>blockMitigated</code>, <code>finalDamage</code>
|-
| <code>PlayerBlockEvent</code> || Sim || O jogador bloqueia ou faz parry de um ataque com sucesso. Cancele-o e o jogador recebe o golpe inteiro. || <code>victim</code>, <code>attacker</code>, <code>originalDamage</code>, <code>finalDamage</code> (editável), <code>isParry</code> (editável), <code>poiseDamage</code> (editável)
|-
| <code>BarrierAbsorbEvent</code> || Não || Uma barreira de ki (a técnica de barreira ou a barreira dos Androides) absorve um golpe antes que ele chegue à entidade protegida. || <code>owner</code> (quem criou a barreira), <code>protectedEntity</code>, <code>attacker</code>, <code>amount</code>
|-
| <code>PlayerDashEvent</code> || Sim || Antes que uma esquiva seja executada. || <code>player</code>, <code>dashType</code> (<code>NORMAL</code> ou <code>DOUBLE</code>), <code>distance</code> (editável), <code>kiCost</code> (editável)
|-
| <code>PlayerEvasionEvent</code> || Sim || Antes que uma evasão seja ativada. || <code>player</code>, <code>attacker</code>, <code>originalDamage</code>, <code>kiCost</code> (editável)
|-
| <code>CritChanceEvent</code> || Não || Enquanto a chance crítica de um jogador é calculada. || <code>player</code>, <code>chance</code> (editável, de 0 a 1)
|-
| <code>KiAttackCastEvent</code> || Não || Um jogador começa a carregar (lança) um ataque de ki. || <code>player</code>, <code>statsData</code>, <code>kiAttack</code>
|-
| <code>KiAttackFireEvent</code> || Não || Um ataque de ki carregado é disparado. || <code>player</code>, <code>statsData</code>, <code>kiAttack</code>, <code>chargeMultiplier</code>, <code>cooldownTicks</code> (editável, mínimo 1)
|-
| <code>StrikeAttackCastEvent</code> || Não || Um jogador inicia um Ataque de Golpe. || <code>player</code>, <code>statsData</code>, <code>strike</code>
|-
| <code>StrikeAttackFireEvent</code> || Não || Um Ataque de Golpe acerta e começa sobre um alvo. || <code>player</code>, <code>statsData</code>, <code>strike</code>, <code>target</code>
|}

<code>DamageSourceType</code> também contém um valor <code>KI</code>; na v2.2, os ataques de ki não publicam <code>DamageModifyEvent</code> nem <code>DamageDealtEvent</code>.


=== Fusões e dragões ===

{| class="wikitable"
! Evento !! Cancelável !! Disparado quando !! Campos principais
|-
| <code>FusionEvent</code> || Sim || Antes de uma tentativa de fusão. O DMZ o publica para as fusões <code>METAMORU</code>, <code>POTHALA</code> e <code>BEETLE</code> (Besouro Medi-Bug); o enum também contém <code>ABSORPTION</code> e <code>ASSIMILATION</code>. || <code>initiator</code>, <code>target</code>, <code>type</code>
|-
| <code>DragonSummonedEvent</code> || Não || Depois que um dragão é invocado com um conjunto de esferas completo. || <code>player</code>, <code>level</code>, <code>position</code>, <code>dragonDefinition</code>, <code>ballSetDefinition</code>, <code>consumedPositions</code>; auxiliares <code>getDragonId()</code> e <code>getBallSetId()</code>
|}

Veja [[Special:MyLanguage/Fusions|Fusões]] e [[Special:MyLanguage/Dragons and Wishes|Dragões e desejos]] para a parte de jogabilidade.


=== Missões ===
Todos os eventos de missões estendem <code>QuestLifecycleEvent</code> e compartilham seus campos: <code>player</code>, <code>questKey</code> (<code>sagaId:questId</code> para missões de saga, o id em texto para missões secundárias), <code>saga</code> (null para missões secundárias), <code>quest</code> e <code>partyMembers</code>.

{| class="wikitable"
! Evento !! Cancelável !! Disparado quando !! Campos extras
|-
| <code>QuestStartEvent</code> || Sim || Antes que uma missão seja aceita. || <code>difficulty</code> (editável)
|-
| <code>QuestObjectiveProgressEvent</code> || Sim || Antes que o progresso de um objetivo seja salvo. || <code>objectiveIndex</code>, <code>oldProgress</code>, <code>newProgress</code> (editável), <code>objectiveRequired</code>
|-
| <code>QuestFailEvent</code> || Sim || Antes que uma missão seja marcada como falha. || <code>reason</code> (<code>PLAYER_DEATH</code>, <code>FORCED_RESET</code>, <code>SCRIPT</code>, <code>TIME_EXPIRED</code>, <code>ESCORT_FAILED</code>)
|-
| <code>QuestTurnInEvent</code> || Sim || Antes que a entrega de uma missão seja aplicada. || <code>npcId</code>
|-
| <code>QuestRewardClaimEvent</code> || Sim || Antes que uma recompensa individual seja resgatada. || <code>rewardIndex</code>
|-
| <code>QuestCompletedEvent</code> || Não || Quando uma missão é concluída. || Só os campos compartilhados
|}


=== Eventos de cliente ===
Os eventos só de cliente ficam em <code>com.dragonminez.client.events.DMZClientEvent</code> e são publicados no barramento do Forge do cliente físico. Registre esses listeners com <code>value = Dist.CLIENT</code>. Nenhum deles é cancelável e eles são apenas informativos: o servidor continua decidindo o que de fato acontece.

{| class="wikitable"
! Evento !! Disparado quando !! Campos principais
|-
| <code>PlayerAttackStart</code> || O jogador local começa a preparação do ataque. || <code>player</code>, <code>attackHand</code>
|-
| <code>PlayerAttackHit</code> || O ataque do jogador local resolve seus alvos (zero ou mais). || <code>player</code>, <code>attackHand</code>, <code>targets</code>, <code>cursorTarget</code> (pode ser null)
|-
| <code>KiAttackCast</code> || O jogador local começa a carregar o ataque de ki de um slot. || <code>player</code>, <code>slot</code>
|-
| <code>KiAttackRelease</code> || O jogador local dispara um ataque de ki carregado. || <code>player</code>
|-
| <code>StrikeAttack</code> || O jogador local inicia um Ataque de Golpe. || <code>player</code>, <code>targetId</code>
|}


== Ler o estado do jogador ==
Obtenha a capability de qualquer <code>Player</code> (um jogador do servidor, ou o jogador local no cliente; o DMZ mantém a cópia do cliente sincronizada):

<syntaxhighlight lang="java">
StatsProvider.get(StatsCapability.INSTANCE, player).ifPresent(data -> {
String race = data.getCharacter().getRaceName();
String activeForm = data.getCharacter().getActiveForm();
float currentKi = data.getResources().getCurrentEnergy();
float maxKi = data.getMaxEnergy();
int level = data.getLevel();
});
</syntaxhighlight>

<code>StatsProvider.get(cap, entity)</code> é um atalho para <code>player.getCapability(StatsCapability.INSTANCE)</code>; os dois retornam um <code>LazyOptional<StatsData></code>. Os getters do DMZ são gerados pelo Lombok em tempo de compilação, então você não precisa do Lombok no seu addon para chamá-los.

Leituras úteis de <code>StatsData</code>:

{| class="wikitable"
! Getter !! Retorna
|-
| <code>getCharacter().getRaceName() / getCharacterClass() / getGender()</code> || Raça, classe e gênero
|-
| <code>getCharacter().getActiveForm() / getActiveFormGroup()</code> || Forma de raça atual (um texto vazio na forma base)
|-
| <code>getCharacter().getActiveStackForm() / getActiveStackFormGroup()</code> || Forma acumulável atual (por exemplo, o nível de Kaioken)
|-
| <code>getStats().getStrength() / getStrikePower() / getResistance() / getVitality() / getKiPower() / getEnergy()</code> || Valores base das estatísticas
|-
| <code>getResources().getCurrentEnergy() / getCurrentStamina() / getCurrentPoise() / getAlignment()</code> || Reservas de recursos atuais e índole
|-
| <code>getMaxHealth() / getMaxEnergy() / getMaxStamina() / getMaxPoise()</code> || Limites de recursos calculados
|-
| <code>getBattlePower() / getMeleeDamage() / getStrikeDamage() / getKiDamage() / getDefense()</code> || Estatísticas de combate calculadas
|-
| <code>getLevel()</code> || Nível de jogador calculado
|-
| <code>getPlayerQuestData()</code> || Progresso de missões (<code>getQuestStatus(questKey)</code>, <code>isQuestAccepted(questKey)</code>, <code>isQuestCompleted(questKey)</code>, <code>isSagaLocked(sagaId)</code>, <code>getTrackedQuestId()</code>, <code>getDifficulty()</code>)
|-
| <code>getSkills()</code> || Níveis de habilidades (<code>hasSkill(name)</code>, <code>getSkillLevel(name)</code>)
|-
| <code>getStatus()</code>, <code>getEffects()</code>, <code>getTechniques()</code>, <code>getBonusStats()</code> || Indicadores de status, efeitos ativos, técnicas de ki e de golpe, modificadores de estatísticas extras
|}

Os cálculos de raça, forma e estatísticas leem a configuração ao vivo toda vez, então os valores sempre refletem a configuração atual do servidor (inclusive depois de <code>/dmzreload</code>).


== Alterar o estado com segurança ==
Os setters de estatísticas do próprio DMZ (por exemplo <code>Stats.setStrength()</code>) publicam primeiro um evento cancelável e só aplicam a mudança se ele não for cancelado:

<syntaxhighlight lang="java">
DMZEvent.StatChangeEvent event = new DMZEvent.StatChangeEvent(player, StatType.STRENGTH, oldValue, newValue);
if (!MinecraftForge.EVENT_BUS.post(event)) {
// apply the change
}
</syntaxhighlight>

No seu addon, prefira '''reagir aos''' eventos (alterando seus campos editáveis ou cancelando-os) a chamar diretamente os setters do DMZ. Nem todo setter valida ou publica um evento (a maioria dos setters de <code>Resources</code>, por exemplo, só limita o valor e o aplica sem evento), então passar pelos eventos é o único ponto de integração com estabilidade garantida.

Se você alterar dados do DMZ a partir do servidor, faça isso na thread do servidor e depois envie ao cliente uma cópia atualizada, do mesmo jeito que o DMZ faz:

<syntaxhighlight lang="java">
NetworkHandler.sendToTrackingEntityAndSelf(new StatsSyncS2C(serverPlayer), serverPlayer);
</syntaxhighlight>

<code>StatsSyncS2C</code> envia todos os dados do jogador; o DMZ também usa <code>ProgressionSyncS2C</code> (estatísticas, estatísticas extras, habilidades, técnicas, dados de missões) e <code>ResourceSyncS2C</code> (recursos e status) para atualizações menores.


== Objetivos e recompensas de missão personalizados ==
{{See also|Custom Quests}}
Os addons podem adicionar novos '''tipos''' de objetivos e recompensas de missões que os arquivos JSON de missões podem usar depois, sem mexer no parser do DMZ. Registre-os durante o setup do mod (por exemplo, em <code>FMLCommonSetupEvent</code>) nos '''dois''' lados: o cliente reconstrói as missões a partir do registro sincronizado com as mesmas fábricas.

<syntaxhighlight lang="java">
QuestObjectiveRegistry.register("MEDITATE",
json -> new MeditateObjective(json.get("seconds").getAsInt()), // parse quest JSON
(objective, out) -> out.addProperty("seconds", ((MeditateObjective) objective).getSeconds()), // client sync fields
objective -> Component.translatable("myaddon.quest.meditate.obj")); // HUD/journal text

QuestRewardRegistry.register("MY_CURRENCY",
json -> new MyCurrencyReward(json.get("amount").getAsInt()),
(reward, out) -> out.addProperty("amount", ((MyCurrencyReward) reward).getAmount()));
</syntaxhighlight>

O contrato:
* As classes de objetivos estendem <code>QuestObjective</code> e chamam o construtor <code>QuestObjective(String customType, int required)</code>; as classes de recompensas estendem <code>QuestReward</code>, chamam <code>QuestReward(String customType)</code> e implementam <code>giveReward(ServerPlayer)</code> e <code>getDescription()</code>. Os objetivos também precisam implementar <code>checkProgress(Object... params)</code>.
* No JSON das missões, use sua chave como <code>"type"</code> (por exemplo <code>{"type": "MEDITATE", "seconds": 60}</code>). As chaves de tipo não diferenciam maiúsculas de minúsculas (são guardadas em maiúsculas). Trate-as como nomes de registro: não as renomeie depois que as missões passarem a usá-las.
* O escritor de sincronização precisa gravar todos os campos que sua fábrica lê, porque o cliente lê de novo o JSON sincronizado com a sua fábrica.
* Tipos desconhecidos são reportados no relatório de carregamento de JSON (veja [[Special:MyLanguage/Developer Scope and Prerequisites#Finding JSON mistakes|Encontrar erros de JSON]]) e o objetivo ou a recompensa é ignorado.
* O progresso é controlado pelo servidor e orientado a eventos: escute seus próprios eventos de jogo no servidor e salve o progresso com <code>PlayerQuestData.setObjectiveProgress(questKey, objectiveIndex, progress)</code>, e depois sincronize com <code>ProgressionSyncS2C</code>. Use <code>DMZEvent.QuestObjectiveProgressEvent</code> e <code>QuestCompletedEvent</code> para reagir às missões incluídas.

Veja [[Special:MyLanguage/Custom Quests|Missões personalizadas]] para o formato JSON das missões.


== Placeholders de texto personalizados ==
Os textos de missões, diálogos e NPCs aceitam <code>%placeholders%</code> como <code>%player%</code>, <code>%race%</code>, <code>%class%</code>, <code>%level%</code>, <code>%alignment%</code>, <code>%deaths%</code>, <code>%form%</code> e <code>%dimension%</code>. Adicione os seus durante o setup do mod:

<syntaxhighlight lang="java">
DMZTextPlaceholders.register("zeni", (player, data) -> String.valueOf(MyAddon.getZeni(player)));
// "%zeni%" in quest/dialogue text now resolves to your value
</syntaxhighlight>

As chaves não diferenciam maiúsculas de minúsculas. O resolvedor roda no lado que renderiza o texto (geralmente o cliente) e precisa lidar com um <code>StatsData</code> <code>null</code>.


== Botões do Menu de Utilidades ==
O Menu de Utilidades (radial) do cliente tem dois slots livres, à esquerda e à direita da roda, reservados para addons. Adicione um botão no setup do cliente:

<syntaxhighlight lang="java">
UtilityMenuScreen.addMenuSlot(new IUtilityMenuSlot() {
@Override
public ButtonInfo render(StatsData statsData) {
return new ButtonInfo(Component.literal("My Addon"), Component.literal("Open"));
}

@Override
public void handle(StatsData statsData, boolean rightClick) {
// client side: open your screen or send your own packet to the server
}
});
</syntaxhighlight>

Os slots são preenchidos na ordem de registro; registros além dos dois slots livres não são mostrados. Sobrescreva <code>hasRightClickAction</code> para retornar <code>true</code> se o seu botão também reagir ao clique direito. <code>IUtilityMenuSlot</code> e <code>ButtonInfo</code> ficam em <code>com.dragonminez.client.gui.utilitymenu</code>.


== Armaduras e camadas de renderização ==
* '''Armaduras do seu addon:''' a classe de item de armadura do DMZ, <code>DbzArmorItem</code> (<code>common/init/armor</code>), tem um construtor <code>DbzArmorItem(material, type, properties, modId, itemId)</code>. Passe seu próprio <code>modId</code> e as texturas são lidas do seu próprio namespace: <code>assets/<modId>/textures/armor/<itemId>_layer1.png</code> (<code>_layer2</code> para as calças), mais as opcionais <code><itemId>_damaged_layer1.png</code> e <code>_damaged_layer2.png</code>, usadas quando o item perde mais da metade da durabilidade.
* '''Outras armaduras:''' os <code>ArmorItem</code> comuns de outros mods são desenhados no modelo de jogador do DMZ com sua textura de armadura normal.
* '''Camadas de renderização de terceiros:''' as camadas de renderização que outros mods adicionam ao renderizador de jogador vanilla são repassadas para o modelo de jogador do DMZ. As camadas vanilla e as camadas de armaduras cosméticas são ignoradas, e nada é repassado enquanto o jogador é um Grande Macaco.


== Rede ==
O canal do DMZ é <code>NetworkHandler.INSTANCE</code> (um <code>SimpleChannel</code> do Forge em <code>dragonminez:network</code>). Não registre seus próprios pacotes nele: o DMZ atribui os ids de pacote pela ordem de registro, então qualquer coisa que você adicionar deslocaria os ids do DMZ ou colidiria com eles. Em vez disso, registre seu próprio <code>SimpleChannel</code> no seu addon e use o do DMZ como referência do padrão (<code>messageBuilder</code>, codificador, decodificador e handler, com uma direção explícita).

Você pode usar os helpers de envio do DMZ (<code>sendToPlayer</code>, <code>sendToTrackingEntityAndSelf</code>, ...) para enviar os pacotes de sincronização do próprio DMZ, como mostrado acima.

Também nunca confie no cliente nos seus próprios pacotes: valide no servidor tudo o que afeta estatísticas, desbloqueios, missões, desejos ou progresso.

Não existe um evento de "dados sincronizados" no lado do cliente. No cliente, leia a capability quando precisar dela (por exemplo, durante a renderização) em vez de tentar interceptar os pacotes do DMZ.


== Usar os registros do DMZ ==
Importe diretamente os contêineres de registro <code>Main*</code> em vez de escrever as resource locations à mão:

<syntaxhighlight lang="java">
import com.dragonminez.common.init.MainItems;
import com.dragonminez.common.init.MainAttributes;

Item redCapsule = MainItems.RED_CAPSULE.get();
Attribute strength = MainAttributes.STRENGTH.get();
</syntaxhighlight>

Disponíveis em <code>common/init/</code>: <code>MainItems</code>, <code>MainBlocks</code>, <code>MainBlockEntities</code>, <code>MainEntities</code>, <code>MainAttributes</code>, <code>MainEffects</code>, <code>MainEnchants</code>, <code>MainPotions</code>, <code>MainSounds</code>, <code>MainParticles</code>, <code>MainFluids</code>, <code>MainMenus</code>, <code>MainRecipes</code>, <code>MainTabs</code>, <code>MainTags</code>, <code>MainVillagers</code>, <code>MainDamageTypes</code>, <code>MainGameRules</code>, <code>MainLootModifiers</code>.


== Padrão de dependência opcional ==
Se o seu addon precisa funcionar com ou sem o DMZ instalado, siga o padrão que o próprio DMZ usa nas integrações opcionais (<code>common/compat/WeaponLevelingCompat.java</code>):

<syntaxhighlight lang="java">
public final class DmzCompat {
private static Boolean loaded;

public static boolean isLoaded() {
if (loaded == null) loaded = ModList.get().isLoaded("dragonminez");
return loaded;
}

public static int getLevel(Player player) {
if (!isLoaded()) return 0; // safe fallback without DMZ
return Impl.getLevel(player);
}

// Only this nested class imports DMZ classes, so it is never loaded without DMZ.
private static final class Impl {
static int getLevel(Player player) {
return StatsProvider.get(StatsCapability.INSTANCE, player).map(StatsData::getLevel).orElse(0);
}
}
}
</syntaxhighlight>

# Verifique <code>ModList.get().isLoaded("dragonminez")</code> uma única vez e guarde o resultado em cache.
# Mantenha todos os imports do DMZ dentro de classes que só são usadas depois dessa verificação (incluindo os listeners de eventos do DMZ: registre-os manualmente e só quando o DMZ estiver carregado).
# Proteja com essa flag toda chamada que mexa no DMZ, com um comportamento alternativo seguro ou um valor padrão quando ela for <code>false</code>.
# Registre no log uma mensagem clara de informação ou de aviso em qualquer caso, para que os donos de servidores vejam de relance se a integração está ativa.


== Próximo passo ==
Veja [[Special:MyLanguage/Creating a DMZ Addon|Criar um addon de DMZ]] para a configuração completa do projeto Gradle e a declaração da dependência no <code>mods.toml</code>.

{{Navbox Add-ons}}

Implementation and Events/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository