Description
Introduction to Heroes MMORPG
Join the Discord! Requires Herocore API
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
- Advanced GUI System
- Combat Effect System
- Race models
Planned:
- Attributes
- Skill system
- Damage System
Out of Scope/Much Later:
- Custom Items
- Custom Mobs
Created for the MMORPG server play.herotale.net
INSTALL INSTRUCTIONS
- Download herotale_Heroes.zip
- Extract folder contents (herotale_Heroes folder / heroetale_heroes.jar to /mods
- Configure classes/configs as you see fit
- Start singleplayer/server
- /op self or grant herotale.heroes.command.hero.* to you/your grp
- DO NOT LEAVE ANY ZIPS INSIDE THE MODS FOLDER OR THIS WILL CAUSE THIS ISSUES
CANT FIND CLASSES? Copy from .zip (dont leave zip in mods) to /mods/herotale_Heroes/classes
Permission Nodes
| Category | Permission Node | Description |
|---|---|---|
| Player Commands | ||
herotale.heroes.command.hero.gui |
Access the Heroes GUI interface | |
herotale.heroes.command.hero.info |
View detailed character information | |
herotale.heroes.command.hero.class |
View available classes | |
herotale.heroes.command.hero.race |
View available races | |
herotale.heroes.command.hero.profession |
View available professions | |
herotale.heroes.command.hero.paths |
View class paths and trees | |
herotale.heroes.command.hero.skills |
View character skills and abilities | |
herotale.heroes.command.hero.who |
Look up other players' character information | |
herotale.heroes.command.hero.level |
View character level and experience | |
herotale.heroes.command.hero.choose |
Choose a character class | |
herotale.heroes.command.hero.choose.race |
Choose a character race | |
herotale.heroes.command.hero.reset |
Reset character to starting state | |
herotale.heroes.command.confirm |
Confirm pending actions (e.g., character reset) | |
| Admin Commands | ||
herotale.heroes.command.hero.admin.class |
Set another player's class | |
herotale.heroes.command.hero.admin.race |
Set another player's race | |
herotale.heroes.command.hero.admin.profession |
Set another player's profession | |
herotale.heroes.command.hero.admin.level |
Set another player's level | |
herotale.heroes.command.hero.admin.exp |
Add or remove player experience | |
herotale.heroes.command.hero.admin.bonus |
Manage XP boost multipliers | |
herotale.heroes.command.hero.admin.expboost |
View XP boost information | |
herotale.heroes.command.hero.admin.expboost.info |
View detailed XP boost status | |
herotale.heroes.command.hero.admin.expboost.reload |
Reload XP boost configuration |
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 gui– Main gui 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