H
PLUGIN DOCUMENTATION

Homes

A homes system for Paper, Folia and Canvas servers with modern dialog menus and a full chest GUI fallback for older clients and Bedrock players.

Paper / Folia 26.1+Java 25ViaVersion optionalPlaceholderAPI optionalVelocity for network modeSQLite / SQL / MongoDB

What it does

⌂

Dialog + chest GUI

AUTO mode chooses the modern dialog for supported clients and a chest menu for older clients.

#

Permission-based slots

Home limits use homes.limit.<number> permissions with a configurable global maximum.

◉

Custom home icons

Players can choose item icons, with inline sprites for supported clients and custom glyphs for resource-pack setups.

⇄

Network homes

Shared storage and the Velocity bridge support same-proxy and cross-proxy home teleports.

↓

EssentialsX import

/homes import essentials copies every EssentialsX home into Homes.

▣

Bedrock chest menu

Bedrock players on Geyser or Floodgate get the chest menu while Java players keep the dialog menu.

✓

Safe teleport

Homes in the air, inside blocks or in lava send players to the nearest safe spot instead.

≡

Staff menu

/home-admin lists any player's homes, online or offline, to teleport to, rename or delete.

Quick start

  1. Install the Homes plugin JAR on your Paper/Folia/Canvas backend server.
  2. Receive your license and set license-key in plugins/Homes/config.yml.
  3. Leave mode: single-server under network: for a standalone server; SQLite works immediately.
  4. Review default-limit: 3 under homes:, max: 20 under homes:, GUI mode and teleport warmup settings.
  5. Run /homes and create a test home with /sethome.

Explore the docs