# \ud83d\udc77 xJobs | The Ultimate Professional Job System \ud83d\udc77
\n
\n—<\/p>\n
**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.<\/p>\n
—<\/p>\n
> ## \u2728 Premium Features
\n* **\ud83d\udc8e High-End GUI**: A modern, columnar selection menu with custom heads and vibrant accent colors.
\n* **\ud83c\udf10 100% Internationalized**: Professionally translated into English, with global label management.
\n* **\ud83e\udd16 Discord Webhooks**: Real-time notifications for level-ups, job changes, and more with fully customizable embeds.
\n* **\ud83d\udcca Optimized Backend**: Support for H2 and MySQL databases with efficient caching.
\n* **\ud83c\udfad Dynamic Lore**: Each job features unique premium descriptions and action hints.
\n* **\ud83d\udee0\ufe0f Developer Friendly**: Full PlaceholderAPI support and a simple yet powerful YML API for creating jobs.
\n* **\u26a1 Lightweight**: Built for performance, ensuring zero impact on your server’s TPS.<\/p>\n
—<\/p>\n
> ## \ud83d\ude80 How to Create a Custom Job
\nAdding new professions to your server is incredibly simple. Follow this step-by-step guide:<\/p>\n
1. Navigate to the `\/plugins\/xJobs\/jobs\/` folder.
\n2. Create a new file named `your_job_id.yml` (e.g., `alchemist.yml`).
\n3. Copy and customize the template below:<\/p>\n
“`yaml
\nname: “Alchemist”
\npermission: “default”
\nmax-level: 200<\/p>\n
icon:
\n material: PLAYER_HEAD
\n base64: “eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUv…”
\n slot: 10
\n name: “Alchemist”
\n lore:
\n – “”
\n – ” &#A2FF5C\u2726 &f{info_label}:”
\n – ” &e\u2b50 &f{level_label}: &e{level}&f\/&e{max_level}”
\n – ” &a\ud83d\udc65 &f{workers_label}: &#D0FFD3{workers}”
\n – “”
\n – ” &#A2FF5C\u2726 &f{blurb_label}:”
\n – ” &7A master of volatile reactions. Brew concoctions”
\n – ” &7and elixirs that grant inhuman strength and life.”
\n – “”
\n – ” &#A2FF5C\u2726 &f{actions_label}:”
\n – ” &8\u25aa &7Brew magical potions”
\n – “”
\n – ” {join_action}”<\/p>\n
actions:
\n block_break: # Logic for breaking blocks
\n ‘WHEAT’:
\n xp: 5
\n money: 10.0
\n kill_mob: # Logic for hunting
\n ‘ZOMBIE’:
\n xp: 15
\n money: 20.0
\n“`<\/p>\n
4. Use `\/jobs reload` in-game to apply your new profession immediately!<\/p>\n
—<\/p>\n
> ## \ud83d\udccc Placeholders & Variables
\nEnhance your GUIs and chat with our dynamic placeholders:<\/p>\n
| Placeholder | Description |
\n| :— | :— |
\n| `{player}` | The name of the player |
\n| `{job}` | The current profession name |
\n| `{level}` | The player’s current job level |
\n| `{max_level}` | The maximum level reachable |
\n| `{xp}` | Current experience points |
\n| `{xp_needed}` | Experience needed for next level |
\n| `{progress}` | A visual progress bar (e.g., `|||||…..`) |
\n| `{workers}` | Total number of players in that job |<\/p>\n
—<\/p>\n
> ## \ud83d\udee0\ufe0f Commands & Permissions
\nManage your professions with these simple commands:<\/p>\n
| Command | Description | Permission |
\n| :— | :— | :— |
\n| `\/jobs` | Open the main professional selection menu | *None* |
\n| `\/jobs stats` | View your personal progress and statistics | *None* |
\n| `\/jobs leave` | Resign from your current job | *None* |
\n| `\/jobs help` | Show the command help menu | *None* |
\n| `\/jobs reload` | Reload all configurations and jobs | `xjobs.admin` |<\/p>\n
—<\/p>\n
> ## \ud83d\udce6 Requirements
\nEnsure your server meets these criteria for optimal performance:<\/p>\n
| Requirement | Description | Status |
\n| :— | :— | :— |
\n| **Vault** | Essential for economy rewards and money management | **Required** |
\n| **Java 17+** | Modern runtime required for high-performance execution | **Required** |
\n| **PlaceholderAPI** | Enables dynamic labels and custom variables | *Recommended* |<\/p>\n
—<\/p>\n
> ## \ud83d\udef0\ufe0f Discord Integration
\nKeep your community engaged by linking your Discord server.
\nIn `config.yml`, set `webhooks.discord.enabled: true` and paste your URL.<\/p>\n
**Features:**
\n* **Custom Embeds**: Edit colors, footers, and thumbnails per event.
\n* **Async Processing**: Webhooks never lag your server.
\n* **Player Avatars**: Automatically fetches the player’s head for the notification.
\n
\n—<\/p>\n
> **Pro Tip**: You can edit the titles of all GUI sections (like “Information” or “Active Workers”) globally in `messages.yml`. Edit once, update everywhere!<\/p>\n
> Got some cash? Get a PREMIUM (ES\/EN) config on Discord.<\/p>\n","protected":false},"excerpt":{"rendered":"
The best plugin for working on your server<\/p>\n","protected":false},"featured_media":172429,"template":"","meta":{"_minecraft_slug":"xjobs","_minecraft_project_id":"t2LuwSY3","_minecraft_author":"jn_willfrydev","_minecraft_license":"Apache-2.0","_minecraft_downloads":82,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"xjobs.zip","_minecraft_size_bytes":5542902,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:21:24.342551Z","_minecraft_date_created":"2026-05-03T04:26:06.301870Z","_minecraft_date_modified":"2026-05-09T18:42:18.139922Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/xjobs","_minecraft_icon_attachment_id":172429,"_minecraft_imported_at":"2026-06-09T22:06:26+00:00","_minecraft_import_hash":"30723dc1aaecb59c708bae58417b236f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,125,89,866,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-172428","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n