⚔️ 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

	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

🔥 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

🎮 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

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

👨‍💻 Author

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

LevelTools/Weapons 2.0