⚒ 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 <player> <job> <level> | Set a player's job level |
| /jadmin addxp <player> <job> <amount> | Add XP to a player |
| /jadmin reset <player> | Reset all job data for a player |
| /jadmin info <player> | 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