🏠 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.vip permission.
• 👥 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.yml and teams.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.vip is 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

1. Drop the .jar into your server's plugins/ folder.
2. Restart the server — no dependencies required.
3. Configuration files (config.yml, homes.yml, teams.yml) are generated automatically inside plugins/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