Integrasi API & Addon (MC 26.2)
Dokumen ini menjelaskan hook integrasi mod pihak ketiga, interaksi API DasikLibrary, dan kueri pengelompokan terprogram untuk Item Clumps di Minecraft 26.2.
📊 Kotak Info Integrasi
| Properti | Nilai |
|---|---|
| Arsitektur API | API Asli Vanilla ItemEntity dan ItemStack |
| Protokol Penyimpanan Data | Langsung via ItemStack.getCount() (VarInt / Integer 32-bit) |
| API GameRule | DynamicGameRuleManager (API DasikLibrary) |
| Antarmuka Duck-Typing | Kompatibel dengan antarmuka magnet / entitas item kustom |
🔌 Kueri Pengelompokan Terprogram untuk Pengembang Addon
Karena Item Clumps menyimpan jumlah mega-stack virtual langsung di dalam ItemStack standar Minecraft, pengembang addon tidak memerlukan facade API kustom untuk membaca atau mengubah ukuran kelompok:
1. Membaca Jumlah Kelompok
java
// Standard ItemEntity instance
ItemEntity entity = ...;
// Native vanilla getter returns true mega-count (e.g. 5000)
int trueCount = entity.getItem().getCount();2. Memeriksa Kelayakan Penggabungan
java
// Queries Item Clumps customIsMergable logic
boolean canMerge = entity.isMergable();3. Mengubah Jumlah Kelompok Secara Aman
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!🧲 Hook Duck-Typing Magnet & Penerbangan
Jika Anda mengembangkan mod magnet item, telekinesis, atau vakum, Anda dapat mencegah Item Clumps menggabungkan item secara prematur saat melayang dengan menambahkan salah satu metode duck-typed berikut ke mixin ItemEntity Anda:
java
public boolean ig_magnet$isMagnetized() {
return this.isFlyingTowardsPlayer;
}
// Or legacy alternative:
public boolean ig$isMagnetized() {
return this.isFlyingTowardsPlayer;
}Item Clumps memanggil metode ini secara otomatis via refleksi pada tick penggabungan.