本文详解如何在分离的 inventory 类中创建可复用的物品栏实例，并在 inventorylistener 中通过 player.openinventory() 正确调用，避免变量作用域问题，推荐使用静态工厂方法实现解耦、线程安全与内存友好设计。
本文详解如何在分离的 inventory 类中创建可复用的物品栏实例，并在 inventorylistener 中通过 player.openinventory() 正确调用，避免变量作用域问题，推荐使用静态工厂方法实现解耦、线程安全与内存友好设计。
在 Bukkit 插件开发中，将物品栏逻辑封装到独立类（如 Copper_Inventory）是良好的工程实践，但直接在 InventoryListener 的 switch 语句中引用局部变量（如 copperInventory）会导致编译错误——因为该变量仅在其定义的方法（如 onCommand）内有效，超出作用域即不可访问。
✅ 推荐方案：静态工厂方法（最佳实践）
不依赖全局状态或 HashMap 缓存，而是将物品栏构建逻辑抽象为无状态、可重复调用的静态方法。这既保证线程安全，又避免内存泄漏风险（无需手动清理缓存），同时符合单一职责原则。
首先，创建统一的 Inventories 工具类（建议置于 inventories 包下）：
package de.t0x1ccr34t0r.charactertrails.inventories;
import org.bukkit.Bukkit;
import org.bukkit.Material;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.meta.ItemMeta;
public class Inventories {
// 静态工厂方法：生成 Copper 物品栏
public static Inventory createCopperInventory() {
Inventory inv = Bukkit.createInventory(null, 4 * 9, "§5Copper Trails:");
// Close 按钮
ItemStack close = new ItemStack(Material.BARRIER);
ItemMeta closeMeta = close.getItemMeta();
closeMeta.setLocalizedName("Close");
closeMeta.setDisplayName("§cClose");
close.setItemMeta(closeMeta);
inv.setItem(31, close);
// Back 按钮
ItemStack back = new ItemStack(Material.ARROW);
ItemMeta backMeta = back.getItemMeta();
backMeta.setLocalizedName("Back");
backMeta.setDisplayName("§7Back");
back.setItemMeta(backMeta);
inv.setItem(27, back);
// ✅ 可在此处添加 Copper Trail 相关物品（如染色羊毛、自定义头颅等）
// inv.setItem(13, createTrailItem("copper"));
return inv;
}
// 同理可扩展其他材质：createIronInventory()、createDiamondInventory() 等
}然后，在 InventoryListener 中直接调用该方法：
package de.t0x1ccr34t0r.charactertrails.listeners;
import de.t0x1ccr34t0r.charactertrails.inventories.Inventories; // ✅ 导入工具类
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.inventory.InventoryClickEvent;
public class InventoryListener implements Listener {
@EventHandler
public void onInvClick(InventoryClickEvent event) {
if (event.getCurrentItem() == null || event.getView().getTitle() == null) return;
// 匹配主菜单标题
if ("§5Trails:".equals(event.getView().getTitle())) {
Player player = (Player) event.getWhoClicked();
event.setCancelled(true);
if (event.getCurrentItem().getItemMeta().hasLocalizedName()) {
String localName = event.getCurrentItem().getItemMeta().getLocalizedName();
switch (localName) {
case "Close":
player.closeInventory();
break;
case "Copper":
player.openInventory(Inventories.createCopperInventory()); // ✅ 直接打开新实例
break;
case "Iron":
// player.openInventory(Inventories.createIronInventory());
break;
// 其他 case...
}
}
}
}
}⚠️ 注意事项与进阶建议
- 性能考量：createCopperInventory() 每次调用都会新建 Inventory 对象，但 Bukkit 的 Inventory 创建开销极低（远低于网络/IO），且避免了缓存管理复杂度，对常规插件完全可接受。
- 本地化支持：若需动态适配玩家语言，可在 createCopperInventory(Player p) 方法中传入 Player 参数，读取 p.getLocale() 并设置对应显示名。
-
物品栏复用优化（高级）：如需高频重用同一物品栏（如公告页），可结合 ConcurrentHashMap
缓存 模板（非玩家专属），例如： private static final Map<String, Inventory> TEMPLATES = new ConcurrentHashMap<>(); public static Inventory getCopperTemplate() { return TEMPLATES.computeIfAbsent("copper", k -> createCopperInventory()); } -
禁止使用 HashMap
方案 ：原文中提到的 HashMap 缓存方式易引发内存泄漏（未及时移除离线玩家）、并发修改异常（多线程点击）及生命周期混乱，强烈不推荐生产环境使用。
通过静态工厂模式，你获得了清晰的职责划分：Inventories 负责“造物”，InventoryListener 负责“调度”，所有 Inventory 实例按需创建、自动回收，代码更健壮、可维护性更高。
