Homes DonutSMP

Homes-DonutSMP

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 - 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

Commands

- /home - /sethome <name> - /delhome <name> - /homes reload

Permissions

- homes-donutsmp.use - homes-donutsmp.sethome - homes-donutsmp.admin - 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.