Item Limits

物品限制

为 Minecraft Java 26.3 提供可配置的每位玩家物品上限。

限制玩家可以携带的任何物品数量，例如1个不死图腾或4个附魔金苹果。当玩家达到上限并拾取更多物品时，多余的物品会掉落到地上。

该数据包默认为空：在你使用简单的/function命令自行添加限制之前，没有任何限制。无需配置文件，无需重启，无需/reload。

特性

• 适用于任何物品（原版物品 ID）
• 在游戏内添加、更改、移除和列出限制
• 多余物品会掉落，绝不会被删除（只有在掉落物成功生成后，物品才会从物品栏中移除）
• 统计整个玩家物品栏：快捷栏、主物品栏、盔甲槽和副手
• 还会统计玩家携带的潜影盒和收纳袋内的物品（包括潜影盒内的收纳袋），因此容器无法用来绕过限制
• 可选的聊天消息，告知玩家物品被掉落的原因
• 为应豁免的玩家（例如管理员）提供绕过标签
• 仅服务端，无需模组或资源包
• 非常轻量：每5刻运行一次，在没有配置限制时不做任何事

安装

1. 下载ItemLimits-1.1.0-mc26.3.zip。
2. 将 zip 放入服务器的world/datapacks/中（或在单人游戏中放入世界的datapacks文件夹）。
3. 运行/reload或重启服务器。

需要 Minecraft Java 版26.3（数据包格式 121）。

命令

所有命令都需要管理员权限（权限等级2，和任何/function一样）。

| 命令 | 作用 |
|—|—|
| /function item_limits:add {item:"minecraft:totem_of_undying",max:1} | 添加限制，如果该物品已有则更改 |
| /function item_limits:remove {item:"minecraft:totem_of_undying"} | 移除某物品的限制 |
| /function item_limits:list | 显示所有已配置的限制 |
| /function item_limits:clear_all | 移除所有限制 |
| /function item_limits:messages_on | 当多余物品被掉落时告知玩家（默认） |
| /function item_limits:messages_off | 不发送这些消息 |
| /function item_limits:containers_on | 统计潜影盒和收纳袋内的物品（默认） |
| /function item_limits:containers_off | 仅统计散落物品（v1.0 行为） |

示例

# Max 1 totem per player
/function item_limits:add {item:"minecraft:totem_of_undying",max:1}

# Max 4 enchanted golden apples per player
/function item_limits:add {item:"minecraft:enchanted_golden_apple",max:4}

# Change the totem limit to 2
/function item_limits:add {item:"minecraft:totem_of_undying",max:2}

# Remove the totem limit again
/function item_limits:remove {item:"minecraft:totem_of_undying"}

提示：item值是普通物品 ID。在游戏中按F3 + H可在物品提示中查看 ID。max:0会完全禁用某物品（所有都会掉落）。

豁免玩家

/tag <player> add item_limits.bypass
/tag <player> remove item_limits.bypass

工作原理

每 5 个刻检查一次每位玩家是否超出配置的各项上限。统计总量时，会计算散落物品，以及玩家携带的潜影盒和收纳袋中的所有物品。如果玩家携带的物品超过上限，超出的部分会掉落在玩家脚边（并有 5 秒的拾取延迟）。优先掉落散落物品（通常就是刚捡起的物品）。如果超出的物品在潜影盒或收纳袋里，就会从容器中取出并掉落，容器仍留在原来的背包格子中，物品原有的组件也会保留。如果玩家超出上限很多（例如刚添加了某项上限），每次检查最多处理 64 个物品，直到数量回到上限以内。

上限保存在 item_limits:config 命令存储中，因此会随地图保存，并在重启和 /reload 后继续保留。

限制

• 计入：玩家的背包、副手和盔甲栏，以及其中潜影盒和收纳袋内的物品（也包括潜影盒中的收纳袋）。不计入：末影箱、地图中的箱子/木桶、打开菜单时光标上拿着的物品，以及其他模组添加的容器。
• 上限仅根据物品 ID 匹配。物品组件（自定义名称、附魔等）不会纳入统计，因此所有 minecraft:enchanted_book 物品都会合并计数。不支持物品标签（#minecraft:...）。
• 会按游戏背包顺序，先减少散落物品，再处理容器内的物品，因此掉落的物品不一定是刚捡起的那一个。物品总量始终会正确统计。
• 掉落的物品可在 5 秒后重新拾取，但如果玩家仍达到上限，整合包会再次将它丢出来。
• 检查携带潜影盒或收纳袋的玩家时，耗时会略多一些。如果不需要统计容器内的物品，请使用 /function item_limits:containers_off。
• 如果由于任何原因无法修改容器，则不会移除或掉落任何物品；检查会在之后重试。

兼容性

• Minecraft Java Edition 26.3
• 原版、Fabric、Quilt、Paper、Purpur、Velocity 后端服务器网络（上限按服务器分别设置，请在每个需要限制的后端服务器上安装此整合包）