ModernJobs

A premium Minecraft jobs plugin with full GUI, prestige, boosters, perks, leaderboards and PlaceholderAPI support.

API-Version 1.21+ Folia Supported PlaceholderAPI Vault Economy 11 Built-in Jobs

Prestige Guide PlaceholderAPI French Docs

GUI — Main Menu

Open with /jobs. Shows all loaded jobs. Click a job to view its details.

░

⛏ Miner

🪓 Wood

🌾 Farm

🎣 Fish

⚔ Hunt

░

🔥 Smith

🔥 Smelt

⚒ Craft

🏗 Build

✨ Ench

░

🧭 Expl

░

◄ Prev

✖ Close

Next ►

Main Menu layout (54-slot inventory)

Interactions

Action	Result
Left-click a job you haven't joined	Opens the Job Detail menu to view info and join
Left-click a job you have joined	Opens the Job Detail menu showing your progress
Right-click a job you have joined	Instantly leaves that job
Click ◄ / ► arrows	Navigate pages (when there are more jobs than slots)
Click ✖ Close	Closes the menu

GUI — Job Detail Menu

Shows when you click any job in the main menu. Contains all information about that specific job and your progress in it.

░

📊 Stats

░

💰 Earn

🏆 Reward

📖 All Rwds

✨ Perks

░

◄ Back

🚪 Leave

⭐ Prestige

Job Detail Menu layout

Buttons Explained

Button	Slot (default)	What it shows / does
📊 Stats (Book)	13	Shows your current level, prestige, XP, XP needed, progress bar, and total XP earned. Click to print the same info in chat.
💰 How To Earn (Paper)	30	Preview of actions that give XP/money in this job (first 5 shown). Green = available, Red = level-locked, Gray = level exceeded. Click to print the full list in chat.
🏆 Upcoming Rewards (Chest)	31	Shows the next reward level and what you will receive (money, items, perks, permissions).
📖 All Level Rewards (Knowledge Book)	32	Opens the Rewards GUI showing every level reward in order.
✨ Perks (Nether Star)	33	Opens the Perks GUI showing every perk in this job, whether unlocked or locked.
🚪 Leave / Join	49	If you are in the job: click to leave. If you are not: click to join.
◄ Back (Arrow)	45	Returns to the Main Menu.
⭐ Prestige (Nether Star)	53	Only shows if you are in the job and prestige is enabled. Glows when you are at max level and can prestige. Click to prestige.

GUI — Rewards Menu

Shows all level rewards for a job in order. Accessed by clicking All Level Rewards in the Job Detail menu.

Each slot is a coloured dye: green = already unlocked, gray = still locked.
Hover over each slot to see the reward details (money, items, commands, perks).
If there are many rewards, use the ◄ / ► arrow buttons to page through them.
If the job has prestige rewards, tabs appear at the top to switch between prestige levels.
Click ◄ Back to return to the Job Detail menu.

GUI — Perks Menu

Shows all perks defined in the job's yml file. Accessed by clicking ✨ Perks in the Job Detail menu.

Unlocked perks — shown with their custom icon and a glowing enchantment effect. The lore shows the description and confirms it is unlocked.
Locked perks — shown as a gray dye. The lore shows what level you need.
Perks are shown in level order (lowest level first).
Use ◄ / ► arrows if there are more perks than fit on one page.
Click ◄ Back to return to the Job Detail menu.

GUI — Leaderboard Menu

Access via the leaderboard button (if configured) or a command. Shows the top players ranked by XP.

Tabs at the top switch between the Global leaderboard and each individual job's leaderboard.
Each entry shows the player's head, rank, level, prestige and total XP.
The leaderboard is cached and refreshes on the interval set in config.yml (leaderboard.refresh-interval).
Admins can force-refresh via the Admin GUI.

GUI — Admin Menu

Open with /jobs admin. Requires the ojobs.admin permission.

Button	What it does
Give XP (Experience Bottle)	Give a target player XP in a specific job
Set Level (Golden Sword)	Set a target player's level in a specific job
Reset Player (TNT)	Reset all job data for a player
Add Booster (Beacon)	Activate an XP booster
Reload Plugin (Redstone)	Same as `/jobs reload`
Refresh Leaderboard (Clock)	Force a leaderboard data refresh

gui.yml — Complete Reference

Every GUI's layout, slot positions, materials, names and lore are defined in gui.yml. You can move, rename or recolour every element.

main-menu

Key	Default	What it controls
`title`	`<gold>Jobs`	Text shown in the inventory title bar
`size`	`54`	Inventory size in slots (must be multiple of 9)
`filler.enabled`	`true`	Fill decoration slots with a filler item
`filler.material`	`GRAY_STAINED_GLASS_PANE`	Material of the filler item
`filler.slots`	border slots	Which slots to fill (list of numbers 0–53)
`job-slots`	inner slots	Slots where jobs are placed, in order. Jobs fill these sequentially. Reorder this list to change the visual layout.
`joined-lore`	—	Lore shown on job items the player has joined. Supports `%level%`, `%xp%`, `%xp_required%`, `%progress_bar%`, `%description%`
`not-joined-lore`	—	Lore shown on job items the player hasn't joined
`prev-page-slot`	`45`	Slot of the Previous Page arrow
`next-page-slot`	`53`	Slot of the Next Page arrow
`close-button.slot`	`49`	Slot of the Close button
`click-sound`	`UI_BUTTON_CLICK`	Sound played on any click in this menu

job-menu (Job Detail)

Key	What it controls
`stats-slot`	Slot of the Stats button
`stats-material`	Material of the Stats button
`earnings-slot`	Slot of the How To Earn button
`earnings-preview-limit`	How many actions to preview in the tooltip (default 5)
`rewards-slot`	Slot of the Upcoming Rewards button
`all-rewards-slot`	Slot of the All Level Rewards button
`perks-slot`	Slot of the ✨ Perks button (default 33)
`perks-material`	Material of the Perks button
`perks-name`	Display name of the Perks button
`leave-slot`	Slot of the Leave/Join button
`back-slot`	Slot of the Back arrow
`prestige-slot`	Slot of the Prestige button

perks-menu

Key	Default	What it controls
`title`	`<light_purple>✨ %job_name% Perks`	Menu title
`size`	`54`	Inventory size
`perk-slots`	inner slots	Slots where perk items appear, filled in level order
`unlocked-material`	`LIME_DYE`	Fallback material for unlocked perks (used if perk has no icon)
`locked-material`	`GRAY_DYE`	Material shown for locked perks
`unlocked-name`	`<green>%perk_name%`	Display name for unlocked perks
`locked-name`	`<red>%perk_name% [Locked]`	Display name for locked perks
`unlocked-lore`	—	Lore template for unlocked perks. Use `%description%` to insert perk description lines, `%level%` for required level.
`locked-lore`	—	Lore template for locked perks
`back-slot`	`49`	Slot of the Back arrow

rewards-menu

Key	What it controls
`reward-slots`	Which slots to place reward items in (list)
`prestige-tab-slots`	Which slots to place the prestige tab switchers
`reward-material-unlocked`	Material for unlocked reward slots (default: LIME_DYE)
`reward-material-locked`	Material for locked reward slots (default: GRAY_DYE)
`reward-lore-unlocked`	Lore shown on an unlocked reward. Supports `%level%`, `%money_line%`, `%items_line%`, `%commands_line%`, `%perks_line%`
`reward-lore-locked`	Lore shown on a locked reward

progress-bar

Key	Default	What it controls
`enabled`	`true`	Show the XP progress bar in tooltips and action bar
`length`	`20`	Total number of characters in the bar
`filled-char`	`█`	Character used for filled portion
`empty-char`	`░`	Character used for empty portion
`filled-color`	`<green>`	Colour of filled characters
`empty-color`	`<dark_gray>`	Colour of empty characters

ModernJobs — Premium Minecraft Jobs Plugin

Documentation generated for server administrators and players.