物品管理器

物品管理器

完全控制你的 Minecraft 服务器上的物品。禁止、限制或标记物品为非法——自动执行并集成 JEI。

管理

完全掌控您 Minecraft 服务器上的物品。禁止、限制或标记物品为非法 —— 自动执行,支持 JEI、维度与自定义消息。


描述

Item Manager 是一款服务端管理模组,让管理员能够控制玩家在服务器上可以拥有、合成或携带的物品。无论您运营的是生存 SMP、RPG 服务器还是竞技环境,Item Manager 都能为您提供自动执行物品规则的工具——无需插件、无需命令刷屏、无需手动管理。

只需将物品添加到一个类别,剩下的交给模组。


工作原理

Item Manager 拥有 3 个强制类别,每个类别具有不同级别的限制:


🔴 已禁止

最严格的限制。被禁止的物品在服务器上完全被禁止。

  • ✖ 每秒钟自动从玩家背包中移除
  • ✖ 当玩家打开箱子或容器时,自动从其中移除
  • ⚠ 物品被移除时玩家会收到警告消息
  • 🏷️ 物品上显示红色提示文本
  • 💬 支持每个物品自定义消息(含颜色代码)
  • 🌍 可限制在特定维度内

🟠 非法

较宽松的限制。非法物品可以存在于背包中,但不能被主动使用。

  • ↩ 自动移出快捷栏(0–8 格)
  • ↩ 自动从副手槽移除
  • ↩ 自动从所有盔甲槽(头盔、胸甲、护腿、靴子)卸下
  • 物品保留在主背包中 —— 不会被销毁
  • 🏷️ 物品上显示橙色提示文本
  • 💬 支持每个物品自定义消息(含颜色代码)
  • 🌍 可限制在特定维度内

🟡 受限制

最宽松的限制。受限制的物品可以被拥有,但不能被合成。

  • ✖ 合成配方被阻止 —— 结果自动取消
  • ✖ 配方在服务器启动时直接从服务器中移除
  • ✖ 配方在 JEI(Just Enough Items)中隐藏
  • 🏷️ 物品上显示黄色提示文本
  • 💬 支持每个物品自定义消息(含颜色代码)
  • 🌍 可限制在特定维度内

维度支持

每个物品可以被限制为全局或仅在特定维度内——包括模组维度。

# 全局限制(所有维度)
/itemmanager add banned minecraft:tnt

# 仅在地狱
/itemmanager add banned minecraft:tnt --dim minecraft:the_nether

# 仅在末地
/itemmanager add illegal minecraft:elytra --dim minecraft:the_end

# 模组维度
/itemmanager add banned botania:mana_sword --dim botania:alfheim

自定义消息

每个物品都可以有完全自定义的提示文本消息,支持任何语言,使用 & 支持完整的 Minecraft 颜色代码。

/itemmanager add banned minecraft:tnt|&8[&c&l已禁止&8] &c▪ &f此物品被禁止。
/itemmanager add illegal minecraft:diamond_sword|&6你不能在此使用它。
/itemmanager add restricted minecraft:elytra|&e此物品在此服务器上受限制。

# 带维度
/itemmanager add banned minecraft:tnt|&c地狱中没有TNT --dim minecraft:the_nether

如果未设置自定义消息,则显示默认的双语消息(西班牙语/英语)。


实时配置同步

无需重启服务器。更改即时生效:

  • 每次命令后配置自动同步给所有玩家
  • 玩家登录时同步配置
  • /itemmanager reload 强制向所有玩家手动同步

命令

所有命令需要 OP 等级 2 或更高。全部支持 Tab 自动补全。

命令 描述
/itemmanager add <cat> <item> 将物品添加到某个类别
/itemmanager add <cat> <item>|<msg> 添加物品并附带自定义消息
/itemmanager add <cat> <item> --dim <dim> 为特定维度添加物品
/itemmanager add <cat> <item>|<msg> --dim <dim> 添加带消息和维度的物品
/itemmanager remove <cat> <item> 从某个类别移除物品
/itemmanager setmessage <cat> <item>|<msg> 设置或更新自定义消息
/itemmanager clearmessage <cat> <item> 移除自定义消息
/itemmanager list 显示所有已注册的物品
/itemmanager check <item> 检查特定物品的状态
/itemmanager reload 重新加载配置并同步给所有玩家

快速开始

1. 安装模组 — 将 itemmanager-1.2.0.jar 放入服务器的 mods/ 文件夹。适用于 Forge 和 Mohist 服务器。要隐藏 JEI 配方和显示提示,客户端也需要安装该模组。

2. 启动服务器 — 配置文件在 world/serverconfig/itemmanager-server.toml 中创建。

3. 通过命令添加物品:

/itemmanager add banned minecraft:tnt|&c在此服务器上被禁止
/itemmanager add illegal minecraft:diamond_helmet|&6无法装备
/itemmanager add restricted minecraft:elytra|&e此处不可合成

4. 手动编辑(可选):

[items]
    banned = ["minecraft:tnt", "minecraft:tnt@minecraft:the_nether"]
    banned_messages = ["minecraft:tnt|&c禁止!", "minecraft:tnt@minecraft:the_nether|&c此处无TNT"]
    illegal = ["minecraft:diamond_sword"]
    illegal_messages = ["minecraft:diamond_sword|&6无法使用"]
    restricted = ["minecraft:elytra"]
    restricted_messages = []

兼容性

模组/平台 状态
Forge 1.20.1 ✅ 完全支持
Mohist 1.20.1 ✅ 完全支持
JEI 15.20.0.x ✅ 隐藏配方和物品
REI 🔜 即将推出
EMI 🔜 即将推出
任何模组物品 ✅ 通过 modid:itemname 完全支持
模组维度 ✅ 通过 modid:dimension 完全支持

常见问题

更改后需要重启服务器吗? 不需要 —— 更改会立即同步给所有玩家。

禁止的物品会从从未打开的箱子中移除吗? 不会 —— 只有玩家打开箱子时才会扫描。

当非法物品被移动时背包已满怎么办? 物品会掉落在玩家附近的地上。

这适用于模组物品和维度吗? 是的 —— 使用 modid:itemname 和 modid:dimension。

可以在消息中使用颜色代码吗? 是的 —— 使用 & 后跟颜色代码(例如 &c 红色, &e 黄色, &6 金色)。

它在 Mohist 上有效吗? 是的 —— 已在 Mohist 1.20.1 上全面测试。


需求

  • Minecraft: 1.20.1
  • Forge: 47.4.13+
  • JEI (可选): 15.20.0.x