majiayu000 Topic skill
Enables you to use skills and the skillbar and such.
Note: Skills in the skillbar can have the id 0 to identify empty skillbar slots.
Asynchroneous initial message after successful join
initial
- unlocked_skills // overall available skills
- skillbar // your current skillbar as list of skill-ids
Synchroneous client requests.
Setting a skillbar slot:
skillbar:set
- slot // the slot index of the skillbar (0-based, i.e. has to be between 0-7)
- id // the id of the skill to be placed there, or 0 for deletion
Success:
skillbar:ok
- skillbar // your current skillbar as list of skill-ids
Failure: (No permission to change skillbar)
skillbar:error
- reason // the reason why the server couldn't perform the skillbar-change
Casting a skill:
cast
- slot // the slot index on the skillbar that you want to cast
- target // the entity-id of the target - if this is invalid or not set, it defaults
// to your own entitys id
Success:
cast:ok
Failure: (Already casting a skill, or still recharging)
cast:error
- slot // the index of the skillbar-slot that you tried to use
- reason // the reason why the cast could not be performed
Asynchroneous server events.
Skill-Casting & skill-recharging: You will be notified when a player starts casting a skill and also when the casting was successful. After a cast, the skill might need to recharge. In this case the recharge time will be more than 0 and you will also be notified that a recharge has ended. If the recharge time of a skill is 0, there will be no notification that the recharge has ended (it never took place).
Notification that an entity starts to cast a skill: (This might is not sent if the casting is instantaneous)
cast:start // -> Start of the casting process, if cast-time is not 0
- entity // entity id of the caster
- target // entity id of the target (defaults to caster entity id if no target given)
- slot // the index of the skillbar-slot that the player used
- skill // the id of the skill the player used
- cast_time // the actual cast-time in milliseconds
cast:end // -> End of the casting process, if cast-time is not 0
- entity // entity id of the caster
- target // entity id of the target (defaults to caster entity id if no target given)
- slot // the index of the skillbar-slot that the player used
- skill // the id of the skill the player used
- recharge_time // the actual recharge-time in milliseconds
Skill casting failures: (Note that in a future release some of these failures might also be handled already during the start of the casting process, for example range checks and parameter checks)
cast:interrupt
- entity // entity id of the caster
- target // entity id of the target (defaults to caster entity id if no target given)
- slot // the index of the skillbar-slot that the player used
- skill // the id of the skill the player used
- recharge_time // the actual recharge-time in milliseconds
- reason // why the skill casting could not be performed
Skill recharge events:
recharge:end // -> End of the recharge process, if recharge-time is not 0
- entity // entity id of the caster
- slot // the index of the skillbar-slot that the player used
- skill // the id of the skill the player used
After-cast delay end events:
after_cast:end // -> End of the after-cast delay
- entity // entity id of the caster