** ? 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 更新
- 依赖注入以实现整洁的架构
- 轻量级 - 对服务器影响极小
? 安装
-
要求:
- Minecraft Server 1.21.1 - 1.21.11
- Paper(或基于 Paper 的服务器,如 Purpur、Pufferfish)
- Java 21+
-
步骤:
下载 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 文档
? 故障排除
药水仍在被酿造
- 运行
/plimit list 确认药水已在黑名单中
- 验证您使用的是 1.21 药水名称(例如
SWIFTNESS 而不是 SPEED)
- 修改配置后运行
/plimit reload
- 检查控制台中是否有“Invalid PotionType”警告
- 通过
/plimit list 验证世界限制
控制台出现 “Invalid PotionType”(无效药水类型) 警告
这意味着你正在使用旧版的 1.20 名称。请更新你的配置文件:
- ❌
SPEED → ✅ SWIFTNESS
- ❌
INSTANT_HEAL → ✅ HEALING
- ❌
JUMP_BOOST → ✅ LEAPING
- ❌
INSTANT_DAMAGE → ✅ HARMING
插件在某个世界中未生效
- 检查
world-settings.blacklist-mode 设置
- 确保世界名称完全匹配(区分大小写)
- 请使用世界文件夹名称,而非显示名称
玩家未收到通知
- 检查配置中的
notify-players: true 设置
- 增大
notify-radius 的数值
- 验证 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 名称**
** ? PotionLimiter - Complete Plugin Documentation
? Description
PotionLimiter is a powerful and lightweight Minecraft plugin for Paper 1.21.1+ that gives server administrators complete control over the brewing system. Whether you want to balance PvP, create custom game modes, or restrict certain potion types for gameplay reasons, PotionLimiter provides an intuitive and flexible solution.
The plugin allows you to:
- Blacklist specific potion types from being brewed (including variants like LONG, STRONG)
- Control brewing by world - enable or disable the plugin in specific worlds
- Notify players when blocked potions are attempted
- Preserve ingredients when brewing is blocked
- Easy configuration with copy-paste reference examples
Built with modern Java 21, Paper API, and Kyori Adventure (MiniMessage), PotionLimiter offers clean code, performance optimization, and beautiful chat formatting.
✨ Key Features
? Granular Potion Control
- Block specific PotionTypes (e.g.,
STRENGTH, LONG_STRENGTH, STRONG_STRENGTH)
- Support for all Minecraft 1.21 potions including new additions:
- Wind Charged
- Weaving
- Oozing
- Infested
- Easy-to-use configuration with built-in reference list
? World-Based Management
- Blacklist Mode: Disable plugin in specific worlds (creative, lobby, etc.)
- Whitelist Mode: Only enable plugin in specific worlds (survival only)
- Per-world control for maximum flexibility
? Player Notifications
- Configurable radius-based notifications
- Beautiful MiniMessage formatting with gradients and colors
- Toggle notifications on/off
- Custom blocked messages per potion type
? Ingredient Preservation
- Brewing events are cancelled before ingredients are consumed
- Items remain in brewing stand when blocked
- Prevents resource waste
⚙️ Admin-Friendly
- Simple
/plimit reload command - no server restart needed
/plimit list shows all blocked potions and world restrictions
- Tab completion for all commands
- Clear console logging
? Performance & Modern Code
- Java 21 with modern syntax (switch expressions, pattern matching)
- No NMS (Native Minecraft Server code) - fully compatible with Paper updates
- Dependency injection for clean architecture
- Lightweight - minimal server impact
? Installation
-
Requirements:
- Minecraft Server 1.21.1 - 1.21.11
- Paper (or Paper-based servers like Purpur, Pufferfish)
- Java 21+
-
Steps:
Download PotionLimiter-1.0.0.jar
Place in your server's plugins/ folder
Start/restart your server
Edit plugins/PotionLimiter/config.yml
Run /plimit reload in-game
? Usage Examples
Example 1: Block Strength Potions in All Worlds
Perfect for balanced PvP servers where strength potions are too overpowered.
blacklisted-potions:
- STRENGTH
- LONG_STRENGTH
- STRONG_STRENGTH
Result: Players cannot brew any strength potions. The brewing stand will not complete the process.
Example 2: Disable Plugin in Creative World
Allow unrestricted brewing in creative/building worlds while maintaining restrictions in survival.
world-settings:
blacklist-mode: true Blacklist mode
blacklisted-worlds:
- world_creative
- lobby
- skyblock_spawn
Result: Plugin is disabled in world_creative, lobby, and skyblock_spawn. Players can brew anything there. In all other worlds, restrictions apply.
Example 3: Only Work in Survival World (Whitelist Mode)
Enable the plugin ONLY in your main survival world, ignoring all other worlds.
world-settings:
blacklist-mode: false Whitelist mode
blacklisted-worlds:
- world Only active here
Result: Plugin is only active in the world named world. All other worlds have unrestricted brewing.
Example 4: Block All Harmful Potions
Great for peaceful/roleplay servers.
blacklisted-potions:
- HARMING
- STRONG_HARMING
- POISON
- LONG_POISON
- STRONG_POISON
- WEAKNESS
- LONG_WEAKNESS
Example 5: Block Invisibility for Fair PvP
Prevent invisibility potions in PvP arenas.
blacklisted-potions:
- INVISIBILITY
- LONG_INVISIBILITY
Example 6: Block 1.21 New Potions
Disable the new experimental potions added in 1.21.
blacklisted-potions:
- WIND_CHARGED
- WEAVING
- OOZING
- INFESTED
Example 7: Custom Notification Settings
Configure how players are notified when brewing is blocked.
brewing-settings:
notify-players: true
notify-radius: 10 10 blocks
blocked-message: "<gradient:ff0000:ff6666>⚠ You cannot brew <potion> on this server!</gradient>"
Result: Players within 10 blocks of the brewing stand receive a gradient red message.
Example 8: Disable Notifications (Silent Mode)
Block potions without notifying players.
brewing-settings:
notify-players: false
Result: Brewing is blocked silently. Only console logs the event.
? Common Use Cases
1. Competitive PvP Servers
Block overpowered potions for balanced combat
blacklisted-potions:
- STRONG_STRENGTH
- STRONG_HEALING
- LONG_INVISIBILITY
- TURTLE_MASTER
- STRONG_TURTLE_MASTER
2. Survival Servers with Custom Mechanics
Force players to obtain potions through custom methods (shops, quests, etc.)
blacklisted-potions:
- REGENERATION
- LONG_REGENERATION
- STRONG_REGENERATION
- HEALING
- STRONG_HEALING
3. Minigame Servers
Disable plugin in minigame worlds, enable in lobby
world-settings:
blacklist-mode: true
blacklisted-worlds:
- bedwars
- skywars
- parkour
4. Roleplay/Peaceful Servers
Block all combat/harmful potions
blacklisted-potions:
- HARMING
- STRONG_HARMING
- POISON
- LONG_POISON
- STRONG_POISON
- STRENGTH
- LONG_STRENGTH
- STRONG_STRENGTH
5. Economy Servers
Block high-value potions to maintain economy balance
blacklisted-potions:
- STRONG_HEALING
- STRONG_REGENERATION
- LONG_NIGHT_VISION
- LONG_WATER_BREATHING
? Commands
| Command |
Description |
Permission |
/plimit reload |
Reload configuration without restart |
potionlimiter.admin |
/plimit list |
Show all blacklisted potions and world restrictions |
potionlimiter.admin |
/plimit help |
Display command help |
potionlimiter.admin |
Aliases: /potionlimiter, /pl
? Permissions
| Permission |
Description |
Default |
potionlimiter.admin |
Access to all commands |
OP |
⚙️ Configuration Reference
brewing-settings
brewing-settings:
return-ingredients: true Preserve ingredients when blocked (always true in Paper)
notify-players: true Send messages to nearby players
notify-radius: 5 Notification radius in blocks
blocked-message: "<red>⚗ Brewing of <potion> has been disabled!</red>"
world-settings
world-settings:
blacklist-mode: true true = disable in listed worlds, false = only enable in listed
blacklisted-worlds:
- world_creative
- lobby
blacklisted-potions
blacklisted-potions:
- STRENGTH Add PotionType names here
- LONG_STRENGTH
- STRONG_STRENGTH
messages
messages:
prefix: "<gradient:00ffff:0080ff>[PotionLimiter]</gradient> "
reload-success: "<green>Configuration reloaded successfully!</green>"
reload-error: "<red>Error reloading configuration! Check console.</red>"
no-permission: "<red>You don't have permission to use this command.</red>"
list-header: "<gradient:ff0000:ff6666>===== Blacklisted Potions =====</gradient>"
list-item: "<red>• <potion></red>"
list-empty: "<yellow>No potions are currently blacklisted.</yellow>"
list-footer: "<gray>Total: <count> potion(s) blocked</gray>"
? All Available Potion Types (1.21)
Click to expand full potion list
Base Potions
WATER - Water Bottle
MUNDANE - Mundane Potion
THICK - Thick Potion
AWKWARD - Awkward Potion
Swiftness (Speed)
SWIFTNESS - Swiftness I (3:00) ⚠️ Changed from SPEED
LONG_SWIFTNESS - Swiftness I (8:00) ⚠️ Changed from LONG_SPEED
STRONG_SWIFTNESS - Swiftness II (1:30) ⚠️ Changed from STRONG_SPEED
Slowness
SLOWNESS - Slowness I (1:30)
LONG_SLOWNESS - Slowness I (4:00)
STRONG_SLOWNESS - Slowness IV (0:20)
Strength
STRENGTH - Strength I (3:00)
LONG_STRENGTH - Strength I (8:00)
STRONG_STRENGTH - Strength II (1:30)
Healing (Instant Health)
HEALING - Instant Health I ⚠️ Changed from INSTANT_HEAL
STRONG_HEALING - Instant Health II ⚠️ Changed from STRONG_INSTANT_HEAL
Harming (Instant Damage)
HARMING - Instant Damage I ⚠️ Changed from INSTANT_DAMAGE
STRONG_HARMING - Instant Damage II ⚠️ Changed from STRONG_INSTANT_DAMAGE
Leaping (Jump Boost)
LEAPING - Jump Boost I (3:00) ⚠️ Changed from JUMP_BOOST
LONG_LEAPING - Jump Boost I (8:00) ⚠️ Changed from LONG_JUMP_BOOST
STRONG_LEAPING - Jump Boost II (1:30) ⚠️ Changed from STRONG_JUMP_BOOST
Regeneration
REGENERATION - Regeneration I (0:45)
LONG_REGENERATION - Regeneration I (1:30)
STRONG_REGENERATION - Regeneration II (0:22)
Fire Resistance
FIRE_RESISTANCE - Fire Resistance (3:00)
LONG_FIRE_RESISTANCE - Fire Resistance (8:00)
Water Breathing
WATER_BREATHING - Water Breathing (3:00)
LONG_WATER_BREATHING - Water Breathing (8:00)
Invisibility
INVISIBILITY - Invisibility (3:00)
LONG_INVISIBILITY - Invisibility (8:00)
Night Vision
NIGHT_VISION - Night Vision (3:00)
LONG_NIGHT_VISION - Night Vision (8:00)
Weakness
WEAKNESS - Weakness (1:30)
LONG_WEAKNESS - Weakness (4:00)
Poison
POISON - Poison I (0:45)
LONG_POISON - Poison I (1:30)
STRONG_POISON - Poison II (0:21)
Turtle Master
TURTLE_MASTER - Turtle Master I (0:40)
LONG_TURTLE_MASTER - Turtle Master I (1:20)
STRONG_TURTLE_MASTER - Turtle Master II (0:20)
Slow Falling
SLOW_FALLING - Slow Falling (1:30)
LONG_SLOW_FALLING - Slow Falling (4:00)
1.21 New Potions ✨
WIND_CHARGED - Wind Charged (3:00) ?
WEAVING - Weaving (3:00) ?
OOZING - Oozing (3:00) ?
INFESTED - Infested (3:00) ?
? MiniMessage Format Examples
PotionLimiter uses MiniMessage for beautiful chat formatting. You can customize all messages in config.yml.
Gradient Text
blocked-message: "<gradient:ff0000:ffff00>⚠ This potion is banned!</gradient>"
Rainbow Text
blocked-message: "<rainbow>You cannot brew <potion>!</rainbow>"
Bold/Italic/Underline
blocked-message: "<bold><red>BREWING BLOCKED:</red></bold> <italic><potion></italic>"
Hover Text
blocked-message: "<hover:show_text:'Contact admin for help'><red>Brewing disabled!</red></hover>"
Combined Effects
blocked-message: "<gradient:ff0000:ff6666><bold>⚠ BLOCKED</bold></gradient> <gray>-</gray> <yellow><potion></yellow>"
Learn more: MiniMessage Documentation
? Troubleshooting
Potions are still being brewed
- Check
/plimit list to confirm potions are in the blacklist
- Verify you're using 1.21 potion names (e.g.,
SWIFTNESS not SPEED)
- Run
/plimit reload after config changes
- Check console for "Invalid PotionType" warnings
- Verify world restrictions with
/plimit list
"Invalid PotionType" warnings in console
This means you're using old 1.20 names. Update your config:
- ❌
SPEED → ✅ SWIFTNESS
- ❌
INSTANT_HEAL → ✅ HEALING
- ❌
JUMP_BOOST → ✅ LEAPING
- ❌
INSTANT_DAMAGE → ✅ HARMING
Plugin not working in a world
- Check
world-settings.blacklist-mode
- Verify world name matches exactly (case-sensitive)
- Use world folder name, not display name
Players not receiving notifications
- Check
notify-players: true in config
- Increase
notify-radius value
- Verify MiniMessage syntax is correct
? Performance
- Event Handling: Optimized brewing recipe prediction
- Memory Usage: <5MB typical
- CPU Impact: Negligible (<0.1% on modern hardware)
- No NMS: Future-proof and update-safe
? Support
- Discord: geturplugins
- Issues: Report bugs with detailed steps to reproduce
- Feature Requests: Suggest improvements with use cases
- Questions: Provide server version, config, and console logs
? Credits
Developer: geturplugins
API: PaperMC Team
Chat Library: Kyori Adventure Team
Built with: Java 21, Maven, IntelliJ IDEA
? Changelog
Version 1.0.0 (Initial Release)
- ✅ Granular potion blacklist system
- ✅ World-based blacklist/whitelist
- ✅ Player notifications with MiniMessage
- ✅ Admin commands (reload, list, help)
- ✅ Tab completion
- ✅ Ingredient preservation
- ✅ Java 21 & Paper 1.21.1 support
- ✅ Full configuration examples
- ✅ Updated for 1.21 PotionType names (SWIFTNESS, HEALING, LEAPING, HARMING)
- ✅ Advanced brewing recipe prediction system
? Quick Reference Card
Most Common Blocked Potions (PvP Servers)
blacklisted-potions:
Combat potions
- STRENGTH Strength I
- LONG_STRENGTH Strength I (8:00)
- STRONG_STRENGTH Strength II
Healing potions
- HEALING Instant Health I (NEW NAME)
- STRONG_HEALING Instant Health II (NEW NAME)
Movement potions
- SWIFTNESS Speed I (NEW NAME)
- LONG_SWIFTNESS Speed I extended (NEW NAME)
- STRONG_SWIFTNESS Speed II (NEW NAME)
Utility potions
- INVISIBILITY Invisibility
- LONG_INVISIBILITY Invisibility extended
Damage potions
- HARMING Instant Damage I (NEW NAME)
- STRONG_HARMING Instant Damage II (NEW NAME)
? PotionLimiter - Take Control of Your Server's Brewing! ?
Updated for Minecraft 1.21.1 with new PotionType names**
评论 0
登录后参与评分
还没有评论,来抢沙发吧