
WaterHomes
A simple home plugin for your server!
Автор: WatermanMC85215272обновлён 19 мар. 2026 г.
Механики игрыУтилиты
Описание
WaterHomes
WaterHomes is a lightweight and efficient home-setting plugin designed for PaperMC 1.21+ servers. It provides players with the fundamental ability to set personal teleport locations, making world navigation quick and easy without the unnecessary clutter or overhead of larger plugins.
Key Features & Why You Should Download It
- Essential Home Functionality: Quickly set your personal spawn location anywhere in the world. No complex features, just simple, reliable
/homefunctionality. - Minimal Overhead: Built to be lightweight and efficient, ensuring minimal impact on your server's performance. Perfect for small to medium-sized survival, semi-vanilla, or even large public servers that just need a core home feature.
- Extra Features: Extra features like to ban a word if a player is setting a home or unsafe blocks so players cannot set a home near a blacklisted block! View it at your
config.yml! - Customize Plugin Messages: Customize all WaterHomes messages completely on
messages.yml! Uses MiniMessage so you can have gradients, hex, clickable text and more! No more ugly § color codes! MiniMessage formatter: https://webui.advntr.dev/ - Intuitive Commands: Everything a player needs is covered by a small, easy-to-remember commands set with tab complete.
- Modern Server Support: Built specifically for the latest PaperMC 1.21+ versions and its forks, guaranteeing up-to-date performance and stability.
- Open Source: Developed under the GNU General Public License v3.0, allowing for transparency and community contributions.
Commands & Usage
(<> is optional, [] is required):
| Command | Description | Permission |
|---|---|---|
/sethome <name> | Sets a new home at your current location. | waterhomes.sethome |
/home <name> | Teleports you to your chosen home. | waterhomes.home |
/delhome <name> | Delete your home | waterhomes.delhome |
/homelist | Lists all homes you have set. | waterhomes.homelist |
/waterhomes [info/reload] | Reload or see the info of the plugin. | waterhomes.admin |
Default Configs
Default configs used on the plugin.
config.yml
# Thank you for using WaterHomes!
# Documentation: https://github.com/WatermanMC/WaterHomes/wiki
# Discord: https://discord.gg/Scgqfm5EU4
# GitHub: https://github.com/WatermanMC/WaterHomes
# Teleport Delay
# Bypass permission: waterhomes.tpdelay.bypass
tp-delay:
enabled: true
cancel-on-move: true
duration: 2 # In seconds
# Teleport Cooldown
# Bypass permission: waterhomes.cooldown.bypass
tp-cooldown:
enabled: true
duration: 60 # In seconds
# Banned words for sethome
# Regex pattern is allowed
# Bypass permission: waterhomes.bannedwords.bypass
banned-words:
- banned words is listed here
- th(i|1)s is (a|4) reg(3|3)x pattern
# Here you can customize for home limits
# Permission: waterhomes.sethome.<group>
# For example, you set 'default' to create only 1 home. You need to give a group/user the permission: waterhomes.sethome.default
home-group-limits:
default: 1
god: 10
# List unsafe blocks here so players cannot set home at this blocks
# Use Minecraft block identifier here, not numerical! You may try googling if you dont know :D
# Bypass permission: waterhomes.unsafeblocks.bypass
# This detects within 2 block radius of player
# Case insensitive
unsafe-blocks:
- water
- lava
- cactus
- magma_block
- bedrock
messages.yml
# Customize messages here!
# Only supports MiniMessage!
# MniMessage formatter: https://webui.advntr.dev/
prefix: "<aqua><b>WaterHomes<white>: <reset>"
reloaded: "<aqua><b>WaterHomes <reset><gray>Reloaded!"
nopermission: "<red>You don't have permission to use this command!"
sethome:
success: "<green>Successfully set home at your location!"
failed:
unsafe: "<red>Error! Unsafe location!"
banword: "<red>Error! Your set home contains a banned word!"
args: "<red>Error! Invalid Argument!"
# This is only activated if a player have a permission that grants him a multiple homes
noname: "<red>Error! No name specified!"
reachedmaximum: "<red>You reached your limit for setting homes!"
home:
success: "<green>Teleported to your home!"
delay: "<green>Teleporting... Please wait."
cooldown: "<red>You are in cooldown! Please wait in <yellow>%seconds% <red>seconds!"
failed:
delaymoved: "<red>You moved! Home teleportation cancelled."
invalidhome: "<red>Error! Invalid home."
args: "<red>Error! Invalid Argument!"
delhome:
success: "<green>Home '<yellow>%home%<green>' has been deleted!"
failed:
fail: "<red>Failed to delete %home%."
nohomes: "<red>You don't have any homes to delete!"
notfound: "<red>Home '<yellow>%home%<red>' not found!"
noname: "<red>Please specify a home name to delete!"
# This will show example:
# home1, home2, home3 and so on
homelist: "<yellow>Your homes<gray>: <reset>%homes%"
Links & Additional Information
Author: WatermanMC
- GitHub Repository (Source Code & Full Documentation): https://github.com/WatermanMC/WaterHomes
- Documentation: https://github.com/WatermanMC/WaterHomes/wiki
- Discord Support: https://discord.gg/Scgqfm5EU4
Последние версии
Все версии →release
WaterHomes 2.3.1
2.3.119 мар. 2026 г.178Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3paper, purpur
Что нового
Added tp delay permission checks and configuration checks for player move & damage.
release
WaterHomes 2.3.0
2.3.018 мар. 2026 г.15Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
- Full implementation of teleport delay cancel on move, cancel on damage.
- Remove unnecessary tasks when player left the server to prevent errors.
release
WaterHomes 2.2.4
2.2.47 мар. 2026 г.33Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
Fixed `NullPointerException` on calling `homeManager` on main class `onEnable()` method.
release
WaterHomes 2.2.3
2.2.35 мар. 2026 г.12Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
- Fixed sethome sometimes doesn't work and doesn't register to the database.
- Fixed teleport delay message is sent twice.
- `/waterhomes reload` now reloads the database too.
release
WaterHomes 2.2.2
2.2.24 мар. 2026 г.16Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
- Fixed `ClassCastException` on commands.
- Fixed homes does not save on `homes.yml`
- Added `home.failed.nohomes` message key on `messages.yml.
release
WaterHomes 2.2.1
2.2.12 мар. 2026 г.13Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
- Main class code cleaning.
- Fixed `plugin.getConfig()` is used on HomeCommand class instead of `configManager.getConfig()` causing a desync.
release
WaterHomes 2.2.0
2.2.022 февр. 2026 г.23Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
Added early `return true;`.
release
WaterHomes 2.1.1
2.1.122 февр. 2026 г.16Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
Fixed `NullPointerException` error.
release
WaterHomes 2.1.0
2.1.016 февр. 2026 г.21Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
- Use `ConfigManager`'s `getConfig()` instead of Bukkit's internal `plugin.getPluginConfig()`.
- Removed unnecessary methods.
release
Major 2.0.0 update
2.0.013 февр. 2026 г.14Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Что нового
# WaterHomes 2.0.0
**Changelogs:**
- Added MiniMessage support.
- Removed Legacy color codes support.
- `home-limits` is renamed to `home-group-limits` in `config.yml`.
- Added User-friendly error handling for YAML syntax errors or Java errors.
- `homelist` on `messages.yml` now shows comma-separated home list.
- Added Tab complete on commands.
- Console can now execute `/waterhomes`.
- Added `reachedmaximum` in `messages.yml` on `sethome.failed` section.
- Saving homes is now asynchronous for less lag.
- Fixed bug that prefix don't show on all messages.
- `unsafe-blocks` in `messages.yml` is now case-insensitive.
**Changes on Code:**
- Added `String getDiscordHelp()` getter on main class.
- Added `getMessage(@NotNull String path)` getter on config manager.
- Removed `getMessages()` method on config manager.
- Added `registerCommandCompleter()` method on main class.
- Added `@NotNull` and `@Nullable` annotations.