TeleHome
一款轻量级的 Paper/Spigot 插件,允许玩家保存他们喜爱的位置并瞬间传送回那里——或者使用可配置的倒计时延迟。
专为运行在 Java 21 上的 Paper 1.21+ 和 26.2.1 构建。
✨ 功能特性
- ? 设置无限数量的命名家 —
/sethome castle、/sethome mine、/sethome farm... - ⚡ 随时传送回家 —
/home castle会将你精确地传送到该位置,包括朝向和俯仰角度。 - ? 持久化存储 — 家园按玩家(UUID)独立保存,并在服务器重启、名称更改或世界重载后保留。
- ⏱ 可配置的传送延迟 — 支持即时传送或倒计时传送(例如 3 秒)。
- ? 移动取消传送 — 可选择在倒计时期间如果玩家移动则取消传送。
- ? 多世界支持 — 家园会记住其所属的世界。
- ? 完全自定义消息 — 通过
config.yml进行配置。
? 安装方法
将其放入服务器的 `plugins/` 文件夹中。
启动(或重启)你的服务器。
配置文件将在 `plugins/TeleHome/config.yml` 生成。
? 命令
/sethome <name>
在当前地点设置一个家
telehome.sethome
/home <name>
传送到你的某个家
telehome.home
家园名称规则:字母、数字、下划线和连字符。最大长度为 32 个字符。
? 权限
权限 - 默认设置 - 描述
telehome.sethome - true - 允许玩家设置家
telehome.home - true - 允许玩家传送到家
⚙️ 配置
Set to 0 for instant teleport.
teleport-delay-seconds: 3
If true, the teleport will be cancelled if the player moves during the delay.
cancel-on-move: true
Messages (supports legacy & color codes)
messages:
home-set: "&aHome '&e%name%&a' has been set!"
home-not-found: "&cNo home found with the name '&e%name%&c'."
teleporting: "&aTeleporting to '&e%name%&a' in &e%seconds% &aseconds. Don't move!"
teleported: "&aTeleported to '&e%name%&a'!"
teleport-cancelled: "&cTeleport cancelled because you moved!"
world-missing: "&cThe world for that home no longer exists."
usage-sethome: "&cUsage: /sethome <name>"
usage-home: "&cUsage: /home <name>"
players-only: "&cOnly players can use this command."
/home
teleporting: "&aTeleporting to '&e%name%&a' in &e%seconds% &aseconds. Don't move!"
teleported: "&aTeleported to '&e%name%&a'!"
teleport-cancelled: "&cTeleport cancelled because you moved!"
usage-home: "&cUsage: /home <name>"
/delhome
home-deleted: "&aHome '&e%name%&a' has been deleted."
usage-delhome: "&cUsage: /delhome <name>"
/listhome
no-homes: "&eYou have no homes set. Use &f/sethome <name>&e to set one."
list-header: "&6--- Your Homes (&e%count%&6) ---"
list-entry: "&7- &e%name% &7(&f%world%&7 @ &f%x%&7, &f%y%&7, &f%z%&7)"
list-footer: "&7Use &f/home <name>&7 to teleport."
Shared
home-not-found: "&cNo home found with the name '&e%name%&c'."
world-missing: "&cThe world for that home no longer exists."
players-only: "&cOnly players can use this command."
? 数据存储
家园存储在 plugins/TeleHome/homes.yml 中,以玩家 UUID 为键:
e5f1d2a7-...-...:
castle:
world: world
x: 123.5
y: 64.0
z: -452.3
yaw: 90.0
pitch: 0.0
由于使用的是 UUID 而非用户名,即使 Mojang 更改了用户名,家园数据也会保留。
? 测试环境
Paper 1.21+, 26.2.1
Java 21
? 路线图
未来版本计划的功能:
[X] /delhome <name> — 删除一个家
[X] /listhomes — 列出你的家
[X] 家园名称的 Tab 补全
[ ] 基于排名的家园数量限制(基于权限)
[ ] 传送冷却时间
[ ] 跨世界传送开关
[ ] 可选的费用系统(经济集成)
[ ] 床/重生点之家集成
有建议?请提交 Issue!
? 问题与贡献
Bug / 功能请求:提交 Issue
Pull Requests:欢迎!请针对 main 分支,并清晰描述你的更改。
? 许可证
本项目采用 MIT 许可证 — 详见 LICENSE 文件。
❤️ 致谢
基于 Paper API 构建。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧