ModernJobs
The most complete and modern Jobs plugin for Minecraft 1.21+
Full Documentation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ What is ModernJobs?
ModernJobs is a feature-rich, fully configurable jobs plugin for Paper/Spigot 1.21+. Players choose one or more jobs — Miner, Farmer, Hunter, and more — and earn XP and money for performing in-game actions. As they level up they unlock perks, rewards, and prestige — all through a slick click-through GUI.
Every single detail is configurable via YAML. No coding required.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ 11 Built-in Jobs
- ⛏ Miner — Break ores and stone for XP and money. Unlocks Vein Mining and Night Vision perks.
- Woodcutter — Chop logs and trees. Unlocks Tree Feller and instant Leaf Decay.
- Farmer — Harvest crops. Unlocks auto-replant, auto-plant, and crop growth boost.
- Fisher — Catch fish and treasure. Unlocks Double Cast, Lucky Waters, and Treasure Sense.
- ⚔ Hunter — Kill mobs and monsters. Unlocks Loot Boost, Mob Tracking, and Mob Sense.
- Builder — Place blocks. Unlocks the Scaffold perk for instant vertical building.
- Blacksmith — Smelt and craft gear. Unlocks Auto Smelt, Field Repair, and Netherite Smithing.
- Smelter — Smelt items and cook food. Unlocks Super Smelt and Auto Fuel.
- ⚒ Crafter — Craft items at a workbench. Unlocks Mass Make for bonus crafting output.
- Explorer — Break biome-specific blocks. Unlocks Dimension Warp to teleport between worlds.
Enchanter — Enchant items at the enchanting table. Unlocks Lore Reader, XP Boost, and Arcane Focus.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Key Features
Full Click-Through GUI
Every action — joining, leaving, tracking progress, viewing rewards and perks — is done through intuitive inventory menus. No commands needed for players.
- Main Menu — Browse all jobs with your level, XP bar, and progress shown on each job icon.
- Job Detail Menu — See your stats, how to earn XP, upcoming rewards, all level rewards, and your perks.
- Rewards Menu — Browse every reward at every level in order. Green = unlocked, Gray = locked.
- Perks Menu — See every perk the job offers, at which level it unlocks, and whether you have it.
- Leaderboard Menu — Per-job and global rankings with player heads, level, prestige and total XP.
- Admin Menu — Give XP, set levels, reset players, add boosters and force-reload — all in one GUI.
Prestige SystemAfter reaching max level in a job, players can prestige — resetting to level 1 in exchange for:
- A permanent XP multiplier (configurable, default +10% per prestige level)
- Exclusive prestige rewards (money, items, commands) defined per prestige milestone in config.yml
- Per-prestige level rewards inside each job file — different rewards at Prestige 1 vs Prestige 2, etc.
20+ Active PerksReal gameplay-changing perks unlocked by reaching certain job levels:
- Vein Miner — Break an entire ore vein in one click
- Tree Feller — Chop a full tree with one swing
- Auto Smelt — Break ore blocks and get smelted results directly
- Super Smelt — Auto Smelt drops double output
- Field Repair — Repair tools in the field using iron ingots
- Netherite Smithing — Upgrade diamond gear to Netherite at a Smithing Table
- Replant — Harvested crops replant themselves automatically
- Growth Boost — Nearby crops grow faster when you harvest
- Double Cast — Fishing duplicates your catch
- Mob Tracking — Compass points to the nearest monster
- Mob Sense — Sneak with compass to reveal mobs through walls (Glowing effect)
- Scaffold — Place blocks below you while sneaking/flying
- Dimension Warp — Teleport between dimensions with a compass
- Mass Make — Crafting produces a bonus copy of the result
- Permanent Night Vision — Flicker-free permanent night vision for Miners
- ...and more
XP & Money Per Action
- xp — how much XP to award
- money — how much money to give (requires Vault)
- chance — probability of reward (0.0–1.0)
- level-requirement — minimum level to earn from this action
- max-level-requirement — stop earning from this action above this level
Level Rewards
Define rewards for any level in any job:
- Money — give in-game currency
- Items — give any Minecraft item (format: MATERIAL AMOUNT)
- Commands — run any console command (%player% placeholder)
- Permissions — permanently grant a permission node (auto-integrates with LuckPerms)
- Fireworks — launch a firework at the player's location
- Custom sound — play any Bukkit sound with configurable volume and pitch
XP Multipliers & Boosters
- Global multiplier — multiply all XP for everyone
- Permission multipliers — VIP, MVP, Elite ranks get higher XP (fully configurable permissions and values)
- Temporary Boosters — activate time-limited XP multipliers per job via command or Admin GUI
4 Storage Backends
- YAML — one file per player, zero setup, perfect for small servers
- SQLite — single file database, better performance for medium servers
- MySQL / MariaDB — full relational database, perfect for networks and large servers
- MongoDB — flexible document storage for scale
ActionBar & Title Notifications
- Every XP gain shows in the ActionBar — fully customisable format with XP, money, level, and a progress bar
- Level-up titles appear on screen with configurable fade-in, stay, and fade-out timing
- Optional server-wide broadcast every N levels
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Integrations
- Vault — money rewards on every XP action and level reward
- PlaceholderAPI — full placeholder support: level, XP, prestige, progress bar, and more per job
- LuckPerms — permission nodes granted by level rewards persist reliably
- ItemsAdder — custom blocks and furniture can be job action targets
- Nexo — same support for Nexo custom blocks and furniture
- Folia — full threaded scheduler support, no extra configuration needed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ PlaceholderAPI Placeholders
- %jobs_level_<job>% — player's level in that job
- %jobs_xp_<job>% — current XP in that job
- %jobs_xp_needed_<job>% — XP needed for next level
- %jobs_progress_<job>% — progress percentage
- %jobs_progress_bar_<job>% — visual progress bar
- %jobs_prestige_<job>% — prestige level in that job
- %jobs_total_xp_<job>% — total XP ever earned in that job
- %jobs_max_level_<job>% — configured max level for that job
- %jobs_count% — number of jobs the player has joined
- %jobs_total_level% — sum of levels across all joined jobs
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Commands
- /jobs — open the main Jobs GUI
- /jobs reload — reload all configs without restarting
- /jobs giveexp <player> <job> <amount> — give a player XP in a job
- /jobs setlevel <player> <job> <level> — set a player's level
- /jobs reset <player> [job] — reset a player's job data
- /jobs booster add <job> <multiplier> <seconds> — activate a temporary booster
- /jobs admin — open the Admin GUI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Requirements
- Java 17+
- Paper / Spigot 1.21+ (also supports Folia)
- Vault + an economy plugin (EssentialsX, CMI, etc.) — optional, for money rewards
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Full Documentation
https://oreostudios.fr/wiki/modernjobs/index.html
Everything — every config key, every perk, every GUI option — is documented in detail.
New to the plugin? Start with the Installation section. It takes 5 minutes.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Frequently Asked Questions
Can players have more than one job at once?
Yes. The max-jobs option in config.yml controls how many jobs a player can hold simultaneously. Set it to -1 for unlimited. You can also grant the modernjobs.slots.<n> permission to give specific groups a higher limit.
Does it work with CMI / EssentialsX / other economy plugins?
Yes — ModernJobs pays money through Vault, which is compatible with any economy plugin that provides a Vault hook. EssentialsX, CMI, iConomy, and hundreds of others all work out of the box.
How do I add a custom job?
Create a new .yml file in the jobs/ folder and define your actions, levels, and rewards following the same format as the built-in jobs. Run /jobs reload — the new job appears in-game immediately with no restart required.
Can I disable a perk I don't want on my server?
Yes. Every perk has an enabled: true/false toggle inside config.yml. Disabled perks are hidden from the Perks GUI automatically.
Does prestige wipe all a player's level rewards?
Prestige resets XP and level back to 0 but does not revoke previously granted permissions or items. You control exactly what happens at each prestige milestone via the prestige-rewards section in config.yml.
Does it support 1.20.x?
ModernJobs targets Paper / Spigot 1.21+. Older versions are not officially supported. Using the plugin on 1.20.x may work but is not tested and no bug reports for sub-1.21 versions will be accepted.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Support
Found a bug? Have a question? Want to suggest a feature?
- Discord — fastest response. Join the Oreo Studios Discord server linked in the resource banner.
- SpigotMC Discussion tab — post your question or bug report directly on this page.
- GitHub Issues — for confirmed bugs and feature requests, open a ticket on the repository.
When reporting a bug please include your server version, ModernJobs version, the full error from latest.log, and steps to reproduce. Bug reports without this information will be closed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ModernJobs
Built with care by Oreo Studios — because your players deserve more than /baltop grind.
