原创 开源 RecallPotion | 泰拉瑞亚 的 回忆药水 v1.2.0

RecallPotion｜回忆药水

一款轻量级的 Paper 插件，将传统的 /home 传送改造成需要实际资源成本的生存玩法。

玩家需要通过酿造台制作并饮用回忆药水，才能返回自己的床、重生锚或服务器出生点。

---

插件介绍

RecallPotion 最初为个人服务器开发，主要目标是为“回家传送”增加合理的制作成本。

相比直接使用免费且无消耗的 /home 命令，玩家需要收集材料、制作浓稠药水，并等待酿造完成后才能获得回忆药水。

整个过程使用原版酿造台完成，不需要额外安装客户端模组或资源包。

---

主要功能

原版酿造台配方

使用 Paper 的 PotionMix API 注册自定义酿造配方，无需额外合成界面。

有成本的回家传送

玩家饮用回忆药水后，将被传送至：

• 玩家设置的床或已充能重生锚
• 没有个人重生点时，传送至服务器重生世界的出生点

可自定义酿造材料

管理员可以在配置文件中修改酿造所需的材料，例如回响碎片、末影珍珠或钻石。

可自定义酿造时间

可以单独设置回忆药水的酿造时长，不会影响其他普通药水配方。

可自定义药水名称

支持修改新酿造回忆药水的显示名称。

可靠的药水识别

插件使用 PDC 数据标记识别回忆药水，不依赖药水名称、颜色或附魔光效，避免普通药水被误判。

安全的消费验证

只有在插件确认药水被真正饮用后，才会开始传送流程。

能够正确处理：

• 消费事件被其他插件取消
• 主手与副手饮用
• 创造模式
• 堆叠药水
• 玻璃瓶和自定义替换物品
• 其他插件修改药水消费结果

安全的延迟传送

等待传送期间，如果玩家切换物品、操作背包、丢弃物品、进入传送门、切换游戏模式、死亡、下线或被其他来源传送，本次回忆传送将自动取消。

---

默认酿造配方

制作回忆药水时，请将浓稠药水放入酿造台底部，并在顶部放入回响碎片。


自定义酿造时间只会应用于有效的回忆药水配方。

即使其他配方使用了相同的酿造材料，也不会受到影响。

---

配置文件

默认配置如下：


可用材料示例：


或：


填写无效材料、空气方块或非物品类型时，插件会自动恢复为默认的 ECHO_SHARD。

升级插件后，缺少的新配置项会自动添加，不会覆盖已有配置。

---

命令与权限


该权限默认仅服务器管理员拥有。

普通玩家制作和饮用回忆药水不需要任何权限。

---

运行要求

• 服务端：Paper
• Minecraft：1.21.9
• Java：Java 21
• 前置插件：无

本插件使用 Paper 专属的酿造 API，不支持仅运行 Spigot API 的服务端。

---

安装方法

1. 下载最新版本的 RecallPotion 插件
2. 将插件放入服务器的 /plugins 文件夹
3. 启动或重启服务器
4. 根据需要修改 plugins/recallPotion/config.yml
5. 修改配置后执行 /recallpotion reload

---

旧版本升级说明

从 v1.2.0 开始，回忆药水使用 PDC 数据标记进行识别。

旧版本制作的药水可能没有新的识别标记，因此升级后可能无法继续触发传送。

建议升级插件后重新酿造新的回忆药水。

---