EssentialsC - Homes

Overview

EssentialsC's home system works in two interchangeable modes, controlled by a single config option: a classic chat-based command mode, and a fully interactive GUI mode for browsing, creating, renaming, and deleting homes from an inventory menu. Both modes share the same underlying data, permissions, limits, cooldowns, and warmups - switching modes never affects existing homes.

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.
`/home [name]`	Teleports to the named home. With no name, opens your home list (or the GUI list in GUI mode) 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.
`/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`.

In command mode, 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 or GUI button 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.

GUI Mode

Set home.mode to gui in config.yml to replace the chat-list output of /home, /sethome, /delhome, and /homes with a full inventory-based browser.

Home List

Shows up to 8 homes per page, with buttons to:

Cycle sort order between alphabetical, date created, and world
Open a sign-based search prompt to filter homes by name
Page forward and backward
Create a new home, either under the default name or a custom one typed on a sign
Open any home's details screen

Home Details

Opens from clicking a home in the list, with buttons to teleport to it, rename it (via a sign prompt), update it to your current location, or delete it - the latter two routed through confirmation screens before anything changes.

Renaming, updating, and deleting all show a confirmation screen first. Nothing is changed until you click confirm on that screen.

Admin Management

Players with essentialsc.home.admin get an additional player-management entry point in GUI mode: a type-selection screen (online, offline, or all players with homes), then a searchable, paginated player list, then that player's home list - using the same details/confirm screens as a player browsing their own homes.

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.mode`	Either `command` for chat-based output or `gui` for the inventory browser.	`command`
`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.	empty
`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.	empty
`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.	Operators
`essentialsc.home.admin`	Allows teleporting to and managing other players' homes, skips cooldowns and warmups.	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