Integración de API y complementos (MC 26.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.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) |
| Interfaces de Duck-Typing | Compatible con interfaces personalizadas de imanes y entidades de objetos |
🔌 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().copyWithCount(newCount);
entity.setItem(stack); // Triggers custom name tag update automatically!🧲 Gancho de tipado dinámico (Duck-Typing) para imanes y vuelo
Si estás desarrollando un mod de imán de objetos, telequinesis o aspiradora, puedes evitar que Item Clumps fusione objetos prematuramente mientras están en vuelo añadiendo cualquiera de los siguientes métodos tipados dinámicamente a tu mixin de ItemEntity:
public boolean ig_magnet$isMagnetized() {
return this.isFlyingTowardsPlayer;
}
// Or legacy alternative:
public boolean ig$isMagnetized() {
return this.isFlyingTowardsPlayer;
}Item Clumps invoca automáticamente este método mediante reflexión durante los ticks de comprobación de fusión.