> For the complete documentation index, see [llms.txt](https://tyzbrand.gitbook.io/docs.tyzs_skills/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tyzbrand.gitbook.io/docs.tyzs_skills/kubejs/kubejs_events.md).

# Use KubeJS events to react to Tyz's Skills

You can catch events to cancel, modify or react to them by using `TyzsSkillsEvents`. When an event is cancelable, you can use `event.cancel()`.

*Examples of usage:*

```js
// Canceling an event
TyzsSkillsEvents.skill_purchase_pre(event => {
  // Prevent players from buying a specific skill
  if (event.getSkill().getId() == 'my_custom_skill') {
    event.cancel()
  }
})
```

<br>

```js
// Modifying a value dynamically
TyzsSkillsEvents.xp_change(event => {
  // Double the XP gained by the player
  let oldXp = event.getOldAmount()
  let newXp = event.getNewAmount()
  
  if (newXp > oldXp) {
    let gained = newXp - oldXp
    event.setNewAmount(oldXp + (gained * 2))
  }
})
```

\ <br>

## EVENTS

### Technical

* `skill_load_pre` -> At the start of the server, just before a skill is loaded. **\[Cancelable]**

> Skill: `event.getSkill()`

\ <br>

* `skill_load_post` -> At the start of the server, just after a skill is loaded and added to the server list.

> Skill: `event.getSkill()`

\ <br>

* `skill_reload` -> When server skill list is reloaded (/skills reload).

\ <br>

* `player_reset` -> When a player gets their data reset (/skills reset).

> Player: `event.getPlayer()`

\ <br>

### Metadata

* `sp_change` -> When the SP amount of a player changes. **\[Cancelable]**

> Player: `event.getPlayer()`\
> Amount: `event.getNewAmount()`, `event.getOldAmount()`, `event.setNewAmount(amount)`

\ <br>

* `power_change` -> When the power amount of a player changes. **\[Cancelable]**

> Player: `event.getPlayer()`\
> Amount: `event.getNewPower()`, `event.getOldPower()`, `event.setNewPower(power)`

\ <br>

* `xp_change` -> When the XP amount of a player changes. **\[Cancelable]**

> Player: `event.getPlayer()`\
> Amount: `event.getNewAmount()`, `event.getOldAmount()`, `event.setNewAmount(amount)`

\ <br>

* `skill_level_change` -> When a player's level changes. **\[Cancelable]**

> Player: `event.getPlayer()`\
> Amount: `event.getNewLevel()`, `event.getOldLevel()`, `event.setNewLevel(level)`

\ <br>

### Specific Actions

* `skill_purchase_pre` -> Just before a skill is bought by a player. **\[Cancelable]**

> Player: `event.getPlayer()`\
> Skill: `event.getSkill()`

\ <br>

* `skill_purchase_post` -> Just after a skill is bought by a player.

> Player: `event.getPlayer()`\
> Skill: `event.getSkill()`

\ <br>

* `skill_refund_pre` -> Just before a skill is refunded by a player. **\[Cancelable]**

> Player: `event.getPlayer()`\
> Skill: `event.getSkill()`

\ <br>

* `skill_refund_post` -> Just after a skill is refunded by a player.

> Player: `event.getPlayer()`\
> Skill: `event.getSkill()`

\ <br>

* `skill_bookmark` -> When a player bookmarks a skill.

> Player: `event.getPlayer()`\
> Skill: `event.getSkill()`

\ <br>