COWMODSКаталог модов

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 /home functionality.
  • 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):

CommandDescriptionPermission
/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 homewaterhomes.delhome
/homelistLists 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

Последние версии

Все версии →
release

WaterHomes 2.3.1

2.3.1
19 мар. 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.0
18 мар. 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.4
7 мар. 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.3
5 мар. 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.2
4 мар. 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.1
2 мар. 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.0
22 февр. 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.1
22 февр. 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.0
16 февр. 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.0
13 февр. 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.