HyRPG

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