Integração de API e Addons (MC 26.1.2)

Este documento detalha pontos de integração com mods de terceiros, interações com a API da DasikLibrary e consultas programáticas de agrupamentos para o Item Clumps no Minecraft 26.1.2.

---

📊 Ficha Técnica de Integração

Propriedade	Valor
Arquitetura de API	APIs nativas de ItemEntity e ItemStack do Vanilla
Protocolo de Armazenamento	Direto em ItemStack.getCount() (VarInt / Inteiro de 32 bits)
API de GameRules	DynamicGameRuleManager (API da DasikLibrary)

---

🔌 Consultas Programáticas de Agrupamentos para Desenvolvedores de Addons

Como o Item Clumps armazena as contagens de mega-pilhas diretamente dentro do ItemStack padrão do Minecraft, desenvolvedores de addons não precisam de fachadas de API personalizadas para ler ou alterar o tamanho dos agrupamentos:

1. Lendo a Quantidade do Agrupamento

// Standard ItemEntity instance
ItemEntity entity = ...;

// Native vanilla getter returns true mega-count (e.g. 5000)
int trueCount = entity.getItem().getCount();

2. Verificando Capacidade de Fusão

// Queries Item Clumps customIsMergable logic
boolean canMerge = entity.isMergable();

3. Modificando Quantidades com Segurança

// When mutating item entity counts, always update the stack object:
ItemStack stack = entity.getItem().copy();
stack.setCount(newCount);
entity.setItem(stack); // Triggers custom name tag update automatically!

---

🔗 Documentação Relacionada (MC 26.1.2)

• 26.1.2 Arquitetura & Mixins
• 26.1.2 Configuração & Compilação Loom