快速装备包

QuickKit v1.0.0

Minecraft 1.21.11 (Fabric)

功能说明

QuickKit 允许你将整个背包保存为命名的工具包，并在需要时即时恢复。每个工具包会保存背包的完整状态，包括快捷栏、盔甲、副手物品、附魔、组件、 lore、自定义名称及所有其他物品数据。

工具包使用 Minecraft 的 ItemStack.CODEC 进行序列化，确保物品信息准确且具有前瞻性存储。每位玩家的工具包存储在独立的 JSON 文件中，路径位于服务器运行目录下：

pvppractice_kits/<uuid>.json

命令

所有命令需要操作员等级 2。

• /kit save <名称>
  将当前背包保存为命名的工具包。工具包名称最长 64 个字符。

• /kit load <名称>
  清空当前背包并恢复选定的工具包。

• /kit delete <名称>
  永久删除指定的工具包。

• /kit rename <旧名称> <新名称>
  重命名现有工具包。

• /kit list
  在聊天中显示所有已保存的工具包。

• /kit bind <名称>
  创建一个特殊的绑定物品，使用时立即加载选定的工具包。

在 load、delete、bind 和 rename 命令中可使用 Tab 补全工具包名称。

GUI 界面

按 K 键（可在控制 → PVP Practice Mod中配置）打开工具包管理界面。

GUI 以可滚动的列表显示所有已保存的工具包。

工具包列表操作

• 左键点击工具包 → 立即加载该工具包并关闭 GUI。
• 右键点击工具包 → 选中该工具包并高亮为蓝色，以便进行管理操作。

按钮

• Load Kit
  加载当前选中的工具包。

• Save Inventory
  提示输入工具包名称并保存当前背包。

• Delete Kit
  在永久删除选中的工具包前，弹出确认对话框。

• Rename Kit
  提示输入新名称并重命名选中的工具包。

• Refresh
  直接从服务器重新加载工具包列表。

工具包绑定物品

运行：

/kit bind <名称>

会获得一个发光的下界之星，具有：

• 自定义名称："Kit: <名称>"（金色，粗体）
• lore："右键点击加载工具包"（灰色，斜体）
• 隐藏组件：pvppractice:kit_name

右键点击绑定物品会立即加载绑定的工具包。

为防止意外丢失，如果在加载工具包时绑定物品会被覆盖，QuickKit 会自动将其移动到下一个可用的背包栏位，尽可能确保它始终在你的背包中。

技术细节

• 使用 Fabric API 网络功能通过自定义数据包：
  • C2SKitActionPayload
  • S2CKitListPayload
• 使用自定义数据组件：
  • pvppractice:kit_name（字符串类型）用于绑定物品识别。
• 服务端工具包缓存通过每个玩家的 UUID 对应的 ConcurrentHashMap 处理，并持久化到磁盘。
• 玩家加入时工具包自动加载，断开连接时自动保存。
• 完全服务端授权架构——客户端仅发送请求，所有验证、工具包管理和背包操作均在服务端处理。

需求

• Java 21
• Fabric Loader 0.18.4+
• Fabric API 0.141.3+
• Minecraft 1.21.11