Integración de API y complementos (MC 26.1.2)

Este documento detalla los ganchos de integración con mods de terceros, las interacciones con la API de DasikLibrary y las consultas programáticas de grupos para Item Clumps en Minecraft 26.1.2.

---

📊 Ficha técnica de integración

Propiedad	Valor
Arquitectura de API	APIs nativas de ItemEntity e ItemStack de Vanilla
Protocolo de almacenamiento de datos	Directo ItemStack.getCount() (VarInt / Entero de 32 bits)
API de GameRule	DynamicGameRuleManager (API de DasikLibrary)

---

🔌 Consultas programáticas de grupos para desarrolladores de complementos

Dado que Item Clumps almacena los recuentos de mega-stacks directamente dentro del ItemStack estándar de Minecraft, los desarrolladores de complementos no necesitan fachadas de API personalizadas para leer o manipular los tamaños de grupos:

1. Lectura del recuento del grupo

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

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

2. Comprobación de fusionabilidad

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

3. Modificación segura del recuento del grupo

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

---

🔗 Documentación relacionada (MC 26.1.2)

• 26.1.2 Arquitectura y Mixins
• 26.1.2 Configuración y Compilación Loom