Jobs

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

# 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

# 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
  # true = missing actions, titles and rewards of the bundled default jobs
  # are merged into modules/jobs/ (files are rewritten without comments).
  # false = files are left untouched.
  merge-default-definitions: false
  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
    # Only real crops (wheat, carrots, nether wart ...) pay when fully
    # grown; sugar cane, cactus, bamboo etc. always pay.
    crop-age-check: true
    # true = creative and spectator mode also earn money, XP, points
    # and quest progress.
    creative-mode-pay: false
    spam-kill:
      enabled: true
      window: 30
      max-kills: 5
    # Applies to mobs from spawners and from spawn eggs (dispensers too), so a
    # spawner mob caught as an egg cannot be sold as a fully paid kill.
    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

# 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"