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:

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.