PotionLimiter

插件

· 作者 geturplugins

在你的服务器上禁用药水酿造,支持药水黑名单和世界黑名单系统......

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

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

** ? PotionLimiter - 完整插件文档

? 描述

PotionLimiter 是一款功能强大且轻量的 Minecraft 插件,适用于 Paper 1.21.1+,赋予服务器管理员对酿造系统的完全控制权。无论您是想平衡 PvP、创建自定义游戏模式,还是出于玩法原因限制某些药水类型,PotionLimiter 都能提供直观且灵活的解决方案。

该插件允许您:

  • 将特定的药水类型列入黑名单,禁止其被酿造(包括 LONG、STRONG 等变种)
  • 按世界控制酿造 - 在特定世界中启用或禁用插件
  • 通知玩家 当尝试酿造被禁用的药水时
  • 保留原料 当酿造被阻止时
  • 易于配置,提供复制粘贴的参考示例

基于现代 Java 21、Paper API 和 Kyori Adventure (MiniMessage) 构建,PotionLimiter 提供整洁的代码、性能优化以及美观的聊天格式化效果。


✨ 主要特性

? 精细的药水控制

  • 阻止特定的 PotionTypes(例如 STRENGTH、LONG_STRENGTH、STRONG_STRENGTH)
  • 支持所有 Minecraft 1.21 药水,包括新增内容:
    • Wind Charged(风充注)
    • Weaving(编织)
    • Oozing(渗出)
    • Infested(虫蚀)
  • 易于使用的配置,内置参考列表

? 基于世界的管理

  • 黑名单模式:在特定世界中禁用插件(如创造模式、大厅等)
  • 白名单模式:仅在特定世界中启用插件(仅限生存模式)
  • 每个世界的独立控制,实现最大灵活性

? 玩家通知

  • 可配置的基于半径的通知
  • 带有渐变和颜色的精美 MiniMessage 格式化
  • 可切换通知的开/关
  • 每种药水类型的自定义阻止消息

? 原料保留

  • 在消耗原料之前取消酿造事件
  • 当酿造被阻止时,物品保留在酿造台中
  • 防止资源浪费

⚙️ 对管理员友好

  • 简单的 /plimit reload 命令 - 无需重启服务器
  • /plimit list 显示所有被阻止的药水及世界限制
  • 所有命令均支持 Tab 补全
  • 清晰的控制台日志

? 高性能与现代代码

  • 使用 Java 21 及现代语法(switch 表达式、模式匹配)
  • 无 NMS(原生 Minecraft 服务端代码)- 完全兼容 Paper 更新
  • 依赖注入以实现整洁的架构
  • 轻量级 - 对服务器影响极小

? 安装

  1. 要求:

    • Minecraft Server 1.21.1 - 1.21.11
    • Paper(或基于 Paper 的服务器,如 Purpur、Pufferfish)
    • Java 21+
  2. 步骤:

     下载 PotionLimiter-1.0.0.jar
     将其放入服务器的 plugins/ 文件夹
     启动/重启您的服务器
     编辑 plugins/PotionLimiter/config.yml
     在游戏中运行 /plimit reload
    

? 使用示例

示例 1:在所有世界中阻止力量药水 非常适合力量药水过于超模的平衡 PvP 服务器。

blacklisted-potions:
  - STRENGTH
  - LONG_STRENGTH
  - STRONG_STRENGTH

结果: 玩家无法酿造任何力量药水。酿造台将不会完成酿造过程。


示例 2:在创造世界禁用插件 允许在创造/建造世界中自由酿造,同时在生存模式中保持限制。

world-settings:
  blacklist-mode: true   黑名单模式
  blacklisted-worlds:
    - world_creative
    - lobby
    - skyblock_spawn

结果: 插件在 world_creative、lobby 和 skyblock_spawn 中被禁用。玩家可以在这些世界中酿造任何东西。在所有其他世界中,限制仍然适用。


示例 3:仅在主生存世界生效(白名单模式) 仅在您的主生存世界中启用插件,忽略所有其他世界。

world-settings:
  blacklist-mode: false   白名单模式
  blacklisted-worlds:
    - world   仅在此处激活

结果: 插件仅在名为 world 的世界中激活。所有其他世界均可自由酿造。


示例 4:阻止所有有害药水 非常适合和平/角色扮演服务器。

blacklisted-potions:
  - HARMING               
  - STRONG_HARMING       
  - POISON
  - LONG_POISON
  - STRONG_POISON
  - WEAKNESS
  - LONG_WEAKNESS

示例 5:为公平 PvP 阻止隐形药水 防止在 PvP 竞技场中使用隐形药水。

blacklisted-potions:
  - INVISIBILITY
  - LONG_INVISIBILITY

示例 6:阻止 1.21 新药水 禁用 1.21 中添加的新实验性药水。

blacklisted-potions:
  - WIND_CHARGED
  - WEAVING
  - OOZING
  - INFESTED

示例 7:自定义通知设置 配置玩家在酿造被阻止时如何收到通知。

brewing-settings:
  notify-players: true
  notify-radius: 10   10 格
  blocked-message: "<gradient:ff0000:ff6666>⚠ 您不能在此服务器上酿造 <potion>!</gradient>"

结果: 酿造台 10 格范围内的玩家会收到一条红色的渐变消息。


示例 8:禁用通知(静默模式) 阻止药水而不通知玩家。

brewing-settings:
  notify-players: false

结果: 酿造被静默阻止。仅控制台记录该事件。


? 常见用例

1. 竞技 PvP 服务器

 阻止超模药水以实现平衡战斗
blacklisted-potions:
  - STRONG_STRENGTH
  - STRONG_HEALING        
  - LONG_INVISIBILITY
  - TURTLE_MASTER
  - STRONG_TURTLE_MASTER

2. 具有自定义机制的生存服务器

 强制玩家通过自定义方式获取药水(商店、任务等)
blacklisted-potions:
  - REGENERATION
  - LONG_REGENERATION
  - STRONG_REGENERATION
  - HEALING               
  - STRONG_HEALING        

3. 小游戏服务器

 在小游戏世界中禁用插件,在大厅中启用
world-settings:
  blacklist-mode: true
  blacklisted-worlds:
    - bedwars
    - skywars
    - parkour

4. 角色扮演/和平服务器

# 阻止所有战斗/有害药水
blacklisted-potions:
  - HARMING               
  - STRONG_HARMING        
  - POISON
  - LONG_POISON
  - STRONG_POISON
  - STRENGTH
  - LONG_STRENGTH
  - STRONG_STRENGTH

5. 经济服务器

# 阻止高价值药水以维持经济平衡
blacklisted-potions:
  - STRONG_HEALING        
  - STRONG_REGENERATION
  - LONG_NIGHT_VISION
  - LONG_WATER_BREATHING

? 命令

命令 描述 权限
/plimit reload 无需重启即可重载配置 potionlimiter.admin
/plimit list 显示所有被禁用的药水及世界限制 potionlimiter.admin
/plimit help 显示命令帮助信息 potionlimiter.admin

别名: /potionlimiter, /pl


? 权限

权限 描述 默认值
potionlimiter.admin 访问所有命令 OP(管理员)

⚙️ 配置参考

brewing-settings(酿造设置)

brewing-settings:
  return-ingredients: true       # 阻止时保留材料(Paper 中始终为 true)
  notify-players: true           # 向附近玩家发送消息
  notify-radius: 5               # 通知半径(方块数)
  blocked-message: "<red>⚗ <potion> 的酿造已被禁用!</red>"

world-settings(世界设置)

world-settings:
  blacklist-mode: true           # true = 在列出的世界中禁用,false = 仅在列出的世界中启用
  blacklisted-worlds:
    - world_creative
    - lobby

blacklisted-potions(被禁用的药水列表)

blacklisted-potions:
  - STRENGTH                     # 在此处添加 PotionType 名称
  - LONG_STRENGTH
  - STRONG_STRENGTH

messages(消息)

messages:
  prefix: "<gradient:00ffff:0080ff>[PotionLimiter]</gradient> "
  reload-success: "<green>配置重载成功!</green>"
  reload-error: "<red>重载配置出错!请检查控制台。</red>"
  no-permission: "<red>您没有权限使用此命令。</red>"
  list-header: "<gradient:ff0000:ff6666>===== 被禁用的药水列表 =====</gradient>"
  list-item: "<red>• <potion></red>"
  list-empty: "<yellow>当前没有禁用任何药水。</yellow>"
  list-footer: "<gray>总计:阻止了 <count> 种药水</gray>"

? 所有可用药水类型 (1.21)

点击展开完整药水列表

基础药水

  • WATER - 水瓶
  • MUNDANE - 平庸药水
  • THICK - 浓稠药水
  • AWKWARD - 棘手药水

迅捷药水 (速度)

  • SWIFTNESS - 迅捷 I (3:00) ⚠️ 已从 SPEED 更改
  • LONG_SWIFTNESS - 迅捷 I (8:00) ⚠️ 已从 LONG_SPEED 更改
  • STRONG_SWIFTNESS - 迅捷 II (1:30) ⚠️ 已从 STRONG_SPEED 更改

迟缓药水

  • SLOWNESS - 迟缓 I (1:30)
  • LONG_SLOWNESS - 迟缓 I (4:00)
  • STRONG_SLOWNESS - 迟缓 IV (0:20)

力量药水

  • STRENGTH - 力量 I (3:00)
  • LONG_STRENGTH - 力量 I (8:00)
  • STRONG_STRENGTH - 力量 II (1:30)

治疗药水 (瞬间生命)

  • HEALING - 瞬间生命 I ⚠️ 已从 INSTANT_HEAL 更改
  • STRONG_HEALING - 瞬间生命 II ⚠️ 已从 STRONG_INSTANT_HEAL 更改

伤害药水 (瞬间伤害)

  • HARMING - 瞬间伤害 I ⚠️ 已从 INSTANT_DAMAGE 更改
  • STRONG_HARMING - 瞬间伤害 II ⚠️ 已从 STRONG_INSTANT_DAMAGE 更改

跳跃提升药水

  • LEAPING - 跳跃提升 I (3:00) ⚠️ 已从 JUMP_BOOST 更改
  • LONG_LEAPING - 跳跃提升 I (8:00) ⚠️ 已从 LONG_JUMP_BOOST 更改
  • STRONG_LEAPING - 跳跃提升 II (1:30) ⚠️ 已从 STRONG_JUMP_BOOST 更改

再生药水

  • REGENERATION - 再生 I (0:45)
  • LONG_REGENERATION - 再生 I (1:30)
  • STRONG_REGENERATION - 再生 II (0:22)

抗火药水

  • FIRE_RESISTANCE - 抗火 (3:00)
  • LONG_FIRE_RESISTANCE - 抗火 (8:00)

水下呼吸药水

  • WATER_BREATHING - 水下呼吸 (3:00)
  • LONG_WATER_BREATHING - 水下呼吸 (8:00)

隐身药水

  • INVISIBILITY - 隐身 (3:00)
  • LONG_INVISIBILITY - 隐身 (8:00)

夜视药水

  • NIGHT_VISION - 夜视 (3:00)
  • LONG_NIGHT_VISION - 夜视 (8:00)

虚弱药水

  • WEAKNESS - 虚弱 (1:30)
  • LONG_WEAKNESS - 虚弱 (4:00)

中毒药水

  • POISON - 中毒 I (0:45)
  • LONG_POISON - 中毒 I (1:30)
  • STRONG_POISON - 中毒 II (0:21)

海龟主宰药水

  • TURTLE_MASTER - 海龟主宰 I (0:40)
  • LONG_TURTLE_MASTER - 海龟主宰 I (1:20)
  • STRONG_TURTLE_MASTER - 海龟主宰 II (0:20)

缓降药水

  • SLOW_FALLING - 缓降 (1:30)
  • LONG_SLOW_FALLING - 缓降 (4:00)

1.21 新增药水 ✨

  • WIND_CHARGED - 蓄风 (3:00) ?
  • WEAVING - 编织 (3:00) ?
  • OOZING - 黏液 (3:00) ?
  • INFESTED - 虫蚀 (3:00) ?

? MiniMessage 格式示例

PotionLimiter 使用 MiniMessage 来实现精美的聊天格式。您可以在 config.yml 中自定义所有消息。

渐变文本

blocked-message: "<gradient:ff0000:ffff00>⚠ 此药水已被禁止!</gradient>"

彩虹文本

blocked-message: "<rainbow>您无法酿造 <potion>!</rainbow>"

粗体/斜体/下划线

blocked-message: "<bold><red>酿造已阻止:</red></bold> <italic><potion></italic>"

悬停文本

blocked-message: "<hover:show_text:'联系管理员寻求帮助'><red>酿造已禁用!</red></hover>"

组合效果

blocked-message: "<gradient:ff0000:ff6666><bold>⚠ 已阻止</bold></gradient> <gray>-</gray> <yellow><potion></yellow>"

了解更多:MiniMessage 文档


? 故障排除

药水仍在被酿造

  1. 运行 /plimit list 确认药水已在黑名单中
  2. 验证您使用的是 1.21 药水名称(例如 SWIFTNESS 而不是 SPEED)
  3. 修改配置后运行 /plimit reload
  4. 检查控制台中是否有“Invalid PotionType”警告
  5. 通过 /plimit list 验证世界限制

控制台出现 “Invalid PotionType”(无效药水类型) 警告 这意味着你正在使用旧版的 1.20 名称。请更新你的配置文件:

  • ❌ SPEED → ✅ SWIFTNESS
  • ❌ INSTANT_HEAL → ✅ HEALING
  • ❌ JUMP_BOOST → ✅ LEAPING
  • ❌ INSTANT_DAMAGE → ✅ HARMING

插件在某个世界中未生效

  1. 检查 world-settings.blacklist-mode 设置
  2. 确保世界名称完全匹配(区分大小写)
  3. 请使用世界文件夹名称,而非显示名称

玩家未收到通知

  1. 检查配置中的 notify-players: true 设置
  2. 增大 notify-radius 的数值
  3. 验证 MiniMessage 语法是否正确

? 性能表现

  • 事件处理: 优化了酿造配方预测功能
  • 内存占用: 通常低于 5MB
  • CPU 影响: 可忽略不计(在现代硬件上低于 0.1%)
  • 无 NMS 依赖: 面向未来,兼容各版本更新

? 支持

  • Discord: geturplugins
  • 问题反馈: 报告 Bug 时请提供详细的复现步骤
  • 功能建议: 提出改进意见时请附带使用场景
  • 常见问题: 请提供服务器版本、配置文件及控制台日志

? 致谢

开发者: geturplugins
API: PaperMC Team
聊天库: Kyori Adventure Team
开发环境: Java 21, Maven, IntelliJ IDEA


? 更新日志

Version 1.0.0 (初始发布)

  • ✅ 细粒度的药水黑名单系统
  • ✅ 基于世界的黑名单/白名单功能
  • ✅ 使用 MiniMessage 的玩家通知功能
  • ✅ 管理员命令(reload, list, help)
  • ✅ Tab 键自动补全
  • ✅ 原料保留机制
  • ✅ 支持 Java 21 与 Paper 1.21.1
  • ✅ 完整的配置示例
  • ✅ 适配 1.21 PotionType 新名称(SWIFTNESS, HEALING, LEAPING, HARMING)
  • ✅ 高级酿造配方预测系统

? 快速参考卡

PvP 服务器中最常见的被屏蔽药水

blacklisted-potions:
   战斗类药水
  - STRENGTH               力量 I
  - LONG_STRENGTH          力量 I (8:00)
  - STRONG_STRENGTH        力量 II
  
   治疗类药水
  - HEALING                瞬间恢复 I (新名称)
  - STRONG_HEALING         瞬间恢复 II (新名称)
  
   移动类药水
  - SWIFTNESS              速度 I (新名称)
  - LONG_SWIFTNESS         速度 I 延长版 (新名称)
  - STRONG_SWIFTNESS       速度 II (新名称)
  
   辅助类药水
  - INVISIBILITY           隐身
  - LONG_INVISIBILITY      隐身延长版
  
   伤害类药水
  - HARMING                瞬间伤害 I (新名称)
  - STRONG_HARMING         瞬间伤害 II (新名称)

? PotionLimiter - 掌控服务器的酿造规则! ?

已适配 Minecraft 1.21.1 及新的 PotionType 名称**

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源