Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-13T23:47:13Z

Translation sync from dragonminez-wiki repository

New page

'''Crear un addon de DMZ''' te guía paso a paso por un addon de Forge completo que se integra con DragonMineZ: el jar de tu propio mod, que depende de DMZ y puede reaccionar a sus eventos y datos. Lee primero [[Special:MyLanguage/Add-on Getting Started|Primeros pasos con addons]] para conocer las herramientas y versiones necesarias.


== Paso 1: Crea un proyecto de Forge 1.20.1 ==
Parte del MDK de Forge para Minecraft <code>1.20.1</code> con Forge <code>47.4.10</code>, ForgeGradle <code>6.0.30</code> y Java <code>17</code>, igual que DMZ.

Estos archivos del repositorio de DMZ son buenas referencias para la estructura y la configuración de tu proyecto:
* <code>gradle.properties</code>
* <code>build.gradle.kts</code>
* <code>src/main/resources/META-INF/mods.toml</code>


== Paso 2: Configura Gradle ==
DMZ usa el DSL de Gradle en Kotlin (<code>build.gradle.kts</code>), pero para tu addon puedes usar Gradle con Groovy o cualquier otra configuración que prefieras. Solo asegúrate de que las versiones de Forge y Java coincidan. Un ejemplo de <code>build.gradle.kts</code>:

<syntaxhighlight lang="kotlin">
plugins {
java
idea
id("net.minecraftforge.gradle") version "6.0.30"
id("org.parchmentmc.librarian.forgegradle") version "1.+"
id("org.spongepowered.mixin") version "0.7.38"
}

repositories {
maven("https://dl.cloudsmith.io/public/geckolib3/geckolib/maven/") // GeckoLib
maven("https://maven.blamejared.com/") // TerraBlender
maven("https://maven.theillusivec4.top/") // Curios
flatDir { dirs("libs") } // local DMZ jar
mavenCentral()
}

minecraft {
mappings("parchment", "2023.09.03-1.20.1")
runs {
configureEach {
workingDirectory(project.file("run"))
// DMZ ships mixins: let the dev runtime remap their refmap
property("mixin.env.remapRefMap", "true")
property("mixin.env.refMapRemappingFile", "${projectDir}/build/createSrgToMcp/output.srg")
}
create("client")
create("server")
}
}

dependencies {
minecraft("net.minecraftforge:forge:1.20.1-47.4.10")
annotationProcessor("org.spongepowered:mixin:0.8.7:processor")

// DMZ's mandatory dependencies: GeckoLib, TerraBlender & Curios
implementation(fg.deobf("software.bernie.geckolib:geckolib-forge-1.20.1:4.8.3"))
implementation("com.eliotlash.mclib:mclib:20")
implementation(fg.deobf("com.github.glitchfiend:TerraBlender-forge:1.20.1-3.0.1.10"))
compileOnly(fg.deobf("top.theillusivec4.curios:curios-forge:5.14.1+1.20.1:api"))
runtimeOnly(fg.deobf("top.theillusivec4.curios:curios-forge:5.14.1+1.20.1"))

// DragonMineZ itself (libs/dragonminez-2.2-alpha.jar)
implementation(fg.deobf("local:dragonminez:2.2-alpha"))
}
</syntaxhighlight>


== Paso 3: Declara la dependencia de DMZ ==
En el <code>mods.toml</code> de tu addon, añade una entrada de dependencia para <code>dragonminez</code>:

<syntaxhighlight lang="toml">
[[dependencies.your_addon_modid]]
modId="dragonminez"
mandatory=true # false if your addon also works without DMZ
versionRange="[2.2-alpha]" # Only allow the DMZ version you built against to avoid compatibility issues.
ordering="AFTER"
side="BOTH" # Choose between "CLIENT", "SERVER", or "BOTH" based on your addon needs.
</syntaxhighlight>

Pon <code>mandatory</code> en <code>false</code> si tu addon también funciona sin DMZ (consulta [[Special:MyLanguage/Implementation and Events#Optional dependency pattern|Patrón de dependencia opcional]]). El <code>mods.toml</code> de DMZ usa <code>displayTest = "MATCH_VERSION"</code>, así que de todos modos el cliente y el servidor deben usar la misma versión de DMZ.


== Paso 4: Añade DMZ al classpath de compilación ==
La compilación de DMZ no publica un artefacto de Maven, así que usa un jar local durante el desarrollo:
# Descarga la versión de DMZ a la que apuntas o compílala tú mismo con <code>./gradlew build</code> en el repositorio de DMZ.
# Usa el jar '''sin clasificador''' (<code>dragonminez-<version>.jar</code>): incluye las librerías de base de datos de DMZ. El jar <code>-slim</code> no está pensado para usarse.
# Ponlo en la carpeta <code>libs/</code> de tu proyecto y referéncialo con <code>fg.deobf(...)</code> como se muestra arriba, para que ForgeGradle lo remapee a tus mappings de desarrollo.
Usa <code>compileOnly</code> en lugar de <code>implementation</code> si solo quieres compilar contra DMZ y ejecutarlo desde una instancia aparte.


== Paso 5: Escucha los eventos de DMZ ==
DMZ publica sus eventos de Forge de servidor y comunes como clases anidadas de <code>com.dragonminez.common.events.DMZEvent</code>, y sus eventos de cliente como clases anidadas de <code>com.dragonminez.client.events.DMZClientEvent</code>. Por ejemplo:

<syntaxhighlight lang="java">
@Mod.EventBusSubscriber(modid = "your_addon_modid", bus = Mod.EventBusSubscriber.Bus.FORGE)
public class DmzHooks {
@SubscribeEvent
public static void onTpGain(com.dragonminez.common.events.DMZEvent.TPGainEvent event) {
// Example: increase TP gain by 10%
int boosted = Math.round(event.getTpGain() * 1.10f);
event.setTpGain(boosted);
}
}
</syntaxhighlight>

Los archivos fuente de los eventos son <code>src/main/java/com/dragonminez/common/events/DMZEvent.java</code> y <code>src/main/java/com/dragonminez/client/events/DMZClientEvent.java</code>. La lista completa, junto con los registros de objetivos y recompensas de misiones, los placeholders de texto y las ranuras del menú de utilidades, está en [[Special:MyLanguage/Implementation and Events|Implementación y eventos]].


== Estructura sugerida del addon ==
* <code>your/addon/MainModClass.java</code>
* <code>your/addon/event/DmzHooks.java</code>
* <code>src/main/resources/META-INF/mods.toml</code>
* <code>src/main/resources/pack.mcmeta</code>


== Lista de comprobación del primer hito ==
# El addon carga sin crashear en el cliente de desarrollo.
# DMZ se detecta cuando está presente.
# Se recibe un evento de DMZ en los logs.
# Se ve un cambio de comportamiento en el juego.


== Recomendaciones de compatibilidad ==
* Protege las partes del código que solo funcionan con DMZ con comprobaciones de presencia del mod.
* Registra advertencias claras en el log cuando falte DMZ o su versión sea incompatible.
* No incluyas ni dependas de Legendary Tooltips, Epic Fight o Better Combat: DMZ se niega a iniciar junto a ellos.
* Usa tu propio canal de red y nunca confíes en lo que envía el cliente para el progreso (consulta [[Special:MyLanguage/Implementation and Events#Networking|Red]]).

{{Navbox Add-ons}}

Creating a DMZ Addon/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository