xJobs

# 👷 xJobs | The Ultimate Professional Job System 👷 !(https://cdn.modrinth.com/data/cached_images/93b326bfa62f93f963c2e58f7e3e8a1977851e2b.jpeg) --- **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: ```yaml 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. !(https://cdn.modrinth.com/data/cached_images/57e09342c67b34aec44123f8d3b063b9ea2ddb03.png) --- > **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.