SkyHomes

A clean, lightweight homes plugin for Paper / Spigot 1.20+. Set homes, teleport to them, and manage everything from a simple GUI. Messages, menu items and limits are all configurable. Inspired by the DonutSMP homes system.

✨ Features

• 🏠 Homes GUI – a 4-row menu with beds and dyes: blue means the home is set, gray means the slot is empty
• ⏱️ Teleport delay – cancels if the player moves (configurable)
• ⌛ Teleport cooldown – optional
• 🔑 Permission-based home limits – skyhomes.homes.<number>
• 🎨 Hex color support – use &#RRGGBB and & codes anywhere in the config
• 💬 Fully editable messages and GUI – every message and item name/lore is in config.yml
• 🔌 PlaceholderAPI support (optional)
• 💾 Per-player YAML storage – no database needed
• ⌨️ Tab completion for home names

📜 Commands

Command	Description
/sethome <name>	Set a home at your location (or move an existing one)
/home [name]	Teleport to a home. Opens the menu if no name is given
/delhome <name>	Delete a home (aliases: /deletehome, /removehome)
/homes	Open the homes menu
/skyhomes reload	Reload the config (alias: /sh)

🖱️ GUI

• Blue bed – click to teleport
• Blue dye – left-click to move the home to your location, right-click to delete
• Gray bed / gray dye – empty slot, click to set a home here
• Blue dye (left side) – set a new home
• Banner – shows your home count and limit

🔐 Permissions

Permission	Description	Default
skyhomes.use	Use the home commands	everyone
skyhomes.admin	Use /skyhomes reload	op
skyhomes.homes.<N>	Allow N homes (e.g. skyhomes.homes.10)	–
skyhomes.homes.unlimited	Unlimited homes	op
skyhomes.bypass.delay	Skip the teleport delay	op
skyhomes.bypass.cooldown	Skip the teleport cooldown	op

🧩 PlaceholderAPI

Placeholder	Output
%skyhomes_prefix%	Plugin prefix
%skyhomes_count%	Homes the player has set
%skyhomes_max%	Player's home limit
%skyhomes_left%	Homes the player can still set
%skyhomes_list%	Comma-separated home names
%skyhomes_has_<name>%	true / false

⚙️ Configuration

settings:
  default-max-homes: 3
  teleport-delay: 3
  teleport-cooldown: 0
  cancel-on-move: true
  max-name-length: 16

The prefix, all messages and the whole GUI can be customised in config.yml.

📥 Installation

1. Download the jar and drop it into your plugins folder.
2. Restart the server.
3. Edit plugins/SkyHomes/config.yml to your liking and run /skyhomes reload.

Requirements: Paper or Spigot 1.20+, Java 17+. PlaceholderAPI is optional.

💬 Support

Found a bug or have a suggestion? Open an issue on the GitHub page.