Albion Mastery

Albion Mastery is a weapon mastery system for Minecraft 1.20.1 Forge that drops into any modpack. It reads the weapons from the mods you already have (TACZ and Iron's Arms 'n Artifice guns, melee packs, SlashBlade blades, spells, bows, and any modded sword or axe) and levels each one up as you fight with it. Every level makes that weapon hit harder, and trained weapon types unlock 169 specializations that trade one strength for another, so the weapons nobody used to pick up finally have a reason to be trained.

Versions

Minecraft	Loader / Java	Install on	Dependencies
1.20.1	Forge 47.x, Java 17	Client and server	None (Cloth Config API for the config screen is bundled)

Every supported weapon mod is optional, and sources that aren't installed simply don't appear.

Three mastery rings

Press B to open the mastery compass. Mastery is tracked on three rings:

• Source: where the weapon comes from, such as TACZ guns or SlashBlade.
• Type: rifles, shotguns, swords, axes, bows and so on.
• Weapon: every single item.

Every kill gives XP to all three rings, and each ring adds damage to the weapons inside it. With the default settings a single weapon tops out at level 100 for +200% damage; the type and source rings level more slowly.

The mastery screens pick their own size from your monitor, and the magnifier button at the bottom left makes them one step larger or smaller.

The mastery compass: sources in the middle, weapon types around them, every weapon on the outer ring

Specializations

Every weapon type has up to four slots: normal, breakthrough, normal, breakthrough. There are 169 specializations across 10 sources, and each one comes with a real cost:

• Guns: magazines, ammo, barrels and muzzles, bolts, stocks and grips, training and gear: fire rate, ADS time, recoil, spread, kill refills, ricochets and more.
• Melee: reach, backstab and combo damage.
• SlashBlade: SA damage and proud souls.
• Spells: mana cost, cooldown and double casting.

Specializations are a long-term goal:

• Level them up: normal versions go from Lv1 to Lv5 with mod points earned from source level (plus a few from Mastery Rank). A maxed one can be broken through to ★1–★5 with breakthrough points earned from type level and maxed weapons. Gains and costs grow together.
• Unlock the slots: slot 1 opens once a weapon reaches its level cap, and slots 2 to 4 open with type and source level. Specializations apply to a weapon once it reaches the cap; higher Mastery Ranks lower that requirement, and a fully trained type skips it.
• Respec any time: refund every mod point of a source or every breakthrough point of a type. The first reset is free, then once a day.
• Pick a layout: slots on the left, a slot strip on top or a list with details. A step bar and a first-time walkthrough show what to do next.

Card text is generated from the actual config values, so it always matches your modpack's numbers.

The specialization page: four slots on top, a step bar showing what to do next, and every gain and cost on the cards

Mastery Rank

Your rank is account-wide and grows with the total level of all your weapons. Maxing one weapon only gets you so far; to climb, you have to train many. Every promotion plays its own animation, and the road of ranks shows how far your modpack can take you.

Promotion to a new Mastery Rank

The road of ranks, from your current rank to the end point of your modpack

FTB Quests

With FTB Quests installed there is a Mastery Rank task type, so modpack makers can lock quests and chapters behind a rank. Clicking the task opens the mastery screen.

A quest that requires a Mastery Rank

Leaderboards

Overall, daily, weekly and monthly boards, sorted by rank, maxed weapons, total level, unlocked weapons or XP. Click a player to see their whole mastery compass and specializations.

Click a player to see their mastery map

Supported weapon sources

• TACZ (guns) and the LR Tactical melee addon
• Iron's Arms 'n Artifice (guns)
• SlashBlade Resharped and its addons
• Iron's Spells 'n Spellbooks
• Ars Nouveau (spell glyphs)
• Tinkers' Construct
• Sweet Magic
• Vanilla and modded melee weapons, bows and crossbows (no mod needed)

Gun packs, melee packs and SlashBlade addons are read automatically.

For server owners and modpack makers

• Config screen: select Albion Mastery in the Mods list and click Config, or edit config/albionmastery-common.toml. Every option is listed with its range and a description.
• Numbers: max level, damage per level for each ring, XP rates, per-weapon XP and damage multipliers, slot requirements, point income and costs, and every specialization's values can be changed.
• Missing weapons: add item IDs to extraWeapons (for example examplemod:big_sword=sword); items that shouldn't count go into notWeapons.
• Server authoritative: all bonuses are applied on the server; the client only displays synced data.
• Commands: operators can use /albionmastery help for the management and debug commands.

The in-game config screen

FAQ

Will it find the weapons in my modpack? Most likely. Gun packs, melee packs and SlashBlade addons are read automatically, and so are swords, axes, bows and crossbows from any mod. Anything missed can be added in the config with one line.

Does the server need it? Yes, install it on both the client and the server. It also works in single player.

Can I put it in a modpack? Yes, no need to ask. Please credit the author; commercial use is not allowed (see the license below).

Anything to know before updating? Back up your config folder first, and update the client and the server together. The changelog of each version lists what changed.

Source code · Issues

License and credits

• Licensed under CC BY-NC-SA 4.0: free to use, modify and include in modpacks; no commercial use; redistributed or modified versions must credit the original author (Roinflam), state what was changed, and use the same license.
• The mastery system is inspired by the Destiny Board of Albion Online; the Mastery Rank rules, rank titles and emblem designs are based on the Mastery Rank of Warframe. Albion Online is a trademark of Sandbox Interactive GmbH and Warframe is a trademark of Digital Extremes Ltd. This is an unofficial fan-made mod and is not affiliated with or endorsed by them.
• The names of the supported mods belong to their respective authors. This mod contains no code or assets from them; when they are installed it only calls their classes and applies mixins to them at runtime.
• Bundles Cloth Config API by shedaniel (GNU LGPLv3), unmodified, only for the config screen.