SetHomePlugin

# ⌂ SetHomePlugin SetHomePlugin is a clean, feature-rich home management plugin for Spigot/Paper servers. Players set named homes at any location and teleport back with a countdown, particles and sounds. Admins control per-rank home limits via LuckPerms or permission nodes — no manual config needed. A polished paginated GUI with delete-confirmation makes home management intuitive for every player. --- ## ⌨️ Commands | Command | Alias | Permission | Description | Default | |---|---|---|---|---| | `/sethome <name>` | `/sh` | `sethome.use` | Save a home at your current location | ✅ All | | `/home <name>` | `/h` | `sethome.use` | Teleport to a saved home | ✅ All | | `/delhome <name>` | `/deletehome`, `/removehome` | `sethome.use` | Delete a saved home | ✅ All | | `/homes` | `/homelist`, `/listhomes` | `sethome.use` | Open the paginated homes GUI | ✅ All | | `/sethomereload` | `/shreload` | `sethome.admin` | Reload the plugin configuration | 🔒 OP | --- ## 🔐 Permissions | Permission | Default | Description | |---|---|---| | `sethome.use` | All | Use /sethome, /home, /delhome, /homes | | `sethome.admin` | OP | Reload config, bypass home limits | | `sethome.homes.1` – `sethome.homes.10` | false | Allow exactly N homes (1, 2, 3, 5, 10) | | `sethome.homes.unlimited` | OP | Allow unlimited homes | --- ## 🏠 Home Limit Resolution The plugin resolves the home limit for each player in this order — first match wins: | Priority | Source | Example | |---|---|---| | 1 | Permission node `sethome.homes.unlimited` | → unlimited homes | | 2 | Highest numeric permission node `sethome.homes.N` | `sethome.homes.10` → 10 homes | | 3 | LuckPerms primary group matched in `rank-homes` config | group `vip` → 5 homes | | 4 | `general.default-max-homes` in config.yml | default → 3 homes | --- ## 🖥️ GUI Overview The homes GUI is a paginated 6-row inventory. The bottom row is always a navigation bar; the top 5 rows display home items. Right-clicking a home opens a 3-slot confirmation screen before deletion. | Action | Behavior | |---|---| | Left-click a home | Close GUI and start delayed teleport | | Right-click a home | Open delete-confirmation GUI (if enabled) | | Previous / Next arrows | Page through homes | | Barrier (close button) | Close inventory without action | --- ## ⚙️ Config Features ```yaml general: language: en # en, de default-max-homes: 3 teleport-delay: 3 # seconds countdown before teleport cancel-on-move: true # cancel teleport if player moves sounds: enabled: true teleport: ENTITY_ENDERMAN_TELEPORT set-home: BLOCK_ENCHANTMENT_TABLE_USE delete-home: ENTITY_ITEM_BREAK open-gui: BLOCK_CHEST_OPEN error: ENTITY_VILLAGER_NO particles: enabled: true type: PORTAL count: 30 rank-homes: default: 1 vip: 5 premium: 10 gui: rows: 6 home-item: LIME_BED filler-item: GRAY_STAINED_GLASS_PANE show-coordinates: true show-world: true confirm: enabled: true confirm-item: LIME_CONCRETE cancel-item: RED_CONCRETE ``` - Delayed teleport countdown with movement-cancel detection - Particles spawn at both origin and destination on teleport - Per-player YAML home storage — no database required - Home names validated: letters, digits, hyphens, underscores; max 24 chars - Tab-completion for all home name arguments - All sounds and items fully configurable via `config.yml` - All messages customizable per language --- ## 🌍 Language Support | Code | Language | |---|---| | `en` | 🇬🇧 English | | `de` | 🇩🇪 Deutsch | --- ## 🖥️ Compatibility | Server Software | Version | Supported | |---|---|---| | Paper | 1.21 – 1.21.x | ✅ | | Purpur | 1.21 – 1.21.x | ✅ | | Spigot | 1.21 – 1.21.x | ✅ | | Bukkit | 1.21 – 1.21.x | ✅ | | Folia | 1.21 – 1.21.x | ✅ | Java 21 required. LuckPerms is an optional soft-dependency. --- 💬 Support & Updates: (https://discord.com/invite/n6A3nc3EW7) ---