🏠 ZyraHome
GUI-based home management with teams & VIP support — by sti_moi
◈ Overview
ZyraHome is a lightweight yet feature-rich home plugin for Paper 1.21.x servers. Unlike traditional command-based home plugins, everything is handled through a clean 27-slot GUI — no memorizing commands, no typing coordinates. Just open the menu, click, and teleport.
The plugin supports personal homes, VIP premium homes with instant teleportation, and a full team system with a shared team home managed by the team leader.
◈ Features
- 🖱️ GUI-only home management — Set, teleport to, and delete homes entirely through an intuitive chest-style menu.
- ⏱️ Teleport delay system — Normal homes have a 3-second countdown. Moving during the delay cancels the teleport.
- ⭐ VIP / premium homes — 2 extra home slots with instant teleportation for players with the
zyrahome.vippermission. - 👥 Team system — Create teams, invite members, and share a common team home. The leader manages the team home via the GUI.
- 💾 Persistent data — All homes and team data are saved to
homes.ymlandteams.yml— no database required. - ⚙️ Configurable — Teleport delays, home counts, cancel-on-move and all messages are fully editable in
config.yml.
◈ GUI Explained
The menu is a 27-slot chest split into two rows: beds on top (visual status), dye buttons on the bottom (actions).
| Item | Meaning |
|---|---|
| Gray wool | Team home slot, not yet defined |
| White bed | Normal home, undefined |
| Red bed | VIP home — requires zyrahome.vip |
| Green bed | Home is defined and ready |
| Gray dye | Click to set / define this home |
| Green dye | Left-click to teleport · Right-click to delete |
Note: VIP homes display as red beds until
zyrahome.vipis granted. Once unlocked, they behave identically to normal homes but teleport instantly.
◈ Commands
| Command | Description |
|---|---|
/home |
Open the home GUI menu |
/teamhome |
Teleport to your team's home |
/team create <name> |
Create a new team |
/team invite <player> |
Invite a player to your team (leader only) |
/team accept |
Accept a pending team invitation |
/team leave |
Leave your current team |
/team kick <player> |
Kick a member from your team (leader only) |
/team disband |
Dissolve the team (leader only) |
/team info |
Display team info and member list |
◈ Permissions
| Node | Description | Default |
|---|---|---|
zyrahome.home |
Access the home GUI and use homes | everyone |
zyrahome.vip |
Unlock VIP home slots + instant teleportation | op |
zyrahome.team |
Use team commands and team home | everyone |
zyrahome.admin |
Administrative commands | op |
◈ Installation
- Drop the
.jarinto your server'splugins/folder. - Restart the server — no dependencies required.
- Configuration files (
config.yml,homes.yml,teams.yml) are generated automatically insideplugins/ZyraHome/.
Works out of the box on any Paper 1.21.x server running Java 21+.
Created by sti_moi · ZyraHome v1.0.0 · Paper 1.21.x
