premium banner
Level up your tools when broken! Like a muscle!!!

Description

⚔️ LEVEL TOOLS

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

Apoya a Linceros en BisectHosting

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

  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.