Homes

A lightweight home system with configurable teleportation, storage, permissions, and administration.

Commands

Command	Description
/sethome [name]	Set a home. If no name is provided, the home is named home.
/home [name]	Teleport to a home. Without a name, teleports to home or to the player's only home.
/delhome [name]	Delete a home.
/homes	Display a list of clickable home names. Click a name to teleport.
/renamehome <old> <new>	Rename a home.
/homeadmin set|delete|list|tp|reload	Admin commands for managing other players' homes.

Teleportation

• Warmup: Players must stand still for 5 seconds. A countdown is displayed in the action bar. Moving to another block or taking damage cancels the teleport; both cancellation conditions can be disabled in the config.
• Cooldown: 30 seconds by default, starting after a successful teleport.
• Warmup, cooldown, sounds, and particles are configurable.

Storage

Choose between yaml (homes.yml) and sqlite (homes.db) in the config. Switching storage takes effect after a server restart.

Cooldowns are stored in memory only and reset when the server restarts.

Home Limit

The default limit is default-max-homes: 3. Set it to -1 for unlimited homes.

Players and groups can use homes.limit.<number> (for example, homes.limit.10). The highest applicable limit takes precedence. Grant homes.limit.unlimited for unlimited homes.

Permissions

Player permissions

Permission	Description
homes.set	Set homes
homes.home	Teleport to homes
homes.delete	Delete homes
homes.list	List homes
homes.rename	Rename homes

All player permissions are granted by default.

Admin permissions

Permission	Description
homes.admin.set	Set homes for other players
homes.admin.delete	Delete other players' homes
homes.admin.list	List other players' homes
homes.admin.teleport	Teleport to other players' homes
homes.admin.reload	Reload the plugin

The homes.admin permission grants all admin permissions. By default, admin permissions are granted to operators only.

Bypass permissions

• homes.bypass.cooldown — Bypass the teleport cooldown.
• homes.bypass.warmup — Bypass the teleport warmup.
• homes.bypass.world — Bypass world restrictions.

homes.* grants all permissions.

Additional Features

• Home name validation with configurable maximum length and regex.
• Configurable worlds where /sethome is disabled.
• Option to allow overwriting an existing home.
• Tab completion for home names and player names.
• All messages are configurable in English in config.yml using MiniMessage format. Use <prefix> to insert the prefix. Leave a message empty to disable it.
• Admins can manage homes belonging to offline players only if the server already knows their name (cached player).