Skills
[ Main | Guide | Races | Classes | Skills | Default Skills | Effects | Skill Anatomy | Cmds | Perms ]
Skill Configuration
Skills.yml contains the "default" settings for skills. Classes and Races skill settings override these defaults.
Each skill config or permskill config consists of one ore more skill definitions like this..
permskills: fly: skillname: fly description: "Fly for 1 minute" type: ACTIVE level: 10 requires: SomeSkill requiresOne: - listOfSkills - oneOfWhich - mustBeOwned cost: 0 manaCost: 10 buildup: 1000 delay: 1000 cooldown: 60000 duration: 60000 pay: 1000 xp: 100 karmaCost: 0 karmaReward: 10 karmaRequired: 1000 needPerm: someperm.possibly.from.quest.reward consumes: FEATHER consumesqty: 2 perm: essentials.fly startcommand: "fly on" endcommand: "fly off"
The above uses all the possible setting to make a complete, if rather dubious in application, skill. And here's a smaller example of config for a LegendQuest Skill.
skill: summonpiggy: skillname: summon level: 5 cost: 0 manaCost: 100 cooldown: 60000 vars: qty: 2 entity: pig hatching: skillname: summon level: 15 cost: 0 manaCost: 100 cooldown: 60000 vars: qty: 10 entity: chicken
Here's what all the parts do.
The two sections skill:
and permskills:
are for two different types of skill. skill:
is for LegendQuest skills consisting of custom .jar files in the /plugins/LegendQuest/skills/
folder. permskills:
allows you to assign permissions and run regular plugin commands for a player to use them as skills.
Each skill has a name, for now these must be unique - but in future where the same name is re-used then the skill will be "upgraded" the the higher level/cost as you level up.
Inbuilt skills in the skill:
section have a skillname
value. This is the name of the skill file to use for this skill in the /skills/
folder, allowing you to have several implementations for the same skill, like the above example with two instances of the summon skill.
skill:
section also allows a var:
section to hand settings over to override the skills defaults. The values of these vary per skill and can be found in the skill defaults page.
Description
- Description of the skill as seen in /skill <name> info.
level
- The level at which this skill 'unlocks' use 0 for always available skills.
cost
- The number of skill points needed to buy this skill. Skills with 0 cost unlock at their level. Skills with cost and level are only available to "buy" once the level has been first reached.
requires
- If listed, all of the skills in this list must be owned before this skill is unlocked.
requiresOne
- If listed, one of the skills in this list must be owned before this skill is unlocked.
type
- One of PASSIVE, ACTIVE or TRIGGERED. Passive skills are always on and ignore buildup, delay, duration and cooldown. Active skills are triggered by events, Triggered skills by linked items or the
/skill
command. PermSkills require this, native skills only read this if they have dual type ability.
manaCost
- The amount of mana expended to use this skill. This mana is paid when the skill enters the active phase (after any build up or delay).
consumes
- This is a Material type that is required to use the skill. Which is removed when the skill becomes active.
consumesqty
- This is the amount of the Material type that is required to use the skill.
pay
- Amount of cash to pay to use this skill.
xp
- Amount of XP awarded for using this skill.
karmaCost
- Amount of karma to lose to use this skill
karmaReward
- Amount of karma to recieve when using this skill.
karmaRequired
- Amount of karma required before using this skill. If negative then current karma must be bellow this figure.
needPerm
- Set a requirement for having a permissions node to use this skill.
buildup
- The amount of time (in milliseconds) that the player must stand still before the skill triggers. Moving during this time cancels the skill.
delay
- Amount of time (in milliseconds) to wait before triggering the skil. Note that the skill triggers AFTER this delay (and any buildup) so be aware that skills that use line of sight for targeting will trigger after this delay and use the LoS at that time - not when the skill is first triggered.
duration
- Amount of time (in milliseconds) that the skill is active for. At the start of this time
manaCost
andconsumes
are paid, and thecommand
orstartcommand
is executed. During the duration time period theperm
(if any) permission node is applied to the player.
cooldown
- Amount of time (in milliseconds) before skill can be reused. At the start of this time period, any
perm
is removed andendcommand
is executed.
perm
- The permissions node to add to the player during the duration. (or permanently if type is set to PASSIVE).
perms
- A list of permissions nodes to add to the player during the duration. (or permanently if type is set to PASSIVE).
command/startcommand
- These are interchangeable. This is the command to be run as the player on start of the duration period.
endcommand
- This is the command to be run as the player on end of the duration. This allows for on/off toggle skills to be used.
Can you add a skill list or some list with all names of available spells which we can use ?
@Broxigaar32
Skill pack 1.0 has brawl, dodge and summon.
I'm uploading skill pack 3 (2 was mistakenly rejected) with dodge, brawler, summon, shoot, hex, enchant, aura, stun and weaponmaster.
The skills can be used with the skillname property above to make multiple variants.
for example you can see the two variants of summon above to product a "summonpigg" and "hatching" skill from the one root.
I'll put up a listing for the skill packs once its approved by bukkit, but in summary:
dodge: reduce/evade damage
brawler: increase melee/bare hand damage
summon: spawn an entity
shoot: fire a projectile
hex: inflict an effect on target in combat
enchant: apply effect to an area
aura: apply effect to self
stun: stun enemies in combat
weaponmaster: damage bonus when using listed weapons.
Where are these packs? I'm looking all over and I can't find them :( I'm sure I'm just overlooking them though. I did find that DefaultSkills1.3.jar thing but I threw that on my server and restarted but don't see any file anywhere with the skills in them.
im so confused on how to setup the skills and what they do, for example weapon master how and what does this do.
Yes please explain how to load your skills a bit more indepth
Hey, this is a great Plugin, i really like it.
but because you can configurate so much, its a bit different. :/
I wanted to give a class a passive Spell / Aura, so they can move always faster.
this is in my class.yml schnell: level: 0 cost: 10 perm: essentials.speed.walk command: speed walk 3 endcommand: speed walk 1 type: PASSIVE Where is the Problem? :/ can't find it :/
and if i want to use the essentials command ./effect the usage would be ./effect <player> <effectid> <duration> <strenght>
how would i use this command @spells? command: effect <????> speed 10 5 for example, what can i use for the <player> so your plugin knows that it hast to fill the player name into the command?
Hope u get what i want and understand what i mean :)
whatsoever, amazing plugin, can't wait for the future features and updates :)
@LeftJuke
Just so you guys all know - comments on pages don't trigger alerts. So I only ever know you've commented if i happen to look at page. Please use the forums or the main overview comments.
http://dev.bukkit.org/bukkit-plugins/legendquest/pages/default-skills-configuration/ is the best guide for skill setups. And you can always ask in the forums.
@LeftJuke As for speed - races and classes now have a basespeed so you can do this without a potion effect. But if you did want to have a permanent effect use the skill "passiveaura" not "aura" :)
passing parameters the the skill is a good idea - will look into it.
Is it possible to add a description to permskills???
@MERCHANToDEATH
Yes, there is a descriptions node for skills - need to add it to documentation. But its just "description:" and can be used on native or perms.
How do you use these skills? can I just add them to the class? or do I have to do something complicated with the skill? Heres what im trying to do:
Skillname: Sneak
type: trigger (want player to be able to turn this command on and off)
command: "sneak"
perms: sneaker.sneak
So basically its doing /sneak but I wan it to be used as a skill
@agentwolf44
Thats a perm skill. And triggered is triggered by event - for internal skills only. You want active. You have to actively turn it on and off.
What's powering /sneak skill? You might be better of with /sneak on and /sneak off.
Also theres no notifications for messages on pages - your better off commenting in the overview.