Homes

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 · 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. (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 `` 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).