Skills - CryptoMorin/SkillsPro GitHub Wiki

Each player can have a skill (class) and each skill can have multiple abilities (improvement). There are 2 types of abilities passive and active and there are 2 types of active abilities; instant and non-instant.

Players can choose a skill from the /skill select GUI. To start using an ability, you need to unlock and upgrade it. You'll have level up in order to unlock some abilities. To upgrade an ability, go to /skills improve GUI.
By default, your XP, stats and level are separated for different skills.

Skills XP is completely separated from Vanilla XP and can be gained by killing mobs. You can configure how much XP each mob will give based on different conditions in config.yml -> xp section. You'll also lose some XP when you die. Skills XP is mainly used for leveling up. Your XP is synced with the bossbar and vanilla XP by default and shown in the actionbar. You can change all the behaviour in config.yml

Souls are skills currency. You can get souls from killing mobs. By default, killing anything will give you one soul. You can configure how much souls each mob will give based on different conditions in config.yml -> souls section. You'll also lose a few souls when you die.
Souls are mainly used for upgrades such as /skills improve and /skills mastery

Stats are basically variables used in ability equations to make them stronger. You can upgrade your stats in /skills stats GUI. If an ability's equation depends on a specific stat, the number for that equation is colored based on the stat color (which can be found in config.yml -> stats section) in the /skills improve GUI. If an ability depends on multiple stat types, the color is the first stat that can be found in the equation.

Each skill (class) can have multiple abilities. There are 2 types of abilities passive and active
Players need to unlock and upgrade the ability from /skills improve GUI in order to use them. You can also disable specific abilities in the GUI.

If an ability is not working make sure:

• The ability is unlocked and upgraded.
• You did not disable the ability from the GUI. When it's gray, it means it's deactivated.
• For active abilities, you have enough energy.
• For active abilities, you're not in a cooldown.
• For active abilities, you're performing the activation keys quickly and correctly.

Passive abilities are always active and do not require manual activation from the user. They activate on certain player activities such as attacking, breaking or placing blocks or even moving.

Active abilities require manual activation from the user in order to work. There are two types of active abilities, instant and non-instant These abilities are activated by performing the activation keys for abilities.

Activation Keys

• L left-click
• R right-click
• Q drop item
• S sneak
• C<key> sneak while pressing

Instant active abilities instantly activate without requiring a specific target. Priest's Asclepius, Mage's Energy Flux and Eidolon's Blackhole are examples of these kinds of abilities.

Non-instant active abilities require the player to attack a specific player after activating the ability using the activation keys to activate completely. These abilities need specific targets to function correctly.
When a non-instant ability activates, it goes into ready state. These are some signs when abilities go into ready state.

• A purple particle will start appearing from your right hand.
• Your action bar will completely change to a new one with a new red design.
• A sound will play similar to equipping armor.

If you do not hit a target within the next few seconds, it'll go out of ready state and you'll have to activate the ability again.

Masteries are a small replacement for McMMO and Jobs. While they have a similar behaviour, it doesn't completely replace them with all their features. They're basically passive abilities that are available for all the players, even those without a skill. You can upgrade your masteries from /skills mastery command.

Skills has a small built-in party system. This system provides basic features such as PvP protections, friend teleportation and party chat. It's also used for some instant active abilities such as Priest's Asclepius to distinguish friends from enemies. This is useful when you don't have a Factions/Towny/Kingdoms plugin or just want to blacklist certain players from getting harmed by your abilities. It's also useful to stop adding support for every single party or friends plugin out there. Being in a party also has the advantage of distributing your gained XP and souls to your party members.