Skip to content

Homes

Homes are enabled by default with home.enabled: true.

Commands

Command Purpose
/home Teleport to a home; without a name, open the home menu.
/homes Home command alias.
/sethome Create or update a home.
/delhome Delete a home.
/homeadmin Staff home administration.

Permissions

  • essentials.home allows home use.
  • essentials.sethome allows creating or updating homes.
  • essentials.delhome allows deleting homes.
  • essentialslite.homeadmin allows /homeadmin.
  • Home cooldown and warmup bypass permissions are available as configured bypass nodes.

Configuration

home:
  enabled: true
  cooldown: 1000
  warmup: 5000
  default-limit: 1
  permissions:
    vip: 2
    mvp: 3
    elite: 4
    legend: 5
    god: 6
  menu:
    size: 54

cooldown is 1000 seconds. warmup is 5000 ms. The effective home limit starts at default-limit and uses the highest matching configured limit. The limit nodes are essentials.home.limit.vip, essentials.home.limit.mvp, essentials.home.limit.elite, essentials.home.limit.legend, and essentials.home.limit.god; the configured base limit has no essentials.home.limit.default permission node.

The menu uses a 54-slot layout by default. Its visual items are configured under home.menu.

Edges

  • Home names are trimmed, lowercased, and normalized. Spaces and hyphens become underscores; only letters, digits, underscores, and hyphens are accepted; normalized ids are at most 32 characters.
  • Naming an existing home updates it. A new home requires a free slot under the effective limit.
  • /sethome is rejected inside an enemy MineClans faction claim.
  • /homeadmin <teleport|tp> <player> [home] requires essentialslite.homeadmin and the homeadmin.enabled gate.