API- & Addon-Integration (MC 26.2)
Dieses Dokument beschreibt Drittanbieter-Mod-Hooks, Interaktionen mit der DasikLibrary-API und programmatische Clump-Abfragen für Item Clumps auf Minecraft 26.2.
📊 Integrations-Infobox
| Eigenschaft | Wert |
|---|---|
| API-Architektur | Native Vanilla ItemEntity- und ItemStack-APIs |
| Datenspeicherprotokoll | Direktes ItemStack.getCount() (VarInt / 32-Bit Integer) |
| GameRule-API | DynamicGameRuleManager (DasikLibrary-API) |
| Duck-Typing-Schnittstellen | Kompatibel mit Magnet- & Item-Entitätsschnittstellen |
🔌 Programmatische Clump-Abfragen für Addon-Entwickler
Da Item Clumps die Zähler virtueller Mega-Stapel direkt im normalen ItemStack speichert, benötigen Addon-Entwickler keine speziellen API-Fassaden, um Mengen auszulesen oder zu manipulieren:
1. Anzahl im Stapel auslesen
java
// Standard ItemEntity instance
ItemEntity entity = ...;
// Native vanilla getter returns true mega-count (e.g. 5000)
int trueCount = entity.getItem().getCount();2. Verschmelzbarkeit prüfen
java
// Queries Item Clumps customIsMergable logic
boolean canMerge = entity.isMergable();3. Stapelanzahl sicher modifizieren
java
// 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!🧲 Duck-Typing-Hook für Magneten & Flugstatus
Wenn Sie eine Magnet-, Telekinese- oder Vakuumsauger-Mod entwickeln, können Sie vorzeitiges Verschmelzen im Flug verhindern, indem Sie eine der folgenden Duck-Typing-Methoden in Ihren ItemEntity-Mixin einfügen:
java
public boolean ig_magnet$isMagnetized() {
return this.isFlyingTowardsPlayer;
}
// Or legacy alternative:
public boolean ig$isMagnetized() {
return this.isFlyingTowardsPlayer;
}Item Clumps ruft diese Methode während der Verschmelzungsprüfung automatisch per Reflexion auf.