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

Perks System Overview

Perks are special gameplay bonuses players unlock by reaching certain levels in a job. There are two kinds:

• Active Perks — triggered by specific actions (defined in config.yml under perks.features). These are given via the permissions field in a level reward.
• Passive Effects — permanent potion effects applied as long as the player has the right permission (defined in config.yml under perks.passive-effects).

Players can also view their perks visually in-game by opening a job's detail menu and clicking the ✨ Perks button.

Active Perks Reference

These perks are configured in config.yml under perks.features. Each perk is granted by giving the player the associated permission through a level reward.

Miner Perks

Woodcutter Perks

Farmer Perks

Crafter Perks

Fisher Perks

Hunter Perks

Blacksmith Perks

Builder Perks

Smelter Perks

Explorer Perks

Perk Feature Configuration

Every perk in config.yml under perks.features supports these universal options:

perks:
  features:
    miner-vein:
      enabled: true              # false = perk is completely disabled for everyone
      toggleable: true           # true = players can toggle it with /jobs perk <key>
      permission: "ojobs.miner.vein"
      display-name: "Vein Miner"
      description:
        - "<gray>Break connected ore veins."
      require-sneaking: false    # true = only triggers when the player is sneaking
      require-item: ""           # Material name — only triggers if this item is in main hand

Perk-specific configurable parameters

Some perks have additional numeric parameters you can tune:

Passive Effects (Permanent Potion Effects)

Passive effects apply a potion effect to a player as long as they have the required permission. The system refreshes every second to prevent any flickering.

perks:
  passive-effects:
    enabled: true
    effects:
      miner-nightvision:           # Any unique key you want
        enabled: true
        permanent: true            # true = refresh task (no flicker). false = only on movement.
        permission: "ojobs.miner.nightvision"
        type: "NIGHT_VISION"       # Bukkit PotionEffectType name
        amplifier: 0              # 0 = level I, 1 = level II, etc.
        refresh-threshold: 100   # Reapply when remaining ticks drop below this
        apply-duration: 500       # Ticks to apply each refresh (must be > refresh-threshold)
        ambient: true             # true = subtle particles (or none if particles: false)
        particles: false          # Show potion particles?
        icon: true               # Show effect icon in HUD?

How to add your own permanent effect

Add a new entry under effects: and give the player the permission through a level reward:

# In config.yml:
hunter-speed:
  enabled: true
  permanent: true
  permission: "ojobs.hunter.speed"
  type: "SPEED"
  amplifier: 0
  refresh-threshold: 100
  apply-duration: 500
  ambient: true
  particles: false
  icon: true

# Then in hunter.yml level rewards, grant the permission:
10:
  permissions:
    - "ojobs.hunter.speed"

Defining Perks in Job Files (for GUI display)

Every job yml can have a perks: section. This is purely informational for the GUI — it lets players see what perks they will unlock and at what level. It does NOT grant perks by itself; permissions are granted through level-rewards.

perks:
  5:                               # Level at which this perk unlocks
    name: "Vein Miner"
    icon: DIAMOND_PICKAXE         # Material shown in GUI when unlocked
    description:
      - "Mine an entire ore vein at once"
      - "while sneaking."
  10:
    name: "Ore Fortune"
    icon: EMERALD
    description:
      - "Chance to get an extra ore drop."

In the GUI, unlocked perks glow and show the icon. Locked perks show as a gray item with the required level.

Creating Custom Perks

ModernJobs supports four levels of custom perks, from zero code to a full Java mechanic:

Type 1 — Command trigger perk (full config, no code)

The most powerful config-only option. Define a perk in config.yml under perks.features with a trigger block. When the specified event fires and the player has the permission, ModernJobs runs your commands, shows an action bar message, and plays a sound — with chance and cooldown support.

# config.yml
perks:
  features:
    lucky-miner:
      enabled: true
      toggleable: true
      permission: "ojobs.miner.lucky"
      trigger:
        event: "block-break"        # block-break · block-place · mob-kill · fish
                                       # craft · smelt · interact · damage
        chance: 0.20                 # 20% chance per trigger
        cooldown: 10                 # seconds between triggers per player
        commands:
          - "give %player% diamond 1"
        player-commands: []         # commands run AS the player
        action-bar: "<gold>Lucky Miner<gray>: <white>bonus diamond!"
        sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
        sound-volume: 1.0
        sound-pitch: 1.2

Then wire it to the GUI in the job yml and grant it via a level reward as usual:

# jobs/miner.yml
perks:
  10:
    name: "<gold>🍀 Lucky Miner"
    icon: DIAMOND
    feature-key: "lucky-miner"
    description:
      - "<gray>20% chance to get a bonus diamond"
      - "<gray>when breaking any block."

rewards:
  0:
    10:
      perks:
        - "lucky-miner"

Available placeholders

Type 2 — Passive potion effect (config, no code)

Any permanent or timed potion effect gated behind a permission. Configured in config.yml under perks.passive-effects.effects. See the Passive Effects section for full reference.

Type 4 — Wire a perk to a built-in mechanic

Add a feature-key matching one of the built-in identifiers below. The mechanic fires for any player who has the required permission.

perks:
  15:
    name: "<aqua>⛏ Vein Miner"
    icon: DIAMOND_PICKAXE
    feature-key: "miner-vein"
    description:
      - "<gray>Sneak + break to mine the whole vein."

rewards:
  0:
    15:
      perks:
        - "miner-vein"

Type 5 — Full custom mechanic via the Java API

For completely new gameplay mechanics, implement CustomPerkHandler in your own plugin and register it with ModernJobs on enable. Your handler is called automatically by ModernJobs for the events you override, but only when the player actually has the perk's permission — so all the standard enabled/toggleable/require-sneaking checks from config.yml still apply.

// In your plugin's onEnable():
OJobsProvider.get().ifPresent(api -> api.registerPerkHandler(new MyCustomPerk()));

// Unregister on disable:
OJobsProvider.get().ifPresent(api -> api.unregisterPerkHandler("myplugin-myperk"));

public class MyCustomPerk implements CustomPerkHandler {

    @Override
    public String getKey() {
        return "myplugin-myperk";   // Must match feature-key in job yml
    }

    @Override
    public void onBlockBreak(Player player, BlockBreakEvent event) {
        // Your mechanic here — fires only if the player has the perk permission
        player.sendMessage("Custom perk triggered!");
    }

    // Override only the events you need:
    // onBlockPlace, onInteract, onMobKill, onFish, onCraft, onFurnaceExtract, onDamage
}

Then define the perk in the job yml so it shows in the GUI:

# In jobs/myjob.yml
perks:
  20:
    name: "<red>🔥 My Custom Perk"
    icon: BLAZE_ROD
    feature-key: "myplugin-myperk"
    description:
      - "<gray>Does something awesome."

rewards:
  0:
    20:
      perks:
        - "myplugin-myperk"

Optionally, add a config section to get enabled/toggleable/require-sneaking support for free:

# In config.yml
perks:
  features:
    myplugin-myperk:
      enabled: true
      permission: "myjob.myperk"
      toggleable: true
      require-sneaking: false

All built-in feature keys

ModernJobs — Premium Minecraft Jobs Plugin

Documentation generated for server administrators and players.