🎒 物品管理插件使用指南

欢迎使用物品管理插件！这个插件可以帮你轻松管理服务器中的自定义物品，让物品的创建、编辑和分发变得超级简单~

🌟 主要功能

📦 智能分类存储

不用再为物品分类发愁啦！插件提供了7个预设分类：

• 🔴 任务物品 - 存放任务相关的道具
• 🍎 食物 - 各种自定义食物和药水
• ⚡ 元素 - 合成材料和基础元素
• 💎 装备原核 - 装备升级核心
• 👹 怪物掉落物 - 怪物专属掉落
• 🌿 采集物 - 挖矿采集的特殊物品
• ✨ 未解封物品 - 神秘的封印物品
• ⭐ 常用物品 - 日常使用的物品

🛠️ 强大的物品编辑

每个物品都可以自定义：

• 物品ID - 给物品设置独特的标识符
• 显示名称 - 让物品有个好听的名字
• 物品描述 - 添加详细的说明文字
• 丢弃保护 - 防止玩家意外丢弃重要物品

🔄 智能更新系统

这是最棒的功能之一！当你修改了物品模板后：

• 所有玩家背包里的同类物品会自动更新
• 更新过程完全无感知，不会打扰玩家游戏
• 物品数量、附魔等玩家数据会完整保留

🎮 如何使用

获取管理工具

输入指令获取物品管理工具：

/ubitem givetool

你会得到一个红石，这就是万能工具：

• 左键 - 打开缓存箱子
• 右键 - 打开物品管理面板

创建和编辑物品

1. 右键点击工具，打开物品管理面板
2. 选择合适的分类（比如选择"食物"分类）
3. 将你要编辑的物品放入界面
4. 右键点击物品，进入编辑模式
5. 在编辑界面中可以：

• 设置物品ID（建议用英文+数字，如 magic_apple_001）
• 修改物品名称
• 添加或删除描述文字
• 开启丢弃保护

物品更新管理

当你修改了物品模板后，可以使用这些指令推送更新：

静默更新全服

/ubitem update

适合日常维护，玩家完全感觉不到。

更新特定物品

/ubitem updateitem <物品ID>

例如：/ubitem updateitem magic_apple_001 只更新拥有该物品的玩家，会发送友好提醒。

全量刷新

/ubitem refresh

大版本更新时使用，刷新所有物品。

💡 实用小贴士

物品ID命名建议

• 用英文字母和数字组合：sword_legendary_001
• 按类型分组：food_apple_golden、quest_key_dungeon
• 便于管理：weapon_bow_flame、armor_helmet_dragon

最佳使用流程

1. 先规划分类 - 想好要创建什么类型的物品
2. 批量创建 - 在对应分类中创建一批物品
3. 测试验证 - 检查物品属性是否正确
4. 推送更新 - 使用更新指令同步给玩家

更新时机建议

• 日常修改 → 使用 updateitem 精准更新
• 服务器重启后 → 使用 update 静默同步
• 大版本更新 → 使用 refresh 全量刷新

🔍 调试功能

查看所有物品ID

/ubitem debug

这个指令会列出服务器中所有已注册的物品ID，方便你管理和查找。

⚠️ 注意事项

• 物品ID一旦设置尽量不要修改，否则会影响已发放的物品
• 重要物品建议开启丢弃保护，避免玩家误操作
• 更新前可以先用 debug 指令确认物品ID存在
• 大批量更新时建议选择玩家较少的时间段

🎯 常见场景

📝 创建任务奖励物品

1. 选择"任务物品"分类
2. 放入一个钻石
3. 右键编辑：设置ID为 quest_reward_diamond
4. 修改名称为 §b§l任务奖励钻石
5. 添加描述 §7完成主线任务的奖励

🍖 制作自定义食物

1. 选择"食物"分类
2. 放入熟牛肉
3. 设置ID：food_beef_premium
4. 名称：§6高级牛排
5. 描述：§7回复10点饥饿值、§a品质保证

⚔️ 升级现有装备

1. 修改装备模板的属性
2. 使用 /ubitem updateitem weapon_sword_001
3. 所有玩家的该武器自动升级！

---

希望这个指南能帮到你！如果还有什么问题，随时可以咨询~