# 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 ` shares one home with one player, who visits it with `/home :`. `/homeuninvite` takes it back. The owner's DyClaim access still applies. **Rename and describe.** `/renamehome ` keeps a home public or shared under its new name, and `/homedesc [text]` adds a line shown when hovering over the home in `/homes`. **Warp categories.** `/setwarp ` 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 `. **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.` sets how many homes a group may have (the highest wins, `dyhomes.limit.unlimited` removes the limit). `dyhomes.cooldown.` 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 ` opens a home to everyone; others find it with `/phomes` and visit it with `/phome `. 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 ` asks to go to a player and `/tpahere ` 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](https://github.com/DyPlugin/DyHomes/blob/main/docs/verification.md). [Downloads](https://github.com/DyPlugin/DyHomes/releases/tag/1.2.0) · [Changelog](https://github.com/DyPlugin/DyHomes/blob/main/CHANGELOG.md) ## Commands | Command | Purpose | |---|---| | `/home [name]` | Teleport to a home; without a name, to `home` or your only home | | `/home 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 ` | 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 ` | Ask to teleport to a player | | `/tpahere ` | 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 `, `/homeuninvite ` | Share a home with one player, or stop sharing | | `/renamehome ` | Rename a home | | `/homedesc [text]` | Describe a home, or remove the description | | `/warps [category]` | List warps, or the warps of one category | | `/publichome ` | Open one of your homes to everyone, or close it again | | `/phome ` | Visit a public home | | `/phomes [player]` | List public homes; names are clickable | | `/dyhomes language ` | Save your language | | `/setwarp ` | Create or move a warp | | `/delwarp ` | Delete a warp | | `/setspawn` | Set the spawn where you stand | | `/spawn ` | Visit another world's spawn | | `/tpaall` | Ask every online player to come to you | | `/homes ` | List another player's homes | | `/home :` | Visit another player's home | | `/delhome :` | 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.` | 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 ` | | `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.` | not set | Home limit; the highest wins | | `dyhomes.limit.unlimited` | op | No home limit | | `dyhomes.cooldown.` | 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/.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](https://bstats.org/plugin/bukkit/DyHomes/34939) statistics can be turned off with `metrics.enabled: false`. ## Build ```text 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](https://github.com/DyPlugin/DyHomes/blob/main/LICENSE). ## Get started 1. Put `DyHomes-1.2.0.jar` in `plugins/` and start the server. 2. Stand where players should arrive and run `/setspawn`; create warps with `/setwarp `. 3. Coming from EssentialsX or HuskHomes? Run `/dyhomes import essentials` or `/dyhomes import huskhomes` once. 4. Adjust `config.yml` (limits, warmup, cooldowns, prices) and run `/dyhomes reload`. ## Source and support [Documentation](https://github.com/DyPlugin/DyHomes#readme) · [Report an issue](https://github.com/DyPlugin/DyHomes/issues) · [License](https://github.com/DyPlugin/DyHomes/blob/main/LICENSE) **By Claww / DyPlugin.**

DyHomes

1.2.0

1.1.0

1.0.0

1.0.0-BETA