PLUGIN DOCUMENTATION

Homes

A homes system built for modern Paper/Folia servers, with dialog menus for capable clients and a full chest GUI fallback.

Paper / FoliaViaVersion optionalVelocity for network modeSQLite / SQL / MongoDB

What it does

⌂

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

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

◉

Players can pick item icons; newer clients can render inline sprites and older setups can use custom glyphs.

⇄

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

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

Exact commands, aliases and permission nodes.

Settings, defaults and the full generated configuration.

Common issues and what to check first.