TeleHome

插件

· 作者 ripsnortntear

一个轻量级的 Paper/Spigot 插件,允许玩家使用 /sethome 和 /home 命令保存并传送至个人家园。支持可配置的传送延迟、移动取消功能,以及在重启后保持数据持久化存储。

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

最新 1.1.0 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

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 构建。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源