Homes DonutSMP

# Homes-DonutSMP Version: 2.0.0 Homes-DonutSMP is a Paper plugin that adds a simple homes system with a GUI menu, warmup support, and permission-based home limits. Players use `/home` to open the menu, `/sethome` to add a home, and `/delhome` to remove one. It is built for server owners who want a clean homes flow with configurable messages, group-based limits, and an easy GUI for teleporting and deleting homes. ## Why Homes-DonutSMP - GUI homes menu with click-to-teleport and right-click delete - Permission-based max homes via groups - Optional warmup with move-cancel - Fast sethome button in the GUI - Admin reload command - Admin home management for other players - Read-only admin home GUI view with /home +<player> - LuckPerms-friendly permission nodes ## Features - `/home` opens even if the player has no homes - Set Home button auto-names homes as 1, 2, 3, etc - Teleport is blocked when over the max until homes are deleted - Configurable warmup seconds - Per-message customization with MiniMessage or legacy colors - Admin actions support target syntax: `<player>:<home>` ## Commands - /home - /home <player>:<name> - /home +<player> - /sethome <name> - /sethome <player>:<name> - /delhome <name> - /delhome <player>:<name> - /homes reload ## Permissions - homes-donutsmp.use - homes-donutsmp.sethome - homes-donutsmp.admin.reload - homes-donutsmp.admin.home - homes-donutsmp.admin.sethome - homes-donutsmp.admin.delhome - homes-donutsmp.admin.view - homes-donutsmp.warmup-bypass - homes-donutsmp.group.<name> ## Config Structure Example: ```yml settings: max-homes: 2 warmup-seconds: 3 gui-title: "<gold>Homes</gold>" groups: default: 2 vip: 3 staff: 5 ``` ## Messages All user-facing text is editable in config.yml under `messages`, including: - no-permission - player-only - home-limit - home-over-limit - teleport-start - teleport-cancelled - teleport-complete ## Compatibility - Server software: Paper - Minecraft API target: 1.21.x - Java: 21 ## Install 1. Build or download the release jar. 2. Place it in your server plugins folder. 3. Start the server once to generate config files. 4. Edit config.yml to fit your limits and messages. 5. Run /homes reload.