? RecallPotion
将家园传送转化为可制作的生存机制。
RecallPotion 是一款轻量级的 Paper 插件,引入了通过原版酿造台酿造的自定义 召回药水(Recall Potion)。
玩家不再依赖免费的 /home 命令,而是必须消耗资源并花费酿造时间才能返回床、重生锚或服务器的重生世界。
✨ 功能特性
-
可制作的家园传送
玩家在回家之前必须先酿造并饮用召回药水。
-
原版酿造台集成
使用 Paper 原生的酿造系统,无需自定义菜单或资源包。
-
可配置的配方
通过 config.yml 更改所需的酿造材料。
-
可配置的酿造时间
设置召回药水的酿造时长。
-
可配置的药水名称
自定义新酿造药水的显示名称。
-
可靠的药水检测
使用持久化数据容器(Persistent Data Container)元数据,而非依赖药水的名称或外观。
-
安全的饮用处理
仅在插件确认药水已被实际饮用后,才会开始传送。
-
插件兼容性保护
被取消的饮用事件和恢复的药水物品不会错误地触发传送。
-
无需玩家指令
玩家只需酿造并饮用药水即可。
? 默认配方
| 输入 |
材料 |
结果 |
酿造时间 |
| 浓稠药水 |
回声碎片 |
召回药水 |
2400 ticks / 120 秒 |
自定义酿造时间仅适用于有效的召回药水配方。使用相同材料的其它配方不受影响。
? 传送行为
成功饮用召回药水后,玩家将被传送到:
- 他们的床或已充能的重生锚。
- 当没有个人重生位置时,传送到服务器重生世界的出生点。
当玩家的相關状态发生变化时(例如切换物品、移动背包物品、进入传送门、死亡、断开连接、更改游戏模式或被其他来源传送),待处理的召回将被安全取消。
⚙️ 配置
# 酿造持续时间(以 tick 为单位)。
brewing-time: 2400
# 酿造材料,使用 Bukkit Material 名称。
brewing-ingredient: ECHO_SHARD
# 新酿造召回药水的显示名称。
potion-name: "Recall Potion"
缺失的配置选项会自动添加,而不会覆盖现有值。
? 指令
| 指令 |
描述 |
权限 |
/recallpotion reload |
重新加载配置和酿造配方 |
recallpotion.reload |
重载权限默认授予服务器操作员。
普通玩家无需任何权限即可酿造或饮用召回药水。
? 依赖要求
- Paper 1.21.9
- Java 21
- 无外部依赖项
RecallPotion 使用 Paper 特定的酿造 API,并非专为仅支持 Spigot 的服务器设计。
? 安装方法
- 下载最新的 RecallPotion 发布版本。
- 将 JAR 文件放入服务器的
plugins 文件夹中。
- 启动或重启服务器。
- (可选)编辑
plugins/recallPotion/config.yml。
- 更改配置后运行
/recallpotion reload。
⚠️ 从旧版本升级
RecallPotion 1.2.0 使用持久化数据容器(Persistent Data Container)元数据来识别自定义药水。
使用旧版本酿造的药水可能不包含所需的标记,从而无法再激活传送。升级后,玩家应重新酿造新的召回药水。
? 反馈
发现 Bug 或有想法?
请在 GitHub Issue 追踪器 上报告。
源代码可在 GitHub 获取。
? RecallPotion
Turn home teleportation into a craftable survival mechanic.
RecallPotion is a lightweight Paper plugin that introduces a custom Recall Potion brewed through the vanilla Brewing Stand.
Instead of relying on a free /home command, players must spend resources and brewing time to return to their bed, respawn anchor, or the server's respawn world.
✨ Features
-
Craftable Home Teleportation
Players must brew and consume a Recall Potion before returning home.
-
Vanilla Brewing Stand Integration
Uses Paper's native brewing system without custom menus or resource packs.
-
Configurable Recipe
Change the required brewing ingredient through config.yml.
-
Configurable Brewing Time
Set how long Recall Potions take to brew.
-
Configurable Potion Name
Customize the display name of newly brewed potions.
-
Reliable Potion Detection
Uses Persistent Data Container metadata instead of relying on the potion's name or appearance.
-
Safe Consumption Handling
Teleportation only begins after the plugin confirms that the potion was actually consumed.
-
Plugin Compatibility Safeguards
Cancelled consumption events and restored potion items will not incorrectly trigger teleportation.
-
No Player Commands Required
Players only need to brew and drink the potion.
? Default Recipe
| Input |
Ingredient |
Result |
Brewing Time |
| Thick Potion |
Echo Shard |
Recall Potion |
2400 ticks / 120 seconds |
The custom brewing time only applies to valid Recall Potion recipes. Other recipes using the same ingredient remain unaffected.
? Teleportation Behavior
After successfully drinking a Recall Potion, the player is teleported to:
- Their bed or charged respawn anchor.
- The server respawn world's spawn point when no personal respawn location is available.
A pending recall is safely cancelled when the player's relevant state changes, such as when they switch items, move inventory items, enter a portal, die, disconnect, change game mode, or are teleported by another source.
⚙️ Configuration
# Brewing duration in ticks.
brewing-time: 2400
# Brewing ingredient using a Bukkit Material name.
brewing-ingredient: ECHO_SHARD
# Display name of newly brewed Recall Potions.
potion-name: "Recall Potion"
Missing configuration options are added automatically without overwriting existing values.
? Commands
| Command |
Description |
Permission |
/recallpotion reload |
Reloads the configuration and brewing recipe |
recallpotion.reload |
The reload permission is granted to server operators by default.
Regular players do not need any permissions to brew or consume Recall Potions.
? Requirements
- Paper 1.21.9
- Java 21
- No external dependencies
RecallPotion uses Paper-specific brewing APIs and is not designed for Spigot-only servers.
? Installation
- Download the latest RecallPotion release.
- Place the JAR file in your server's
plugins folder.
- Start or restart the server.
- Optionally edit
plugins/recallPotion/config.yml.
- Run
/recallpotion reload after changing the configuration.
⚠️ Upgrading from Older Versions
RecallPotion 1.2.0 uses Persistent Data Container metadata to identify custom potions.
Potions brewed using older versions may not contain the required marker and may no longer activate teleportation. Players should brew new Recall Potions after upgrading.
? Feedback
Found a bug or have an idea?
Please report it on the GitHub issue tracker.
Source code is available on GitHub.
评论 0
登录后参与评分
还没有评论,来抢沙发吧