Configuração e Integração com GUI (MC 26.1.2)
Este documento detalha o esquema do arquivo de configuração, integração com Cloth Config v2 GUI, pontos de entrada do ModMenu e regras de precedência de mundo para o Item Clumps no Minecraft 26.1.2.
📊 Ficha Técnica de Configuração
| Propriedade | Valor |
|---|---|
| Caminho do Arquivo de Configuração | config/item-clumps.json |
| Formato do Arquivo | JSON (Serialização Gson com segurança atômica) |
| Versão Atual do Esquema | configVersion: 1 |
| Provedor de Interface Gráfica | Cloth Config v2 via ModMenu |
| Mandato de Precedência | Config define padrões para novos mundos; mundos ativos usam GameRules |
📄 Esquema do Arquivo JSON (config/item-clumps.json)
json
{
"configVersion": 1,
"enableClumping": true,
"maxClumpSize": 9999,
"renderLabels": true,
"mergeRadius": 1
}Definições de Campos
| Chave JSON | Tipo | Padrão | Descrição |
|---|---|---|---|
configVersion | Inteiro | 1 | Rastreador interno de migração de esquema. |
enableClumping | Booleano | true | Ativa ou desativa a fusão de itens em mega-pilhas. |
maxClumpSize | Inteiro | 9999 | Limite máximo de itens por entidade de agrupamento ($64\text{ a }2.147.483.647$). |
renderLabels | Booleano | true | Renderiza etiquetas flutuantes personalizadas com quantidades sobre agrupamentos. |
mergeRadius | Inteiro | 1 | Raio de busca de blocos na horizontal ($1\text{ a }10\text{ blocos}$). |
🖥️ Interface Gráfica (Cloth Config e ModMenu)
O Item Clumps integra telas de configuração opcionais do lado do cliente através de Cloth Config v2 e 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;
}
}