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 options:

perks:
  features:
    miner-vein:
      enabled: true              # Set false to disable this perk completely
      toggleable: true           # (future) players can toggle perk on/off
      permission: "ojobs.miner.vein"
      display-name: "Vein Miner"
      description:
        - "<gray>Break connected ore veins."
      require-sneaking: false    # true = only works while player is sneaking
      require-item: ""           # Material name. Only works if this item is in main hand.

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.

ModernJobs — Premium Minecraft Jobs Plugin

Documentation generated for server administrators and players.