設定とGUI連携 (MC 26.1.2)

本書では、Minecraft 26.1.2 における設定ファイルスキーマ、Cloth Config v2 GUI連携、ModMenuエントリーポイント、ワールド優先順位ルールを解説します。

---

📊 設定情報ボックス

項目	値
設定ファイルパス	config/item-clumps.json
ファイル形式	JSON (アトミックスワップ対応のGsonシリアライズ)
現在のスキーマ版	configVersion: 1
設定GUIプロバイダー	Cloth Config v2 via ModMenu
優先順位ルール	設定ファイルは新規ワールドの初期値、稼働中はGameRulesが優先

---

📄 JSONファイルスキーマ (config/item-clumps.json)

{
  "configVersion": 1,
  "enableClumping": true,
  "maxClumpSize": 9999,
  "renderLabels": true,
  "mergeRadius": 1
}

フィールド定義

JSONキー	型	初期値	説明
configVersion	Integer	1	内部スキーマ移行トラッカー。
enableClumping	Boolean	true	メガスタック結合機能の有効/無効。
maxClumpSize	Integer	9999	集約エンティティごとのアイテム上限 ($64$ 〜 $2,147,483,647$)。
renderLabels	Boolean	true	アイテム上空に浮遊数量ラベルを表示。
mergeRadius	Integer	1	水平方向の探索半径 ($1$ 〜 $10$ ブロック)。

---

🖥️ グラフィカルUI (Cloth Config & ModMenu)

Item Clumps は Cloth Config v2 および ModMenu によるクライアント設定GUIをサポートしています:

// 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;
    }
}

---

🔗 関連ドキュメント (MC 26.1.2)

• 26.1.2 GameRules 一覧表
• 26.1.2 アーキテクチャと Mixin