Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-13T23:47:57Z

Translation sync from dragonminez-wiki repository

Nova página

'''Criar um addon de DMZ''' guia você passo a passo por um addon de Forge completo que se integra ao DragonMineZ: o jar do seu próprio mod, que depende do DMZ e pode reagir aos seus eventos e dados. Leia primeiro [[Special:MyLanguage/Add-on Getting Started|Primeiros passos com addons]] para conhecer as ferramentas e versões necessárias.


== Passo 1: Crie um projeto Forge 1.20.1 ==
Comece pelo MDK do Forge para Minecraft <code>1.20.1</code> com Forge <code>47.4.10</code>, ForgeGradle <code>6.0.30</code> e Java <code>17</code>, iguais aos do DMZ.

Estes arquivos do repositório do DMZ são boas referências para a estrutura e a configuração do seu projeto:
* <code>gradle.properties</code>
* <code>build.gradle.kts</code>
* <code>src/main/resources/META-INF/mods.toml</code>


== Passo 2: Configure o Gradle ==
O DMZ usa a DSL do Gradle em Kotlin (<code>build.gradle.kts</code>), mas no seu addon você pode usar Gradle com Groovy ou qualquer outra configuração que preferir. Só garanta que as versões do Forge e do Java sejam as mesmas. Um exemplo 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>


== Passo 3: Declare a dependência do DMZ ==
No <code>mods.toml</code> do seu addon, adicione uma entrada de dependência 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>

Defina <code>mandatory</code> como <code>false</code> se o seu addon também funcionar sem o DMZ (veja [[Special:MyLanguage/Implementation and Events#Optional dependency pattern|Padrão de dependência opcional]]). O <code>mods.toml</code> do DMZ usa <code>displayTest = "MATCH_VERSION"</code>, então de qualquer forma o cliente e o servidor precisam rodar a mesma versão do DMZ.


== Passo 4: Adicione o DMZ ao classpath de compilação ==
O build do DMZ não publica um artefato Maven, então use um jar local durante o desenvolvimento:
# Baixe a versão do DMZ que você quer usar ou compile você mesmo com <code>./gradlew build</code> no repositório do DMZ.
# Use o jar '''sem classificador''' (<code>dragonminez-<version>.jar</code>): ele inclui as bibliotecas de banco de dados do DMZ. O jar <code>-slim</code> não é feito para ser usado.
# Coloque-o na pasta <code>libs/</code> do seu projeto e referencie-o com <code>fg.deobf(...)</code> como mostrado acima, para que o ForgeGradle o remapeie para os seus mappings de desenvolvimento.
Use <code>compileOnly</code> em vez de <code>implementation</code> se você só quer compilar contra o DMZ e rodá-lo em uma instância separada.


== Passo 5: Escute os eventos do DMZ ==
O DMZ publica seus eventos de Forge de servidor e comuns como classes aninhadas de <code>com.dragonminez.common.events.DMZEvent</code>, e seus eventos de cliente como classes aninhadas de <code>com.dragonminez.client.events.DMZClientEvent</code>. Por exemplo:

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

Os arquivos-fonte dos eventos são <code>src/main/java/com/dragonminez/common/events/DMZEvent.java</code> e <code>src/main/java/com/dragonminez/client/events/DMZClientEvent.java</code>. A lista completa, junto com os registros de objetivos e recompensas de missões, os placeholders de texto e os slots do Menu de Utilidades, está em [[Special:MyLanguage/Implementation and Events|Implementação e eventos]].


== Estrutura sugerida do 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>


== Checklist do primeiro marco ==
# O addon carrega sem crashar no cliente de desenvolvimento.
# O DMZ é detectado quando está presente.
# Um evento do DMZ é recebido nos logs.
# Uma mudança de comportamento fica visível no jogo.


== Recomendações de compatibilidade ==
* Proteja os trechos de código que só funcionam com o DMZ com verificações de presença do mod.
* Registre avisos claros no log quando o DMZ estiver ausente ou sua versão for incompatível.
* Não inclua nem dependa de Legendary Tooltips, Epic Fight ou Better Combat: o DMZ se recusa a iniciar junto com eles.
* Use seu próprio canal de rede e nunca confie no que o cliente envia para o progresso (veja [[Special:MyLanguage/Implementation and Events#Networking|Rede]]).

{{Navbox Add-ons}}

Creating a DMZ Addon/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository