Vocation | Profession Leveling & Perks v1.0.0

Vocation
Vocation adds profession leveling to your server. Players level up Mining, Farming, Fishing, and Combat just by playing, then unlock real perks like double drops, auto smelt, tool durability saves, and bonus XP. Two in-game menus show every profession's progress and perk track. Built for SMPs and survival servers.

Built for: Survival, SMP, Skyblock.



How it works
Players earn XP in the four professions just by playing: breaking ore and stone for Mining, harvesting fully grown crops for Farming, catching fish for Fishing, and killing mobs for Combat. The XP needed per level grows a little each time, and perks unlock automatically at set levels, no points to spend and no menus to manage.

The four professions

• Mining - break ore and stone for XP. Rarer ores like diamond and ancient debris are worth much more than stone.
• Farming - harvest fully grown crops for XP. Crops that are not fully grown give nothing, so it rewards real farming.
• Fishing - every catch grants XP, and treasure catches like enchanted books and name tags grant a lot more.
• Combat - kill mobs for XP. Tougher mobs are worth more, up to the Wither and the Ender Dragon. Spawner mobs and player kills do not count by default.

Perks
Each profession has its own perk track, unlocked automatically as the player levels up.

• Tough Tools - a chance your tool takes no durability damage.
• Double Drop - a chance to double what you gather.
• Auto Smelt - ore drops already smelted, keeping fortune and silk touch. Mining only.
• Fast Learner - a chance to earn double vocation XP.

Mining ships with five unlock levels covering all four perk types. Farming and Fishing each ship with four unlock levels across three perk types (auto smelt is mining only). Every perk's unlock level and strength is set in config.yml, so you can retune them or add a track to Combat too.



Prestige
Once a profession hits max level, a player can prestige it: the level resets to 1 in exchange for a permanent XP bonus for that profession, 3% per prestige by default, up to 10 prestiges. Prestige needs a confirmation, either by shift-clicking again in the perk menu or by adding "confirm" to the command, so it never happens by accident.

Features

• Four professions, each with its own XP table, perk track, and icon, fully configurable per profession.
• In-game Vocations menu showing level, prestige, progress bar, and perks unlocked for every profession.
• Per-profession perk menu with unlock levels, perk strength, and locked or unlocked status.
• Prestige with a permanent XP bonus and a confirmation step so it cannot be triggered by mistake.
• Per-permission level caps, so you can give VIP or member ranks a different progression ceiling.
• Leaderboards for every profession with /vocation top.
• Action-bar progress feedback, level-up messages, and sound cues, all configurable.
• Optional per-world XP multipliers.
• PlaceholderAPI support for level, XP, progress, and prestige.
• Player data saves automatically on an interval and always on shutdown, so nothing is lost.
• Full admin toolkit to set level, add XP, set prestige, or reset any player, online or offline.

Commands

• /vocation - open your Vocations menu.
• /vocation perks <profession> - view a profession's perk track.
• /vocation top <profession> [amount] - see the leaderboard.
• /vocation prestige <profession> - prestige a maxed profession.
• /vocation reload - reload the config and messages.
• /vocation admin setlevel <player> <profession> <level> - set a player's level.
• /vocation admin addxp <player> <profession> <amount> - give a player XP.
• /vocation admin setprestige <player> <profession> <count> - set a player's prestige.
• /vocation admin reset <player> [profession] - reset one profession or all of them.

Aliases: /voc, /professions, /skills

Permissions

• vocation.use - view professions, leaderboards, and prestige. Default: everyone.
• vocation.admin - reload and edit any player's professions. Default: operators.
• vocation.cap.member and vocation.cap.vip - grant a higher level cap to a rank. Default: off.

Placeholders

• %vocation_<profession>_level% - the player's level in that profession.
• %vocation_<profession>xp% and %vocation<profession>_next% - current and needed XP.
• %vocation_<profession>_percent% - progress to the next level, as a percent.
• %vocation_<profession>_prestige% - the player's prestige count.
• %vocation_total_level% - the player's combined level across all four professions.

Use mining, farming, fishing, or combat in place of <profession>.

Requirements

• Minecraft 1.21 to 26.1.2.
• Paper, Spigot, or Bukkit.
• Java 21.
• PlaceholderAPI is optional, for placeholders.

Installation

1. Drop Vocation-1.0.0.jar into your plugins folder.
2. Start the server once to generate the config.
3. Edit config.yml to taste, then run /vocation reload.

Try it first
Vocation is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to connect and try it yourself.

Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.