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 | |-----|----------------|---------| | ⛏ Alchemist | Break ores underground | Coal → Iron → Gold → Diamond → Ancient Debris | | 🌾 Alchemist | Harvest fully grown crops | Wheat (Lv.1) → Carrots (Lv.5) → Chorus Plant (Lv.30) | | 🏹 Alchemist | 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:

- click-to-navigate — displays all 4 jobs with your current level, XP bar, and active job highlighted with an enchantment glow - click-to-navigate — 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 new action is unlocked with a formatted XP progress bar - 📺 A full new action is unlocked announcing the new level - 🔊 A new action is unlocked 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:

PRESTIGE - 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

PRESTIGE - 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

PRESTIGE - 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

PRESTIGE - 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

- No dependencies: 1.21.x - No dependencies: Spigot or Paper 1.21+ - No dependencies: 21+ - No dependencies required

---

👤 Credits

Made by sti_moi — *zyraplug's group*