Heroes - Leveling, Classes, Races and more!

Introduction to Heroes RPG

Join the Discord!

A comprehensive, lightweight, and flexible RPG character progression system for Hytale servers. Features classes, races, professions, experience systems, leveling, and extensive customization options.

The best part of this? It's your choice how your Heroes is set up, don't want a certain skill, that's fine, you can just remove the skill and be done with it!

Features: - Class / Race / Profession Selection - Leveling with varying Exp Curves - Armor/Inventory restrictions - Level-Up Modifiers (Health/Mana/Stamina, Regen) - Permission skill nodes

Planned: - Attributes - Skill system - Damage System - Advanced GUI System

Out of Scope/Much Later: - Custom Items - Custom Mobs

Created for the MMORPG server play.herotale.net

NOTE: all permission nodes must be prefixed with herotale.heroes.*

Player Permissions

Permission Description Default

herotale.heroes.command.info View character information true

herotale.heroes.command.paths List available classes true

herotale.heroes.command.choose Choose a class true

herotale.heroes.command.class View class information true

herotale.heroes.command.race View race information true

herotale.heroes.command.profession View profession information true

herotale.heroes.command.level View current levels true

herotale.heroes.command.reset Reset character false

herotale.heroes.boost View active boosts true

Admin Permissions

Permission Description Default

herotale.heroes.admin All admin commands op

herotale.heroes.admin.bonus Manage global boosts op

herotale.heroes.admin.expboost Grant player boosts op

herotale.heroes.admin.expboost.reload Reload boost config op

herotale.heroes.admin.expboost.info View boost info op

Permission-Based Experience Boosts

Grant permanent experience boosts via permission nodes:

Permission Boost Percentage

herotale.heroes.premium.exp-boost.5 +5%

herotale.heroes.premium.exp-boost.10 +10%

herotale.heroes.premium.exp-boost.15 +15%

herotale.heroes.premium.exp-boost.25 +25%

herotale.heroes.premium.exp-boost.35 +35%

herotale.heroes.premium.exp-boost.50 +50%

🎮 Core Features

🧙 Classes

Primary & secondary class system

Multiple specializations per class

Tier-based progression and balance

Class mastery at max level

Unique attributes and stat scaling

Equipment and weapon restrictions

Class-based damage and EXP scaling

Multiple EXP sources (combat, PvP, skills, gathering, etc.)

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

🧬 Races

Multiple playable races

Unique base attributes and passives

Regeneration and stat modifiers

Race progression and mastery

Optional model/visual changes

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

🛠 Professions

Separate progression from combat classes

Crafting and gathering bonuses

Unlock profession-specific recipes

Multiple professions per player (switchable)

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

📈 Experience & Leveling

Configurable EXP curves (linear, exponential, fixed)

Many EXP sources (combat, farming, mining, PvP, admin, API)

Per-class EXP modifiers

Configurable level caps

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

⏱ Experience Boosts

Global server boosts

Temporary player boosts

Permanent permission-based boosts

Configurable stacking behavior

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

💾 Storage & Persistence

JSON or SQL storage

Automatic player data saving

Fast caching for performance

Easy migration between storage types

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

❤️ Regeneration Systems

Health, mana, and stamina regeneration

Scaling based on class and race

🖥 UI & Feedback

Class selection UI

Level-up and mastery notifications

EXP gain messages with progress bars

🧩 Placeholder Support

20+ built-in placeholders

Real-time class, race, profession, and level data

Support for chat, scoreboards, and signs

Custom placeholders via API

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

🔔 Event System

Events for class, race, profession, and level changes

Cancellable and async-safe events

Easy integration for other plugins

🔌 API & Developer Support

Full public API

Access to character data, EXP, boosts, and storage

Event bus and placeholder registration

Designed for plugin interoperability

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

📋 Commands

🧑 Player Commands

/hero – Main help menu

/hero info – Full character overview

/hero paths – Available class paths

/hero choose – Choose or switch class

/hero class | race | profession – View details

/lvl – Quick level overview

/boost – View active EXP boosts

/hero reset – Reset character (permanent)

🛠 Admin Commands

/hero admin – Admin command menu

Manage class, race, profession, EXP, and levels

Control global and player EXP boosts

Reload boost configuration

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

🔐 Permission Skills

Grant or revoke permission nodes based on class, race, and level

No logic execution — permission-driven integration

Ideal for economy, jobs, commands, and external plugins

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

📊 Placeholders

Class, race, profession, level, EXP, and mastery placeholders

Support for specific class/race/profession lookups

👉 Full list: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home

⚙️ Configuration

Fully JSON-based configuration

Toggle systems (classes, races, professions)

Custom EXP curves and mob EXP

Per-class configuration files

👉 Learn more: https://gitlab.com/herocraft/herotale-heroes/-/wikis/home