NMS Data Component

目的

操作 Minecraft 1.20.5 引入的 DataComponentType 物品組件系統，直接讀寫 CustomData、MaxStackSize、Enchantments、AttributeModifiers 等組件，取代舊版 NBT getTag()/setTag() 模式。

---

平台需求

• Paper 1.21.11 / 26.2（DataComponent 為 1.20.5+ 新增）
• Paperweight userdev 2.0.0-beta.24+
• Mojang 官方名稱（Minecraft 26.1 起不再混淆）
• Java 21（1.21.11）／25（26.2）

---

產生的代碼

ItemComponentUtil.java

// 讀取 MaxStackSize 組件
Optional<Integer> maxStack = ItemComponentUtil.get(item, DataComponents.MAX_STACK_SIZE);

// 設定不可破壞（UNBREAKABLE 為 Unit 標記組件；回傳新 ItemStack，原物不變）
ItemStack unbreakable = ItemComponentUtil.setUnbreakable(item, true);

// 移除組件
ItemStack clean = ItemComponentUtil.remove(item, DataComponents.CUSTOM_DATA);

CustomDataHelper.java（自定義 NBT 組件）

// 寫入自定義字串資料
ItemStack tagged = CustomDataHelper.setString(item, "rarity", "legendary");

// 讀取自定義整數資料（getTag 回傳 custom_data 的 CompoundTag 副本）
int level = CustomDataHelper.getTag(item).getInt("weapon_level");

// 檢查是否有指定鍵
boolean hasTag = CustomDataHelper.getTag(item).contains("owner_uuid");

---

執行緒安全

• ItemComponentUtil 操作 NMS Copy，可在任意執行緒呼叫
• 套用修改後的 ItemStack 至玩家物品欄須在主執行緒完成