Proficiency Levels - Combat & Tools ⚔️⛏️

Play as you always would. Level up while doing it.

Proficiency Levels adds a subtle yet rewarding RPG progression layer to Hytale. Every swing of your sword, every block you mine, every tree you chop—it all counts. The mod works silently in the background, making your character gradually stronger without changing how you play.

🎯 Philosophy: Play First, Progress Always

This mod was designed with one core principle: the player should never feel like they're grinding. Instead of forcing you to think about XP, the system rewards your natural gameplay:

Mining rocks? You're earning Mining XP.
Chopping trees? Woodcutting XP is flowing.
Fighting monsters? Your weapon skills improve.
Taking damage? Your Defense is getting stronger.

The progression is intentionally lightweight by default—you'll feel rewarded without the game becoming "easy mode."

✨ Features Overview

🗡️ Works with Every Weapon (NEW)

The mod now automatically recognizes new weapons! Whether you download a mod with Katanas, Scythes, or Muskets, they will instantly have their own skill progression.

Modded Weapons? Fully supported.
New Strategies? Master unique weapons like Scythes or Warhammers apart from standard Swords.
Instant Setup: No configuration needed. Just equip the weapon and start fighting!

📈 Deep Leveling System (Levels 1-400)

Each skill has 400 levels with carefully balanced XP curves:

Phase	Levels	Progression Style
Early Game	1-100	Fast progression, instant gratification
Mid Game	101-200	Steady climb, noticeable improvements
Late Game	201-400	Long-term goals for dedicated players

🛠️ Three Skill Categories

Category	Skills	Bonuses
Lifeskills	Mining, Woodcutting	Speed Bonus (up to +200%)
Attack	Sword, Axe, Bow, Crossbow, Staff, Deployables	Damage Bonus (+75%), Critical Chance (40%)
Defense	Defense	Damage Reduction (up to 50%)

⚡ Ready to Play

Installation

Drop the .jar file into your Mods folder
Launch Hytale
That's it. No configuration required.

The mod comes pre-balanced out of the box. All XP values, bonus curves, and multipliers have been carefully tuned for a vanilla-friendly experience.

🎮 Player Commands

Command	Description
`/prl skills`	View all your skill levels and bonuses
`/prl skills --category=CATEGORY;`	View specific category (attack/defense/lifeskills)
`/prl stats`	See your total XP and average levels
`/prl xp`	Toggle XP gain notifications on/off

Example Output:

=== PROFICIENCY SKILLS: ATTACK ===
[SWORD] Level 45
  [||||||||..] 8,234 / 12,500 XP
  DMG: +8.4% | Crit: 3.6%

🔧 Server Administrator Commands (OP Only)

Want to customize the experience for your server? Everything is configurable via commands:

Module Control

/prl module status              # See which modules are active
/prl module attack --action=disable      # Disable all attack skills
/prl module lifeskills --action=enable   # Re-enable gathering skills

XP Multipliers

/prl modify xp_all=2.0          # Double ALL XP gains
/prl modify xp_attack=0.5       # Halve attack XP only
/prl modify xp_lifeskills=3.0   # Triple gathering XP

Bonus Multipliers

/prl modify bonus_attack=1.5    # +50% to damage/crit bonuses
/prl modify bonus_defense=2.0   # Double defense reduction

View Current Settings

/prl modifiers                  # Display all active multipliers
/prl debug                      # Technical debug information
/prl reload                     # Reload configuration from file

📊 How Bonuses Work

Lifeskills: Speed Bonus

Mining and Woodcutting give you permanent passive speed increases:

Level	Speed Bonus
1	+0%
100	+100%
200	+150%
400	+200%

Higher speed = faster block breaking = more XP per minute!

Attack: Damage & Critical Hits

Each weapon skill boosts your damage output:

Level	Damage Bonus	Critical Chance
1	+0%	0%
100	+50%	15%
200	+65%	25%
400	+75%	40%

Critical hits deal 3x damage!

Defense: Damage Reduction

Taking damage trains your Defense skill:

Level	Damage Reduction
1	0%
100	25%
200	35%
400	50%

At max level, you take half damage from all sources!

⚙️ Configuration File

All settings are saved in plugins/ProficiencyLevels/config.json:

{
  "baseXp": {
    "MINING": 5,
    "WOODCUTTING": 10,
    "SWORD": 1,
    "MACE": 1,
    "BATTLEAXE": 1,
    "DAGGERS": 1,
    "SHORTBOW": 2,
    "CROSSBOW": 2,
    "DEPLOYABLE": 2,
    "STAFF": 3,
    "DEFENSE": 10
  },
  "oreMultipliers": {
    "Silver": 4.0,
    "Onyxium": 12.0,
    "Mithril": 15.0,
    "Adamantite": 10.0,
    "Iron": 3.0,
    "Prisma": 25.0,
    "Copper": 2.0,
    "Cobalt": 8.0,
    "Thorium": 6.0
  },
  "gemMultiplier": 8.0,
  "showXpGainsDefault": false,
  "autoSaveInterval": 10,
  "xpMultiplierAll": 10.0,
  "xpMultipliers": {
    "LIFESKILLS": 1.5,
    "ATTACK": 1.0,
    "DEFENSE": 1.0
  },
  "bonusMultipliers": {
    "LIFESKILLS": 1.0,
    "ATTACK": 100.0,
    "DEFENSE": 1.0
  }
}

Changes made via /prl modify are automatically saved and persist across server restarts.

🎲 XP Scaling Examples

Mining XP

Block Type	Base XP	With Ore Multiplier
Stone	5	5
Copper Ore	5	10
Iron Ore	5	15
Mithril Ore	5	75
Prisma Ore	5	125

Combat XP

Damage Dealt	XP Gained
10 damage	10 XP
50 damage	50 XP
Critical (100 dmg)	100 XP

XP scales with damage dealt, encouraging better gear and skilled play!

💡 Design Goals

Zero Learning Curve - Just play the game normally
Vanilla-Friendly - Bonuses are noticeable but not game-breaking
Long-Term Goals - 400 levels gives hundreds of hours of progression
Server Control - Admins can tune everything without touching code
Persistent Progress - Your levels save automatically

🚀 Quick Start for Server Owners

Want a more hardcore experience?

/prl modify xp_all=0.5          # Slower progression
/prl modify bonus_attack=0.75   # Weaker combat bonuses

Want a faster, more casual server?

/prl modify xp_all=3.0          # Triple XP gains
/prl modify bonus_lifeskills=2  # Faster gathering

Want only gathering skills?

/prl module attack --action=disable
/prl module defense  --action=disable

📝 Credits

Developed by TechOverdrive for the Hytale community.

Start your journey. Every action counts.