HyRPG - Comprehensive RPG Extension for Hytale

Transform your Hytale server into a fully-featured RPG experience with player progression, dynamic mob scaling, and an extensive skill tree system!

🎮 Overview

HyRPG adds a complete RPG progression system to Hytale servers, featuring player leveling, skill trees, dynamic mob scaling, and experience systems. Players can level up from 1 to 50, earn skill points, and customize their character through an intuitive skill tree interface.

✨ Key Features

📈 Player Progression

Level System: Level up from 1 to 50 (configurable)
Experience Points: Gain XP by defeating mobs - higher level mobs grant more experience
Dynamic Experience Scaling: Experience requirements scale with level progression
Visual Experience Bar: Beautiful HUD experience bar to track your progress
Skill Points: Earn 1 skill point per level to spend in the skill tree

🌳 Skill Tree System

18 Unique Skills across 3 categories (Survival, Combat, Utility)
Skill Tree UI: Professional modal interface to view and allocate skill points
Prerequisites System: Advanced skills require category point investments
Active Skill Effects: Skills actually modify your stats, damage, speed, and more!

Skill Categories:

Survival Skills:

Health Boost - Increase maximum health
Stamina Efficiency - Increase maximum stamina
Regeneration - Health regeneration over time
Damage Resistance - Reduce incoming damage
Oxygen Capacity - Increase underwater breathing time
Resource Gathering - Faster block breaking and resource collection

Combat Skills:

Damage Boost - Increase all damage dealt
Critical Strike - Chance for devastating critical hits
Armor Penetration - Ignore enemy armor
Weapon Mastery - Enhanced weapon effectiveness
Battle Focus - Overall combat effectiveness multiplier

Utility Skills:

Movement Speed - Move faster
Jump Height - Jump higher
Mana Pool - Increase maximum mana
Mana Regeneration - Restore mana over time
Experience Bonus - Gain more experience from kills

👹 Dynamic Mob Scaling

Randomized Mob Levels: Mobs spawn with levels based on their type
Configurable Level Ranges: Customize level ranges for each mob type
Level-Based Rewards: Higher level mobs grant significantly more experience
Visual Level Display: Mob levels displayed in nameplates above entities

🎯 Experience Sharing

Cooperative Play: Experience is shared between nearby players who participate in combat
Configurable Radius: Adjust the distance for shared experience
Participation Tracking: Only players who recently damaged the mob receive shared XP

🛠️ Installation

Download the latest release from the Files tab
Place the HyRPGMod.jar file in your server's mods directory
Start your server - the mod will automatically create a configuration file
Customize settings in {ServerWorldDirectory}/Mods/dev.crazzymods_HyRPG/config.json if desired
Restart your server to apply changes

⚙️ Configuration

All settings are configurable via the config.json file (auto-generated on first run):

Level Caps: Set maximum player and mob levels
Experience Settings: Customize base XP, XP per level, and leveling formulas
Experience Sharing: Adjust radius and participation time window
Mob Level Ranges: Set custom level ranges for each mob type

Example configuration:

{
  "MaxPlayerLevel": 50,
  "MaxMobLevel": 50,
  "BaseExperience": 20,
  "ExperiencePerLevel": 5,
  "SharedXpRadius": 25.0,
  "SharedXpRecentSeconds": 15.0,
  "MobLevelRanges": {
    "Frog": { "MinLevel": 1, "MaxLevel": 5 },
    "Bear_Grizzly": { "MinLevel": 10, "MaxLevel": 25 }
  }
}

🎮 Commands

Player Commands

/skilltree or /st or /skills - Open the skill tree interface

Admin Commands

/rpgadmin setlevel [player] <level> - Set a player's level
/rpgadmin setexp [player] <experience> - Set player experience
/rpgadmin addexp [player] <experience> - Add experience to a player
/rpgadmin reset [player] - Reset player RPG data
/rpgadmin setpoints [player] <points> - Set skill points
/rpgadmin stats [player] - View player RPG statistics

📊 How It Works

Leveling Up

Defeat mobs to gain experience
Experience is calculated as: BaseExperience + (Mob Level × ExperiencePerLevel)
Experience Bonus skill multiplies all XP gained
Level up to earn skill points (1 point per level)

Skill Allocation

Open the skill tree with /skilltree
Click skill buttons to allocate points
Some skills require prerequisite category points
Skills take effect immediately and persist across sessions

Mob Scaling

Each mob type has a configurable level range
Mobs spawn with a random level within their range
Higher level mobs are more challenging but grant more experience
Mob levels are visible in nameplates: [Level] or MobName [Level]

🎨 Skill Effects in Detail

Stat Modifications

Health/Stamina/Mana/Oxygen: Directly increase maximum values
Effects are permanent while skills are allocated

Combat Enhancements

Damage Modifiers: Stack multiplicatively for powerful builds
Critical Strikes: Chance-based 2x damage multiplier
Armor Penetration: Reduces enemy defensive capabilities
Damage Resistance: Percentage-based damage reduction

Regeneration

Health/Mana Regen: Restores stats every second based on maximum values
Percentage-based: Higher max stats = more regeneration

Movement

Speed: Affects walking, running, and sprinting speeds
Jump Height: Increases jump force for better mobility

Gathering

Resource Collection: Increases block break damage for faster mining/chopping