Configuration & Intégration GUI (MC 26.2)
Ce document détaille le schéma du fichier de configuration, l'intégration de YACL v3, points d'entrée ModMenu et règles de priorité de monde pour Item Clumps sur Minecraft 26.2.
📊 Fiche Technique de Configuration
| Propriété | Valeur |
|---|---|
| Chemin du Fichier de Config | config/item-clumps.json |
| Format de Fichier | JSON (Géré via ConfigHelper de DasikLibrary) |
| Version Actuelle du Schéma | configVersion: 1 |
| Interface Graphique | YetAnotherConfigLib v3 (YACL) via ModMenu |
| Isolation de Chargement | Réflexion différée (GuiHelper.getOptionalYaclFactory) |
| Règle de Priorité | La config définit les mondes créés ; les mondes actifs utilisent GameRules |
⚠️ Règle de Priorité : Configuration Globale vs Monde Actif
⚠️ AVIS IMPORTANT : Modifier
config/item-clumps.jsonou changer les réglages dans l'interface ModMenu définit les valeurs par défaut pour les mondes nouvellement créés. Pour configurer un monde actif ou existant, utilisez la commande en jeu/gameruleou l'écran natif d'édition des règles de jeu.
📄 Schéma de Fichier JSON (config/item-clumps.json)
{
"configVersion": 1,
"enableClumping": true,
"maxClumpSize": 9999,
"renderLabels": true,
"mergeRadius": 1,
"labelMinCount": -1
}Définitions des Champs
| Clé JSON | Type | Par Défaut | Description |
|---|---|---|---|
configVersion | Entier | 1 | Suivi interne de migration de schéma. |
enableClumping | Booléen | true | Active ou désactive la fusion en méga-piles. |
maxClumpSize | Entier | 9999 | Plafond strict d'items par amas ($64\text{ à }2,147,483,647$). |
renderLabels | Booléen | true | Affiche des étiquettes flottantes indiquant les quantités. |
mergeRadius | Entier | 1 | Rayon de recherche horizontal en blocs ($1\text{ à }10\text{ blocs}$). |
labelMinCount | Entier | -1 | Seuil d'apparition de l'étiquette (-1 = pile maximale vanilla). |
🖥️ Interface Graphique (YACL v3 & ModMenu)
Item Clumps intègre des écrans de configuration client optionnels via YetAnotherConfigLib (YACL v3) et 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 ] |
+-------------------------------------------------------------------------+Chargement Différé Sécurisé des Classes
Pour garantir que le mod ne plante jamais sur serveur dédié ou client sans YACL/ModMenu, l'instanciation des écrans est isolée derrière 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"
);
}
}