Docs / Jobs Reborn Integration

Jobs Reborn Integration

Soft-depend on Jobs Reborn (Zrips / com.gamingmesh.jobs). No compile-time jar required.

Features

Feature	Status
Detect Jobs plugin	Yes
Read player job progression (name, level, XP)	Yes
List job catalog	Yes
Bridge ops	`status`, `list`, `player` / `progression`
Events → bridge	`jobs_payment`, `jobs_levelup`, `jobs_join`, `jobs_leave` (`jobs_exp` off by default)
Auto join/leave jobs	No (safety)

Observation fields

When Jobs is present and a player is observed:

jobs_available, jobs_count, jobs_primary, jobs_primary_level,
jobs_primary_xp, jobs_primary_xp_max, jobs_primary_xp_pct,
jobs_list, jobs_max_slots, jobs_can_join_more

Example: jobs_list=Miner:14,Builder:3 jobs_primary=Miner jobs_primary_level=14

Events (reward signals for RL)

Event	Reward (default)
`jobs_payment`	`min(cap, amount * payment-reward-scale)`
`jobs_levelup`	`levelup-reward` (0.15)
`jobs_exp`	0.01 (disabled by default — noisy)
`jobs_join` / `jobs_leave`	0

Commands

Minecraft

/ai jobs status
/ai jobs list
/ai jobs player Steve
/ai jobs progression
/ai jobs reload

`_AI` (bridge connected)

minecraft jobs status
minecraft jobs list
minecraft jobs player Steve

Bridge JSON

{"type":"jobs","id":1,"op":"player","player":"Steve"}
{"type":"jobs_result","ok":true,"jobs_primary":"Miner","jobs_primary_level":14,"jobs_list":"Miner:14","summary":"..."}

Config (`config.yml`)

plugin-integrations:
  jobs:
    observe-progression: true
    max-jobs-in-observation: 3
    max-jobs-slots: 3
    emit-events: true
    emit-payment-events: true
    emit-levelup-events: true
    emit-exp-events: false
    payment-reward-scale: 0.01
    payment-reward-cap: 0.5
    levelup-reward: 0.15

API notes

Hook target: com.gamingmesh.jobs.Jobs → getPlayerManager() → getJobsPlayer(player) → getJobProgression().
Events under com.gamingmesh.jobs.api.*. Reflection only — if a Jobs fork renames packages, status will report unavailable.

Safety

Read-only API surface for bots by default.
Government jobs_boost_notice still does not mutate Jobs configs (notice only).
Install Jobs + Vault + CMILib on the server for Jobs Reborn to run.

File

minecraft_spigot_plugin/.../JobsService.java

Generated from the project markdown docs on 2026-07-24. This is a static, self-contained site.