Homes++

Homes++

Lightweight, survival-focused homes plugin for Paper / Purpur / Spigot / Bukkit (1.21.x).
Players can create named homes, teleport with a countdown (cancels on move), and admins can inspect/teleport to player homes using a polished GUI. Works with LuckPerms if present — and still works without LuckPerms.

Features

• /sethome <name> — set a named home at your current location (configurable max, safety checks).
• /home <name> — teleport to a named home (delayed; actionbar countdown; cancels on move).
• /homes — list homes in clickable chat GUI with [Go] buttons.
• /delhome <name> — delete your named home.
• /homesadmin <player> / /phomes <player> — admin GUI to view a player's homes, see creation time and safety status, and teleport to homes (requires admin permission).
• Safe-location checks (configurable list of forbidden blocks; checks the feet block).
• Permission-based max-homes via homesplusplus.homes.<N> nodes — works with or without LuckPerms.
• Optional reflective read of LuckPerms maxhomes meta (safe; only used if LuckPerms is present).
• Saves homes to homes.yml with creation timestamp and safe flag.

Requirements

• Java 17
• Paper / Purpur / Spigot / Bukkit server (1.21.x recommended)
• (Optional) LuckPerms for rank-based homes; plugin works without it

Installation (server)

1. Download homesplusplus-<version>.jar (or build from source).
2. Put the JAR into your server plugins/ folder.
3. Start or restart server. On first run the plugin will generate config.yml, messages.yml and homes.yml in plugins/HomesPlusPlus/.
4. Edit config.yml / messages.yml as needed.

Configuration examples

config.yml (example) — include these fields in your config.yml:

teleport-delay: 5             # seconds
max-homes-default: 1
forbidden-blocks:
  - LAVA
  - FIRE
  - CACTUS
safe-check-feet: true