EssentialsC - Homes

Overview

EssentialsC's home system is a lightweight, chat-driven experience: run /sethome to create homes, /home to browse them, and click a name in chat to teleport instantly to that home. Every home name EssentialsC prints is clickable - no inventory screens involved.

Commands

Command	Description
`/sethome [name]`	Sets a home at your current location. With no name, uses the configured default home name. Running it again on an existing name overwrites that home's location.
`/sethome <player> <name>`	Sets a home for another player (including offline players) at your current location. Requires `essentialsc.sethome.admin`.
`/home [name]`	Teleports to the named home. With no name, opens your home list unless a default teleport home is configured, in which case it teleports there directly.
`/home bed`	Teleports to your bed or respawn anchor, if you have `essentialsc.home.bed` and a bed location set.
`/home <player> <name>`	Teleports you to another player's named home. Requires `essentialsc.home.admin`.
`/delhome <name>`	Deletes the named home. In command mode this requires confirmation - run the same command again within 15 seconds to confirm.
`/delhome <player> <name>`	Deletes a named home from another player (including offline players). Requires `essentialsc.delhome.admin`.
`/homes [player]`	Lists all of your homes with name, world, and coordinates. With a player name and `essentialsc.home.admin`, lists that player's homes instead.
`/homes notifications`	Toggles whether you receive notifications for admin home actions. Requires `essentialsc.home.notifications`.

Every home name in /home output is clickable in chat - clicking a name runs /home <name> for you.

Home Limits

How many homes a player can set is decided per-player by permission, falling back to a configured default if no specific limit permission is granted.

Permission	Effect
`essentialsc.sethome.admin` or `essentialsc.sethome.unlimited`	No home limit at all.
`essentialsc.sethome.<number>`	Caps the player at exactly that many homes. EssentialsC checks numbers from 100 down to 1 and uses the highest one granted, so a player with both `essentialsc.sethome.5` and `essentialsc.sethome.10` gets a limit of 10.
none granted	Falls back to `home.max-homes` in `config.yml`.

Ship presets exist for 1, 2, 3, 5, 10, and 25 - but any number works, since the check is permission-string based rather than a fixed list.

If home.bed-counts-in-limit is enabled, a player's bed location counts as one of their homes toward their limit, provided they also hold essentialsc.home.bed.

Teleport Behavior

Teleporting to a home goes through the same warmup/cooldown/cancellation logic regardless of which command triggered it.

Blocked worlds - if a home's world is listed in home.blocked-worlds, the teleport is refused entirely, even if the home still exists.
Cooldown - after a successful teleport, home.cooldown seconds must pass before another home teleport will start. Players with essentialsc.home.admin skip this entirely.
Warmup - if home.warmup is greater than zero, the player is told a countdown and the actual teleport happens after that many seconds. Admins skip warmups too.
Movement cancels warmup - if home.cancel-on-movement is enabled, moving so much as one block during the warmup cancels the pending teleport.
Disconnecting cancels warmup - leaving the server during a warmup cancels it automatically.

On a successful teleport, EssentialsC can optionally play a portal particle burst and an enderman teleport sound, controlled by home.particles and home.sounds.

Players with essentialsc.home.mount bring their mount with them - horses, donkeys, mules, pigs, and striders are teleported along with their rider rather than left behind.

Bed Homes

Players with essentialsc.home.bed can use /home bed to teleport straight to their current bed or respawn anchor location, without needing to set it as a regular home first. If they have no bed set, they're told so instead.

Admin Management

Players with essentialsc.home.admin can view and teleport to other players' homes (including offline players) with /home <player> <name> and list another player's homes with /homes <player>. Admins also skip home cooldowns and warmups.

Toggling /homes notifications controls whether a player is told when an admin teleports to, views, or modifies one of their homes.

Configuration

Key	Description	Default
`home.enabled`	Fully disables homes and unregisters `/home`, `/sethome`, `/delhome` and `/homes`. See the Modules page - a restart is required.	`true`
`home.max-homes`	Fallback home limit when no `essentialsc.sethome.<n>` permission is granted.	`3`
`home.cooldown`	Seconds required between home teleports.	`5`
`home.warmup`	Seconds of delay before a home teleport completes.	`3`
`home.cancel-on-movement`	Whether moving during a warmup cancels the pending teleport.	`true`
`home.particles`	Plays a particle effect at the destination on teleport.	`true`
`home.sounds`	Plays a sound effect at the destination on teleport.	`true`
`home.blocked-worlds`	List of world names where home teleports are refused.	`world_example_blocked`
`home.default-name`	Home name used when `/sethome` is run with no arguments.	`home`
`home.default-teleport-name`	If set, `/home` with no arguments teleports straight to this home instead of opening the home list.	`home`
`home.bed-counts-in-limit`	Whether a player's bed location counts toward their home limit.	`true`

Permissions

Node	Description	Default
`essentialsc.sethome`	Allows setting homes.	Everyone
`essentialsc.home`	Allows teleporting to homes.	Everyone
`essentialsc.delhome`	Allows deleting homes.	Everyone
`essentialsc.homes`	Allows listing homes.	Everyone
`essentialsc.sethome.1` / `.2` / `.3` / `.5` / `.10` / `.25`	Sets a fixed home limit at that number.	Nobody
`essentialsc.sethome.unlimited`	Removes the home limit entirely.	Operators
`essentialsc.sethome.admin`	Bypasses home limits and blocked-world restrictions, and lets you set other players' homes (including offline players).	Operators
`essentialsc.home.admin`	Allows teleporting to and managing other players' homes, skips cooldowns and warmups.	Operators
`essentialsc.delhome.admin`	Allows deleting other players' homes, including offline players.	Operators
`essentialsc.home.notifications`	Allows toggling admin home action notifications with `/homes notifications`.	Everyone
`essentialsc.home.bed`	Allows using a bed or respawn anchor as a home waypoint with `/home bed`.	Nobody
`essentialsc.home.mount`	Brings a ridden horse, donkey, mule, pig, or strider along when teleporting to a home.	Nobody