BMSItemManager — BMS 物品管理系统
版本：1.7.2 RC1 | 平台：Paper 1.21.1 | Java 21BMSItemManager 是为 Minecraft Java 版服务器开发的一款物品管理插件，最初服务于 BMS 搜索、战斗、撤离（Search · Fight · Extract）游戏项目。
插件的目标是将 Minecraft 原版物品、自定义变卖物以及已有服务器物品定义纳入统一的管理流程，让服务器管理员能够更方便地配置物品重量、价值、品质、说明和战利品相关属性。
插件同时提供手持编辑、物品 ID 编辑、历史撤销和多语言接口，适合需要自定义物品规则的 Paper 服务器进行测试和扩展。
一、主要功能
1. 自定义物品注册
管理员可以将手持物品注册为 BMS 自定义变卖物，并为其分配独立的物品 ID。注册后的物品可以设置：
- 物品重量
- 品质等级（1–5）
- 物品价值
- 物品说明
- 物品载体材质
- 是否加入自定义战利品池
2. 原版物品重量管理
除了自定义变卖物，BMSItemManager 还支持对普通 Minecraft 原版物品建立重量规则。未单独配置的普通物品默认单件重量为 1，可根据服务器玩法进行调整。
例如：
- 石头：默认重量 1
- 铁锭：可以配置独立重量
- 钻石：可以配置独立重量
- 地图：可以配置相应重量规则
3. 特殊物品重量配置
对于具有可识别自定义名称或模型数据的物品，插件提供独立重量规则配置能力。这类物品可以包括战术地图、枪械弹药及其他插件生成的特殊物品。
需要注意：特殊物品的识别效果取决于其实际保存的物品数据，不保证兼容所有第三方插件。
4. 手持物品编辑
管理员手持目标物品，即可使用指令修改其属性。示例：
/bmsitem weight 3
/bmsitem value 180
/bmsitem tier 2
/bmsitem desc 破损的电子元件
手持编辑适合现场测试、制作物品和调整数据。
5. 通过物品 ID 编辑
不需要将目标物品拿在手上，也可以通过已登记的物品 ID 进行管理。例如：
/bmsitem list
/bmsitem info bms_001
/bmsitem edit bms_001 weight 3
/bmsitem edit bms_001 value 1000
/bmsitem edit bms_001 tier 2
这种方式特别适合拥有较多物品定义的服务器管理员。
6. 撤销与重做
BMSItemManager 提供管理操作历史功能，减少误输入造成的配置问题。常用指令：
/bmsitem undo
/bmsitem redo
/bmsitem history
管理员可以查看相关修改记录，并对支持的操作进行撤销或重做。
建议在执行批量修改前备份配置文件。历史功能不能替代完整的数据备份，也不会逆向撤销已完成的玩家交易。
7. 旧版 BMS 变卖物兼容
插件提供针对 BMS 既有变卖物体系的兼容和迁移逻辑。其设计目标是保留原有物品身份及相关属性，并统一后续管理过程，避免重新建立全部物品定义。
该功能与 BMS 原有物品数据格式有关，不保证自动识别其他服务器自行开发的所有特殊物品。
8. 战利品与黑市集成
插件包含与下列 BMS 插件连接的适配逻辑：- BMSCore
- BMSLootSystem
- BMSMarket
- BMSStorage
这些属于 BMS 专用集成功能，不是对所有经济插件或战利品插件的通用兼容承诺。
9. 中文及英文语言接口
本版本加入语言文件支持：lang/zh_CN.yml
lang/en_US.yml
可以通过配置文件选择默认语言，并支持语言重载。
当前版本主要提供服务器级语言切换及文本翻译接口，不支持每位玩家独立显示不同语言的完整物品 Lore。
二、常用管理员指令
| 指令 | 功能 |
|---|---|
| /bmsitem help | 查看帮助 |
| /bmsitem list | 查看已登记物品 |
| /bmsitem info | 查看手持物品信息 |
| /bmsitem info <id> | 根据 ID 查询物品 |
| /bmsitem weight <数值> | 修改手持物品重量 |
| /bmsitem value <数值> | 修改手持变卖物价值 |
| /bmsitem tier <1-5> | 修改物品等级 |
| /bmsitem edit <id> weight <数值> | 通过 ID 修改重量 |
| /bmsitem edit <id> value <数值> | 通过 ID 修改价值 |
| /bmsitem undo | 撤销操作 |
| /bmsitem redo | 重做操作 |
| /bmsitem history | 查看历史 |
| /bmsitem lang zh_CN | 切换中文 |
| /bmsitem lang en_US | 切换英文 |
| /bmsitem lang reload | 重载语言文件 |
默认授予 OP。
具体参数和可用子命令以对应版本的 /bmsitem help 为准。
三、安装教程
运行环境- Minecraft Java Edition
- Paper 1.21.1
- Java 21
- BMSItemManager 1.7.2 RC1
- 下载本页面提供的 JAR 文件。
- 关闭 Paper 服务器。
- 将 JAR 放入服务器的 plugins 文件夹。
- 如果此前安装过旧版本 BMSItemManager，先备份旧 JAR 和插件数据，再移走旧版本，避免重复加载。
- 启动服务器，检查控制台是否出现 BMSItemManager 的加载错误。
- 使用 OP 账号进入服务器，输入 /bmsitem help 检查管理功能。
plugins/BMSItemManager/
建议在首次修改物品定义前备份整个配置目录。
四、配置与数据同步
插件支持设置普通物品默认重量、战利品导出、共享物品注册表和语言选项。对于使用 Lobby 与 Raid 等多服务器架构的 BMS 项目，可以配置共享注册表实现物品定义同步。
需要注意，共享注册表功能要求实际文件路径可访问，并且需要正确配置写入端。
不同物理服务器之间的远程同步不能仅凭相同配置文件路径实现。
五、兼容性与已知限制
本版本为 RC 测试候选版，并非经过完整生产环境验收的稳定版本。目前存在以下需要注意的限制：
- BMSCore 原有的实际负重限制尚未完全接管新重量规则。
- 某些自定义物品可能需要根据实际物品元数据调整识别方式。
- 历史变卖物的 Lore 显示和迁移仍需要在实际服务器中验证。
- 与 BMSMarket、BMSLootSystem、BMSStorage 的端到端流程仍需测试。
- 多语言功能目前不提供完整的玩家独立 Lore 翻译。
- 未针对全部 Paper 分支及 Minecraft 版本进行兼容性测试。
六、常见问题
Q：可以管理没有登记的原版物品吗？可以。插件支持为普通原版材质建立重量规则，不要求所有物品先注册成变卖物。
Q：设置重量后，其他负重插件会自动采用这个数值吗？
不会。其他插件需要有对应适配接口或专门集成逻辑，才能使用 BMSItemManager 的重量数据。
Q：BMSItemManager 是独立经济插件吗？
不是。它主要负责物品注册和属性管理，完整经济交易需依赖服务器已有的经济及市场系统。
Q：可以用于不采用 BMS 搜打撤玩法的服务器吗？
可以尝试使用基础物品管理功能，但部分集成模块专为 BMS 插件体系开发。
Q：修改物品价值后，玩家已经卖出的物品会重新结算吗？
不会。物品定义调整不会自动回滚历史经济交易。
七、反馈与交流
BMSItemManager 仍在持续开发中。如果遇到物品识别异常、错误说明、重量计算问题或兼容性问题，欢迎向开发团队提供服务器版本、插件版本、相关配置和错误日志。
BMS 官方 QQ 群：2164075514
Discord：https://discord.gg/fc879N6kS
BMS — Search · Fight · Extract
感谢你对 BMS 项目的支持！
开发团队：BMS Team
