Configuración e integración de GUI (MC 26.1.2)
Este documento detalla el esquema del archivo de configuración, la integración de la GUI de Cloth Config v2, puntos de entrada de ModMenu y reglas de precedencia de mundo para Item Clumps en Minecraft 26.1.2.
📊 Ficha técnica de configuración
| Propiedad | Valor |
|---|---|
| Ruta del archivo de configuración | config/item-clumps.json |
| Formato de archivo | JSON (Serialización Gson con intercambio atómico seguro) |
| Versión de esquema actual | configVersion: 1 |
| Proveedor de interfaz gráfica | Cloth Config v2 mediante ModMenu |
| Mandato de precedencia | Config define valores predeterminados de nuevos mundos; mundos activos usan GameRules |
📄 Esquema del archivo JSON (config/item-clumps.json)
json
{
"configVersion": 1,
"enableClumping": true,
"maxClumpSize": 9999,
"renderLabels": true,
"mergeRadius": 1
}Definiciones de campos
| Clave JSON | Tipo | Predeterminado | Descripción |
|---|---|---|---|
configVersion | Entero | 1 | Rastreador interno de migración de esquema. |
enableClumping | Booleano | true | Habilita o deshabilita la fusión de objetos en mega-stacks. |
maxClumpSize | Entero | 9999 | Límite máximo de objetos por entidad de grupo ($64\text{ a }2,147,483,647$). |
renderLabels | Booleano | true | Muestra etiquetas de nombre personalizadas flotantes con cantidades sobre los grupos. |
mergeRadius | Entero | 1 | Radio de búsqueda de bloques horizontal ($1\text{ a }10\text{ bloques}$). |
🖥️ Interfaz gráfica (Cloth Config y ModMenu)
Item Clumps integra pantallas de configuración opcionales del lado del cliente mediante Cloth Config v2 y ModMenu:
java
// ModMenuIntegration.java (MC 26.1.2)
public class ModMenuIntegration implements ModMenuApi {
@Override
public ConfigScreenFactory<?> getModConfigScreenFactory() {
if (net.fabricmc.loader.api.FabricLoader.getInstance().isModLoaded("cloth-config")) {
return ClothConfigScreenHelper.createFactory();
}
return parent -> null;
}
}