⚒ 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

!Main Menu — Farmer tooltip

!Job Detail Menu — Farmer

• 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.

!Level requirement message

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:

!Level-up title

!Level-up subtitle bar

• 🔔 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