Konfiguration & GUI-Integration (MC 26.2)
Dieses Dokument beschreibt das Konfigurationsdateischema, YACL v3 GUI-Integration, ModMenu-Einstiegspunkte und Vorrangregeln für Item Clumps auf Minecraft 26.2.
📊 Konfigurations-Infobox
| Eigenschaft | Wert |
|---|---|
| Konfigurationsdateipfad | config/item-clumps.json |
| Dateiformat | JSON (Verwaltet über DasikLibrary ConfigHelper) |
| Aktuelle Schemaversion | configVersion: 1 |
| Grafischer Oberflächen-Provider | YetAnotherConfigLib v3 (YACL) über ModMenu |
| Klassenlade-Isolation | Verzögerte Reflexion (GuiHelper.getOptionalYaclFactory) |
| Vorrang-Mandat | Konfiguration setzt Standardwerte neuer Welten; aktive Welten nutzen GameRules |
⚠️ Vorrangregel: Globale Konfiguration vs. Aktive Welt
⚠️ WICHTIGER HINWEIS: Änderungen an
config/item-clumps.jsonoder Einstellungen in der ModMenu-GUI legen die Standardwerte für neu erstellte Welten fest. Um Einstellungen für eine aktive Welt zu ändern, verwenden Sie den In-Game-Befehl/gameruleoder den nativen Spielregeln-Bearbeitungsbildschirm.
📄 JSON-Dateischema (config/item-clumps.json)
json
{
"configVersion": 1,
"enableClumping": true,
"maxClumpSize": 9999,
"renderLabels": true,
"mergeRadius": 1,
"labelMinCount": -1
}Felddefinitionen
| JSON-Schlüssel | Typ | Standard | Beschreibung |
|---|---|---|---|
configVersion | Integer | 1 | Interner Schema-Migrationszähler. |
enableClumping | Boolean | true | Aktiviert oder deaktiviert das Verschmelzen zu Mega-Stapeln. |
maxClumpSize | Integer | 9999 | Feste Obergrenze für Items pro Stapel-Entität ($64\text{ bis }2.147.483.647$). |
renderLabels | Boolean | true | Rendert schwebende Mengenschilder über Stapeln. |
mergeRadius | Integer | 1 | Horizontaler Block-Suchradius ($1\text{ bis }10\text{ Blöcke}$). |
labelMinCount | Integer | -1 | Schwelle vor Anzeige der Beschriftung (-1 = Vanilla-Max-Stapel). |
🖥️ Grafische Benutzeroberfläche (YACL v3 & ModMenu)
Item Clumps integriert optionale clientseitige Konfigurationsmenüs über YetAnotherConfigLib (YACL v3) und 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 ] |
+-------------------------------------------------------------------------+Sicheres verzögertes Laden von Klassen
Um sicherzustellen, dass dedizierte Server oder Clients ohne YACL/ModMenu niemals abstürzen, ist die Menü-Erstellung hinter GuiHelper.getOptionalYaclFactory isoliert:
java
// 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"
);
}
}