FANDOM


Heroes-Master

Welcome to the Heroes WikiEdit

ObjectivesEdit

  • Full encompassing RPG system
  • Level & Advancement based on experience
  • Highly configurable
  • As lightweight as possible

FeaturesEdit

  • Classes
    • 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
  • Permitted Skills
    • Skills in the base platform of Heroes
    • All permitted skills start with /skill <skillname>
      How to install Heroes 1.212:21

      How to install Heroes 1.2.5 for Bukkit 1060-1337

      Heroes - Bukkit RPG Plugin01:36

      Heroes - Bukkit RPG Plugin

    • Allows for developers to add in their own code for new skills
    • Adjustable through skills.yml or overwritten in classes.yml
  • 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 copy the original command exactly
    • Also works with non-command required Permission nodes (ie. Firelord for special armor abilities for certain classes)
  • Binding 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
  • Inventory Restrictions
    • Armor & Weapon restrictions based on class
    • Configurable in classes.yml
  • 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
  • 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 classes.yml
  • Mana
    • /mana - shows the current amount of mana - caps at 100%.
    • Server wide regen of mana - default is 5% mana regen every 5-6 seconds
    • Configurable mana regen rate
  • Parties
    • EXP-Sharing - on/off
    • PVP - on/off
    • Bonus Exp per extra party member
    • Group-Skills
    • Volatile

Plugins that Support HeroesEdit

PermissionsEdit

Heroes supports Permissions3 and SuperPerms.

  • heroes.classes.*
    • Choose all classes
  • 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.health
    • Set a player's health
  • heroes.admin.reload
    • Reload configuration files
  • heroes.admin.saveall
    • saves all online heroes
  • heroes.scroll
    • allows players to use Heroes SMS Scrolls
  • heroes.bind
    • allows players to bind skills to items

Config.yml ExampleEdit

leveling:
    power: 1.0
    maxExperience: 100000
    maxLevel: 50
    expLoss: 0.10
    max-tracked-blocks: 2000
    block-tracking-duration: 900000
    resetExpOnClassChange: true
    swapMasteryCost: false
    partyBonus: 0.20
    levelsViaExpLoss: false
    masteryLoss: false
properties:
    iConomy: false
    swapcost: 0
    debug: false
    useDamageSystem: true
bed:
    bedHeal: true
    healInterval: 15
    healPercent: 5
mana:
    regenInterval: 5
    regenPercent: 5
default:
    level: 1 
    allowHatsPlugin: false
    prefixClassName: false
    resetOnDeath: false
mappartyui:
    id: 1
    enabled: true
    packetinterval: 20
worlds:
    disabledWorlds: ['World1', 'World2', 'World3']

ExplanationEdit

leveling

  • power -set this to adjust the EXP curve (higher numbers equal longer ending levels)
  • maxExperience - adjusts the maximum xp a player can have
  • maxLevel - the maximum level a player can attain - this also is the standard mastery level
  • expLoss - xp multiplier that a player loses when dying
  • max-tracked-blocks - number of blocks to track to prevent players from repeatedly mining/placing the same block for xp farming
  • block-tracking-duration - how long a block is tracked for.
  • resetExpOnClassChange - if true, a players XP will reset when changing classes if they have not mastered that class
  • swapMasteryCost - if false players will not be charged when swapping back to a mastered class
  • partyBonus - xp multiplier bonus while in a party
  • levelsViaExpLoss - allows a player to lose levels when losing XP
  • masteryLoss - allows a player to lose mastery levels when losing XP

properties

  • iConomy - whether to use economy for class choosing
  • swapcost - how much to charge players for choosing a class
  • debug - turns debug mode on/off -
  • useDamageSystem - turns the heroes damage system on/off - Some skills/Effects rely completely on the damage system!

bed

These settings affect how much hp a player regains while resting, how many seconds they must wait to regain health, and the percent of health regained each interval. useDamageSystem must be true for this to work.


mana

regenInterval adjusts the number of seconds between mana regeneration. Players will regain the amount specified for regenPercent


default

Most of these settings are currently unused, see below for ones that are.


resetOnDeath

This is 'hardcore' mode. If set to true, a player will lose all XP when they die, resetting them back to level 0.


mappartyui

These settings control if the map party UI is enabled, and how often to update it. The id is the map ID to use for sending the partyUI.


disabledWorlds

This disables Heroes on the specified worlds. If your worlds are in a seperate folder, include the path. E.g. 'worlds/world1'

Command ListEdit

General CommandsEdit

/hero - /heroes
/hero help
/hero armor
/hero choose <path>
/hero paths
/hero reset
/hero armor
/hero tools
/hero save
/hero skills - /skills
/hero specs
/hero leaderboard
/hero who <player>
/hero verbose
/level - /hlevel - /lvl
/mana
/health - /hp
/cooldowns - /cd
/bind
/bind <skill>

Admin CommandsEdit

/hero admin class <player> <class>
/hero admin exp <player> <amount>
/hero admin hp <player> <amount>
/hero admin reload
/hero admin saveall

Skill CommandsEdit

/skills - /skilllist
/skill <skill> <args>

Party CommandsEdit

/party invite <player>
/party accept <player>
/party leave
/p <message>
/mode +[option]
/mode -[option]
/party ui
/party who

ExperienceEdit

OverviewEdit

Experience is how Heroes gain levels. Currently there are six different sources of gaining experience: Skills, Crafting, Mining, Killing, Logging, and PvP. 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.

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

Default ConfigurationEdit

killing:
    chicken: 1
    cow: 1
    creeper: 23
    ghast: 50
    pig: 1
    pig_zombie: 40
    sheep: 1
    wolf: 6
    skeleton: 22
    spider: 18
    zombie: 15
    squid: 1
    slime: 15
    giant: 300
    player: 31
mining:
    coal: 5
    cobblestone: 1
    clay: 15
    diamond_ore: 15
    dirt: 1
    glowstone: 5
    gold_ore: 3
    coal_ore: 6
    grass: 1
    gravel: 1
    iron_ore: 3
    lapis_ore: 7
    mossy_cobblestone: 2
    netherrack: 1
    obsidian: 20
    redstone_ore: 8
    glowing_redstone_ore: 8
    sand: 1
    sandstone: 1
    snow_block: 1
    soul_sand: 8
    stone: 1
logging:
    log: 3
crafting:
    Arrow: 1
    Bed: 1
    Boat: 1
    Book: 0
    Bookshelf: 5
    Bow: 3
    Bread: 0
    Brick: 10
    Bucket: 2
    Cake: 15
    Chest: 1
    Cobblestone_Stairs: 0
    Compass: 4
    Cookie: 2
    Detector_Rail: 5
    Diamond_Axe: 17
    Diamond_Boots: 15
    Diamond_Chestplate: 20
    Diamond_helmet: 15
    Diamond_Hoe: 8
    Diamond_Leggings: 18
    Diamond_Pickaxe: 12
    Diamond_Spade: 8
    Diamond_Sword: 10
    Dispenser: 3
    Fence: 0
    Fishing_Rod: 6
    Flint_and_steel: 1
    Furnace: 1
    Golden_Apple: 100
    Gold_Axe: 25
    Gold_Boots: 20
    Gold_Helmet: 20
    Gold_Hoe: 20
    Gold_Leggings: 30
    Gold_Pickaxe: 30
    Gold_Chestplate: 40
    Gold_Spade: 10
    Gold_Sword: 20
    Iron_Axe: 6
    Iron_Boots: 8
    Iron_Chestplate: 12
    Iron_Door: 3
    Iron_Helmet: 6
    Iron_Hoe: 4
    Iron_Leggings: 10
    Iron_Pickaxe: 6
    Iron_Spade: 4
    Iron_sword: 5
    Jukebox: 1
    Ladder: 0
    LEATHER_HELMET: 4
    Leather_leggings: 6
    LEATHER_CHESTPLATE: 8
    Leather_Boots: 4
    Lever: 0
    Minecart: 2
    Map: 10
    Note_Block: 1
    Painting: 1
    Paper: 0
    Powered_Rail: 10
    Rails: 1
    DIODE: 3
    REDSTONE_TORCH_OFF: 0
    REDSTONE_TORCH_ON: 0
    Sandstone: 0
    Sign: 2
    Stick: 0
    Stone_Button: 0
    Stone_Axe: 2
    Stone_Hoe: 1
    Stone_Pickaxe: 2
    Stone_Plate: 0
    Stone_Spade: 1
    Stone_sword: 2
    Storage_Minecart: 3
    PISTON_STICKY_BASE: 5
    Sugar: 0
    TNT: 5
    Torch: 0
    Trap_door: 1
    Wood_Axe: 1
    Wood_Door: 2
    Wood_Hoe: 1
    Wood_Pickaxe: 1
    Wood: 0
    Wood_Plate: 0
    Wood_Spade: 1
    Wood_Stairs: 0
    Wood_sword: 1

SkillsEdit

Skill ConfigurationEdit

In the skills.yml you'll have skill definitions like this. This is where you set server-wide feault values for the skills.

Confuse:
    duration: 10000
    max-distance: 15
    apply-text: '%target% is confused!'
    use-text: '%hero% used %skill% on %target%!'
    period: 1000
    max-drift: 0.35
    reagent: BONE
    reagent-cost: 2
    health-cost: 1
    expire-text: '%target% has regained his wit!'

In the classes.yml you'll have a section in your class like this.

classes:
    Mage:
        permitted-skills:
            Confuse:
                level: 2
                mana: 10
                duration: 20000
                cooldown: 30000

These settings will override the default values found in the skills.yml and help customize different classes Skills.

Official SkillsEdit

  • Absorb - Converts all damage into mana
  • Antidote - Cures you of Poisons!
  • Assassin's Blade - Poisons your weapon, applying the poison on the next strike
  • Backstab - Extra damage when attacking from behind
  • Bandage - Bandages the target + Cures Bleeds
  • Barrage - Fire a Barrage of Arrows around you.
  • Battery - Gives your target mana
  • Bite - You bite your opponent ferociously!
  • Blackjack - Occasionally stuns your opponent
  • Bladegrasp - Blocks incoming melee damage
  • Blaze - Sets everyone around you on fire
  • Bleed - Causes your target to bleed
  • Blink - Teleports you 4-5 blocks
  • Bolt - Calls a bolt of thunder down on the target
  • Boltstorm - Calls down bolts periodically
  • ChainLightning - Calls down a bolt of lightning which bounces to nearby targets
  • Chakra - Group heal that also removes harmful effects
  • Chant - Single-target heal
  • Charge - Charges towards your target
  • Confuse - Confuses your target
  • Construct - Alternative recipes - many items to one
  • Consume - Sacrifice an item for mana
  • Curse - Your target has a chance to miss their attacks
  • Decay - You disease your target
  • Deconstruct - Destroy items for their materials - one item to many
  • DeepFreeze - Root your target in ice, and cause them to be susceptible to fire damage
  • Dispel - Removes effects from your target
  • Drainsoul - Absorb health from target
  • ExplosiveFireball - Hurl a massive exploding fireball
  • FireArmor - Attackers are lit on fire!
  • Firearrow - Shoots a burning arrow
  • Fireball - Shoots a dangerous ball of fire
  • Flameshield - Fire can't hurt you!
  • ForcePull - Yank a target toward you
  • Forcepush - Forces your target backwards
  • Gills - Negate drowning damage
  • GroupHeal - Heals all party members nearby
  • GroupTeleport - Summons your group to your location
  • Harmtouch - Deals direct damage to the target
  • Hellgate - Teleports you and your nearby party to or from the nether
  • Icebolt - Fires a snowball that hurts the player and if they're on fire puts them out
  • IcyAura - Periodically damage players around you, and turns the ground they walk on to ice
  • Invuln - Grants total damage immunity
  • IronFist - Slam the ground knocking back and dealing damage to nearby enemies
  • Jump - Launches you into the air
  • Layhands - Heals the target to full
  • LickWounds - Heals your nearby wolves
  • Manaburn - Burns the targets mana
  • ManaFreeze - Stops your target regening mana
  • ManaShield - Uses your mana as a shield
  • Might - Increases party members damage
  • MortalWound - Strike the target with your weapon, and cause them to bleed in addition to limiting heals
  • Overgrowth - turns a sapling into a tree
  • Piggify - Forces your target to ride a pig
  • Poison - Poisons the target
  • PoisonArrow - Your arrows will poison your targets.
  • Port - Teleports you and your nearby party to the set location!
  • Pray - Heals the target
  • Pulse - Damages everyone around you
  • Recall - saves a location and lets you teleport back to it
  • Reflect - Reflects all the damage done to you back to your target
  • Replenish - Brings your mana back to full
  • Revive - Teleports the target to their place of death
  • Root - Roots your target in place
  • Safefall - Stops you from taking fall damage for a short amount of time
  • SafefallOther - Stops your target from taking fall damage for a short amount of time
  • Shield - Your shield absorbs damage!
  • Skeleton- Summons a Skeleton to fight by your side
  • Smite - Direct damage on a player
  • Smoke - You completely disappear from view
  • Sneak - Hides your nameplate and makes you sneak without holding shift
  • SoulFire - your attacks have a chance to set your target on fire
  • Superheat - Your pickaxe becomes superheated
  • SummonArrow - Summons you some arrows!
  • Summonfood - Summons you food!
  • Syphon - Gives your health to the target
  • Taunt - Taunts enemies around you
  • Telekinesis - Activate levers buttons and other interactable objects from afar!
  • Teleport - Teleports you to (roughly) to your party member!
  • Track - Locates a player
  • UnholyRitual - Target Zombie or Skeleton is sacrificed, necromancer receives mana
  • Web - creates webs around the target
  • Wolf - Summons and tames a wolf to your side
  • XMuteOre - Transmutes ores into more valuable ones
  • For download this skills please

Public SkillsEdit

ClassesEdit

OverviewEdit

Classes (also known as HeroClasses) are the foundation which Heroes is built upon. We decided not to hard-code classes and instead, let the admin create their own. Classes allow admins to choose what weapons, armor and skills a person can use! You can have leather wearing rogues, a fireball throwing iron wearer or even a vagrant who can only afford wooden weaponry!

Our class system allows for a "2-tier" hierarchy. This means, you can have a profession and once you reach a certain level and want to, you can advance to your next profession! This could get tricky though, remember. Professions = 1st class | Specialties = 2nd class.

ConfigurationEdit

To configure your class file, open it up with an editor like Notepad++ and you should see the following:

classes:
    Warrior:
        default: true
        permitted-armor: [IRON, DIAMOND_BOOTS, DIAMOND_HELMET]
        permitted-weapon: [WOOD, IRON_SWORD, IRON_SPADE, IRON_PICKAXE]
        permitted-skills:
            Skill:
                skill options: data
        experience-sources: [KILLING]
        base-max-health: 20
        max-health-per-level: 0.1
        expmodifier: 1.0
        expLoss: .05
        parent:
        parents:
            strong: [ OtherClass ]
            weak: [ someotherclass ]
        item-damage:
            AIR: 1
        projectile-damage:
            ARROW: 5

Please, remember. Much like any other YML document, this requires four spaces, like so " " not a tab.

Firstly, ignore the "classes:", you don't need to know what that is. Now, to create a new class you'll need to know what each element means and does.

Warrior:

The above is the class name. This identifies the class to the player when they're trying to select the class. Meaning, this needs to be something readable and typable in minecraft. So please avoid long names such as "warriormagesoawesomelolololo" as this won't be typable with the rest of the commands. This is needs to be unique, so no duplicate warrior classes.

default:

This denotes the default class, meaning that when the player first logs in, this will be their class. This is a true or false value. False if this is a non-default class and true if it is.

permitted-armor:

This is the types of armor that are allowed. It only does material types at the moment, meaning that it can't stop people from using helmets or boots, but will stop those pesky rogues being over powered by wearing diamond armor. It accepts these values:

DIAMOND
IRON
GOLD
LEATHER

Optionally paired with these Descriptors:

HELMET
CHESTPLATE
LEGGINGS
BOOTS

permitted-weapon:

Much like "permitted-armor", this is the types of weapons users in the class can use. Anything not on the list, the person cannot use. It only accepts these values

WOOD
STONE
IRON
GOLD
DIAMOND

optionally paired with these types:

PICKAXE
AXE
HOE
SPADE
SWORD

permitted-skills

This is the skills the person is allowed to use. Only skills put inside this will be available to the player. There will be a list of Skills after running the plugin for the first time. Generated in the file itself.

experience-sources:

Experience sources is where the player gets their experience from. There are three types of experience sources, KILLING, MINING and LOGGING. Killing is for PVP/PVE, Mining is for all rock related breaks and LOGGING is for tree cutting.

item-damage

This is the list of damage values for the items that can be used as weapons by this class. Any material you define here will use the value sepcified for that item, rather than the default damage value.

projectile-damage

This sets the damage this class does with certain projectiles. Currently only SNOWBALL, ARROW, and EGG are supported. Itworks just like item-damages but adjusts projectile damage instead.

base-max-health

The amount of maximum HP the class has at level 1.

max-health-per-level

The amount of maximum health added to the class per level beyond the first.

expmodifier

All xp a hero gains are multiplied by this amount. That means that a value of 1.0 will result in no xp alterations, a modifier of .5 will halve all exp, and a value of 2.0 will double all exp. This is generally for making it require less, or more, experience to get through different classes.

parent:

This tag isn't needed, but it can be added. Parent puts the class as a specialty and links it to its parent. It's recommended you put these at the bottom of your YML document, so they will be loaded last. The value needs to be a different class name. E.g. parent:Warrior

parents

There are 2 sub-settings for parents. Weak and Strong. These options are intended to allow more flexibility in what classes are required before a player can go into another class. A player must have mastered ALL classes in the strong parent list before being able to join the class. Weak parents only require the player to master one of the classes listed to meet the requirements. A class can have both Strong and Weak parents. It will require all of the strong parents to be mastered and only one of the weak parents. This only works in 1.3.0+

expLoss:

This settings enables the alternative experience loss multiplier. A player will lose experience equal to the current level's required experience * expLoss.

Default DocumentEdit

classes:
    Vagrant:
        default: true
        description: The vagrant, starter PATH
        permitted-armor:
        - '*'
        permitted-weapon:
        - '*'
        permitted-skills:
            ALL:
        experience-sources:
        - KILLING
        permission-skills:
            Example:
                level: 1
                usage: This is an EXAMPLE!
                permissions:
                - plugin.example.node.here
        base-max-health: 20
        max-health-per-level: 0.1
        expmodifier: 1.0
        item-damage:
            air: 1
        expLoss: 0
    Warrior:
        default: false
        description: Skilled in Defense Combat and Heavy Armor
        permitted-armor:
        - LEATHER
        - CHAINMAIL
        - IRON_CHESTPLATE
        permitted-weapon:
        - WOOD
        - STONE
        - IRON_PICKAXE
        permitted-skills:
            Taunt:
                level: 5
                mana: 75
                cooldown: 30000
            Fireball:
                level: 10
                mana: 20
                cooldown: 3000
            Manaburn:
                level: 20
                mana: 30
                cooldown: 40000
        experience-sources:
        - KILLING
        - MINING
        - PVP
        - CRAFTING
        - LOGGING
        - SKILL
        expmodifier: 1.5
        expLoss: 0.05
    Paladin:
        default: false
        parent: Warrior
        description: Divine Knight
        permitted-armor:
        - IRON
        - CHAINMAIL
        - GOLD
        permitted-weapon:
        - WOOD
        - GOLD
        - STONE
        - IRON_PICKAXE
        permitted-skills:
            Layhands:
                level: 10
                mana: 100
                cooldown: 30000
                exp: 5
            Invuln:
                level: 40
                mana: 100
                cooldown: 500000
            Revive:
                level: 50
                mana: 100
                cooldown: 60000
            Taunt:
                level: 1
                mana: 20
                cooldown: 3000
            Dispel:
                level: 1
                mana: 5
                cooldown: 2000
        experience-sources:
        - KILLING
        - PVP
        - SKILL
        expmodifier: 1.0
        expLoss: 0.1
    Shadowknight:
        default: false
        parent: Warrior
        description: Dark Knight
        permitted-armor:
        - LEATHER
        - DIAMOND_LEGGINGS
        - IRON
        - CHAINMAIL
        - GOLD
        permitted-weapon:
        - WOOD
        - GOLD
        - STONE
        - IRON_PICKAXE
        permitted-skills:
            Layhands:
                level: 10
                mana: 100
                cooldown: 30000
            Invuln:
                level: 40
                mana: 100
                cooldown: 500000
            Revive:
                level: 50
                mana: 100
                cooldown: 60000
            Taunt:
                level: 1
                mana: 20
                cooldown: 3000
            Fireball:
                level: 1
                mana: 5
                cooldown: 2000
                exp: 1
            Manaburn:
                level: 1
                mana: 50
                cooldown: 3000
        experience-sources:
        - KILLING
        - PVP
        - SKILL
        expmodifier: 1.0
        expLoss: 0.05

PartiesEdit

OverviewEdit

Parties is one of the best parts of Heroes. Parties allows a group of players to join together and fight with or against each other. Parties can be setup to share experience, and can protect those in your party from your damaging attacks and spells.

Parties are entirely made in game, and once the leader leaves, the party is disbanded. Below is each feature for parties:

Command ListEdit

/party invite <player>
/party accept <player>
/party leave
/p <message>
/mode +[option]
/mode -[option]
/party ui
/party who

PVPEdit

This means that PvP between the players in the party is toggled. If PVP is on, players can attack each other that are in the party and if PvP is off then they can't. This is useful for group projects, so you don't accidentally mine the head off of your friends. It's used like this:

  • /mode +pvp

and to remove it

  • /mode -pvp

ChatEdit

We've implemented a command which sends messages to those in your party only! With this, you can scheme and even plan to attack other parties. Secrets can be shared this way. The command is used like this:

  • /p Hello party, how are we doing today?

This will return:

  • [p]RightLegRed: Hello party, how are we doing today?

Experience ShareEdit

Along with the other two features, we've added experience sharing. This means that players get a share of all the experience you get. Don't fear, everyone shares! The command is used like this:

  • /mode +exp

and to remove it

  • /mode -exp

Latest activityEdit

Ad blocker interference detected!


Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.