👷 xJobs | The Ultimate Professional Job System 👷

!banner

xJobs is a high-performance, premium-grade job system designed for modern Minecraft servers. Featuring a stunning Cyan & Midnight Blue interface, seamless Discord integration, and a robust database-driven backend, it provides your players with an immersive and rewarding professional experience.

---

✨ Premium Features

• 💎 High-End GUI: A modern, columnar selection menu with custom heads and vibrant accent colors.
• 🌐 100% Internationalized: Professionally translated into English, with global label management.
• 🤖 Discord Webhooks: Real-time notifications for level-ups, job changes, and more with fully customizable embeds.
• 📊 Optimized Backend: Support for H2 and MySQL databases with efficient caching.
• 🎭 Dynamic Lore: Each job features unique premium descriptions and action hints.
• 🛠️ Developer Friendly: Full PlaceholderAPI support and a simple yet powerful YML API for creating jobs.
• ⚡ Lightweight: Built for performance, ensuring zero impact on your server's TPS.

---

🚀 How to Create a Custom Job

Adding new professions to your server is incredibly simple. Follow this step-by-step guide:

1. Navigate to the /plugins/xJobs/jobs/ folder.
2. Create a new file named your_job_id.yml (e.g., alchemist.yml).
3. Copy and customize the template below:

name: "Alchemist"
permission: "default"
max-level: 200

icon:
  material: PLAYER_HEAD
  base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUv..."
  slot: 10
  name: "Alchemist"
  lore:
    - ""
    - " &#A2FF5C✦ &f{info_label}:"
    - " &e⭐ &f{level_label}: &e{level}&f/&e{max_level}"
    - " &a👥 &f{workers_label}: &#D0FFD3{workers}"
    - ""
    - " &#A2FF5C✦ &f{blurb_label}:"
    - " &7A master of volatile reactions. Brew concoctions"
    - " &7and elixirs that grant inhuman strength and life."
    - ""
    - " &#A2FF5C✦ &f{actions_label}:"
    - " &8▪ &7Brew magical potions"
    - ""
    - " {join_action}"

actions: block_break: # Logic for breaking blocks 'WHEAT': xp: 5 money: 10.0 kill_mob: # Logic for hunting 'ZOMBIE': xp: 15 money: 20.0

4.  Use `/jobs reload` in-game to apply your new profession immediately!

---

> ## 📌 Placeholders & Variables
Enhance your GUIs and chat with our dynamic placeholders:

| Placeholder | Description |
| :--- | :--- |
| `{player}` | The name of the player |
| `{job}` | The current profession name |
| `{level}` | The player's current job level |
| `{max_level}` | The maximum level reachable |
| `{xp}` | Current experience points |
| `{xp_needed}` | Experience needed for next level |
| `{progress}` | A visual progress bar (e.g., `|||||.....`) |
| `{workers}` | Total number of players in that job |

---

> ## 🛠️ Commands & Permissions
Manage your professions with these simple commands:

| Command | Description | Permission |
| :--- | :--- | :--- |
| `/jobs` | Open the main professional selection menu | *None* |
| `/jobs stats` | View your personal progress and statistics | *None* |
| `/jobs leave` | Resign from your current job | *None* |
| `/jobs help` | Show the command help menu | *None* |
| `/jobs reload` | Reload all configurations and jobs | `xjobs.admin` |

---

> ## 📦 Requirements
Ensure your server meets these criteria for optimal performance:

| Requirement | Description | Status |
| :--- | :--- | :--- |
| **Vault** | Essential for economy rewards and money management | **Required** |
| **Java 17+** | Modern runtime required for high-performance execution | **Required** |
| **PlaceholderAPI** | Enables dynamic labels and custom variables | *Recommended* |

---

> ## 🛰️ Discord Integration
Keep your community engaged by linking your Discord server.
In `config.yml`, set `webhooks.discord.enabled: true` and paste your URL.

**Features:**
*   **Custom Embeds**: Edit colors, footers, and thumbnails per event.
*   **Async Processing**: Webhooks never lag your server.
*   **Player Avatars**: Automatically fetches the player's head for the notification.
!example
---

> **Pro Tip**: You can edit the titles of all GUI sections (like "Information" or "Active Workers") globally in `messages.yml`. Edit once, update everywhere!

> Got some cash? Get a PREMIUM (ES/EN) config on Discord.