ItemLimiter

插件

· 作者 nieuwjaar

一个简单且轻量的 ItemLimiter 插件!

0 本站下载 0 关注 更新于 5 个月前

最新 2.5 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

ItemLimiter

ItemLimiter 是一款轻量级且高度可配置的 Minecraft 插件,允许服务器管理员限制玩家携带、存储、拾取、移动或合成特定物品的数量。

它通过为每种物品强制执行可配置的数量上限,帮助防止玩家囤积强力物品,例如 Totem、Ender Pearl、Golden Apple、Mace 或任何其他材料。

该插件设计为 完全可配置、轻量级 且 安全,同时防止通过容器、Bundle、合成、库存操作和物品拾取等方式绕过限制。


主要功能

库存物品上限

每个已配置的物品都可以设置 玩家可携带的最大数量。

如果玩家尝试超过该数量:

  • 该操作将被 阻止
  • 或者 多余的物品会自动从库存中掉落

使用示例:

  • 限制 Totem 数量为 1
  • 限制 Ender Pearl 数量为 16
  • 限制 Golden Apple 数量为 8

可配置的物品交互行为

每个物品可以限制不同类型的交互:

行为 描述
pickup 当达到上限时,防止玩家拾取更多该物品
containers 处理与容器相关的限制,包括从容器中取出物品以及限制在支持的容器中存储的数量
inventory 当会导致超出限制时,防止将物品移动到玩家的库存中
craft 当玩家的库存限制会被超出时,防止合成该物品
global 当玩家的终身/全局合成总量限制会被超出时,防止合成该物品

配置示例:

{
  "TOTEM_OF_UNDYING": {
    "limit": 1,
    "action": ["pickup", "containers", "inventory"]
  },
  "ENDER_PEARL": {
    "limit": 16,
    "action": ["pickup"]
  },
  "MACE": {
    "limit": 1,
    "action": ["global"]
  }
}

上限基于所配置的行为。基于库存的上限计算玩家库存中的物品数量(包括 Bundle 的内容,如适用)。全局上限跟踪每位玩家针对每种材料的合成总数。


独立的容器存储上限

containers 行为还可以限制在支持的容器中存储的特定物品数量。

要为同一种材料使用独立的容器存储上限,请使用 seperate 标志:

/itemlimiter add TOTEM_OF_UNDYING 0 containers seperate

这将创建一个单独的配置条目:

{
  "TOTEM_OF_UNDYING": {
    "limit": 1,
    "action": ["pickup", "inventory"]
  },
  "TOTEM_OF_UNDYING#containers": {
    "limit": 0,
    "action": ["containers"]
  }
}

这允许玩家携带 1 个 Totem,同时防止将 Totem 存储在容器中。

支持的存储容器包括:

Chests
Barrels
Shulker Boxes
Hoppers
Droppers
Dispensers
Furnaces
Smokers
Blast Furnaces
Crafters
Brewing Stands
Decorated Pots
Chiseled Bookshelves
Jukeboxes
Lecterns
Ender Chests

智能上限执行

如果玩家已经超过了上限(例如在安装插件或更改配置后),插件将自动:

  1. 检测多余物品
  2. 从玩家库存中移除它们
  3. 自然地掉落在地面上

这可以防止玩家利用之前持有的物品来绕过限制。


对容器友好的逻辑

除非你配置了单独的容器存储上限,否则玩家仍然可以将物品存储在容器中。

默认允许:

  • 使用 Shift+点击将物品从库存放入箱子
  • 将物品放入 Shulker Box
  • 将物品放入 Bundle

当个人上限达到时阻止:

  • 从箱子移动到库存
  • 从 Bundle 移动到库存
  • 从漏斗移动到库存

当容器存储上限达到时阻止:

  • 向支持的容器中添加超过允许数量的物品
  • 使用快捷栏键或副手交换来绕过容器限制

全局合成上限

global 行为会跟踪每位玩家在一段时间内合成已配置物品的次数。

全局合成总数持久存储在:

crafted-limits.db

你可以使用以下命令查看你的全局合成数量:

/itemlimiter globalcheck <material>

对于使用 craft 或 global 行为的物品,Crafter 方块的自动化合成功能被阻止,因为无法可靠地将自动化合成链接到玩家以进行数据库跟踪。


完全可配置

该插件使用 Bukkit 材质名称 和 JSON 配置文件。

目录结构:

plugins/ItemLimiter/

config.json
config-examples.txt
crafted-limits.db

translations/
  messages.json

功能包括:

  • 可编辑的消息
  • 可配置的物品上限
  • 每个物品可配置的行为
  • 可配置的全局上限公告
  • 内置文档示例

热重载支持

你可以重新加载配置文件和翻译文件,而无需重启服务器。

/itemlimiter reload

如果配置文件缺失,插件将自动重新创建它们。


命令

命令 描述
/itemlimiter help 显示所有插件命令
/itemlimiter list [page] 列出已配置的物品上限
/itemlimiter info <material> 显示关于某个物品的信息
/itemlimiter check <material> 显示你当前拥有的物品数量
/itemlimiter globalcheck <material> 显示你某物品的全局合成数量
/itemlimiter add <material> <limit> <actions> [seperate] 添加新的物品上限
/itemlimiter edit <material> <limit> <actions> 编辑现有物品
/itemlimiter remove <material> 移除物品上限
/itemlimiter reload 重新加载插件配置

权限

权限 描述 默认值
itemlimiter.help 允许使用 /itemlimiter help 命令 true
itemlimiter.info 允许使用 /itemlimiter info 命令 op
itemlimiter.list 允许使用 /itemlimiter list 命令 op
itemlimiter.check 允许使用 /itemlimiter check 命令 op
itemlimiter.globalcheck 允许使用 /itemlimiter globalcheck 命令 true
itemlimiter.reload 允许使用 /itemlimiter reload 命令 op
itemlimiter.add 允许添加新的物品限制 op
itemlimiter.edit 允许编辑物品限制 op
itemlimiter.remove 允许移除物品限制 op
itemlimiter.bypass 绕过所有物品限制 false
itemlimiter.update.notify 允许接收更新通知 op

为什么选择 ItemLimiter?

许多服务器面临物品囤积或堆叠问题,例如:

  • 携带数十个不死图腾
  • 末影珍珠过度堆叠
  • 金苹果囤积
  • PvP 或生存模式中的物品失衡
  • 在容器内存储受限物品

ItemLimiter 提供了一种简洁且可配置的方式来平衡游戏性,同时让服务器管理员能够精确决定哪些物品需要受到限制。


兼容性

  • Minecraft 1.20+
  • Spigot / Paper
  • 轻量级,对性能影响极小

示例用例

服务器常限制的物品包括:

TOTEM_OF_UNDYING
ENDER_PEARL
ELYTRA
MACE
GOLDEN_APPLE
ENCHANTED_GOLDEN_APPLE
SHIELD
TRIDENT

配置理念

ItemLimiter 的设计目标是:

  • 简单
  • 灵活
  • 对服务器友好

你可以决定哪些物品、多少玩家能携带或存储,以及哪些交互行为受到限制。


支持

如果你遇到问题或有功能建议,欢迎在 Discord 服务器中提交工单。

享受为你服务器打造的平衡且可控的物品库存系统。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源