HomePlugin v1.0.0
A fully-featured /home system with a GUI, LuckPerms permission-gated slots, team homes, and a teleport countdown shown on-screen.Features
- Inventory GUI with up to 5 home slots
- Slot state colours: Blue = home set, Gray = empty/available, Red = locked (needs rank)
- Red dye below each bed opens a Confirm Delete screen before removing a home
- On-screen action bar countdown when teleporting (Teleporting in 3s…)
- Cancels teleport if player moves (configurable)
- Team home — shared home for a group, resolved via %donutteam_name% (PlaceholderAPI) with LuckPerms fallback
- All storage in flat YAML files — no database required
GUI Layout
┌────────────────────────────────────────┐│ G G G G G G G G G │ Row 0 — glass
│ G G BED BED BED BED BED G TEAM │ Row 1 — beds + team banner (slot 17)
│ G G DEL DEL DEL DEL DEL G G │ Row 2 — red dye delete buttons
└────────────────────────────────────────┘
- Click a gray bed → sets home at your current location
- Click a blue bed → teleports to that home
- Click a red dye → opens Confirm Delete screen
- Click the white banner (top-right of bed row) → opens Team Home menu
Dependencies
| Plugin | Required |
|---|---|
| LuckPerms | Soft (recommended) |
| PlaceholderAPI | Soft (for %donutteam_name%) |
Installation
- Drop HomePlugin-1.0.0.jar into your plugins/ folder
- Start/restart the server
- Configure plugins/HomePlugin/config.yml as needed
- In LuckPerms, assign home permissions to your rank groups
Permissions
| Permission | Description | Default |
|---|---|---|
| homeplugin.home.1 | Unlock home slot 1 | true (via default group) |
| homeplugin.home.2 | Unlock home slot 2 | true (via default group) |
| homeplugin.home.3 | Unlock home slot 3 | true (via default group) |
| homeplugin.home.4 | Unlock home slot 4 | VIP+ |
| homeplugin.home.5 | Unlock home slot 5 | VIP+ |
| homeplugin.teamhome.use | Open/teleport to team home | — |
| homeplugin.teamhome.set | Set/delete the team home | leaders |
| homeplugin.admin | All permissions + bypass limits | op |
Commands
| Command | Permission | Description |
|---|---|---|
| /home | homeplugin.home.1 | Open homes GUI |
| /home <name> | homeplugin.home.1 | Teleport to a named home |
| /sethome <name> | homeplugin.home.1 | Set a home at your location |
| /delhome <name> | homeplugin.home.1 | Delete a home |
| /teamhome | homeplugin.teamhome.use | Teleport to team home |
| /teamhome set | homeplugin.teamhome.set | Set team home at your location |
| /teamhome delete | homeplugin.teamhome.set | Remove the team home |
Config (plugins/HomePlugin/config.yml)
settings:default-homes: 3 # Slots for players with no specific home permission
teleport-delay: 3 # Seconds before teleport (0 = instant)
cancel-on-move: true # Cancel teleport if player moves during countdown
gui-title: "&0&lHOMES"
