👷 xJobs | The Ultimate Professional Job System 👷

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

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

---

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.