Placeholders

%jobs_job_<id>%

Job?

Looks up a loaded job by its id (JobService#findById). null if no job has that id. Chain further tokens into job_* — e.g. %jobs_job_farmer_name%.

%jobs_jobs%

ItemProvider\<Job\>

Every loaded job. Use as a layout provider to list all jobs.

%jobs_modifier_<jobId>_<scope>[_<sub>]%

double?

Player-only. The player's combined modifier for <jobId>/<scope>. See Modifiers below.

%jobs_boosterBonus_<scope>_<personal\|global>%

double

The bonus percent contributed by active booster items alone, split by origin. Never null — every failure path yields 0. See Booster bonus below.

%jobs_boosterMisc_<jobId>_<scope>%

double

Player-only (yields 0, not null, outside a player context). The residual bonus percent that isn't a personal or global booster item — permission boosters and API-added modifiers. See Booster misc below.

%jobs_boosters_global%

ItemProvider\<BoosterEntity\>

Every currently active global booster. No player context required.

%jobs_boosters_global_<TYPE>%

BoosterEntity

The first active global booster of <TYPE> (EXPERIENCE, MONEY, or BOTH), or BoosterEntity.EMPTY if none is active. No player context required.

%jobs_boosters_player%

ItemProvider\<BoosterEntity\>?

Player-only. Every booster currently active for the player.

%jobs_boosters_player_<TYPE>%

BoosterEntity?

Player-only. The first active booster of <TYPE> for the player, or BoosterEntity.EMPTY if none is active.

%job_id%

String

The job's id (from its YAML file, e.g. farmer).

%job_name%

Component

The job's display-name.

%job_actions%

ItemProvider\<JobActionPlaceholder\>

Every material/entity key in the job's actions map. Chain into action_*.

%job_rewards%

ItemProvider\<JobRewardPlaceholder\>

Every level in the job's rewards map. Chain into reward_*.

%job_menu_title%

Component

The job's menu-title, resolved against the current context.

%job_menu_icon%

ItemStack

The job's menu-icon, resolved against the current context.

%job_menu_secondary-icon%

ItemStack

The job's menu-secondary-icon, resolved against the current context.

%job_player_level%

int

Player-only, and needs a further sub-key. The player's level for this job (LevelService#level), or 0 if they have no level entry.

%job_player_experience%

double

Player-only. The player's accumulated experience for this job, or 0.0 if they have no level entry.

%action_name%

TranslatableComponent

The material/entity's translatable name, computed once from the first action-type entry under this key (JobActionType#translatable) — in practice this is the same regardless of which action type looks it up, since it just wraps the block/item/entity's own translation key.

%action_item%

ItemStack

A representative icon ItemStack for the key (JobActionType#buildItem), with attributes, "placed on", and the additional tooltip hidden.

%action_computed%

List\<Component\>?

Player-only. One rendered action-display block per action-type entry under this key — see below.

%experience%

The entry's experience value, run through the job's leveling equations and the player's active modifiers (ModifierService#computeWithLevel) — the actual XP the player would earn right now.

%money%

The entry's reward value, computed the same way for the MONEY scope.

%formattedName%

The action type's localized label from action-type-displays (e.g. Casser for block-break).

%operation%

The entry's operation (UP/DOWN/NONE) rendered as a bold colored arrow: ↑ green, ↓ red, - gray.

%reward_level%

int

The reward's level key.

%reward_description%

ComponentWrapperList

The reward's description lines, unresolved (as configured in the job's YAML).

%reward_claimed%

Boolean

Whether the viewing player has already claimed this reward (JobsPlayerData#hasClaimedReward). Outside a player context this resolves to false (not null); if the player has no synced JobsPlayerData at all it resolves to null.

%reward_claimable%

Boolean?

Whether the player can claim it right now — not yet claimed and their current level (LevelService#level, 0 if absent) is >= the reward's level. Player-only — resolves to null outside a player context (note the asymmetry with claimed above, which resolves to false instead).

%booster_type%

BoosterType

EXPERIENCE, MONEY, or BOTH.

%booster_scope%

BoosterScope

INDIVIDUAL or GLOBAL.

%booster_duration%

Duration

The configured duration, as a raw java.time.Duration — not directly print-friendly; use formattedDuration below.

%booster_formattedDuration%

String

The duration formatted for display, e.g. 1h 5m.

%booster_multiplier%

double

The configured multiplier (e.g. 1.15 for +15%).

%booster_item%

ItemStack

The blueprint's configured item, resolved against the current context — chain into item_* sub-keys.

%booster_id%

UUID

The active booster instance's id (not the blueprint id).

%booster_owner%

MinecraftPlayerPlaceholder

The owning player — chain into player_* sub-keys.

%booster_type%

BoosterType

EXPERIENCE, MONEY, or BOTH.

%booster_formattedType%

Component

The type's localized label — the type-experience/type-money/type-global message.

%booster_scope%

BoosterScope

INDIVIDUAL or GLOBAL.

%booster_duration%

long

The configured duration in milliseconds — a raw long, not a Duration (no formattedDuration on the active entity).

%booster_remainingTime%

long

Milliseconds remaining until expiry, clamped to 0 (never negative). BoosterEntity exposes no formatted variant, so every shipped messages.yml value wraps it in AstralCore's $format-date(…, format-duration) inline function.

%booster_timeUntilActive%

long

Milliseconds until a queued booster goes live (activatesAt - now), clamped to 0 — so it reads 0 for an already-active booster. Used by global-booster-queued.

%booster_multiplier%

double

The multiplier this instance was activated with.

%booster_expiresAt%

long

Epoch milliseconds when the booster expires.

%booster_activatesAt%

long

Epoch milliseconds when the booster starts counting down (in the future for a queued global booster stacked behind another).