English Français
ModernJobs

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

Level Rewards

When a player reaches a specific level, they can receive a reward. Rewards support two formats.

Format 1 — Prestige-aware (recommended)

The rewards: section has an outer key for prestige level, then inner keys for job level:

rewards:
  0:                               # Prestige 0 (normal play)
    5:                             # At job level 5
      money: 500                   # Give this much money
      commands:
        - "say %player% reached level 5!"
      items:
        - "DIAMOND 8"              # Give 8 diamonds
        - "GOLDEN_APPLE 4"
      permissions:
        - "ojobs.miner.fortune"   # Grant this permission
      firework: false              # Launch a firework on reward?
      sound: "UI_TOAST_CHALLENGE_COMPLETE"
      sound-volume: 1.0
      sound-pitch: 1.0
  1:                               # Prestige 1 rewards
    10:
      money: 5000
      commands: []
      items:
        - "NETHERITE_INGOT 1"
      permissions: []
      firework: true
      sound: "UI_TOAST_CHALLENGE_COMPLETE"
      sound-volume: 1.0
      sound-pitch: 1.0

Reward Fields Explained

FieldWhat it does
moneyAmount of money to give (requires Vault)
commandsList of console commands to run. %player% is replaced with the player's name.
itemsList of items in MATERIAL AMOUNT format. Given directly to the player's inventory.
permissionsList of permissions to grant the player permanently (uses LuckPerms or similar).
fireworktrue = launch a colourful firework at the player's location.
soundA Bukkit Sound enum name played to the player on level-up.
sound-volumeVolume of the sound (1.0 = normal).
sound-pitchPitch of the sound (1.0 = normal, 2.0 = higher).

XP Multipliers

There are three layers of XP multipliers that stack:

  1. Global multiplier (xp.global-multiplier) — applies to everyone
  2. Permission multiplier — applies to players with a specific permission. Highest matching permission wins (they don't stack with each other)
  3. Active booster — temporary multiplier added on top
xp:
  global-multiplier: 1.0
  permission-multipliers:
    ojobs.multiplier.vip:   1.25   # VIP rank gets 25% extra XP
    ojobs.multiplier.mvp:   1.5    # MVP rank gets 50% extra XP
    ojobs.multiplier.elite: 2.0    # Elite rank gets double XP

XP Boosters

Boosters are temporary XP multipliers that apply to a specific job (or all jobs). Activate via the Admin GUI or the command:

/jobs booster add <job> <multiplier> <duration-seconds>

Example: /jobs booster add miner 2.0 3600 — doubles Miner XP for 1 hour.

Booster limits are configurable in config.yml under xp.boosters.

When a booster activates, all online players receive a chat notification. When it expires, they are notified again.

Prestige System

Prestige allows players to "reset" a job after reaching max level, in exchange for a permanent XP bonus and exclusive rewards.

i Prestige is tracked per job. A player can be Prestige 3 in Miner and still Prestige 0 in Farmer.

How to Prestige

  1. Reach max level in a job (e.g. level 20)
  2. Open /jobs → click the job → the ⭐ Prestige button glows
  3. Click Prestige — level resets to 1, XP resets to 0
  4. All future XP in this job is multiplied by 1 + (prestige × xp-bonus-per-prestige)

What Resets and What Stays

prestige:
  enabled: true
  max-prestige: 10
  reset-level: true
  reset-xp: true
  xp-bonus-per-prestige: 0.10

XP Bonus Examples

PrestigeTotal bonusEffective XP multiplier
0+0%1.00x
1+10%1.10x
3+30%1.30x
5+50%1.50x
10+100%2.00x

Prestige Reward Layers

Prestige Rewards

Define milestone rewards in config.yml. These trigger when a player reaches that prestige level:

prestige:
  rewards:
    1:
      money: 5000
      commands:
        - "say %player% prestiged for the first time!"
    5:
      money: 50000
      commands:
        - "broadcast %player% reached Prestige 5!"

Jobs can also have prestige-specific level rewards in their yml files (under rewards.1:, rewards.2:, etc.).

ModernJobs — Premium Minecraft Jobs Plugin

Documentation generated for server administrators and players.