SpectreWall
Masterwork

Masterwork

A Hytale server plugin that introduces a craftsmanship system to forging. Each piece of gear is signed with its creator’s name and receives a unique quality roll, reflecting how well it was crafted.

Concretely, when a player crafts a weapon, an armor piece or a tool, the plugin does two things.

  1. Stamps the crafter’s name. The name is persisted on that single item instance and shown in the item’s in game description as “Crafted by <name>”.
  2. Rolls a Grade. A craftsmanship tier is rolled at craft time. A higher Grade swaps the crafted item to a per tier item variant with natively scaled stats (damage, armor, durability) and a native rarity border in the Grade’s color. The crafter stamp rides along on the swapped instance.

Both features are implemented and verified in game. The crafter stamp works across instant, timed and bulk crafts, and it survives a relog. The Grade system rolls a seven tier ladder, supports custom quality injection, mints per tier variants with native stats and a border, swaps the item on craft, and honors a blacklist through neutral variants.

The Grade ladder

Grade is a seven tier craftsmanship ladder, independent from the game’s own material rarity system:

  • Masterworktop tier, red
  • Exquisitegold
  • Superiorpurple
  • Well-Craftedblue
  • Adequategreen
  • Commonbase tier, gray
  • Poorbottom tier, dark gray

Common is the base tier: a common roll yields the item’s shipped id and stats, only with its rarity border normalized to Masterwork’s own Common quality. Every tier above and below it mints a distinct item variant, so a Masterwork sword is a different item instance from a Common one, with its own stats and its own quality border.

Grade vs. Quality. Quality is the base game’s ItemQuality asset system, the colored slot and border a player already knows from vanilla rarity. Masterwork injects its own custom quality assets, one per Grade, and stamps them on graded items so the border communicates the Grade rather than the item’s native material rarity.

Drops and chests

Grade is not only rolled at the crafting bench. Gear the world gives a player, a mob’s drop or a chest’s contents, is graded too, on its own odds table with its own tuning. By default the top tier is not available there at all: Masterwork is a title a crafter earns, not one a player finds lying on the ground. A drop table can also pin an exact tier on a hand authored reward, so a quest chest can hand out a guaranteed Superior sword.

A found piece rolls no XP, no ranking points and no crafter stamp: finding a piece of gear is not the same as forging one. See Droplist for how the roll works and how to pin a guaranteed tier on a hand authored reward.

Where to go next