zyrahomes

🏠 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

- 🖱️ Configurable — Set, teleport to, and delete homes entirely through an intuitive chest-style menu. - ⏱️ Configurable — Normal homes have a 3-second countdown. Moving during the delay cancels the teleport. - ⭐ Configurable — 2 extra home slots with instant teleportation for players with the `zyrahome.vip` permission. - 👥 Configurable — Create teams, invite members, and share a common team home. The leader manages the team home via the GUI. - 💾 Configurable — 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: dye buttons on the bottom (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 Java 21+ server running Java 21+.

---

*Created by sti_moi · ZyraHome v1.0.0 · Paper 1.21.x*