⚔️ LEVEL TOOLS

Don't let your tools break… let them EVOLVE!

⚠️ IMPORTANT REQUIREMENT ⚠️

Please install MultipleHUD for the custom HUD to function correctly.

---

🆕 What's New in v2.4.2

	Feature	Description
🪨	Tiered Evolution Stones	7 unique stones (Copper to Onyxium) with custom crafting recipes
🔒	Strict Tier Progression	Evolution stones only upgrade items from the immediately preceding tier
🖼️	Custom 3D Models	Full support for .blockymodel and .png textures for each stone tier

---

🆕 What's New in v2.4.1

	Feature	Description
📊	Item Statistics	Each tool/weapon records enemies defeated, blocks mined, and total XP earned
🔍	Stats Page	Use /leveltools stats to open a dedicated panel for your held item
⭐	Milestone Messages	Reaching levels 5, 10, 15, 25, 50 triggers a special styled message
🔧	Hytale 0.5.3 Support	Full ECS compatibility, HUD thread safety, and native Tool Belt detection
🛠️	Debug Command	Use /leveltools debug to troubleshoot active items and components

---

🔥 How It Works

Use your tools and weapons. Durability lost = XP gained. Fill the bar → level up → full auto-repair. Simple.

Event	What happens
Level Up	Full repair, stats increase, level-up message
Manual Repair	Resets current-level XP progress
Hit Max Level	Item stops advancing (Legendary & Crude Hoe scale infinitely)
Prestige	Converts levels into Ability Tokens and resets the item

📈 Stat Bonuses per Level

Stat	Bonus	Who benefits
Max Durability	+15%	All items
Damage	+5%	Weapons
Mining Speed	+5%	Tools

💎 Rarity Level Caps

Rarity	Max Level
Trash / Junk	3
Common	5
Uncommon	10
Rare	15
Epic	25
Legendary	∞

Special exception: Crude Hoe also scales infinitely.

---

🪙 Ability Tokens

Reach the level cap → /leveltools prestige → earn Ability Tokens → spend them in /leveltools tokens. Every 5 levels (configurable) = 1 token. Tokens stay on the item across prestiges.

⚔️ Weapon Abilities

Ability	Cost	Effect
Fire Aspect	1	Sets target on fire
Vampirism	2	Heals you for a portion of damage dealt
Poison	1	Poisons target on hit
Unstoppable	3	Bypasses enemy defense
Energy Saver	2	Restores stamina on each hit

⛏️ Tool Abilities

Ability	Cost	Effect
Vein Miner	1	Mines all connected ore blocks at once (up to 20)
Auto Smelt	1	Mined ores are automatically smelted

---

🪨 Evolution Stones (Tiered Upgrades!)

Why throw away your trusty, leveled-up sword just because you found some new ores? Now you don't have to! Instead of crafting a completely new tool from scratch, you can Evolve your existing tools and weapons while keeping their progress and abilities!

We've introduced 7 Unique Tiers of Evolution Stones. Each stone has its own custom 3D model, custom texture, and requires specific, tier-appropriate materials to craft (scaling with Hytale's progression).

🛠️ How it works:

1. Strict Progression: You can't skip tiers! An Evolution Stone only works on the tool from the immediately preceding tier.
2. Dynamic Validation: If you try to use an Iron Stone on a Thorium pickaxe, the UI will intelligently block you and tell you exactly what went wrong.
3. The Ritual: Just right-click while holding the stone in your hand to open the Evolution UI. Then, click the tool in your inventory that you want to ascend to the next level!

💎 The 7 Tiers of Evolution

Tier	Evolution Stone	Required Base Material	Quality
	Copper	Crude	Common
	Iron	Copper	Uncommon
	Thorium	Iron	Rare
	Cobalt	Thorium	Rare
	Mithril	Cobalt	Epic
	Adamantite	Mithril	Epic
	Onyxium	Adamantite	Legendary

Modder Note: I am terrible at creating 3D models and textures. If anyone wants to contribute cool models for the Evolution Stones, you are more than welcome and will be added to the credits!

---

🎮 Commands

👤 Player

Command	Description
/leveltools	List all available commands
/leveltools tokens	Open the Weapon Mastery menu to spend Ability Tokens
/leveltools prestige	Convert levels into Ability Tokens (hold the item)
/leveltools stats	View statistics for the held item
/leveltools hud	Toggle the LevelTools HUD on/off
/leveltools hud position <x> <y>	Move the HUD to a custom pixel position on screen
/leveltools hud reset	Restore the HUD to its default position

🔧 Admin (requires leveltools.admin)

Command	Description
/leveltools setlevel <level>	Force-set the level of the held item

---

⚙️ Configuration

Settings live in LevelTools.json (auto-generated on first run). Key fields:

{
    "DurabilityLossToLevel": 100.0,
    "DurabilityBonusPercent": 15.0,
    "DamageBonusPercent": 5.0,
    "SpeedBonusPercent": 5.0,
    "WeaponXPMultiplier": 2.5,
    "ToolXPMultiplier": 1.0,
    "TokensPerLevel": 5,
    "VeinMinerMaxBlocks": 20,
    "ShowLevelUpMessage": true
}

Full config includes HUD position defaults, ability durations, rarity caps, salvage compat, and more.

---

📥 Installation

1. Download Linceros.LevelTools-2.4.jar
2. Install MultipleHUD
3. Drop both .jar files in your server's mods/ folder
4. Restart — and start grinding!

---

👨‍💻 Author

Created by Linceros — part of the Linceros Mod Collection for Hytale.