# Event Reference

### Overview

This page contains all the events built in to BattleArena natively. Additional modules or extensions may add new events, which will be included on their documentation page.

### Events List

<table border="1" id="bkmrk-event-description-on" style="border-collapse: collapse; width: 100%; height: 518px;"><colgroup><col style="width: 50.1786%;"></col><col style="width: 49.9405%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Event**  
</td><td style="height: 29.8px;">**Description**  
</td></tr><tr style="height: 63.4px;"><td style="height: 63.4px;">on-start</td><td style="height: 63.4px;">Called when a phase starts. Best used inside of the **events** section of phases, since while this can be used globally, it'll call on *every* phase.  
</td></tr><tr style="height: 63.4px;"><td style="height: 63.4px;">on-complete  
</td><td style="height: 63.4px;">Called when a phase completes. Best used inside of the **events** section of phases, since while this can be used globally, it'll call on *every* phase.</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">on-join  
</td><td style="height: 29.8px;">Called when a player joins a competition.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">on-leave  
</td><td style="height: 29.8px;">Called when a player leaves a competition for any reason.  
</td></tr><tr><td>on-respawn  
</td><td>Called when a player respawns in a competition.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">on-death  
</td><td style="height: 29.8px;">Called when a player dies in a competition.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">on-life-deplete  
</td><td style="height: 29.8px;">Called when a player loses a life, but still has lives to spare.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">on-lives-exhaust  
</td><td style="height: 29.8px;">Called when a player loses their final life and is considered "dead".  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">on-kill  
</td><td style="height: 29.8px;">Called when a player kills another player in a competition.  
</td></tr><tr style="height: 46.6px;"><td style="height: 46.6px;">on-victory  
</td><td style="height: 46.6px;">Called when a player or team is victorious in a competition. This is only called for players who win the competition.  
</td></tr><tr style="height: 46.6px;"><td style="height: 46.6px;">on-lose  
</td><td style="height: 46.6px;">Called when a player or team loses a competition. This is only called for players who lose in the competition.</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">on-draw  
</td><td style="height: 29.8px;">Called when a competition ends in a draw. This will be called for all players.  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">on-spectate  
</td><td style="height: 29.8px;">Called when a player spectates a competition.  
</td></tr></tbody></table>