Konfigurasi & Integrasi GUI (MC 26.2)
Dokumen ini menjelaskan skema berkas konfigurasi, integrasi GUI YACL v3, titik masuk ModMenu, dan aturan prioritas dunia untuk Item Clumps di Minecraft 26.2.
📊 Kotak Info Konfigurasi
| Properti | Nilai |
|---|---|
| Jalur Berkas Konfigurasi | config/item-clumps.json |
| Format Berkas | JSON (Dikelola via ConfigHelper DasikLibrary) |
| Versi Skema Saat Ini | configVersion: 1 |
| Penyedia Antarmuka Grafis | YetAnotherConfigLib v3 (YACL) via ModMenu |
| Isolasi Pemuatan Kelas | Refleksi tertunda (GuiHelper.getOptionalYaclFactory) |
| Mandat Prioritas | Konfigurasi menetapkan bawaan dunia baru; dunia aktif memakai GameRules |
⚠️ Aturan Prioritas Konfigurasi Global vs. Dunia Aktif
⚠️ PEMBERITAHUAN PENTING: Mengubah
config/item-clumps.jsonatau mengganti pengaturan di GUI ModMenu hanya menentukan nilai dasar bawaan untuk dunia yang baru dibuat. Untuk mengonfigurasi pengaturan pada dunia yang sedang aktif atau sudah ada, gunakan perintah dalam game/gameruleatau layar pengeditan Game Rules bawaan.
📄 Skema Berkas JSON (config/item-clumps.json)
{
"configVersion": 1,
"enableClumping": true,
"maxClumpSize": 9999,
"renderLabels": true,
"mergeRadius": 1,
"labelMinCount": -1
}Definisi Bidang (Field)
| Kunci JSON | Tipe Data | Nilai Bawaan | Deskripsi |
|---|---|---|---|
configVersion | Integer | 1 | Pelacak migrasi skema internal. |
enableClumping | Boolean | true | Mengaktifkan atau menonaktifkan penggabungan item mega-stack. |
maxClumpSize | Integer | 9999 | Batas maksimum item per entitas kelompok ($64$ hingga $2.147.483.647$). |
renderLabels | Boolean | true | Menampilkan label nama jumlah melayang di atas kelompok item. |
mergeRadius | Integer | 1 | Radius pencarian blok horisontal ($1$ hingga $10$ blok). |
labelMinCount | Integer | -1 | Ambang batas sebelum label ditampilkan (-1 = batas tumpukan vanilla). |
🖥️ Antarmuka Grafis (YACL v3 & ModMenu)
Item Clumps mengintegrasikan layar konfigurasi sisi-klien opsional melalui YetAnotherConfigLib (YACL v3) dan ModMenu:
+-------------------------------------------------------------------------+
| ITEM CLUMPS CONFIGURATION |
| |
| [ General Settings ] |
| |
| Enable Clumping ............................................ [ ON ] |
| When true, ground items aggressively merge into mega-stacks. |
| |
| Max Clump Size ............................................. [ 9999 ] |
| The hard cap on items per entity. (Hidden if Stack Size Adjuster on) |
| |
| Render Labels .............................................. [ ON ] |
| Renders holographic count above item clumps. |
| |
| Merge Radius ................................... [───●──────────] (1) |
| Horizontal block search radius (1-10 blocks). |
| |
| Label Min Count ............................................ [ -1 ] |
| Minimum item count before label displays (-1 for vanilla max stack). |
| |
| [ Cancel ] [ Save & Quit ] |
+-------------------------------------------------------------------------+Pemuatan Kelas Tertunda yang Aman
Untuk menjamin bahwa mod tidak pernah menyebabkan crash pada dedicated server atau klien yang tidak memasang YACL atau ModMenu, inisiasi layar diisolasi di balik GuiHelper.getOptionalYaclFactory:
// ModMenuIntegration.java (MC 26.2)
public class ModMenuIntegration implements ModMenuApi {
@Override
public ConfigScreenFactory<?> getModConfigScreenFactory() {
return GuiHelper.getOptionalYaclFactory(
"item_clumps",
"net.instantgratification.item_clumps.config.YaclScreenHelper",
"createScreen"
);
}
}