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:

🛠️ Three Skill Categories

⚡ Ready to Play

Installation

1. Drop the .jar file into your Mods folder
2. Launch Hytale
3. 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

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:

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

Attack: Damage & Critical Hits

Each weapon skill boosts your damage output:

Critical hits deal 3x damage!

Defense: Damage Reduction

Taking damage trains your Defense skill:

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

Combat XP

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

💡 Design Goals

1. Zero Learning Curve - Just play the game normally
2. Vanilla-Friendly - Bonuses are noticeable but not game-breaking
3. Long-Term Goals - 400 levels gives hundreds of hours of progression
4. Server Control - Admins can tune everything without touching code
5. 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.