DyHomes 1.0.0-BETA
The first public release of DyHomes: homes, warps and spawn in one light plugin for Bukkit, Spigot, Paper, Purpur and Folia, Minecraft 1.20.x through 26.x.
Added
- Homes.
/home,/homes,/sethomeand/delhome.- Named homes; without a name,
/sethomesetshomeand/homegoes tohomeor your only home. /sethomewith an existing name moves that home instead of counting as a new one.- Clickable home list.
- Administrators reach other players' homes with
player:home, also for offline players.
- Named homes; without a name,
- Limits per rank.
homes.default-limit(3),dyhomes.limit.<n>(the highest wins) anddyhomes.limit.unlimited.homes.disabled-worldsblocks new homes in chosen worlds. - Warps.
/warp,/warps,/setwarpand/delwarp, with a clickable list.warps.per-warp-permissionlimits each warp todyhomes.warp.<name>. - Spawn.
/spawnand/setspawn.- New players are sent to the spawn.
- Players without a bed or respawn anchor respawn there.
- Without
/setspawn,/spawnuses the main world's spawn.
- Teleport flow.
- Warmup (3 seconds), cancelled by moving, damage or another teleport.
- Cooldown and price per kind: home, warp, spawn; price also for
/sethome. dyhomes.cooldown.<seconds>per rank (the lowest wins).- The price is taken only right before the teleport and refunded if it fails.
- Destination safety.
- Room to stand, no lava, fire or other hazard, and ground within
safety.max-fallblocks. - An unsafe destination is refused with a hint; adding
forcegoes anyway. - Slabs, carpets and water at the destination are handled.
- Room to stand, no lava, fire or other hazard, and ground within
- DyClaim.
- With DyClaim 1.1.0 or later, homes in someone else's claim need its
buildright to set and itsteleportright to use. Both rights are configurable. - Losing trust keeps the home but blocks it.
- If DyClaim cannot answer, the action is refused.
- With DyClaim 1.1.0 or later, homes in someone else's claim need its
- EssentialsX import.
/dyhomes import essentialscopies homes (current and older file formats), warps and the spawn.- Existing DyHomes entries are kept.
- EssentialsX files are only read.
- Languages. English, Turkish, German, Spanish and Russian, from the client language or
/dyhomes language. Turkish command aliases such as/ev,/evler,/evayarla,/evsil. MiniMessage tags on Paper, Purpur and Folia; text typed by players is never treated as tags. - PlaceholderAPI.
%dyhomes_count%,%dyhomes_limit%,%dyhomes_remaining%,%dyhomes_names%,%dyhomes_cooldown%,%dyhomes_cooldown_formatted%and%dyhomes_warps%. - Developer API.
DyHomesAPIplus the cancellableHomeSetEvent,HomeDeleteEventandDyHomesTeleportEvent. - Folia. The same JAR runs on Folia with region and entity schedulers; Paper and Folia teleport asynchronously.
- Storage.
- One small YAML file per player, written atomically.
- Unreadable files are never overwritten.
- Worlds are remembered by UID and name.
- Modrinth update notices for administrators and optional anonymous bStats statistics.
Upgrading
This is the first release. Put DyHomes-1.0.0-BETA.jar in plugins/ and start the server. Coming from EssentialsX, run /dyhomes import essentials once; EssentialsX files are only read and nothing already in DyHomes is replaced.
Verification
30 automated tests passed. Live checks with the release JAR (SHA-256 d5f053cfde65511b284686cad62f7fb28ab99504faa26f8734bd99135d143595) passed on Purpur 1.20.4 with EssentialsX, LuckPerms, Vault, PlaceholderAPI and DyClaim 1.1.0 (28/28), Folia 1.20.4 with DyClaim 1.1.0-Folia (11/11), Spigot 26.3 (7/7) and Paper 26.2 (7/7). Bukkit without Spigot, Folia 26.x, Geyser/Floodgate and high player counts were not tested.
License
DyHomes Source-Available License 1.0 Effective date: 25 October 2026 Copyright (c) 2026 Claww / DyPlugin and DyHomes contributors. All rights reserved except as expressly granted below. 1. Scope "Software" means the DyHomes code, binaries and documentation distributed with this license, to the extent the relevant copyright holders may grant these permissions. "Modified Version" means a modification or derivative of that Software. This is a custom source-available license, not the GNU GPL and not an OSI-approved open-source license. 2. Permitted use You may download, inspect, run, copy and modify the Software, including for personal, educational and commercial Minecraft servers. Running a server that accepts donations or sells server access does not itself constitute selling the Software. You may redistribute the Software or Modified Versions without charge if you meet all conditions below. 3. No paid distribution Without separate written permission from the relevant copyright holders, you must not sell, sublicense for a fee, offer paid downloads of, or require payment or a donation to obtain the Software or a Modified Version. You must not include it in a paid software bundle or use another arrangement to charge for access to its source or binaries. Voluntary donations are allowed only when access to the Software is not conditional on donating. 4. Source availability on distribution Whenever you distribute the Software or a Modified Version, provide a public, free-of-charge link to its complete corresponding source code, including your changes and the build files needed to produce the distributed version. Keep that source available for as long as you offer the distribution. Do not distribute a closed-source Modified Version. Private modifications that you do not distribute do not have to be published. 5. Attribution and notices Retain this license and existing copyright and attribution notices in source and binary distributions. Identify DyHomes and Claww / DyPlugin visibly in the plugin description, README or equivalent documentation, and any public distribution page. Modified Versions must identify their changes and must not imply that they are official releases or endorsed by the original authors. 6. Same terms for redistribution Distribute covered Software and Modified Versions under this license, with no additional terms that remove the permissions granted here or defeat its conditions. No ownership of the Software, project name or branding is transferred. Attribution does not grant permission to impersonate the project. 7. Third-party material and earlier distributions Third-party components, dependencies and contributions remain subject to their applicable rights and licenses. This license does not override those licenses or grant rights the relevant copyright holders do not possess. Earlier copies distributed under another license retain their applicable license; this notice does not retroactively revoke previously granted rights. If you cannot satisfy all applicable licenses, do not redistribute that combination without obtaining the required permissions. 8. Termination Permissions under this license terminate if you fail to comply with its conditions. They are reinstated when the violation is fully cured, unless the relevant copyright holder has separately terminated them in writing. Termination does not remove any rights you have independently under law or under an applicable license for an earlier distribution. 9. Disclaimer of warranty and liability TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. THE AUTHORS AND COPYRIGHT HOLDERS ARE NOT LIABLE FOR ANY CLAIM, DAMAGE OR OTHER LIABILITY ARISING FROM THE SOFTWARE OR ITS USE, WHETHER IN CONTRACT, TORT OR OTHERWISE. MANDATORY LEGAL RIGHTS REMAIN UNAFFECTED. 10. Separate permissions For permissions beyond this license, contact Claww / DyPlugin through https://github.com/DyPlugin/DyHomes. A separate permission is valid only when granted in writing by the relevant rights holder.

