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。
快速上手
- 将
DyHomes-1.2.0.jar 放入 plugins/ 目录并启动服务器。
- 站在玩家应到达的位置,执行
/setspawn;使用 /setwarp <name> 创建传送点。
- 从 EssentialsX 或 HuskHomes 迁移?只需执行一次
/dyhomes import essentials 或 /dyhomes import huskhomes。
- 调整
config.yml(限制、热身时间、冷却时间、价格等),然后运行 /dyhomes reload。
源码与支持
文档 · 报告问题 · 许可证
By Claww / DyPlugin.
DyHomes — Homes, Warps and Spawn Made Simple
Set your homes. Share your warps. Always find your way back.
DyHomes is a command-based homes plugin for survival, SMP and economy servers. Players set homes and return to them, server owners create warps and a spawn, and everything stays light: no GUI, no database server, one JAR for every server build.
DyHomes combines named homes with rank limits, public homes, /back, warps, spawn handling, destination safety checks, DyClaim trust support, web-map markers and optional prices with a familiar command-based workflow. Version 1.2.0 adds homes shared with one player, renaming and describing homes, warp categories with their own prices and permissions, per-world spawns, /tpaall and a request cooldown, and makes the plugin lighter on busy servers.
New in 1.2.0
Share a home. /homeinvite <player> <home> shares one home with one player, who visits it with /home <owner>:<home>. /homeuninvite takes it back. The owner's DyClaim access still applies.
Rename and describe. /renamehome <old> <new> keeps a home public or shared under its new name, and /homedesc <home> [text] adds a line shown when hovering over the home in /homes.
Warp categories. /setwarp <name> <category> sorts warps into clickable categories, and a warp can have its own price and permission in warps.yml.
Spawn per world. With spawn.per-world, each world has its own spawn; administrators visit one with /spawn <world>.
More request control. /tpaall asks every online player to come to you, and tpa.request-cooldown spaces out requests.
Lighter. Homes are read while players log in, settings are cached on reload, lists stay sorted and data files are written in the background.
Why DyHomes?
Homes that respect claims. With DyClaim 1.1.0 or later, setting a home inside someone else's claim needs that claim's build right, and using it needs the teleport right. Lose the trust and the home stays but can no longer be used; get it back and it works again.
Safe arrivals. Before each teleport DyHomes checks the destination: room to stand, no lava or fire, and ground within a short fall. Builds change after a home is set; an unsafe home is refused with a hint to add force if the player really wants to go.
Ranks without a GUI. dyhomes.limit.<n> sets how many homes a group may have (the highest wins, dyhomes.limit.unlimited removes the limit). dyhomes.cooldown.<seconds> sets their cooldown (the lowest wins).
One JAR for every server. Bukkit, Spigot, Paper, Purpur and Folia. On Folia, homes in other regions are checked and reached on the right region thread; on Paper and Folia teleports are asynchronous.
Share a home. /publichome <name> opens a home to everyone; others find it with /phomes and visit it with /phome <player:home>. The owner's DyClaim trust still applies, so a public home inside someone else's claim stays closed if the owner loses access.
Teleport requests. /tpa <player> asks to go to a player and /tpahere <player> asks them to come to you; they answer with a click. The usual warmup, safety check, cooldown and price apply, and /back works afterwards. With EssentialsX installed, its /tpa keeps working unless you set tpa.enabled: true.
Never lost. /back returns to where you last teleported from or died, with its own cooldown and price.
Easy switch. /dyhomes import essentials copies homes, warps and the spawn from EssentialsX, and /dyhomes import huskhomes copies homes (including public ones) and warps from a HuskHomes SQLite database. Nothing already in DyHomes is replaced, and the other plugin's files are only read.
On your web map. Warps, and optionally public homes, appear as markers on BlueMap, Dynmap and squaremap when one is installed.
Five languages. English, Turkish, German, Spanish and Russian, picked from the player's Minecraft language or their own choice. Messages accept & colour codes everywhere and MiniMessage tags on Paper, Purpur and Folia.
Choose your server build
| Server |
JAR |
| Bukkit, Spigot, Paper, Purpur, Folia |
DyHomes-1.2.0.jar |
Java 17 bytecode; use the Java runtime your server needs. Release listing: Minecraft 1.20.x through 26.x. The live checks for this release used Purpur 1.20.4, Folia 1.20.4, Paper 26.2 and Spigot 26.3; see the verification record.
Downloads · Changelog
Commands
| Command |
Purpose |
/home [name] |
Teleport to a home; without a name, to home or your only home |
/home <name> force |
Go even if the destination looks unsafe |
/homes |
List your homes; names are clickable |
/sethome [name] |
Set a home where you stand, or move an existing one |
/delhome <name> |
Delete a home |
/warp [name] |
Teleport to a warp; without a name, list the warps |
/warps |
List the warps |
/spawn |
Teleport to the spawn |
/back |
Return to where you last teleported from or died |
/tpa <player> |
Ask to teleport to a player |
/tpahere <player> |
Ask a player to come to you |
/tpaccept [player], /tpdeny [player] |
Answer a request |
/tpacancel, /tpatoggle |
Withdraw your request, or turn incoming requests off or on |
/homeinvite <player> <home>, /homeuninvite <player> <home> |
Share a home with one player, or stop sharing |
/renamehome <old> <new> |
Rename a home |
/homedesc <home> [text] |
Describe a home, or remove the description |
/warps [category] |
List warps, or the warps of one category |
/publichome <name> |
Open one of your homes to everyone, or close it again |
/phome <player:home> |
Visit a public home |
/phomes [player] |
List public homes; names are clickable |
/dyhomes language <auto/en/tr/de/es/ru> |
Save your language |
/setwarp <name> |
Create or move a warp |
/delwarp <name> |
Delete a warp |
/setspawn |
Set the spawn where you stand |
/spawn <world> |
Visit another world's spawn |
/tpaall |
Ask every online player to come to you |
/homes <player> |
List another player's homes |
/home <player>:<name> |
Visit another player's home |
/delhome <player>:<name> |
Delete another player's home |
/dyhomes import essentials |
Copy homes, warps and spawn from EssentialsX |
/dyhomes import huskhomes |
Copy homes and warps from HuskHomes (SQLite) |
/dyhomes reload |
Validate and reload settings and messages |
/dyh is short for /dyhomes, /h for /home. Home and warp names use letters of any alphabet, digits, _ and -, up to 32 characters, and ignore case. With EssentialsX installed, plain /home, /homes and the other commands still reach DyHomes; /dyhomes:home always does.
Permissions
| Permission |
Default |
Purpose |
dyhomes.home |
true |
/home, /homes |
dyhomes.sethome |
true |
/sethome, /delhome for your own homes |
dyhomes.warp |
true |
/warp, /warps |
dyhomes.warp.<name> |
not set |
One warp, when warps.per-warp-permission is on |
dyhomes.spawn |
true |
/spawn |
dyhomes.back |
true |
/back |
dyhomes.tpa, dyhomes.tpahere, dyhomes.tpatoggle |
true |
Teleport requests |
dyhomes.homeinvite |
true |
Share your homes |
dyhomes.tpaall |
op |
/tpaall |
dyhomes.spawn.world |
op |
/spawn <world> |
dyhomes.publichome |
true |
/publichome for your own homes |
dyhomes.phome |
true |
/phome, /phomes |
dyhomes.bypass.public-limit |
op |
Open any number of homes to everyone |
dyhomes.setwarp, dyhomes.delwarp |
op |
Manage warps |
dyhomes.setspawn |
op |
Set the spawn |
dyhomes.admin |
op |
Reload, import, server language, update notices |
dyhomes.admin.others |
op |
Other players' homes |
dyhomes.limit.<n> |
not set |
Home limit; the highest wins |
dyhomes.limit.unlimited |
op |
No home limit |
dyhomes.cooldown.<seconds> |
not set |
Cooldown; the lowest wins |
dyhomes.bypass.cooldown, .warmup, .economy |
op |
Skip cooldown, warmup or prices |
dyhomes.bypass.claims |
op |
Set and use homes in any DyClaim claim |
dyhomes.bypass.worlds |
op |
Set homes in homes.disabled-worlds |
Teleports
Every home, warp and spawn teleport follows the same steps: cooldown, price check, DyClaim access (homes), destination safety, the cancellable DyHomesTeleportEvent, then a warmup of warmup.seconds (3 by default). Moving, taking damage or being teleported by something else cancels the warmup. The price is taken right before the teleport and refunded if it fails; the cooldown only starts after a successful teleport. Cooldowns and prices are set per kind: cooldown.home, cooldown.warp, cooldown.spawn, cooldown.back and economy.prices.home, .warp, .spawn, .back, .sethome. Visiting a public home counts as a home teleport.
/back remembers the last place a player teleported from and where they died (back.on-teleport, back.on-death), skipping moves under four blocks and worlds in back.disabled-worlds. Positions are kept until the player leaves.
Public homes: public-homes.enabled and public-homes.max-per-player (3).
Spawn: /setspawn stores the spawn and, with spawn.set-world-spawn, also moves the vanilla world spawn. New players go to it (spawn.on-first-join), and players without a bed or respawn anchor respawn there (spawn.on-respawn). Without /setspawn, /spawn uses the main world's spawn.
Placeholders
With PlaceholderAPI: %dyhomes_count%, %dyhomes_limit%, %dyhomes_remaining%, %dyhomes_names%, %dyhomes_cooldown%, %dyhomes_cooldown_formatted% and %dyhomes_warps%.
For developers
dev.dyhomes.api.DyHomesAPI reads homes (also of offline players), warps, the spawn and a player's limit. HomeSetEvent and HomeDeleteEvent are cancellable and fire before a change; DyHomesTeleportEvent is cancellable and fires before the warmup. WarpChangeEvent and HomePublicChangeEvent report warps that were created, moved or deleted and homes that were opened or closed. getPublicHomes() lists public homes. Add softdepend: [DyHomes] and check DyHomesAPI.isAvailable() first.
Data and upgrades
Homes are stored in plugins/DyHomes/homes/<uuid>.yml, one small file per player; warps in warps.yml, the spawn in spawn.yml and language choices in players.yml. Every file is written atomically. A file that cannot be read is never overwritten: its homes stay read-only and the console says which file to fix. Homes remember their world by UID and name, so a renamed world keeps its homes.
Missing settings and message keys are added on start and reload without touching your edits. An invalid setting rejects the reload and keeps the running settings. DyHomes checks Modrinth every six hours for a newer release and tells administrators; updates.check: false turns this off. Anonymous bStats statistics can be turned off with metrics.enabled: false.
Build
gradle clean build
Gradle 9.1 with Java 21 or 25. The JAR is build/libs/DyHomes-1.2.0.jar. Tests use JUnit and Mockito and are not part of the JAR.
License
DyHomes Source-Available License 1.0, the same terms as DyClaim, DyRTP and DyDiscord: free to use and modify on any server, no paid distribution, and distributed versions must share their source. It is a custom source-available license, not an OSI-approved open-source license. See LICENSE.
Get started
- Put
DyHomes-1.2.0.jar in plugins/ and start the server.
- Stand where players should arrive and run
/setspawn; create warps with /setwarp <name>.
- Coming from EssentialsX or HuskHomes? Run
/dyhomes import essentials or /dyhomes import huskhomes once.
- Adjust
config.yml (limits, warmup, cooldowns, prices) and run /dyhomes reload.
Source and support
Documentation · Report an issue · License
By Claww / DyPlugin.
评论 0
登录后参与评分
还没有评论,来抢沙发吧