Skip to content

Asset Packs

gottsch edited this page Nov 15, 2026 · 2 revisions

Asset Packs

Magic Treasures' metals, styles, gems, spells, jewelry and loot are all data, loaded as Hytale assets. An asset pack can change them or add its own. The built-in files are in the mod's jar (and the source) under Server/MagicTreasures/.

Folders

  • Materials/: metals. Mana (charge), Uses, Repairs, MaxLevel (spell level), RefillSeconds, Quality, Factors (spell boosts: Cost, Cooldown, Effect, Duration, Range) and Elements (powers rolled when a piece is made, each with a Chance).
  • Styles/: plain and Great. ManaMultiplier, UsesMultiplier, MaxLevel and Repairs (added to the metal's), QualitySteps, Sockets, ElementRerolls.
  • Gems/: Item (the raw gem it's cut from), Mana, Recharges, Factors, Quality (which also sets how hard it is to cut), Elements, Bonus (Perfect cut, 1 in 4) and Weakness (Flawed cut).
  • Spells/: Name, Kind, Level, Cost, Cooldown, Duration, Effect, and per kind Element, EntityEffect, OnHit, OnHitChance, Pulse, MaxTargets, Radius.
  • Jewelry/: one definition per jewelry item: its Material, Style and Gem. Named pieces add their own numbers and rules.
  • Loot/: loot tables. Each one names vanilla drop lists by regex (Match), with a Priority (the highest matching table wins), a Chance, MinRolls/MaxRolls, and weighted Entries of item id regexes. An entry can filter scrolls by spell level (MinItemLevel/MaxItemLevel) and pick a gemmed piece's cut (Cuts).

Spell kinds: Healing, Speed, Strength, Cat_Sight, Ward, Weapon, Strike, Vampiric, Drain. See Spells for what each does with its numbers.

Jewelry items

Every jewelry item also needs its Hytale item file, model and icon. The mod's tools/generate_jewelry.py writes the items, definitions, scrolls, cut gems and their text from the data above, so a new metal or gem is easiest to add in the source and regenerate.

/mt loot <droplist> rolls the table that matches a drop list, to check a table without hunting for chests.

Clone this wiki locally