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

1. Download the latest release from the Files tab
2. Place the HyRPGMod.jar file in your server's mods directory
3. Start your server - the mod will automatically create a configuration file
4. Customize settings in {ServerWorldDirectory}/Mods/dev.crazzymods_HyRPG/config.json if desired
5. 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

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

Skill Allocation

1. Open the skill tree with /skilltree
2. Click skill buttons to allocate points
3. Some skills require prerequisite category points
4. 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