DyHomes

插件

· 作者 Claww

一个包含 DyClaim 支持的轻量级插件,提供家园、公共家园、/back、传送点和重生点功能;单个 JAR 文件兼容 Folia。

0 本站下载 0 关注 更新于 1 周前

最新 1.2.0 · 26.3 · Bukkit / Folia

一键开服(送7天)

DyHomes — 简化家园、传送点与重生点设置

设置你的家园。分享你的传送点。永远能找到回家的路。

DyHomes 是一款基于命令的家园插件,适用于生存服、SMP 服和经济类服务器。玩家可以设置家园并返回其中;服务器管理员可以创建传送点和重生点,且整个插件保持轻量:无需 GUI,无需数据库服务器,每个服务器构建只需一个 JAR 文件。

DyHomes 将命名家园与权限等级限制、公开家园、/back 指令、传送点、重生点管理、目的地安全检查、DyClaim 信任支持、网页地图标记以及可选价格等功能结合,并提供熟悉的基于命令的操作流程。版本 1.2.0 新增了仅与一名玩家共享家园的功能、重命名和描述家园、带有独立价格和权限的传送点分类、按世界划分的重生点、/tpaall 指令及请求冷却时间,并使插件在繁忙服务器上运行更加轻量。


1.2.0 新增内容

共享家园。 /homeinvite <player> <home> 可将一个家园分享给一名玩家,该玩家通过 /home <owner>:<home> 访问此家园。使用 /homeuninvite 可收回共享。所有者对 DyClaim 的访问权限仍然有效。

重命名与描述。 /renamehome <old> <new> 允许在保持家园公开或共享状态的同时更改其名称,而 /homedesc <home> [text] 可为家园添加一行文本,当玩家在 /homes 列表中悬停查看该家园时显示。

传送点分类。 /setwarp <name> <category> 可将传送点归类到可点击的分类中,并且 warps.yml 中的每个传送点都可以拥有自己的价格和权限。

按世界划分重生点。 启用 spawn.per-world 后,每个世界都有独立的重生点;管理员可通过 /spawn <world> 前往指定世界的重生点。

更多请求控制。 /tpaall 可向所有在线玩家发送传送邀请,而 tpa.request-cooldown 配置项可对传送请求进行间隔限制。

更轻量。 玩家登录时读取家园数据,重载时缓存设置,列表保持排序,数据文件在后台写入。

为什么选择 DyHomes?

尊重领地声明的家园。 配合 DyClaim 1.1.0 或更高版本,如果在他人领地内设置家园,需要该领地的 build(建造)权限;使用此家园则需要 teleport(传送)权限。如果失去信任,家园会保留但无法使用;重新获得信任后即可再次使用。

安全的抵达体验。 每次传送前,DyHomes 都会检查目的地:确保有站立空间、没有熔岩或火焰,且地面高度适合短距离下落。由于家园设置后地图可能会发生变化,若目的地变得不安全,系统将拒绝传送,并提示玩家若执意前往可添加 force 参数。

无需图形界面的权限系统。 dyhomes.limit.<n> 设置某个组最多可以拥有多少个家园(取最高值,dyhomes.limit.unlimited 表示无限制)。dyhomes.cooldown.<seconds> 设置其冷却时间(取最低值)。

一个 JAR 文件适用于所有服务器。 支持 Bukkit、Spigot、Paper、Purpur 和 Folia。在 Folia 上,其他区域的家园会在正确的区域线程中被检查并访问;在 Paper 和 Folia 上,传送操作是异步进行的。

共享家园。 /publichome <name> 将指定家园开放给所有人;其他人可通过 /phomes 查找,并使用 /phome <玩家:家园> 访问。房主的 DyClaim 信任机制仍然生效,因此如果房主失去了对某个领地(claim)的访问权限,位于该领地内的公共家园也会随之关闭。

传送请求。 /tpa <player> 请求前往某玩家,而 /tpahere <player> 则请求该玩家来到你身边;对方可通过点击进行回应。常规的等待时间、安全检查、冷却时间和费用均适用,之后可使用 /back 返回原处。若安装了 EssentialsX,其 /tpa 命令将继续生效,除非你设置了 tpa.enabled: true。

永不迷路。 /back 命令会返回到你上次传送或死亡的位置,该命令拥有独立的冷却时间和消耗。

轻松切换。 /dyhomes import essentials 会复制 EssentialsX 中的家、传送点和出生点,而 /dyhomes import huskhomes 则从 HuskHomes SQLite 数据库复制家(包括公共家)和传送点。DyHomes 中已有的内容不会被替换,且其他插件的文件仅被读取。

在你的网页地图上。 当安装了 BlueMap、Dynmap 或 squaremap 时,传送点和可选的公共家会以标记的形式显示在地图中。

五种语言支持。 提供英语、土耳其语、德语、西班牙语和俄语,根据玩家的 Minecraft 语言设置或个人选择自动匹配。消息支持在所有位置使用 & 颜色代码,并在 Paper、Purpur 和 Folia 上支持 MiniMessage 标签。


选择你的服务器版本

服务器 JAR 文件
Bukkit, Spigot, Paper, Purpur, Folia DyHomes-1.2.0.jar

Java 17 字节码;请使用你的服务器所需的 Java 运行时环境。发行列表涵盖 Minecraft 1.20.x 至 26.x。本次发布的实时测试使用了 Purpur 1.20.4、Folia 1.20.4、Paper 26.2 和 Spigot 26.3;详见 验证记录。

下载 · 更新日志

命令

命令 用途
/home [name] 传送至家;未指定名称时,传送到 home 或你唯一的家
/home <name> force 即使目的地看起来不安全也强行前往
/homes 列出你的家;名称可点击
/sethome [name] 在你站立的位置设置一个家,或移动现有的家
/delhome <name> 删除一个家
/warp [name] 传送至坐标点;未指定名称时,列出所有坐标点
/warps 列出所有坐标点
/spawn 传送至出生点
/back 返回到你上次传送的起点或死亡位置
/tpa <player> 请求传送到某玩家处
/tpahere <player> 请求某玩家传送到你这里
/tpaccept [player], /tpdeny [player] 接受或拒绝请求
/tpacancel, /tpatoggle 撤回你的请求,或开启/关闭接收传入请求
/homeinvite <player> <home>, /homeuninvite <player> <home> 与一名玩家共享某个家,或停止共享
/renamehome <old> <new> 重命名一个家
/homedesc <home> [text] 为家添加描述,或移除描述
/warps [category] 列出坐标点,或列出特定分类下的坐标点
/publichome <name> 将某个家公开给所有人,或再次设为私有
/phome <player:home> 访问其他玩家的公开家
/phomes [player] 列出公开的家;名称可点击
/dyhomes language <auto/en/tr/de/es/ru> 保存你的语言设置
/setwarp <name> 创建或移动一个坐标点
/delwarp <name> 删除一个坐标点
/setspawn 在你站立的位置设置出生点
/spawn <world> 访问其他世界的出生点
/tpaall 请求所有在线玩家传送到你这里
/homes <player> 列出其他玩家的家
/home <player>:<name> 访问其他玩家的家
/delhome <player>:<name> 删除其他玩家的家
/dyhomes import essentials 从 EssentialsX 复制家、坐标点和出生点数据
/dyhomes import huskhomes 从 HuskHomes (SQLite) 复制家和坐标点数据
/dyhomes reload 验证并重新加载配置和消息

/dyh 是 /dyhomes 的缩写,/h 是 /home 的缩写。家和坐标点的名称可使用任意字母表的字母、数字、_ 和 -,最多 32 个字符,且不区分大小写。如果安装了 EssentialsX,原始的 /home、/homes 及其他命令仍会路由到 DyHomes;而 /dyhomes:home 则始终由 DyHomes 处理。

权限

权限 默认值 用途
dyhomes.home true /home, /homes
dyhomes.sethome true 对自己拥有的家使用 /sethome, /delhome
dyhomes.warp true /warp, /warps
dyhomes.warp.<name> not set 单个坐标点,当启用 warps.per-warp-permission 时
dyhomes.spawn true /spawn
dyhomes.back true /back
dyhomes.tpa, dyhomes.tpahere, dyhomes.tpatoggle true 传送请求相关功能
dyhomes.homeinvite true 共享你的家
dyhomes.tpaall op /tpaall
dyhomes.spawn.world op /spawn <world>
dyhomes.publichome true 对自己拥有的家使用 /publichome
dyhomes.phome true /phome, /phomes
dyhomes.bypass.public-limit op 向所有人开放任意数量的家
dyhomes.setwarp, dyhomes.delwarp op 管理坐标点
dyhomes.setspawn op 设置出生点
dyhomes.admin op 重载、导入、服务器语言、更新通知
dyhomes.admin.others op 操作其他玩家的家
dyhomes.limit.<n> not set 家的数量限制;取最高值生效
dyhomes.limit.unlimited op 无家的数量限制
dyhomes.cooldown.<seconds> not set 冷却时间;取最低值生效
dyhomes.bypass.cooldown, .warmup, .economy op 跳过冷却、预热或费用
dyhomes.bypass.claims op 在任何 DyClaim 领地中设置和使用家
dyhomes.bypass.worlds op 在 homes.disabled-worlds 列表中设置家

传送机制

每个家、坐标点和出生点的传送都遵循相同的步骤:检查冷却时间、价格检查、DyClaim 访问权限(仅限家)、目的地安全性检查、可取消的 DyHomesTeleportEvent 事件,然后是持续 warmup.seconds 秒(默认为 3 秒)的预热时间。移动、受到伤害或被其他方式传送都会取消预热。费用会在传送前立即扣除,如果传送失败则退款;冷却时间仅在传送成功后开始计算。冷却时间和费用按类型分别设置:cooldown.home、cooldown.warp、cooldown.spawn、cooldown.back 以及 economy.prices.home、.warp、.spawn、.back、.sethome。访问公开的家被视为一次家传送。

/back 记录玩家上次传送的起点和死亡位置(通过 back.on-teleport 和 back.on-death 控制),忽略距离小于 4 格的移动以及 back.disabled-worlds 列表中的世界。位置信息会保留直到玩家离开服务器。

公开家:受 public-homes.enabled 和 public-homes.max-per-player(默认为 3)控制。

出生点:/setspawn 会存储出生点,并且如果启用了 spawn.set-world-spawn,还会移动原版的世界出生点。新玩家会前往此处(通过 spawn.on-first-join 控制),没有床或重生锚的玩家也会在此处重生(通过 spawn.on-respawn 控制)。如果没有执行 /setspawn,/spawn 命令将使用主世界的出生点。

占位符

配合 PlaceholderAPI 使用:%dyhomes_count%、%dyhomes_limit%、%dyhomes_remaining%、%dyhomes_names%、%dyhomes_cooldown%、%dyhomes_cooldown_formatted% 和 %dyhomes_warps%。

开发者接口

dev.dyhomes.api.DyHomesAPI 用于读取家(包括离线玩家的家)、坐标点、出生点以及玩家的家的数量限制。HomeSetEvent 和 HomeDeleteEvent 是可取消的,并在变更发生前触发;DyHomesTeleportEvent 是可取消的,并在预热开始前触发。WarpChangeEvent 和 HomePublicChangeEvent 用于报告被创建、移动或删除的坐标点,以及被公开或收回的家。getPublicHomes() 方法用于列出公开的家。请在插件依赖中添加 softdepend: [DyHomes] 并首先检查 DyHomesAPI.isAvailable()。

数据与升级

家保存在 plugins/DyHomes/homes/<uuid>.yml 中,每位玩家一个文件;传送点在 warps.yml,出生点位于 spawn.yml,语言偏好设置在 players.yml。所有文件均以原子方式写入。无法读取的文件不会被覆盖:其对应的家保持只读状态,控制台会提示需要修复哪个文件。家通过世界 UID 和名称记录所属世界,因此即使世界被重命名,家也不会丢失。

启动或重载时会自动添加缺失的配置项与消息键,且不会覆盖您的自定义修改。若配置项无效,则拒绝重载并保留当前运行中的设置。DyHomes 每六小时检查一次 Modrinth 以获取新版本发布,并向管理员发出通知;将 updates.check: false 可关闭此功能。匿名 bStats 统计信息可通过 metrics.enabled: false 关闭。

构建

gradle clean build

需使用 Gradle 9.1 配合 Java 21 或 25。生成的 JAR 文件为 build/libs/DyHomes-1.2.0.jar。测试基于 JUnit 和 Mockito,不包含在 JAR 包内。

许可证

DyHomes Source-Available License 1.0,条款与 DyClaim、DyRTP 和 DyDiscord 相同:允许在任何服务器上免费使用和修改,禁止付费分发,且分发版本必须公开其源代码。这是一份自定义的源码可用许可证,而非 OSI 批准的开源许可证。详见 LICENSE。

快速上手

  1. 将 DyHomes-1.2.0.jar 放入 plugins/ 目录并启动服务器。
  2. 站在玩家应到达的位置,执行 /setspawn;使用 /setwarp <name> 创建传送点。
  3. 从 EssentialsX 或 HuskHomes 迁移?只需执行一次 /dyhomes import essentials 或 /dyhomes import huskhomes。
  4. 调整 config.yml(限制、热身时间、冷却时间、价格等),然后运行 /dyhomes reload。

源码与支持

文档 · 报告问题 · 许可证

By Claww / DyPlugin.

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源