zyraquests

# 📜 ZyraQuests

> **A fully custom quest plugin with beautiful GUI menus, 6 objective types, flexible rewards, and native ZyraJobs integration — built for Spigot 1.21.**

—

## ✨ Overview

**ZyraQuests** lets you create any quest you can imagine directly from a single YAML file — no commands, no in-game editor required. Players browse quests through polished inventory menus, track their progress in real time via action bar indicators, and earn XP, items, or custom commands as rewards.

Works perfectly standalone, and unlocks extra features when paired with **ZyraJobs**.

—

## 🖥️ GUI Menus

ZyraQuests is built around three fully interactive inventory menus:

**📋 Quest Browser** — Browse all quests sorted by category (Mining, Farming, Hunting, Brewing, General). Each quest shows its difficulty color, objectives count, your current status (not started / in progress / completed), and a live XP progress bar if active. Paginated for large quest collections.

**🔍 Quest Detail** — Opens on click. Shows the full quest description, each objective with its own progress bar, all rewards previewed as items, and the Accept / Abandon button. Border color changes based on difficulty (green = Easy, yellow = Medium, red = Hard, orange = Legendary).

**⚡ Active Quests** — See all your quests in progress at a glance, with per-objective progress bars. Quick-navigate back to any quest’s detail view.

—

## 📋 Creating Quests

Everything lives in `quests.yml`. One quest looks like this:

“`yaml
quests:
diamond_hunter:
display-name: “Diamond Hunter”
description:
– “The real treasure lies deep below.”
– “Find and mine diamonds.”
icon: DIAMOND
category: MINING
difficulty: HARD
repeatable: false
objectives:
– type: MINE_BLOCK
block: DIAMOND_ORE
amount: 10
display: “Mine Diamond Ore”
– type: REACH_JOB_LEVEL
job: miner
level: 20
display: “Be Miner Level 20”
rewards:
– type: XP
amount: 20
– type: JOB_XP
job: miner
amount: 1000
– type: ITEM
material: DIAMOND_PICKAXE
amount: 1
name: “&b&lDeep Earth Pickaxe”
lore:
– “&7Forged from the deepest veins.”
“`

That’s it — reload with `/qadmin reload` and the quest is live.

—

## 🎯 Objective Types

| Type | What it tracks |
|——|—————|
| `MINE_BLOCK` | Breaking specific blocks underground |
| `HARVEST_CROP` | Harvesting fully grown crops |
| `KILL_MOB` | Killing any entity by type |
| `BREW_POTION` | Brewing potions at a brewing stand |
| `COLLECT_ITEM` | Picking up or crafting specific items |
| `REACH_JOB_LEVEL` | Reaching a level in ZyraJobs *(ZyraJobs required)* |

—

## 🎁 Reward Types

| Type | Effect |
|——|——–|
| `XP` | Give vanilla experience levels |
| `JOB_XP` | Add ZyraJobs XP to a specific job *(ZyraJobs required)* |
| `ITEM` | Give an ItemStack with optional custom name & lore |
| `COMMAND` | Run any console command with `%player%` placeholder |

—

## 🔗 ZyraJobs Integration

ZyraQuests integrates with **ZyraJobs** as a soft-dependency — install both plugins and the integration activates automatically. No configuration needed.

When ZyraJobs is present:
– `JOB_XP` rewards give XP directly into the player’s job level
– `REACH_JOB_LEVEL` objectives track job progression in real time
– If ZyraJobs is absent, `JOB_XP` rewards fall back to vanilla XP automatically

—

## 📈 Player Experience

– 🔔 **Level-up style chat message** when a quest is completed, listing all rewards
– 📺 **Screen title** on completion
– 📊 **Action bar progress** updates every time an objective advances
– 🔊 **Sounds** on quest accept and completion
– 🔁 **Repeatable quests** — configure any quest to be completable multiple times
– 🌐 **Server broadcast** on completion (optional, disabled by default)
– 💬 **Join message** reminding players of their active quests

—

## 🏷️ Quest Difficulties

| Difficulty | Color | Border |
|———–|——-|——–|
| Easy | 🟢 Green | Lime glass |
| Medium | 🟡 Yellow | Yellow glass |
| Hard | 🔴 Red | Red glass |
| Legendary | 🟠 Orange | Orange glass |

—

## ⚙️ Configuration

**`config.yml`** — Global settings:
– `max-active-quests` — how many quests a player can track at once (default: 3)
– `actionbar-progress` — show action bar updates on objective progress
– `sounds` — toggle all sounds
– `broadcast-completion` — announce completions server-wide
– All chat messages fully customizable with color codes

**`quests.yml`** — All quests. Add, remove, or edit quests freely. No restart needed — just `/qadmin reload`.

—

## 🛠️ Commands

| Command | Description |
|———|————-|
| `/quests [category]` | Open the quest browser |
| `/qadmin reload` | Reload config and all quests |
| `/qadmin list` | List all quest IDs |
| `/qadmin give ` | Force-start a quest for a player |
| `/qadmin complete ` | Force-complete a quest |
| `/qadmin reset [id]` | Reset one quest or all quests |
| `/qadmin info ` | View a player’s quest progress |

Tab-completion is supported on all commands.

—

## 🔑 Permissions

| Permission | Default | Description |
|———–|———|————-|
| `zyraquests.use` | Everyone | Access to `/quests` |
| `zyraquests.admin` | OP | Access to `/qadmin` |

—

## 📦 Requirements

– **Minecraft**: 1.21.x
– **Server software**: Spigot or Paper 1.21+
– **Java**: 21+
– **No required dependencies**
– **Optional**: ZyraJobs (for `JOB_XP` rewards and `REACH_JOB_LEVEL` objectives)

—

## 🤝 Part of the Zyra Suite

ZyraQuests is designed to work alongside **ZyraJobs** as a unified gameplay ecosystem. Install both for the full experience — quests that reward job XP, objectives that track job levels, and a consistent GUI style across both plugins.

—

## 👤 Credits

Made with by **sti_moi** — *zyrajobs’s group*

zyramenu

—

## 🗂️ ZyraMenu — Custom GUI Menus for 1.8 → 1.21

**ZyraMenu** is a lightweight, fully YAML-driven GUI menu plugin with **native multi-version support** from Minecraft 1.8.8 all the way to 1.21.x — no NMS, no reflection hacks, just clean compatibility layers.

—

### ✨ Features

– **YAML-based menus** — each menu is its own `.yml` file in `plugins/ZyraMenu/menus/`, easy to edit and reload without restarting the server
– **In-game menu creator** — open a chest, place your items, close it: the menu is saved automatically (`/zm create `)
– **Image backgrounds** — drop a `.png` named after your menu into `IMAGES-MENU/`, and ZyraMenu will slice it into a 9-slot grid and apply it as the inventory background
– **Rich slot actions** — assign one action per slot:
– `CLOSE` — close the inventory
– `COMMAND:` — run a command as the player
– `CONSOLE:` — run a command from the console
– `MESSAGE:` — send a chat message
– `OPENMENU:` — open another ZyraMenu
– `SERVER:` — transfer to a BungeeCord server
– **Item utilities** — rename any held item or set individual lore lines directly in-game
– **Player head support** — set a skull owner per slot for custom player heads
– **Hot reload** — `/zm reload` picks up all config and menu changes instantly
– **Tab completion** — full tab-complete support on all subcommands

—

### 🔧 Commands

| Command | Description |
|—|—|
| `/zm view

zyrajobs

# ⚒ ZyraJobs

> **A fully custom Jobs plugin with beautiful GUI menus, progressive unlocks, and a deep leveling system — built for Spigot 1.21.**

—

## ✨ Overview

**ZyraJobs** lets your players choose a profession and level it up by doing what they love — mining, farming, hunting, or brewing. Every action earns XP, every level unlocks something new, and every milestone rewards the grind.

No bloat. No dependencies. Just a clean, immersive jobs experience with handcrafted GUI menus that look great out of the box.

—

## 🧭 The 4 Jobs

| Job | How to level up | Unlocks |
|—–|—————-|———|
| ⛏ **Miner** | Break ores underground | Coal → Iron → Gold → Diamond → Ancient Debris |
| 🌾 **Farmer** | Harvest fully grown crops | Wheat (Lv.1) → Carrots (Lv.5) → Chorus Plant (Lv.30) |
| 🏹 **Hunter** | Kill mobs & animals | Chickens → Creepers → Endermen → Warden (Lv.40) |
| ⚗ **Alchemist** | Brew potions at a stand | Basic potions (Lv.1) → Strength (Lv.8) → Turtle Master (Lv.25) |

Each job goes from **level 1 to 50**, with an XP formula that scales naturally: `100 × level^1.5`.

—

## 🖥️ Custom GUI Menus

ZyraJobs is built around **beautiful, interactive inventory menus**:




– **Main Menu** — displays all 4 jobs with your current level, XP bar, and active job highlighted with an enchantment glow
– **Job Detail Menu** — color-coded per job (gray / green / red / purple), shows every unlockable action, required level, XP reward, and all level bonuses
– Everything is **click-to-navigate**: open job details, join, leave, all without typing a command

—

## 📈 Progressive Unlocks

Crops, ores, mobs and potions are **gated by level** — you earn the right to work with better materials as you progress.


**Example for Farmer:**
– Lv. 1 → Wheat `+8 XP`
– Lv. 5 → Carrots & Potatoes `+15 XP` *(unlocked!)*
– Lv. 8 → Beetroots `+12 XP`
– Lv. 10 → Pumpkins & Melons `+20 XP`
– Lv. 30 → Chorus Plant `+45 XP`

Every unlock sends the player a chat notification the moment they reach the required level.

—

## 🎖️ Level-Up System

When a player levels up, they get:



– 🔔 A **rich chat message** with a formatted XP progress bar
– 📺 A full **screen title** announcing the new level
– 🔊 A **level-up sound** effect
– 📣 A notification if a **new action is unlocked** at that level

—

## ⚡ Job Bonuses (every 10 levels)

Each job grants passive bonuses at milestone levels:

**⛏ Miner**
– Lv. 10 — 15% chance to double coal drops
– Lv. 20 — 10% chance to double iron/gold drops
– Lv. 40 — 2% chance to find a diamond while mining deepslate
– Lv. 50 — **PRESTIGE**: Triple XP on all ores

**🌾 Farmer**
– Lv. 5 — 50% chance to auto-replant harvested crops
– Lv. 15 — 10% chance to double wheat/carrot yield
– Lv. 25 — Auto-replant guaranteed at 100%
– Lv. 50 — **PRESTIGE**: Instant harvest without breaking

**🏹 Hunter**
– Lv. 15 — 2% chance to drop monster heads on kill
– Lv. 25 — Double XP against bosses (Ravager, Elder Guardian, Evoker…)
– Lv. 35 — Regeneration effect after each kill
– Lv. 50 — **PRESTIGE**: Random potion drop on every kill

**⚗ Alchemist**
– Lv. 15 — 8% chance to brew a duplicate potion
– Lv. 25 — Brewed potions last 25% longer
– Lv. 35 — 5% chance to auto-upgrade potion to level II
– Lv. 50 — **PRESTIGE**: All your potions are automatically level II

—

## 🛠️ Commands

| Command | Description |
|———|————-|
| `/jobs` | Open the Jobs GUI |
| `/jadmin reload` | Reload the config |
| `/jadmin setlevel ` | Set a player’s job level |
| `/jadmin addxp ` | Add XP to a player |
| `/jadmin reset ` | Reset all job data for a player |
| `/jadmin info ` | View a player’s job stats |

—

## 🔑 Permissions

| Permission | Default | Description |
|———–|———|————-|
| `zyrajobs.use` | Everyone | Access to `/jobs` |
| `zyrajobs.admin` | OP | Access to `/jadmin` |

—

## ⚙️ Configuration

Everything is configurable in `config.yml`:
– Max level (default: 50)
– XP formula base and exponent
– Multi-job mode (allow multiple jobs at once)
– Per-action XP rewards and minimum level requirements
– Level-up titles & sounds on/off
– All chat messages with color code support

—

## 📦 Requirements

– **Minecraft**: 1.21.x
– **Server software**: Spigot or Paper 1.21+
– **Java**: 21+
– **No dependencies** required

—

## 👤 Credits

Made by **sti_moi** — *zyraplug’s group*

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

– 🖱️ **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 ` | Create a new team |
| `/team invite ` | Invite a player to your team *(leader only)* |
| `/team accept` | Accept a pending team invitation |
| `/team leave` | Leave your current team |
| `/team kick ` | 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*