CoreEngineWIKI
ESC
NavigateEnter OpenESC Close

Jobs

Jobs turn Minecraft actions (mining, killing, fishing, crafting, brewing, enchanting, breeding ...) into income: money, job XP and a dedicated points currency. Players level up, unlock titles, rewards, daily quests and a job shop. All progress persists across restarts.

Files: modules/jobs.yml (main config) and modules/jobs/<jobId>.yml (one file per job, seeded with 10 ready-made jobs on first start; your changes are never overwritten by updates, only missing keys are added).

Commands #

All /jobs subcommands need jobs.use (default true) plus the listed permission (all default true).

CommandSyntaxPermissionDescription
Menu/jobs or /jobs menujobs.menuHub GUI: my jobs, browse, quests, shop
Browse/jobs browsejobs.browsePaginated job list with progress, click = join
Info/jobs info <job>jobs.infoAll actions, targets, rewards, titles of a job
Join/jobs join <job>jobs.join + jobs.join.<job>Checks max-jobs limit and cooldown
Leave/jobs leave <job> / leavealljobs.leaveWith XP loss, if enabled
Stats/jobs statsjobs.statsLevel/XP/earnings per job
Top lists/jobs top <job> / gtopjobs.topTop 10 per job or globally
Limit/jobs limitjobs.limitRemaining period quota
Points/jobs pointsjobs.pointsJob points balance
Quests/jobs questsjobs.questsDaily quest GUI with progress bars
Display/jobs toggle [actionbar|bossbar|off]jobs.toggleIncome display mode
Boosts/jobs boostsjobs.boostsActive boosts and total multiplier
Shop/jobs shopjobs.shopJob shop (pays with points)
💡

Tip: jobs.join.<jobId> is registered automatically per job with default true. Block individual jobs via LuckPerms with jobs.join.<jobId>: false; the browse menu checks the same permission.

Admin commands (/jobsa) #

CommandSyntaxPermissionDescription
Reload/jobsa reloadjobs.admin.reloadReloads jobs, quests, boosts, shop
Status/jobsa statusjobs.admin.statusStatus of the block history providers (diagnosis)
Join/Leave/jobsa join|leave|leaveall <player> [job]jobs.admin.manageWithout limit check, without XP loss
Fire/jobsa fire <player> <job>jobs.admin.manageWith guaranteed XP loss
Level/jobsa promote|demote <player> <job> [levels]jobs.admin.manageLevel up/down, XP reset to 0
XP/jobsa grantxp|removexp <player> <job> <amount>jobs.admin.manageGrant/remove XP
Boosts/jobsa boost <job|all> <money|xp|all> <factor> [duration]jobs.admin.boostPermanent without duration; boostremove, boostlist
Limits/jobsa resetlimit <player> / resetlimitalljobs.admin.limitReset period counters
Points/jobsa points <player> <set|add|remove> <amount>jobs.admin.pointsManage points balance
Quest/jobsa skipquest <player> <job> <index>jobs.admin.questComplete a quest without reward

Additional permissions #

PermissionDefaultDescription
jobs.max.<n> / jobs.max.unlimitedfalseMore concurrent jobs (highest wins; unlimited = 50)
jobs.maxlevel.<n>falseHigher max level when n exceeds the config value
jobs.autojoin.<jobId>falseAutomatic join on server join
jobs.boost.<factor>falsePermission boost, e.g. jobs.boost.1.25 (highest wins)
jobs.bypass.xplossfalseNo XP loss on leaving
jobs.bypass.placedblock / cropcheck / spamkill / spawner / afk / limit / dynamicpayfalseBypasses the respective exploit protection

The 10 default jobs #

JobColorMain actions
minergoldBREAK (ores, stone, obsidian, amethyst, sculk, ancient debris)
woodcutterdark_greenBREAK (all wood variants), STRIP_LOG
farmeryellowBREAK (crops), BREED, SHEAR, MILK
hunterredKILL (30+ hostile mobs up to ender dragon/wither)
fishermanaquaFISH (fish and treasure)
crafterlight_purpleCRAFT (redstone, ender chest, beacon, shulker box ...)
enchanterdark_purpleENCHANT (tools, armor, books, elytra)
brewerdark_aquaBREW, CRAFT (brewing stand, cauldron, bottles)
weaponsmithgrayCRAFT (weapons/armor), REPAIR, SMELT
explorergreenEXPLORE (distance based), TAME, KILL (shulker only)

Every job has 6 title tiers (levels 1/10/25/50/75/100) and level-up rewards on the same milestones.

Action types #

ActionTriggerTargetProtection/special
BREAKBreak a blockMaterialPlaced-block check, crop age, AFK detection
KILLKill a creatureCreatureSpam-kill protection, spawner reduction, no suicide
FISHFishingCaught materialAlso pays for treasure
CRAFTCraftingResult materialShift-click counts the real amount
SMELTTake from furnaceMaterialCounts the taken amount
BREWBrew a potionPotion materialLast brewing stand user = brewer
ENCHANTEnchantingMaterial-
REPAIRAnvil repairMaterialBoth slots must be filled
BREED / SHEAR / TAMEBreed/shear/tameCreature-
MILKMilkingCreatureCooldown per animal
EXPLOREWalkingALLPays every explore-distance blocks, teleports do not count
STRIP_LOGStrip woodOriginal material-

ALL is allowed everywhere as a wildcard. Nexo/Carpentary targets (nexo:<id>) take priority over vanilla materials.

Leveling and scaling #

Command
xpRequired(level) = base * level + multiplier * level^exponent
effectiveIncome   = baseMoney * (1 + (level - 1) * level-multiplier)
effectiveXp       = baseXp    * (1 + (level - 1) * level-multiplier * 0.5)

XP scaling deliberately runs at half rate so high levels do not accelerate their own leveling exponentially. Surplus XP is never lost on level-ups (multi-level-ups possible); at max level no more XP is credited.

Overridable per job: each job file may have its own leveling section; missing values (or -1) use the global formula. GUI, /jobs stats and the web interface automatically use the formula of the respective job.

YAML
# in modules/jobs/woodcutter.yml: this job levels slower, earns more
leveling:
  xp-formula:
    base: 15.0
    multiplier: 6.0
    exponent: 2.2
  income-formula:
    level-multiplier: 0.05
    xp-level-multiplier: 0.02

Max level order: job's own max-level (0 = global) → global-max-level → permission jobs.maxlevel.<n> (only when higher).

Payout #

Every action is settled for EVERY active job that pays for it (stacking intended): level scaling and boosts apply to money and XP, then active period limits cap them. Points are always raw: no level scaling, no boosts, no dynamic pay, no limits. The display is batched (batch-interval) as action bar or boss bar.

Quests: per job and day, quests-per-job quests are generated from the job's real action/target pairs. Reward = base value × amount × reward-multiplier (without level scaling), paid out automatically on completion. Daily reset at the configured time.

Boosts: three sources (admin via /jobsa boost, scheduled by time/weekday, permission jobs.boost.<n> where the highest wins). stacking-mode: multiply multiplies all, add adds the bonus shares; capped at max-multiplier. Admin boosts survive reload and restart.

Exploit protection #

Self-placed blocks pay nothing (history check via CoreProtect), immature crops pay nothing, spam kills of the same mob stop paying, spawner mobs pay only the configured fraction, suicide does not count, shift-click crafting counts the real amount, milking has a per-animal cooldown and teleports give no EXPLORE distance. Paid block breaks are optionally logged as #jobs-<player> in CoreProtect.

⚠️

Warning: Without CoreProtect the jobs module disables itself by default (require-history-provider: true), visible only as a log warning. To play without a history source, deliberately set the switch to false; then placed-block-failure decides (deny = safe, allow = pays anyway). AFK detection only applies to BREAK.

Configuration (modules/jobs.yml) #

YAML
# Enables or disables the jobs module.
enabled: true

jobs:
  # Concurrent jobs per player. Highest jobs.max.<n> permission wins,
  # jobs.max.unlimited = 50.
  max-jobs: 3
  # Players with jobs.autojoin.<jobId> join automatically on server join.
  autojoin-enabled: false
  # Level cap for jobs without their own max-level.
  global-max-level: 100
  command-cooldowns:
    # Anti spam for /jobs join and leave, seconds.
    join: 3
    leave: 3
  chat-title:
    # Job title before the chat name (after the team prefix).
    # highest = job with the highest level, first = alphabetically first.
    enabled: false
    mode: highest
    format: "<job_color>[<job_title>] "
  actions:
    # Blocks per EXPLORE payout.
    explore-distance: 100.0
    # Seconds between paid milk actions per animal.
    milk-cooldown: 5
  xp-loss:
    # XP loss on voluntary leave. /jobsa fire always applies it,
    # jobs.bypass.xploss prevents it.
    enabled: true
    percentage: 0.3
  leveling:
    xp-formula:
      # Required XP = base * level + multiplier * level^exponent.
      base: 10.0
      multiplier: 4.0
      exponent: 2.0
    income-formula:
      # +3% income per level; XP scales at half rate.
      level-multiplier: 0.03
    level-up:
      chat-enabled: true
      title-enabled: true
      sound-enabled: true
      sound: "entity.player.levelup"
      sound-volume: 1.0
      sound-pitch: 1.0
      title-fade-in: 10
      title-stay: 40
      title-fade-out: 20
    broadcast:
      # Announce level-ups server-wide from min-level on.
      enabled: false
      min-level: 10
  limits:
    # Rolling window with money/XP caps per player.
    enabled: false
    max-earnings: 10000.0
    max-xp: 50000.0
    period-duration: 3600
  income-display:
    # Ticks between batched displays / boss bar duration.
    batch-interval: 40
    bossbar-duration: 60
  boosts:
    # multiply = boosts multiply, add = bonus shares add up.
    stacking-mode: multiply
    max-multiplier: 10.0
    scheduled:
      weekday-dawn:
        job: farmer
        category: all
        multiplier: 1.25
        start: "05:00"
        end: "08:00"
        days: [MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY]
  quests:
    enabled: true
    quests-per-job: 4
    min-amount: 12
    max-amount: 160
    reward-multiplier:
      money: 2.2
      xp: 2.1
      points: 1.7
    # Daily reset (clears all quest data and regenerates).
    reset-hour: 0
    reset-minute: 0
    creative-style:
      # Flavor names with the <target> placeholder, per job or default.
      enabled: true
      templates:
        default:
          - "Guild contract: <target>"
          - "Rush order: <target>"
        miner:
          - "Crystal vein: <target>"
  dynamic-pay:
    # Supply/demand adjustment based on action frequency.
    enabled: false
    sensitivity: 0.5
    min-multiplier: 0.5
    max-multiplier: 1.5
  integrations:
    coreprotect:
      # Logs paid breaks as #jobs-<player>.
      jobs-tracking: true
      # Block history window for the placed-block check.
      lookup-time-seconds: 2592000
    nexo:
      jobs-enabled: true
    carpentary:
      jobs-enabled: true
    betterhud:
      job-info:
        enabled: true
        popup-name: ""
        popup-duration: 60
  shop:
    # Items cost job points; required-job/-level gate the purchase.
    enabled: true
    title: "<gold>Job Shop"
    items:
      miner_lantern_kit:
        material: TORCH
        amount: 64
        display-name: "<gold>Miner Lantern Kit"
        lore:
          - "<gray>Cheap light for long tunnels."
        cost: 35.0
        required-job: miner
        required-level: 3
  exploit-protection:
    placed-block-check: true
    # true = without a history source (CoreProtect) the module
    # disables itself.
    require-history-provider: true
    # auto, coreprotect, debug or disabled.
    placed-block-provider: auto
    # Without a definite answer: deny = do not pay (safe), allow = pay.
    placed-block-failure: deny
    crop-age-check: true
    spam-kill:
      enabled: true
      window: 30
      max-kills: 5
    spawner-mobs:
      enabled: true
      money-multiplier: 0.0
      xp-multiplier: 0.0
    afk-detection:
      # More than action-threshold actions within radius blocks during
      # window seconds: payout is reduced by multiplier.
      enabled: false
      radius: 5
      action-threshold: 50
      window: 120
      multiplier: 0.0

Custom jobs (modules/jobs/<jobId>.yml) #

YAML
# name is required, otherwise the file is discarded. Invalid targets or
# negative values are skipped and logged. After changes: /jobsa reload.
# Limits: 500 actions, 100 titles, 200 reward tiers.
name: "Miner"
color: "gold"
short-name: "MIN"
icon: "IRON_PICKAXE"
description: "Mine ores and stones for profit"
# 0 = use global-max-level.
max-level: 0

actions:
  # BREAK/CRAFT/SMELT/STRIP_LOG/FISH/ENCHANT/REPAIR expect materials,
  # KILL/BREED/SHEAR/TAME/MILK expect creatures, ALL works everywhere.
  BREAK:
    DIAMOND_ORE:
      money: 4.0
      xp: 8.0
      points: 0.4
    ANCIENT_DEBRIS:
      money: 10.0
      xp: 20.0
      points: 1.0

titles:
  "1": "Apprentice Miner"
  "25": "Expert Miner"
  "100": "Mythic Deep Delver"

level-up-rewards:
  # Console commands with {player}, {job}, {jobname}. Commands with
  # disallowed characters are discarded and logged.
  "25":
    - "give {player} diamond 3"
  "100":
    - "give {player} netherite_upgrade_smithing_template 1"