Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T06:50:22Z

Translation sync from dragonminez-wiki repository

Nova página

'''Implementación y eventos''' describe la superficie de hooks que DragonMineZ ofrece a los addons: sus eventos, cómo leer el estado del jugador, los registros de extensión y dónde conectar tu propia red y tus propios registros. Léela cuando tu addon ya compile contra DMZ (consulta [[Special:MyLanguage/Add-on Getting Started|Primeros pasos con addons]]).


== Escuchar un evento de DMZ ==
Todos los eventos de servidor y comunes son clases estáticas anidadas de <code>com.dragonminez.common.events.DMZEvent</code>, publicadas en el bus de eventos estándar de Forge (<code>MinecraftForge.EVENT_BUS</code>). Cada clase anidada extiende directamente el <code>Event</code> de Forge (<code>DMZEvent</code> en sí solo es el contenedor), así que suscríbete a la clase anidada concreta:

<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>

Los eventos marcados abajo como '''cancelables''' llevan la anotación <code>@Cancelable</code> de Forge: <code>event.setCanceled(true)</code> bloquea la acción subyacente. Los campos marcados como ''modificables'' tienen un setter (<code>setTpGain</code>, <code>setAmount</code>, ...), y DMZ usa el valor resultante después de que se ejecuten todos los listeners. Todos los getters siguen los nombres de los campos (<code>getPlayer()</code>, <code>getOldValue()</code>, ...); los campos booleanos usan <code>is...</code> (<code>isParry()</code>, <code>isBlocked()</code>).


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


=== Estadísticas, recursos y progreso ===

{| class="wikitable"
! Evento !! Cancelable !! Se dispara cuando !! Campos clave
|-
| <code>StatChangeEvent</code> || Sí || Una estadística (STR, SKP, RES, VIT, PWR o ENE) cambia mediante una llamada a <code>Stats.set*()</code>: comandos, objetos, menús, y también cuando se cargan o copian las estadísticas (tanto en el servidor como en el cliente). || <code>player</code>, <code>stat</code> (<code>STRENGTH</code>, <code>STRIKE_POWER</code>, <code>RESISTANCE</code>, <code>VITALITY</code>, <code>KI_POWER</code> o <code>ENERGY</code>), <code>oldValue</code>, <code>newValue</code>
|-
| <code>TPGainEvent</code> || Sí || Antes de que se añada una cantidad positiva de puntos de entrenamiento (<code>Resources.addTrainingPoints</code>). || <code>player</code>, <code>oldValue</code>, <code>tpGain</code> (modificable), <code>shareWithParty</code> (modificable); auxiliar <code>getNewTpsValue()</code>
|-
| <code>KiChargeEvent</code> || Sí || Una vez por segundo mientras el jugador está cargando ki activamente. Cancélalo para detener la ganancia de ki de ese segundo. || <code>player</code>, <code>currentEnergy</code>, <code>maxEnergy</code>; auxiliar <code>isEnergyFull()</code>
|-
| <code>HealthRegenEvent</code> / <code>EnergyRegenEvent</code> / <code>StaminaRegenEvent</code> || Sí || Antes de aplicar la regeneración por segundo de vida, ki o stamina. Comparten la base <code>ResourceRegenEvent</code>. || <code>player</code>, <code>statsData</code>, <code>amount</code> (modificable)
|-
| <code>FormChangeEvent</code> / <code>StackFormChangeEvent</code> || No || Después de que cambie la forma de raza o la forma acumulable del jugador (lado del servidor). || <code>player</code>, <code>oldGroup</code>, <code>oldForm</code>, <code>newGroup</code>, <code>newForm</code>; auxiliares <code>isTransform()</code> y <code>isUntransform()</code>
|-
| <code>PlayerDataSaveEvent</code> || No || Los datos del jugador están a punto de escribirse en el backend de almacenamiento <code>JSON</code> o <code>DATABASE</code>. Puedes añadir tus propias claves a <code>data</code>. || <code>player</code>, <code>data</code>
|-
| <code>PlayerDataLoadEvent</code> || No || Los datos del jugador se leyeron del backend <code>JSON</code> o <code>DATABASE</code>, justo antes de aplicarse al jugador. || <code>player</code>, <code>data</code>
|}

{{Note|title=StatChangeEvent y la carga de datos|text=<code>StatChangeEvent</code> también se dispara mientras DMZ carga los datos guardados y aplica las sincronizaciones del cliente. Si lo cancelas, comprueba antes <code>event.getPlayer().level().isClientSide()</code> y tus propias condiciones, o podrías impedir que se carguen las estadísticas guardadas de un jugador.}}

{{Note|title=Backends de almacenamiento|text=<code>PlayerDataSaveEvent</code> y <code>PlayerDataLoadEvent</code> no se disparan con el backend <code>NBT</code> por defecto, en el que vanilla guarda los datos de DMZ junto con el archivo del jugador. Consulta [[Special:MyLanguage/General Server Config|Configuración del servidor]] para ver los ajustes de <code>storage</code>.}}


=== Combate ===

{| class="wikitable"
! Evento !! Cancelable !! Se dispara cuando !! Campos clave
|-
| <code>DamageModifyEvent</code> || Sí || Cálculo del daño antes de la mitigación, para un golpe de un jugador (golpes cuerpo a cuerpo y Super Golpes). Cancélalo para no hacer daño de DMZ. || <code>attacker</code>, <code>victim</code>, <code>amount</code> (modificable), <code>defensePenetration</code> (modificable), <code>sourceType</code> (<code>MELEE</code> o <code>STRIKE</code>)
|-
| <code>DamageDealtEvent</code> || No || Después de resolver el bloqueo de un golpe cuerpo a cuerpo de un jugador (cantidad antes de la mitigación). || <code>attacker</code>, <code>victim</code>, <code>amount</code>, <code>blocked</code>, <code>parried</code>, <code>sourceType</code>
|-
| <code>PlayerDamageMitigatedEvent</code> || No || Después de que DMZ termine de mitigar un golpe recibido por un jugador. Solo lectura: no cambies el daño aquí. || <code>victim</code>, <code>source</code> (<code>DamageSource</code>), <code>rawDamage</code>, <code>defenseMitigated</code>, <code>blockMitigated</code>, <code>finalDamage</code>
|-
| <code>PlayerBlockEvent</code> || Sí || El jugador bloquea o hace parry a un ataque con éxito. Cancélalo y el jugador recibe el golpe completo. || <code>victim</code>, <code>attacker</code>, <code>originalDamage</code>, <code>finalDamage</code> (modificable), <code>isParry</code> (modificable), <code>poiseDamage</code> (modificable)
|-
| <code>BarrierAbsorbEvent</code> || No || Una barrera de ki (la técnica de barrera o la barrera de los Androides) absorbe un golpe antes de que llegue a la entidad protegida. || <code>owner</code> (quien creó la barrera), <code>protectedEntity</code>, <code>attacker</code>, <code>amount</code>
|-
| <code>PlayerDashEvent</code> || Sí || Antes de que se ejecute un dash. || <code>player</code>, <code>dashType</code> (<code>NORMAL</code> o <code>DOUBLE</code>), <code>distance</code> (modificable), <code>kiCost</code> (modificable)
|-
| <code>PlayerEvasionEvent</code> || Sí || Antes de que se active una evasión. || <code>player</code>, <code>attacker</code>, <code>originalDamage</code>, <code>kiCost</code> (modificable)
|-
| <code>CritChanceEvent</code> || No || Mientras se calcula la probabilidad crítica de un jugador. || <code>player</code>, <code>chance</code> (modificable, de 0 a 1)
|-
| <code>KiAttackCastEvent</code> || No || Un jugador empieza a cargar (lanza) un ataque de ki. || <code>player</code>, <code>statsData</code>, <code>kiAttack</code>
|-
| <code>KiAttackFireEvent</code> || No || Se suelta un ataque de ki cargado. || <code>player</code>, <code>statsData</code>, <code>kiAttack</code>, <code>chargeMultiplier</code>, <code>cooldownTicks</code> (modificable, mínimo 1)
|-
| <code>StrikeAttackCastEvent</code> || No || Un jugador inicia un Super Golpe. || <code>player</code>, <code>statsData</code>, <code>strike</code>
|-
| <code>StrikeAttackFireEvent</code> || No || Un Super Golpe conecta y empieza sobre un objetivo. || <code>player</code>, <code>statsData</code>, <code>strike</code>, <code>target</code>
|}

<code>DamageSourceType</code> también contiene un valor <code>KI</code>; en la v2.2, los ataques de ki no publican <code>DamageModifyEvent</code> ni <code>DamageDealtEvent</code>.


=== Fusiones y dragones ===

{| class="wikitable"
! Evento !! Cancelable !! Se dispara cuando !! Campos clave
|-
| <code>FusionEvent</code> || Sí || Antes de un intento de fusión. DMZ lo publica para las fusiones <code>METAMORU</code>, <code>POTHALA</code> y <code>BEETLE</code> (Escarabajo Medi-Bug); el enum también contiene <code>ABSORPTION</code> y <code>ASSIMILATION</code>. || <code>initiator</code>, <code>target</code>, <code>type</code>
|-
| <code>DragonSummonedEvent</code> || No || Después de invocar un dragón con un 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> y <code>getBallSetId()</code>
|}

Consulta [[Special:MyLanguage/Fusions|Fusiones]] y [[Special:MyLanguage/Dragons and Wishes|Dragones y deseos]] para ver la parte de jugabilidad.


=== Misiones ===
Todos los eventos de misiones extienden <code>QuestLifecycleEvent</code> y comparten sus campos: <code>player</code>, <code>questKey</code> (<code>sagaId:questId</code> para las misiones de saga, el id de texto para las misiones secundarias), <code>saga</code> (null para las misiones secundarias), <code>quest</code> y <code>partyMembers</code>.

{| class="wikitable"
! Evento !! Cancelable !! Se dispara cuando !! Campos extra
|-
| <code>QuestStartEvent</code> || Sí || Antes de aceptar una misión. || <code>difficulty</code> (modificable)
|-
| <code>QuestObjectiveProgressEvent</code> || Sí || Antes de guardar el progreso de un objetivo. || <code>objectiveIndex</code>, <code>oldProgress</code>, <code>newProgress</code> (modificable), <code>objectiveRequired</code>
|-
| <code>QuestFailEvent</code> || Sí || Antes de marcar una misión como fallida. || <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> || Sí || Antes de aplicar la entrega de una misión. || <code>npcId</code>
|-
| <code>QuestRewardClaimEvent</code> || Sí || Antes de reclamar una recompensa individual. || <code>rewardIndex</code>
|-
| <code>QuestCompletedEvent</code> || No || Cuando se completa una misión. || Solo los campos compartidos
|}


=== Eventos de cliente ===
Los eventos solo de cliente están en <code>com.dragonminez.client.events.DMZClientEvent</code> y se publican en el bus de Forge del cliente físico. Registra estos listeners con <code>value = Dist.CLIENT</code>. Ninguno es cancelable y son solo informativos: el servidor sigue decidiendo lo que realmente ocurre.

{| class="wikitable"
! Evento !! Se dispara cuando !! Campos clave
|-
| <code>PlayerAttackStart</code> || El jugador local empieza la preparación del ataque. || <code>player</code>, <code>attackHand</code>
|-
| <code>PlayerAttackHit</code> || El ataque del jugador local resuelve sus objetivos (cero o más). || <code>player</code>, <code>attackHand</code>, <code>targets</code>, <code>cursorTarget</code> (puede ser null)
|-
| <code>KiAttackCast</code> || El jugador local empieza a cargar el ataque de ki de una ranura. || <code>player</code>, <code>slot</code>
|-
| <code>KiAttackRelease</code> || El jugador local suelta un ataque de ki cargado. || <code>player</code>
|-
| <code>StrikeAttack</code> || El jugador local inicia un Super Golpe. || <code>player</code>, <code>targetId</code>
|}


== Leer el estado del jugador ==
Obtén la capability de cualquier <code>Player</code> (un jugador del servidor, o el jugador local en el cliente; DMZ mantiene sincronizada la copia del cliente):

<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> es un atajo de <code>player.getCapability(StatsCapability.INSTANCE)</code>; ambos devuelven un <code>LazyOptional<StatsData></code>. Lombok genera los getters de DMZ en tiempo de compilación, así que no necesitas Lombok en tu addon para llamarlos.

Lecturas útiles de <code>StatsData</code>:

{| class="wikitable"
! Getter !! Devuelve
|-
| <code>getCharacter().getRaceName() / getCharacterClass() / getGender()</code> || Raza, clase y género
|-
| <code>getCharacter().getActiveForm() / getActiveFormGroup()</code> || Forma de raza actual (un texto vacío en la forma base)
|-
| <code>getCharacter().getActiveStackForm() / getActiveStackFormGroup()</code> || Forma acumulable actual (por ejemplo, el nivel de Kaioken)
|-
| <code>getStats().getStrength() / getStrikePower() / getResistance() / getVitality() / getKiPower() / getEnergy()</code> || Valores base de las estadísticas
|-
| <code>getResources().getCurrentEnergy() / getCurrentStamina() / getCurrentPoise() / getAlignment()</code> || Reservas de recursos actuales y alineamiento
|-
| <code>getMaxHealth() / getMaxEnergy() / getMaxStamina() / getMaxPoise()</code> || Topes de recursos calculados
|-
| <code>getBattlePower() / getMeleeDamage() / getStrikeDamage() / getKiDamage() / getDefense()</code> || Estadísticas de combate calculadas
|-
| <code>getLevel()</code> || Nivel de jugador calculado
|-
| <code>getPlayerQuestData()</code> || Progreso de misiones (<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> || Niveles de habilidades (<code>hasSkill(name)</code>, <code>getSkillLevel(name)</code>)
|-
| <code>getStatus()</code>, <code>getEffects()</code>, <code>getTechniques()</code>, <code>getBonusStats()</code> || Indicadores de estado, efectos activos, técnicas de ki y de golpe, modificadores de estadísticas extra
|}

Los cálculos de raza, forma y estadísticas leen la configuración en vivo cada vez, así que los valores siempre reflejan la configuración actual del servidor (también después de <code>/dmzreload</code>).


== Cambiar el estado de forma segura ==
Los setters de estadísticas propios de DMZ (por ejemplo <code>Stats.setStrength()</code>) publican primero un evento cancelable y solo aplican el cambio si no se canceló:

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

En tu addon, es preferible '''reaccionar a''' los eventos (cambiando sus campos modificables o cancelándolos) que llamar directamente a los setters de DMZ. No todos los setters validan o publican un evento (la mayoría de los setters de <code>Resources</code>, por ejemplo, solo limitan el valor y lo aplican sin evento), así que pasar por los eventos es el único punto de integración garantizado que se mantendrá estable.

Si cambias datos de DMZ desde el servidor, hazlo en el hilo del servidor y después envía al cliente una copia actualizada, igual que hace DMZ:

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

<code>StatsSyncS2C</code> envía todos los datos del jugador; DMZ también usa <code>ProgressionSyncS2C</code> (estadísticas, estadísticas extra, habilidades, técnicas, datos de misiones) y <code>ResourceSyncS2C</code> (recursos y estado) para actualizaciones más pequeñas.


== Objetivos y recompensas de misión personalizados ==
{{See also|Custom Quests}}
Los addons pueden añadir nuevos '''tipos''' de objetivos y recompensas de misiones que luego pueden usar los archivos JSON de misiones, sin tocar el parser de DMZ. Regístralos durante la configuración del mod (por ejemplo, en <code>FMLCommonSetupEvent</code>) en '''ambos''' lados: el cliente reconstruye las misiones a partir del registro sincronizado con las mismas 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>

El contrato:
* Las clases de objetivos extienden <code>QuestObjective</code> y llaman al constructor <code>QuestObjective(String customType, int required)</code>; las clases de recompensas extienden <code>QuestReward</code>, llaman a <code>QuestReward(String customType)</code> e implementan <code>giveReward(ServerPlayer)</code> y <code>getDescription()</code>. Los objetivos también deben implementar <code>checkProgress(Object... params)</code>.
* En el JSON de las misiones, usa tu clave como <code>"type"</code> (por ejemplo <code>{"type": "MEDITATE", "seconds": 60}</code>). Las claves de tipo no distinguen mayúsculas de minúsculas (se guardan en mayúsculas). Trátalas como nombres de registro: no las renombres una vez que las misiones las usen.
* El escritor de sincronización debe escribir todos los campos que lee tu fábrica, porque el cliente vuelve a analizar el JSON sincronizado con tu fábrica.
* Los tipos desconocidos se informan en el reporte de carga de JSON (consulta [[Special:MyLanguage/Developer Scope and Prerequisites#Finding JSON mistakes|Encontrar errores de JSON]]) y el objetivo o la recompensa se omite.
* El progreso lo controla el servidor y se basa en eventos: escucha tus propios eventos de juego en el servidor y guarda el progreso con <code>PlayerQuestData.setObjectiveProgress(questKey, objectiveIndex, progress)</code>, y luego sincroniza con <code>ProgressionSyncS2C</code>. Usa <code>DMZEvent.QuestObjectiveProgressEvent</code> y <code>QuestCompletedEvent</code> para reaccionar a las misiones incluidas.

Consulta [[Special:MyLanguage/Custom Quests|Misiones personalizadas]] para ver el formato JSON de las misiones.


== Placeholders de texto personalizados ==
Los textos de misiones, diálogos y NPCs admiten <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> y <code>%dimension%</code>. Añade los tuyos durante la configuración del 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>

Las claves no distinguen mayúsculas de minúsculas. El resolvedor se ejecuta en el lado que renderiza el texto (normalmente el cliente) y debe manejar un <code>StatsData</code> <code>null</code>.


== Botones del menú de utilidades ==
El menú de utilidades (radial) del cliente tiene dos ranuras libres, a la izquierda y a la derecha de la rueda, reservadas para addons. Añade un botón desde la configuración del 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>

Las ranuras se llenan en orden de registro; los registros que superen las dos ranuras libres no se muestran. Sobrescribe <code>hasRightClickAction</code> para que devuelva <code>true</code> si tu botón también reacciona al clic derecho. <code>IUtilityMenuSlot</code> y <code>ButtonInfo</code> están en <code>com.dragonminez.client.gui.utilitymenu</code>.


== Armaduras y capas de renderizado ==
* '''Armaduras de tu addon:''' la clase de objeto de armadura de DMZ, <code>DbzArmorItem</code> (<code>common/init/armor</code>), tiene un constructor <code>DbzArmorItem(material, type, properties, modId, itemId)</code>. Pasa tu propio <code>modId</code> y las texturas se leen de tu propio namespace: <code>assets/<modId>/textures/armor/<itemId>_layer1.png</code> (<code>_layer2</code> para las grebas), más las opcionales <code><itemId>_damaged_layer1.png</code> y <code>_damaged_layer2.png</code>, que se usan cuando el objeto ha perdido más de la mitad de su durabilidad.
* '''Otras armaduras:''' los <code>ArmorItem</code> normales de otros mods se dibujan sobre el modelo de jugador de DMZ con su textura de armadura habitual.
* '''Capas de renderizado de terceros:''' las capas de renderizado que otros mods añaden al renderizador de jugador vanilla se trasladan al modelo de jugador de DMZ. Se omiten las capas vanilla y las capas de armaduras cosméticas, y no se traslada nada mientras el jugador es un Oozaru.


== Red ==
El canal de DMZ es <code>NetworkHandler.INSTANCE</code> (un <code>SimpleChannel</code> de Forge en <code>dragonminez:network</code>). No registres tus propios paquetes en él: DMZ asigna los ids de paquete por orden de registro, así que cualquier cosa que añadas desplazaría los ids de DMZ o chocaría con ellos. En su lugar, registra tu propio <code>SimpleChannel</code> en tu addon y usa el de DMZ como referencia del patrón (<code>messageBuilder</code>, codificador, decodificador y manejador, con una dirección explícita).

Puedes usar los helpers de envío de DMZ (<code>sendToPlayer</code>, <code>sendToTrackingEntityAndSelf</code>, ...) para enviar los paquetes de sincronización propios de DMZ, como se muestra arriba.

Tampoco confíes nunca en el cliente en tus propios paquetes: valida en el servidor todo lo que afecte a estadísticas, desbloqueos, misiones, deseos o progreso.

No existe un evento de "datos sincronizados" en el lado del cliente. En el cliente, lee la capability cuando la necesites (por ejemplo, al renderizar) en lugar de intentar interceptar los paquetes de DMZ.


== Usar los registros de DMZ ==
Importa directamente los contenedores de registro <code>Main*</code> en lugar de escribir a mano las resource locations:

<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>

Disponibles en <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>.


== Patrón de dependencia opcional ==
Si tu addon debe funcionar con o sin DMZ instalado, sigue el patrón que usa DMZ para sus propias integraciones opcionales (<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>

# Comprueba <code>ModList.get().isLoaded("dragonminez")</code> una sola vez y guarda el resultado en caché.
# Mantén todos los imports de DMZ dentro de clases que solo se tocan después de esa comprobación (incluidos los listeners de eventos de DMZ: regístralos a mano y solo cuando DMZ esté cargado).
# Protege con ese indicador toda llamada que toque DMZ, con un comportamiento alternativo seguro o un valor por defecto cuando sea <code>false</code>.
# Registra en el log un mensaje claro de información o de advertencia en ambos casos, para que los dueños de servidores vean de un vistazo si la integración está activa.


== Siguiente paso ==
Consulta [[Special:MyLanguage/Creating a DMZ Addon|Crear un addon de DMZ]] para la configuración completa del proyecto de Gradle y la declaración de la dependencia en <code>mods.toml</code>.

{{Navbox Add-ons}}

Implementation and Events/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository