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.