Changelog — LincerosLevelTools

All notable changes to this project are documented here.

[2.3] — 2026-03-06

Added

• Prestige system (/leveltools prestige): while holding a tool or weapon, converts accumulated levels into Ability Tokens (1 token per TokensPerLevel levels, default 5). The item resets to the leftover levels below the threshold.
• Prestige tokens accumulate across multiple prestiges — stored as LincerosPrestigeTokens in item metadata and preserved through setlevel.
• Token count now includes prestige tokens in both TokenPage display and toggle logic.
• Tooltips on all ability buttons in the Weapon Mastery menu: hover any ability to read its description.
• leveltools.admin permission gate on /leveltools setlevel — only operators or players with the node can use it.
• Commands section in publish.md listing all available commands.
• New config fields documented: TokensPerLevel, WeaponXPMultiplier, ToolXPMultiplier, ShowLevelUpMessage, HudRefreshIntervalMs, MaxLevelJunk, MaxLevelUncommon, MaxLevelRare, MaxLevelEpic, VeinMinerMaxBlocks, VampirismLifestealPercent, IgnoreDefenseMultiplier, EnergySaverStaminaRefund, FireBurnDurationSeconds, PoisonDurationSeconds, SalvageCompatEnabled, LevelUpFullRepair.

Changed

• UI overhaul — Weapon Mastery menu (LincerosTokens.ui) now uses official Hytale Common.ui templates:
  • Layout uses native Panel / SimpleContainer containers and official separator elements.
  • All buttons use CancelTextButton / standard Hytale button styles with correct hover and press states.
  • Tooltip style uses $Common.@DefaultTextTooltipStyle (the mod's own Common.ui definition, compatible with the Hytale mod API).
• Sound polish — ability buttons now use the correct mod-local sound templates:
  • Activate: $Sounds.@Tick at volume 10 (was incorrect template at volume 6).
  • Hover: $Sounds.@ButtonsLightHover at volume 6.
• publish.md updated to v2.3 with prestige system docs, updated ability table with costs and descriptions, full config reference, and commands table.
• HYTALE_UI_GUIDE.txt updated with sounds section rewrite (mod vs game Sounds.ui distinction) and new tooltips section (section 12).

Fixed

• Salvage Station compatibility — tools and weapons with level data can now be salvaged normally at the Salvage Station without issues. Controlled via SalvageCompatEnabled in config (default true).
• Wrong sound template @ButtonsSmall referenced in button sounds — this template does not exist in the mod's Sounds.ui; replaced with inline sound definition using @Tick + @ButtonsLightHover.
• Crash: Could not find an expression named ButtonTextTooltipStyle — @ButtonTextTooltipStyle only exists in the game-installed Common.ui, not in the mod's own Common.ui. Fixed by using @DefaultTextTooltipStyle throughout.

[2.2] — (previous release)

Added

• Token System (Early Access): earn 1 token every 5 levels, spend them in the Weapon Mastery menu.
• Weapon Mastery UI (LincerosTokens.ui): in-game page to toggle abilities on held tools and weapons.
• 7 unlockable abilities:
  • Weapons: Fire Aspect, Vampirism, Poison, Unstoppable, Energy Saver.
  • Tools: Vein Miner, Auto Smelt.
• Ability state and token count stored in item metadata (persisted across sessions).
• /leveltools tokens command to open the Weapon Mastery menu.

[2.1] — (previous release)

Added

• /leveltools setlevel <level> admin command to force-set a tool's level.
• /leveltools hud command to toggle the XP HUD per-player.

Changed

• HUD layout improved: shows current level, XP bar, and max level.

[2.0] — (previous release)

Added

• Complete rewrite with Hytale mod API.
• Level-up system: tools gain XP on durability use, level up and auto-repair on full bar.
• Per-rarity level caps (Junk → Legendary / Infinite).
• Stat bonuses per level: +15% durability, +5% damage (weapons), +5% mining speed (tools).
• Custom HUD overlay via MultipleHUD.
• LevelTools.json configuration file.
• Manual repair detection: repairing at a bench resets current-level XP progress.