- Minecraft Versions
- 1.8, 1.9, 1.10, 1.11, 1.12, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20
- Languages Supported
- FULL TRANSLATION AVAILABLE!
Minecraft RPG Plugin
![[IMG]](http://i.imgur.com/8jFcFVY.png "[IMG]")
Features
Class / Professions with Levels
Heroes Skills & Permission Skills
Skill Binding
Inventory Restrictions
Alternative Health/Damage System
Party EXP Sharing & Party Loot Rolling
Improved Skill Framework
Mana & Stamina System
Improved Help and Commands
Stat/Scoreboard System
Cool-down Action Bar
Toggleable Mob Health Bars
Attributes with GUI
Enhanced Targeting System
Vanilla Crafting Restrictions
Bonus EXP Permission Nodes
Improved Party System with Split EXP Gains
Skill Icons + Hot Bars when combined with Magic
Commands on Class Change
Abstracted Class Progression
Shielding Health System
SQL or YML Storage
PlaceholderAPI support
Language Support for Skills
Mythic Skills integration!
================
WIKI
================
Premium Skill Packs
ā« Blood and Fire ā«
ā« Runes and Rage ā«
ā« Songs and Serenity ā«
ā« Crafty and Buff ā«
ā« Arcane and Dreadful ā«
ā« Honor and Nature ā«
ā« Death and Divine ā«
ā« Stealth and Darts ā«
ā« Magic Skills (NOT 1.15+ COMPAT)ā«
Addons
Heroes Skill Hotbars
REQUIRES
Java 11 + VAULT + Spigot
Skill Depends > EffectLib
Recommended Perms > LuckPerms
EXTRA
Public Skills Pack for 1.11 | 1.10~
Planned Features
Proper Citizen Support
Heroes Attribute Custom Item Support
Scriptable Skills
API | Java Docs Here | Best with PaperSpigot | Default Configurations
WANT TO TEST IT OUT FOR FREE? DOWNLOAD 1.16 and below here
Features
Class / Professions with Levels
Heroes Skills & Permission Skills
Skill Binding
Inventory Restrictions
Alternative Health/Damage System
Party EXP Sharing & Party Loot Rolling
Improved Skill Framework
Mana & Stamina System
Improved Help and Commands
Stat/Scoreboard System
Cool-down Action Bar
Toggleable Mob Health Bars
Attributes with GUI
Enhanced Targeting System
Vanilla Crafting Restrictions
Bonus EXP Permission Nodes
Improved Party System with Split EXP Gains
Skill Icons + Hot Bars when combined with Magic
Commands on Class Change
Abstracted Class Progression
Shielding Health System
SQL or YML Storage
PlaceholderAPI support
Language Support for Skills
Mythic Skills integration!
================
WIKI
================
Premium Skill Packs
ā« Blood and Fire ā«
ā« Runes and Rage ā«
ā« Songs and Serenity ā«
ā« Crafty and Buff ā«
ā« Arcane and Dreadful ā«
ā« Honor and Nature ā«
ā« Death and Divine ā«
ā« Stealth and Darts ā«
ā« Magic Skills (NOT 1.15+ COMPAT)ā«
Addons
Heroes Skill Hotbars
REQUIRES
Java 11 + VAULT + Spigot
Skill Depends > EffectLib
Recommended Perms > LuckPerms
EXTRA
Public Skills Pack for 1.11 | 1.10~
Planned Features
Proper Citizen Support
Heroes Attribute Custom Item Support
Scriptable Skills
API | Java Docs Here | Best with PaperSpigot | Default Configurations
WANT TO TEST IT OUT FOR FREE? DOWNLOAD 1.16 and below here
Introduction
The first Minecraft Role-playing plugin created for the multiplayer server Herocraft! Heroes is a dynamic, flexible and highly configurable class, skill and experience system. Heroes itself is the hub of your players RPG experience, boasting classes, multi-tiering, and advanced skills. Along with classes, Heroes offers your players a new style of PvP & PvE through our well-developed skill system and our weapon + armor restrictions. No longer will your mages have the ability to use diamond swords, your rogues will no longer sneak around in their heavy diamond tunics and most importantly, you can now hurl fireballs and stun your targets. 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!
What can I do with it?
With Heroes, you can do almost anything you'd want to do on an RPG server. The main feature is our customizable tiered class system, which offers as much to the server owner as possible when tied with our skills and permission skills. Your Heroes could be totally unique to your server, it could be the reason players play your server over other servers. The same can be said about our skill system, it's unique to any of the other RPG plugins out there. Other plugins dub "Skills" as methods which you level up, this isn't the case with Heroes. Skills are abilities you can perform which are unique to your class. Some of our favorite skills are Fireball, Jump and Port. These are what makes Heroes unique.
Features
In-depth
- FULL TRANSLATION SUPPORT!
- Translate the entire plugin and all messages via the translations.yml file!
- Classes
- Create your own unique classes or use the defaults!
- Permission nodes to set what classes are obtainable for the default user
- Custom class names
- 'Parent | Child' optional relationship, (example HEALER -> CLERIC)
- Configurable inventory restrictions
- Dual-Classing! (either primary, secondary or both, multi-classing)
- Attributes
- Strength - increases damage with melee weapons, as well as damage with physical based abilities
- Constitution - increases your maximum health pool, and also provides slight resistances to magic based damage
- Endurance - increases your base stamina regeneration, and also increases your maximum equipment weight. A high equipment weight value will be required to wear several pieces of armor at once
- Dexterity - increases damage with projectile based weaponry, as well as your base movement speed. The effectiveness of certain abilities may also be increased by this attribute
- Intellect - increases your maximum mana pool, and also increases the damage dealt by magic based abilities
- Wisdom - increases your base mana regeneration, and also increases the effectiveness of healing based abilities
- Charisma - increases the potency of songs, and increases the duration and effectiveness of certain disabling abilities
- Amazing Skills
- Over 100+ base skills! Get more with the Premium packs!
- Usable with /bind to your item or /skill
- Pair with the Magic hotbar wand system or MacroMod client!
- Works with Attributes, Mana, Health and other reagents!
- Permitted Skills
- Skills in the base platform of Heroes
- All permitted skills start with /skill <skillname>
- Allows for developers to add in their own code for new skills
- Adjustable through skills.yml or overwritten in the class setup
- Permission Skills
- Based on the permission-node system, ability to set the level required to learn certain permission-nodes to have a highly configurable system.
- Does not use the /skill prefix - Permission skills are not linked to any commands they simply give players permissions
- Using Skills
- Ability to '/bind <skillname>' to an item to right click and use that skill
- Use '/bind' again to clear the bind and remove the right click ability
- Currently only works for Permitted-Skills
- Integration with Magic plugin via "/mskills"
- /hero skill version <skill> (or /hero admin skill version <skill>)
- Hot Bar Skill Use
- Alternative to the bind system
- Let players use a hot-bar configured with the Magic plugin
- Add "skills_use_heroes: true" to your Magic config!
- Inventory Restrictions
- Armor & Weapon restrictions based on class
- Configurable in the class files
- Levels
- /level - to show information about the level - comes with a nice interface to show you how much left to obtain the next level.
- Set a mastery level - once achieved the user may switch to different classes and have their level/skills saved on the mastered class.
- Configurable curves of exp to make lower levels easier and higher levels harder to get through
- Optional Health gain per level
- Configurable loss of exp (0.10 = 10% per death) by current level
- Exp-Sources
- SKILL - exp for using a skill
- CRAFTING - exp for crafting an item
- MINING - exp for mining blocks
- KILLING - exp for slaying mobs
- LOGGING - exp for jacking lumber
- PVP - exp for PVP
- QUESTING - used in API's for quest plugins
- EXTERNAL - used in normal API's
- Health/Damage
- Set environmental damage
- Set monster health/damage
- Allow bed healing for players to regenerate health in bed!
- Set player health (works with heart ratios)
- Set across the broad item damage or override single classes in their class files!
- Mana
- /mana - shows the current amount of mana - caps at 100%.
- Configurable mana regen rate per-class
- time between regen is server-wide
- Stamina
- /stamina - alternative system to mana
- regenerates faster than mana
- can toggle the vanilla hunger system!
- Shielding
- /shields - alternative before-health system
- regens slowly over time
- similar to Diablo 2 style "magic shields"
- Parties
- Experience -Sharing - on/off
- PVP - on/off
- Bonus Exp per extra party member
- Group-Skills
- Volatile
![[IMG]](https://i.imgur.com/8c00Jdo.png "[IMG]")
Skill Showcase
![[IMG]](https://i.imgur.com/LTDXkLV.gif "[IMG]")
![[IMG]](https://i.imgur.com/9Dq4FJ1.gif "[IMG]")
![[IMG]](https://i.imgur.com/FY4JOvE.gif "[IMG]")
![[IMG]](https://i.imgur.com/37DdD9x.gif "[IMG]")
![[IMG]](https://i.imgur.com/PKEpRuJ.gif "[IMG]")
![[IMG]](https://i.imgur.com/YF75bQM.gif "[IMG]")
![[IMG]](https://i.imgur.com/Lc2XhlB.gif "[IMG]")
![[IMG]](https://i.imgur.com/Geu11La.gif "[IMG]")
![[IMG]](https://i.imgur.com/zh8SoqY.gif "[IMG]")
Placeholders for PAPI
Papi Expansion Jar
Code:
prefix = %heroes_PLACEHOLDERNAME%
%heroes_party_leader%
%heroes_party_size%
%heroes_stamina%
%heroes_maxstasmina%
%heroes_mana%
%heroes_maxmana%
%heroes_class%
%heroes_class2%
%heroes_class_level%
%heroes_class2_level%
%heroes_class_exp%
%heroes_class2_exp%
%heroes_class_maxexp%
%heroes_class2_maxexp%
%heroes_class_exp_percent%
%heroes_class2_exp_percent%
%heroes_skill_level_%
%heroes_class_description%
%heroes_class2_description%
%heroes_class_tier%
%heroes_class2_tier%
%heroes_mastered%
%heroes_ismastered_%
%heroes_class_ismastered%
%heroes_class2_ismastered%
%heroes_class_maxlevel%
%heroes_class2_maxlevel%Overview
Experience is how Heroes gain levels. Currently there are eleven different sources of gaining experience:
Skill experience is set per-skill in the skills configurations, and is usually not enabled, but can be enabled if you want specific skills to award or cost the player experience. PvP rewards are set under Killing as shown in the default configuration below.
Enchanting is required for a player to enchant items, as it will be used to deduct the exp cost from the heroes.
Questing & External require extra addons to be functional, they are not used internal to the Heroes plugin.
The experiences.yml file controls which experience types award experience and how much they award. Killing goes by entity names, while the other options go by block and item names
Experience is how Heroes gain levels. Currently there are eleven different sources of gaining experience:
- SKILL,
- KILLING,
- PVP,
- MINING,
- ENCHANTING,
- FARMING,
- CRAFTING,
- LOGGING,
- DEATH,
- ADMIN,
- EXTERNAL,
- FISHING,
- QUESTING,
- BUILDING,
- SHEARING,
Skill experience is set per-skill in the skills configurations, and is usually not enabled, but can be enabled if you want specific skills to award or cost the player experience. PvP rewards are set under Killing as shown in the default configuration below.
Enchanting is required for a player to enchant items, as it will be used to deduct the exp cost from the heroes.
Questing & External require extra addons to be functional, they are not used internal to the Heroes plugin.
The experiences.yml file controls which experience types award experience and how much they award. Killing goes by entity names, while the other options go by block and item names
General Commands
/skills - /skilllist
/skill <skill> <args>
Party Commands
/party invite <player>
/party accept <player>
/party leave
/p <message>
/mode +[option]
/mode -[option]
/party who
- /hero - /heroes
- /hero help
- /hero armor
- /hero choose <path>
- /hero prof <path>
- /hero paths
- Only shows those paths which are set as 'tier: 1' in their class file
- /hero reset
- resets the player to the default class and wipes ALL experience/levels gained
- /hero tools
- /hero spawnparticle
- /hero scroll
- /hero skills - /skills
- /hero specs
- /hero leaderboard
- /hero who <player>
- /hero verbose
- /hero suppress <skillname>
- /hero scroll
- /hero level - /level - /hlevel - /lvl
- /mana
- /health - /hp
- /cooldowns - /cd
- /bind
- removes a binding for the held item
- /bind <skill> [args]
- adds a binding for the item being held to the skill specified, if the skill requires arguments they can be supplied
- /hero admin class <player> <class>
- /hero admin prof <player> <profession>
- /hero admin exp <player> <class> <amount>
- class can also be 'prim' or 'prof' to give exp to a player's primary class or profession.
- /hero admin level <player> <class> <amount>
- class can also be 'prim' or 'prof' to give a level to a player's primary class or profession.
- /hero admin heal <player>
- /hero admin hp <player> <amount>
- /hero admin reload
- /hero admin saveall
- /hero debug dump
/skills - /skilllist
/skill <skill> <args>
Party Commands
/party invite <player>
/party accept <player>
/party leave
/p <message>
/mode +[option]
/mode -[option]
/party who
Permissions
Heroes supports zPermissions and bPermissions
Heroes supports zPermissions and bPermissions
- heroes.classes.*
- Choose all classes that are tagged as 'wildcard-permission: true'
- heroes.classes.class-name
- Choose the specified class
- heroes.reset
- Allows the user to RESET and go back to default class
- heroes.admin.exp
- Set a player's experience
- heroes.admin.class
- change Set a player's class
- heroes.admin.level
- Set player's level
- heroes.admin.heal
- Heal a hero to full
- heroes.admin.health
- Set a player's health
- heroes.admin.reload
- Reload configuration files
- heroes.admin.saveall
- saves all online heroes
- heroes.boost
- allows players to use Heroes /boost - cmd
- heroes.bind
- allows players to bind skills to items
Plugins that support Heroes
- MobArena | EcoCreature | HeroTitles | Herochat
- Healthbar | PlaceholderAPI
- MobHealth
- Campaign
- MythicMobs
- Class Builder GUI
- Heroes Scrolls
- BetonQuest > BetonQuest Heroes Compatibility
-- **Full Translation Support** --
Attention all, drum roll please - Heroes now has **FULL TRANSLATION SUPPORT**. Pretty much every single message in Heroes is now translatable via a file created by the plugin called `translations.yml`! The only exceptions is that some commands are not translatable, the majority of the most used ones are! We will be finishing off the rest of the commands in future updates to come! This was a major undertaking, with the translation file featuring literally over 400 messages which used to be hard coded into Heroes, so understandably there may be some small typos or errors - please let us know if you come across any!
When **configuring** the translations. There are few little tricks you can do to further customize Heroes;
- For many translations, mainly those which are sent to the player as a message, if you configure the translation such that `some-translation: ''` (such that it's empty), this will mean that the message simply will not be sent! This means for example for those of you which don't use races or don't use secondary classes, you can simply set those options to an empty string and then those messages won't be sent. For example, see the below translations which are used mainly for the /hero info command.
Attention all, drum roll please - Heroes now has **FULL TRANSLATION SUPPORT**. Pretty much every single message in Heroes is now translatable via a file created by the plugin called `translations.yml`! The only exceptions is that some commands are not translatable, the majority of the most used ones are! We will be finishing off the rest of the commands in future updates to come! This was a major undertaking, with the translation file featuring literally over 400 messages which used to be hard coded into Heroes, so understandably there may be some small typos or errors - please let us know if you come across any!
When **configuring** the translations. There are few little tricks you can do to further customize Heroes;
- For many translations, mainly those which are sent to the player as a message, if you configure the translation such that `some-translation: ''` (such that it's empty), this will mean that the message simply will not be sent! This means for example for those of you which don't use races or don't use secondary classes, you can simply set those options to an empty string and then those messages won't be sent. For example, see the below translations which are used mainly for the /hero info command.
HEROES VERSION 1.9.25-SNAPSHOT
Scriptable Skills (Mythic Skills)
Added Mythic Skills which means Heroes now FINALLY has scriptable skills! You do require MythicMobs for this to work as it essentially casts a MythicMob skill as a Hero. You can configure stamina, mana, reagent costs - cooldowns, delays and all! At the moment, the one limitation is that Mythic Skills do not support increases per attributes unfortunately since Mythic Mobs is what handles the damage calculations. (This could be solved with a custom Heroes damage mechanic, but maybe thats for later). A new file called script-files should be generated after booting your server with this update. There are 3 examples in there of Mythic Skills with an in-depth explanation of how it works.
Custom Heroes Mythic Mechanics and Conditions
Since we are dealing with Mythic Mobs more directly in Heroes, we have added 1 condition and 4 new mechanics for your usages.
The condition 'heroestarget{type=?}' should be used on mythic skills to help mythic target the correct mobs. This is explained further in the script-skills.yml file.
The ? can be replaced with either ALLY, ENEMY, SELF, or ALL.
The mechanic 'drainstamina{amount=50}/drainmana{amount=50}' will drain the target's stamina/mana if they are a player by the specified amount. This can be used in mythic skills or by a mythic mob.
The mechanic 'drainstaminaovertime{amount=20;duration=6000;period=1000}/drainmanaovertime{amount=20;duration=6000;period=1000}' will drain the target's stamina/mana by the specified 'amount' if they are a player for every 'period' over the specified 'duration'. This can be used in mythic skills or by a mythic mob.
Scriptable Skills (Mythic Skills)
Added Mythic Skills which means Heroes now FINALLY has scriptable skills! You do require MythicMobs for this to work as it essentially casts a MythicMob skill as a Hero. You can configure stamina, mana, reagent costs - cooldowns, delays and all! At the moment, the one limitation is that Mythic Skills do not support increases per attributes unfortunately since Mythic Mobs is what handles the damage calculations. (This could be solved with a custom Heroes damage mechanic, but maybe thats for later). A new file called script-files should be generated after booting your server with this update. There are 3 examples in there of Mythic Skills with an in-depth explanation of how it works.
Custom Heroes Mythic Mechanics and Conditions
Since we are dealing with Mythic Mobs more directly in Heroes, we have added 1 condition and 4 new mechanics for your usages.
The condition 'heroestarget{type=?}' should be used on mythic skills to help mythic target the correct mobs. This is explained further in the script-skills.yml file.
The ? can be replaced with either ALLY, ENEMY, SELF, or ALL.
The mechanic 'drainstamina{amount=50}/drainmana{amount=50}' will drain the target's stamina/mana if they are a player by the specified amount. This can be used in mythic skills or by a mythic mob.
The mechanic 'drainstaminaovertime{amount=20;duration=6000;period=1000}/drainmanaovertime{amount=20;duration=6000;period=1000}' will drain the target's stamina/mana by the specified 'amount' if they are a player for every 'period' over the specified 'duration'. This can be used in mythic skills or by a mythic mob.
Custom Health Regen
A new section has been added to the config.yml called 'health'. This should automatically generate after booting your server with the new update. This will add a constant static regeneration effect to all players, similar to how mana and stamina generate. You can customise how often it regenerates, a regen-multiplier when in combat. You can even make it so it only regenerates when food is full. These can be configured by default in the config.yml or individually in classes, and support regen increases per level just like the other stats. As usual, by default this is turned OFF, simply set enabled: true in the health section to enable the feature.
Default Max Stats and Regen
Added a config option to set the default max health, stamina and mana. Similarly a default regen for health, mana and stamina has also been added to config.yml. These values will be used if NO stat is configured in the class.yml file.
Heroes Food Change
Changed the time-multiplier setting in config.yml to be read as milliseconds instead of seconds so that this is consistent with literally all the other config settings. If this value is set to less than 100, you'll get a warning saying you have set it incorrectly, and Heroes will convert the value into milliseconds for you.
MMOItems Additions
Added a heroes-health-regen stat to MMOItems to match with the mana and stamina ones. Added an optional stat to MMOItems called penetration. You can choose to use this in the experimental-features tab. If you set use-mmoitems-penetration to true, then the amount of penetration a weapon will do will now be dependent on the MMOItem's penetration stat on the weapon NOT what is configured in the config.
A new section has been added to the config.yml called 'health'. This should automatically generate after booting your server with the new update. This will add a constant static regeneration effect to all players, similar to how mana and stamina generate. You can customise how often it regenerates, a regen-multiplier when in combat. You can even make it so it only regenerates when food is full. These can be configured by default in the config.yml or individually in classes, and support regen increases per level just like the other stats. As usual, by default this is turned OFF, simply set enabled: true in the health section to enable the feature.
Default Max Stats and Regen
Added a config option to set the default max health, stamina and mana. Similarly a default regen for health, mana and stamina has also been added to config.yml. These values will be used if NO stat is configured in the class.yml file.
Heroes Food Change
Changed the time-multiplier setting in config.yml to be read as milliseconds instead of seconds so that this is consistent with literally all the other config settings. If this value is set to less than 100, you'll get a warning saying you have set it incorrectly, and Heroes will convert the value into milliseconds for you.
MMOItems Additions
Added a heroes-health-regen stat to MMOItems to match with the mana and stamina ones. Added an optional stat to MMOItems called penetration. You can choose to use this in the experimental-features tab. If you set use-mmoitems-penetration to true, then the amount of penetration a weapon will do will now be dependent on the MMOItem's penetration stat on the weapon NOT what is configured in the config.
Heroes API
- IMPORTANT UPDATE FOR DEVELOPERS
We have finally updated our public repository for Heroes! This current version includes the latest API changes and is the same as the free version of Heroes available. You can setup a maven dependency as such.
FAQs / Untested / May have Issues
Q: Does Heroes work with Citizens?
A: Sorta.- Citizens - (NPCs loaded as playerObjects cause some conflicts - contact Citizen for possible fixes) Full support would require a major rewrite of Heroes Framework on how we load/save classes. Avoid using Citizens named as players on your server.
Q: Can I use /reload or reload plugins with Heroes Premium?
A: "/reload" will cause instability with the class manager. Do not use /reload. Spigot recommends not using it ever.
Q: What permission systems do you use or recommend?
A: We recommend using LuckPerms or zPerms. GM & PEX permission systems are untested/unsupported, YMMV.
Q: Can I use other RPG systems (like Mcmmo) with Heroes?
A: Most plugins will load and not cause errors, there may be some philosophical overlap due to both being "RPG" plugins.
Q: Does 1.7 and 1.8 versions work on Heroes Premium
A: 1.7 and 1.8 may have some issues. The more advanced skills may not function properly unless compiled against these versions. 1.8.8 is the only supported 1.8 build.
Q: Is Bukkit Supported?
A: Craftbukkit is NOT supported. You should use Spigot or PaperSpigot.
Q: Is there a language file with Heroes? Can you translate it
A: We DO have a full language file, these sections can be customized in (translations.yml)
Q: Can I localize the skill descriptions?
A: Yes. You can do this in skills.yml by editing the Description section.
Q: Can I turn off stamina and use the food system?
A: Yes. You can do this in config.yml by editing the appropriate section.
Please paste2.org your start-up log and any error that's relevant! Include server/heroes version.
NEW Review --- Spigot is REQUIRD
NEW Review --- Spigot is REQUIRD
