professions

Professions

The professions feature adds persistent, world-scoped progression for Mining, Herbalism, Farming, Fishing, Cooking, Engineering, Melee Combat and Ranged Combat. Players begin at level 1. Level n requires 100 × (n - 1)² lifetime XP, up to level 100.

By default, activity is accepted in worlds matching the survival* glob. Creative and Spectator activity is always excluded. Level-up messages are sent only to the player.

professions:
  enabled: true
  worlds: ["survival*"]
  level-up-message: "&eYou have reached {skill} Level {level}"

Mining and Herbalism ignore player-placed sources. Farming requires mature crops. Engineering covers redstone components, automation blocks, rails and minecarts and awards XP when they are crafted. Combat XP is awarded for the killing blow against hostile mobs and is separated by direct player attacks and player-fired projectiles.

Profession XP is registered with player stats under skill_<profession>_xp keys.

Large lifetime-stat announcements are configured separately under player_stats.milestones. A broadcast happens only when a player's lifetime total crosses the configured value.

Player stats

Players can use /skills (also /professions) to view all profession levels, including skills with no XP yet. /skills <skill> shows progress toward the next level. /stats or /stats <player> remains the broader, sectioned activity report; profession XP there is displayed as both its derived level and lifetime XP.

Block placement and break totals are also recorded against every matching player_stats.groups entry. A group may filter by game mode, world-name globs, or both. Omitting worlds matches every world. Groups are independent: when an activity matches multiple groups, every matching group receives the increment. Milestones for blocks_placed and blocks_broken are expanded across these group totals and {group} resolves to the configured group title.