Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-13T22:26:26Z

Translation sync from dragonminez-wiki repository

Página nueva

'''Primeiros passos com addons''' explica o que você precisa ter pronto ''antes'' de conectar seu próprio mod de Forge ao DragonMineZ: as versões das ferramentas, os mods que você deve evitar e as partes do DMZ em que um addon pode confiar com segurança. Leia antes de [[Special:MyLanguage/Creating a DMZ Addon|Criar um addon de DMZ]].


== Para quem é ==
Estas páginas são para desenvolvedores de addons de Forge que querem que o jar do seu mod reaja ao DMZ: conceder TP extra, escutar mudanças de forma, adicionar novos tipos de objetivos e recompensas de missões, adicionar botões ao Menu de Utilidades e assim por diante. Se você só quer ajustar números ou adicionar raças, formas, missões ou desejos, não precisa de nada disso; veja [[Special:MyLanguage/Developer Scope and Prerequisites|Escopo e pré-requisitos]].

O DMZ não tem uma API Java para registrar novas raças, formas, habilidades ou técnicas: novas raças e formas são adicionadas por arquivos de configuração JSON (veja [[Special:MyLanguage/Custom Races|Raças personalizadas]] e [[Special:MyLanguage/Custom Forms|Formas personalizadas]]).


== Ferramentas necessárias ==

{| class="wikitable"
! Requisito !! Versão !! Onde é declarado
|-
| Minecraft || <code>1.20.1</code> || <code>gradle.properties</code>
|-
| Forge || <code>47.4.10</code> (aceita <code>[47,)</code>) || <code>gradle.properties</code>, <code>mods.toml</code> do addon
|-
| ForgeGradle || <code>6.0.30</code> || Plugins do <code>build.gradle.kts</code>
|-
| Java || <code>17</code> || Toolchain do <code>build.gradle.kts</code>
|-
| Mappings || Parchment <code>2023.09.03-1.20.1</code> || <code>gradle.properties</code>
|-
| GeckoLib || <code>4.8.3+</code> || <code>gradle.properties</code>, <code>mods.toml</code> do addon
|-
| TerraBlender || <code>3.0.1.10+</code> || <code>gradle.properties</code>, <code>mods.toml</code> do addon
|-
| Curios API || <code>5.14.1+1.20.1</code> ou mais recente || <code>gradle.properties</code>, <code>mods.toml</code> do addon
|}

Use exatamente estas versões (ou faixas de versão compatíveis) no <code>build.gradle</code> ou <code>build.gradle.kts</code>, no <code>gradle.properties</code> e no <code>mods.toml</code> do seu addon; caso contrário, você terá erros de carregamento de classes e de mixins incompatíveis em tempo de execução. O DMZ está atualmente na versão <code>2.2-alpha</code> do mod (<code>gradle.properties</code>).

GeckoLib, TerraBlender e Curios são dependências '''obrigatórias''' do DMZ, então também precisam estar no classpath de execução do seu ambiente de desenvolvimento.


== Mods incompatíveis ==
O DMZ se recusa a iniciar (lança uma <code>IllegalStateException</code> durante o carregamento) quando algum destes mods está instalado, e os declara como <code>incompatible</code> no seu <code>mods.toml</code>:
* Legendary Tooltips (<code>legendarytooltips</code>)
* Epic Fight (<code>epicfight</code>)
* Better Combat (<code>bettercombat</code>)
Não dependa deles, não os inclua nem os adicione às suas configurações de execução de desenvolvimento.


== Versões de pré-lançamento ==
<code>2.2-alpha</code> é uma versão de pré-lançamento. As versões alpha e beta do DMZ só deixam entrar em um mundo ou servidor os nomes de usuário da lista de permissões. O nome de usuário de desenvolvimento padrão do ForgeGradle, <code>Dev</code>, está na lista de permissões, então o <code>runClient</code> funciona sem configurar nada: mantenha esse nome de usuário para seus testes locais.


== Estrutura de pacotes ==
Antes de escrever qualquer código de hook, dê uma olhada na estrutura do código-fonte (<code>AI/Context.md</code> no repositório do DMZ a documenta em detalhes):
* <code>com.dragonminez.client</code>: renderização, GUI e animação; só cliente.
* <code>com.dragonminez.common</code>: configuração, estatísticas, rede, missões e desejos; a parte que a maioria dos addons usa.
* <code>com.dragonminez.server</code>: comandos, armazenamento, geração de mundo e eventos de servidor.
* <code>com.dragonminez.mixin</code>: mixins; evite depender deles em um addon.
Os addons devem se conectar quase exclusivamente a <code>com.dragonminez.common</code>: é a camada compartilhada e a mais estável. Os únicos hooks do lado do cliente pensados para addons são <code>DMZClientEvent</code> e os slots do Menu de Utilidades (veja [[Special:MyLanguage/Implementation and Events|Implementação e eventos]]).


== Duas formas de integração ==
# '''Dependência obrigatória:''' seu addon exige que o DMZ esteja presente (<code>mandatory=true</code> no <code>mods.toml</code>). É a opção mais simples, mas seu addon não carrega sem o DMZ.
# '''Dependência opcional:''' seu addon funciona sozinho e só ativa o comportamento específico do DMZ quando o DMZ é detectado. O próprio DMZ usa esse padrão nas suas integrações opcionais (<code>common/compat/WeaponLevelingCompat.java</code>, <code>common/compat/ApotheosisCompat.java</code>): verifique <code>ModList.get().isLoaded("dragonminez")</code> uma única vez e mantenha toda classe que importa código do DMZ atrás dessa verificação. É o recomendado se o seu addon tem valor sem o DMZ instalado. Veja [[Special:MyLanguage/Implementation and Events#Optional dependency pattern|Padrão de dependência opcional]].


== No que você pode confiar ==
* '''Eventos:''' as classes aninhadas de <code>com.dragonminez.common.events.DMZEvent</code> (servidor e comum) e <code>com.dragonminez.client.events.DMZClientEvent</code> (cliente) são a superfície pública de hooks prevista. Veja [[Special:MyLanguage/Implementation and Events|Implementação e eventos]] para a lista completa.
* '''Estado do jogador somente leitura:''' <code>StatsCapability</code>, <code>StatsProvider</code> e <code>StatsData</code>, para ler raça, forma, estatísticas e recursos.
* '''Registros de extensão:''' <code>QuestObjectiveRegistry</code> e <code>QuestRewardRegistry</code> (tipos de conteúdo de missão personalizados), <code>DMZTextPlaceholders</code> (<code>%placeholders%</code> personalizados em textos de missões e diálogos) e <code>UtilityMenuScreen.addMenuSlot</code> (botões no Menu de Utilidades do cliente).
* '''Registros:''' <code>MainItems</code>, <code>MainBlocks</code>, <code>MainEntities</code>, <code>MainAttributes</code>, <code>MainEffects</code>, <code>MainEnchants</code> (e as outras classes <code>Main*</code>) em <code>common/init/</code> expõem referências <code>RegistryObject</code> e <code>DeferredRegister</code> que você pode importar diretamente.


== No que não convém confiar ==
* Valores enviados pelo cliente para qualquer coisa relacionada ao progresso. O DMZ também não confia neles; leia a capability do lado do servidor.
* Alterar campos de <code>StatsData</code> diretamente fora de eventos ou comandos. Prefira reagir aos eventos ou cancelá-los em vez de mexer nos valores, e prefira os comandos existentes do DMZ quando precisar alterar algo que pertence ao DMZ.
* Registrar pacotes no canal de rede do DMZ. Os ids de pacote do DMZ dependem da ordem de registro; use seu próprio canal.
* Depender das classes de <code>com.dragonminez.mixin</code> ou de partes internas do DMZ não mencionadas acima. Elas podem mudar sem aviso entre versões.


== Próximo passo ==
Quando seu ambiente de desenvolvimento compilar contra o DMZ e você vir que ele é detectado em tempo de execução, siga para [[Special:MyLanguage/Implementation and Events|Implementação e eventos]] para conectar os hooks de verdade e depois para [[Special:MyLanguage/Creating a DMZ Addon|Criar um addon de DMZ]] para a configuração completa do Gradle e do <code>mods.toml</code>.

{{Navbox Add-ons}}

Add-on Getting Started/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository