ItemControl
控制你的 Minecraft 服务器上任意物品的数量上限。
ItemControl 是一款适用于 Paper 和 Spigot 的物品数量限制与附魔限制插件。想要全服只有一把警棍?每位玩家最多持有 3 个图腾?禁止锋利 V?只需通过菜单点击几下即可完成设置,插件会自动进行计数管理。
支持 1.21 - 1.21.11 以及 26.1 - 26.3。
功能介绍
物品限制
- 全局限制 - 限制全服中某种物品的总存在数量。非常适合传说级武器、稀有掉落物或“全服唯一”类物品。
- 玩家限制 - 限制单个玩家持有的最大数量。从此告别囤积癖。
- 自定义物品与原版物品分开追踪(基于名称、描述、自定义模型数据、PDC)。
- 隐藏在潜影盒和包裹中的物品仍会计入数量。
- 当受限物品被销毁(岩浆、仙人掌、消失、虚空)时,其占用的槽位会自动释放。
附魔限制
- 可限制任何附魔,或仅限制特定等级(例如锋利 V)。
- 超过限制的附魔等级会在可能的情况下自动降低至允许的最高等级。
使用与存储规则
- 允许玩家持有物品但禁止使用(攻击、放置、食用、射击等)。
- 禁止将受限物品存入箱子、漏斗或潜影盒中。
高级规则
- 5 种限制类型 - 当前存在的数量、历史上可获得的最大数量、按时间段(如每日)、滑动窗口计算,或永久绑定到单个玩家。
- 8 种触发动作 - 当超出限制时:阻止、隔离、掉落、删除、降级、替换、执行命令,或仅记录日志。
- 来源过滤器 - 根据物品的获取来源允许或禁止:制作、交易、钓鱼、战利品箱、怪物掉落、铁砧、附魔台、酿造炉、熔炉、创造模式等。
- 共享池 - 为一组物品设置统一限制。例如:全服最多存在 10 件下界合金物品,无论具体是哪一种。
- 配置文件 - 使规则仅在特定的世界、生物群系、WorldGuard 区域、游戏模式、一天中的时间、天气或 Y 轴高度生效,或仅对拥有特定权限的玩家生效。
- 药水效果限制 - 限制药水效果的等级和持续时间,或禁止来自信标等来源的效果。
自定义合成
- 创建你自己的 3x3 合成配方,精确指定每个槽位的材料数量(例如某个槽位需要 2 个钻石块)。
- 玩家可通过
/recipes 浏览这些配方。
- 每个配方都可以设置独立的权限要求。
隔离区
超出限制的物品可以被存储起来而不是直接删除。管理员可以查看隔离区物品,并一键归还给原主。
审计与修复
/ic audit 会检查在线玩家和已加载的箱子,并告知你是否有任何计数器出现偏差。修复操作只会增加计数器数值,因此绝不会误释放槽位。
专为安全设计
- 计数器在重启和崩溃后依然存活。如果其他插件取消了某项操作,计数也会相应回滚。
- 受追踪的物品带有服务器签名标签,因此不会被信任那些伪造了追踪数据的物品。
- 提供自动备份、最后一次规则更改的回退功能以及变更日志。
- 如果数据文件损坏,插件会停止运行并告知你具体是哪个文件出了问题,而不是直接清空数据。
- 当 TPS 下降时,扫描速度会自动降低以减轻负载。
兼容你的插件
开箱即用支持 50+ 款插件,包括 PlaceholderAPI, WorldGuard, LuckPerms, ItemsAdder, Oraxen, Nexo, MMOItems, MythicMobs, Slimefun,以及 crate 插件和商店插件。自定义物品能保持其身份标识,确保限制精准命中你所选定的物品。所有功能均为可选,无需强制依赖。
快速上手
- 将 jar 包放入
plugins 文件夹。
- 重启服务器。
- 运行
/ic menu。
- 在背包中点击一个物品并设置限制。搞定。
命令
/ic menu - 打开控制中心
/ic status - 快速概览
/ic inspect - 查看手中物品匹配的规则
/ic audit - 检查计数器(使用 /ic audit repair 进行修复)
/ic quarantine - 审查隔离物品
/ic reload - 重新加载配置文件
/recipes - 浏览自定义配方(玩家使用)
权限
itemcontrol.admin - 菜单和管理员命令(默认 OP 拥有)
itemcontrol.audit - 运行审计(OP)
itemcontrol.quarantine - 管理隔离区(OP)
itemcontrol.recipes - 使用 /recipes (所有人)
itemcontrol.recipe.<tag> - 访问某个特定自定义配方
itemcontrol.bypass.* - 忽略所有限制
itemcontrol.bypass.item.<item> - 忽略某个特定物品的限制
itemcontrol.bypass.enchant.<enchant> - 忽略某个特定附魔的限制
绕过权限需先在设置菜单中启用。默认情况下,OP 不会绕过限制。
占位符
%itemcontrol_held_remaining% %itemcontrol_held_rules% %itemcontrol_rules% %itemcontrol_quarantine% %itemcontrol_tps%
常见问题
我能创建一个全服只存在一次的物品吗?
可以。为其设置全局数量为 1 即可。如果该物品被销毁,其他人可以再次获得它。
它与 ItemsAdder、Oraxen、Nexo 或 MMOItems 的物品兼容吗?
是的。自定义物品通过其真实 ID 识别,而不仅仅是基础材质。
玩家能通过潜影盒、包裹或箱子绕过限制吗?
不能。潜影盒和包裹内的物品会计入数量,且你可以完全禁止存储受限物品。
它会拖慢我的服务器吗?
它专为轻量级设计。背包扫描是分步进行的,并且当 TPS 下降时会自动减速。
它在 Folia 上能用吗?
目前不行。支持 Paper、Spigot 及其衍生版本。
兼容性
- Minecraft: 1.21 - 1.21.11, 26.1 - 26.3
- 服务端: Paper, Spigot 及 Paper 衍生版
- Java: 21 或更高版本
- 不支持: Folia, Forge/Bukkit 混合端
ItemControl
Control how many of any item can exist on your Minecraft server.
ItemControl is an item limit and enchantment limit plugin for Paper and Spigot. Want only one Mace on the whole server? Max 3 totems per player? No Sharpness V? Set it up in a menu with a few clicks and the plugin keeps count by itself.
Works on 1.21 - 1.21.11 and 26.1 - 26.3.
What it does
Item limits
- Global limits - cap how many of an item exist on the whole server. Perfect for legendary weapons, rare drops and "only one exists" items.
- Player limits - cap how many one player can hold. No more hoarding.
- Custom items are tracked separately from vanilla ones (name, lore, custom model data, PDC).
- Items hidden in shulker boxes and bundles still count.
- When a limited item is destroyed (lava, cactus, despawn, void), its slot frees up again.
Enchantment limits
- Limit any enchantment, or only specific levels (like Sharpness V).
- Enchants above the limit get lowered to the highest allowed level when possible.
Usage and storage rules
- Let players keep an item but block using it (attacking, placing, eating, shooting).
- Block limited items from being stored in chests, hoppers or shulker boxes.
Advanced rules
- 5 limit types - how many exist right now, how many can ever be obtained, per time period (like daily), rolling window, or forever per player.
- 8 actions when someone goes over - block, quarantine, drop, delete, downgrade, replace, run a command, or just log it.
- Source filters - allow or block items by where they came from: crafting, trading, fishing, loot chests, mob drops, anvils, enchanting, brewing, smelting, creative and more.
- Shared pools - one limit for a group of items. Example: max 10 netherite items on the whole server, no matter which ones.
- Profiles - make rules apply only in certain worlds, biomes, WorldGuard regions, game modes, times of day, weather or Y levels, or only for players with a certain permission.
- Effect limits - cap potion effect level and duration, or block effects from sources like beacons.
Custom crafting
- Create your own 3x3 recipes with exact amounts per slot (for example 2 diamond blocks in one slot).
- Players browse them with
/recipes.
- Every recipe can have its own permission.
Quarantine
Items over the limit can be stored instead of deleted. Admins can look through them and give them back to the owner with one click.
Audit and repair
/ic audit checks online players and loaded chests and tells you if any counter is off. Repair only ever raises counters, so it can never free up a slot by mistake.
Built to be safe
- Counters survive restarts and crashes. If another plugin cancels an action, the count is rolled back.
- Tracked items carry a server-signed tag, so items with faked tracking data aren't trusted.
- Automatic backups, undo for your last rule change, and a change log.
- If a data file breaks, the plugin stops and tells you which one instead of wiping your data.
- Scans slow down by themselves when TPS drops.
Works with your plugins
Supports 50+ plugins out of the box, including PlaceholderAPI, WorldGuard, LuckPerms, ItemsAdder, Oraxen, Nexo, MMOItems, MythicMobs, Slimefun, crate plugins and shop plugins. Custom items keep their identity, so a limit hits the exact item you picked. Everything is optional, no dependencies needed.
Getting started
- Put the jar into your
plugins folder.
- Restart the server.
- Run
/ic menu.
- Click an item in your inventory and set a limit. That's it.
Commands
/ic menu - open the Control Center
/ic status - quick overview
/ic inspect - see which rules match the item in your hand
/ic audit - check counters (/ic audit repair to fix them)
/ic quarantine - review quarantined items
/ic reload - reload files
/recipes - browse custom recipes (for players)
Permissions
itemcontrol.admin - menu and admin commands (op by default)
itemcontrol.audit - run audits (op)
itemcontrol.quarantine - manage quarantine (op)
itemcontrol.recipes - use /recipes (everyone)
itemcontrol.recipe.<tag> - access to one custom recipe
itemcontrol.bypass.* - ignore all limits
itemcontrol.bypass.item.<item> - ignore the limit for one item
itemcontrol.bypass.enchant.<enchant> - ignore the limit for one enchantment
Bypass permissions only work after you turn them on in the settings menu. OPs don't bypass limits by default.
Placeholders
%itemcontrol_held_remaining% %itemcontrol_held_rules% %itemcontrol_rules% %itemcontrol_quarantine% %itemcontrol_tps%
FAQ
Can I make an item that only exists once on the whole server?
Yes. Give it a global limit of 1. If it gets destroyed, someone else can get it again.
Does it work with ItemsAdder, Oraxen, Nexo or MMOItems items?
Yes. Custom items are recognized by their real ID, not just the base material.
Can players get around limits with shulker boxes, bundles or chests?
No. Items inside shulker boxes and bundles count, and you can block storing limited items completely.
Will it lag my server?
It's built to stay light. Inventory scans are spread out and slow down automatically when TPS drops.
Does it work on Folia?
Not right now. Paper, Spigot and Paper forks are supported.
Compatibility
- Minecraft: 1.21 - 1.21.11, 26.1 - 26.3
- Server: Paper, Spigot and Paper forks
- Java: 21 or newer
- Not supported: Folia, Forge/Bukkit hybrids
评论 0
登录后参与评分
还没有评论,来抢沙发吧