> For the complete documentation index, see [llms.txt](https://ajneb97.gitbook.io/conditionalevents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajneb97.gitbook.io/conditionalevents/event-types/player-events.md).

# Player Events

## PLAYER JOIN

Event called when a player joins the server.

```yaml
example:
  type: player_join
  actions:
    default:
    - 'message: &eWelcome %player% to the server.'
```

{% hint style="info" %}
This event has no variables, but you can still use ConditionalEvents variables or PlaceholderAPI variables.
{% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER LEAVE

Event called when a player leaves the server.

```yaml
example:
  type: player_leave
  actions:
    default:
    - 'to_all: message: &e%player% left the server.'
```

{% hint style="info" %}
This event has no variables, but you can still use ConditionalEvents variables or PlaceholderAPI variables.
{% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER PRE JOIN

Event called when a player tries to join the server.

```yaml
example:
  type: player_pre_join
  conditions:
  - "%name% == Ajneb"
  - "%ip% != 192.168.0.1"
  actions:
    default:
    - "console_message: &8[&c&lALERT&8] &7A user with IP &e%ip% &7tried to join the server using and administrator account."
    - "prevent_join: &c&lERROR!\n&7You can't access this account with that IP."
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%name%</mark> (Name of the player trying to join the server)
* <mark style="color:green;">%ip%</mark> (IP of the player)
* <mark style="color:green;">%uuid%</mark> (UUID of the player)
  {% endhint %}

{% hint style="warning" %}
This is not a player event, which means you can't use player variables or player actions.\
Don't be confused, it is called a "player pre join", but it is a special event which doesn't contain player data.
{% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.\
If you want to block the player from joining, use the `prevent_join` action instead.
{% endhint %}

## PLAYER RESPAWN

Event called when a player respawns.

```yaml
example:
  type: player_respawn
  conditions:
  - '%player_world% == pvp1'
  actions:
    default:
    - "teleport: lobby;0;60;0;90;0"
    - "message: &cYou died. Teleporting you back to the PvP Lobby..."
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%x%</mark> (Coordinate X of the respawn point)
* <mark style="color:green;">%y%</mark> (Coordinate Y of the respawn point)
* <mark style="color:green;">%z%</mark> (Coordinate Z of the respawn point)
* <mark style="color:green;">%respawn\_world%</mark> (World of the respawn point)
* <mark style="color:green;">%reason%</mark> (Reason of respawn. All reasons here: <https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/event/player/PlayerRespawnEvent.RespawnReason.html>). Works only on 1.19.4+.
  {% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER DEATH

Event called when a player dies.

```yaml
example:
  type: player_death
  actions:
    default:
    - 'message: &7You died because of: &c%cause%'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%cause%</mark> (Cause of death. All causes here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html>)
* <mark style="color:green;">%killer\_type%</mark> (If the player dies because of an entity, which type of entity. All types on this link: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html>)
* <mark style="color:green;">%killer\_name%</mark> (If the player dies because of an entity, the name of this entity without color codes)
* <mark style="color:green;">%killer\_color\_format\_name%</mark> (The name of the killer including color codes)
  {% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER COMMAND

Event called when a player executes a command.

```yaml
example:
  type: player_command
  conditions:
  - '%main_command% equalsIgnoreCase //calc or %main_command% equalsIgnoreCase //solve'
  actions:
    default:
    - 'cancel_event: true'
    - 'kick: &cWhat are you trying to do?'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%command%</mark> (The full command the player used)
* <mark style="color:green;">%main\_command%</mark> (The main command without arguments)
* <mark style="color:green;">%arg\_X%</mark> (The argument in the X position of the command. If the command is **`/announce hello world`** the %arg\_1% variable would be "hello" and the %arg\_2% would be "world")
* <mark style="color:green;">%args\_length%</mark> (The amount of arguments of the command)
* <mark style="color:green;">%args\_substring\_\<arg1>-\<arg2>%</mark> (This variable will create a text using a first argument and a last argument. For example, if the command is **`/announce I am currently doing a Youtube livestreaming`**, you could use the %args\_substring\_1-6% variable to take arg1, arg2,...,arg6 and get the text that the player is announcing. If you don't care about the arguments length, instead of 6 use a large number like 100)
  {% endhint %}

## PLAYER CHAT

Event called when a player writes something in chat.

```yaml
example:
  type: player_chat
  conditions:
  - '%message% contains hacker'
  actions:
    default:
    - 'cancel_event: true'
    - 'message: &cIf you have found a hacker please report them on our Discord.'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%message%</mark> (The chat message)
  {% endhint %}

## PLAYER RECEIVE CHAT

Event called when a player receives a message in chat.

```yaml
example:
  type: player_receive_chat
  conditions:
  - '%player_is_afk% == true'
  actions:
    default:
    - 'cancel_event: true'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%normal\_message%</mark> (Message received including color codes)
* <mark style="color:green;">%normal\_message\_without\_color\_codes%</mark> (Message received without color codes)
* <mark style="color:green;">%json\_message%</mark> (Complete JSON format of the message received)
* <mark style="color:green;">%message\_type%</mark> (Can be PLAYER\_MESSAGE or SERVER\_MESSAGE)
  {% endhint %}

{% hint style="warning" %}
Only works on **Paper**!\
To detect for all chat messages you need **PacketEvents** (<https://modrinth.com/plugin/packetevents>)
{% endhint %}

## PLAYER LEVELUP

&#x20;Event called when a player changes its level.

```yaml
example:
  type: player_levelup
  actions:
    default:
    - 'message: &aLevel &6&l%old_level% &7-> &6%new_level%'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%old\_level%</mark> (The previous level of the player)
* <mark style="color:green;">%new\_level%</mark> (The new level of the player)
  {% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER WORLD CHANGE

Event called when a player is moving to another world.

```yaml
example:
  type: player_world_change
  actions:
    default:
    - 'message: &7Moving to &e%world_to% &7world'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%world\_from%</mark> (The previous world)
* <mark style="color:green;">%world\_to%</mark> (The world where the player is moving to)
* <mark style="color:green;">%online\_players\_from%</mark> (Amount of online players in the previous world)
* <mark style="color:green;">%online\_players\_to%</mark> (Amount of online players in the world where the player is moving to)
  {% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER ATTACK

Event called when a player damages an entity.

```yaml
example:
  type: player_attack
  conditions:
  - '%victim% == PLAYER'
  - '%item% == DIAMOND_SWORD'
  - '%item_name% == Super Sword'
  - '%random_1_10% >= 8'
  actions:
    default:
    - 'message: &aYour diamond sword poison effect was activated! &6%target:player_name% &ais now poisoned!'
    - 'to_target: give_potion_effect: POISON;120;1'
    - 'to_target: message: &cYou were poisoned by &e%player%&c!'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%damage%</mark> (Damage made by the player)
* <mark style="color:green;">%original\_damage%</mark> (Original damage made by the player)
* <mark style="color:green;">%attack\_type%</mark> (Type of the damage. For projectiles it could be: ARROW, TRIDENT, SNOWBALL. If the damage is not made by a projectile, it will result in PLAYER)
* <mark style="color:green;">%is\_critical%</mark> (Whether the damage was a critical damage or not. **Requires Paper 1.17+**)
* ConditionalEvents <mark style="color:green;">item variables</mark> (for item in hand)
* ConditionalEvents <mark style="color:green;">victim variables</mark>
  {% endhint %}

{% hint style="info" %}
On this event you can use **target player variables** and **to\_target actions**.
{% endhint %}

## PLAYER KILL

Event called when a player kills an entity.

```yaml
example:
  type: player_kill
  conditions:
  - '%victim% == COW'
  actions:
    default:
    - 'message: &aAre you happy killing this cow?'
```

{% hint style="success" %}
**Variables:**

* ConditionalEvents <mark style="color:green;">item variables</mark> (for item in hand)
* ConditionalEvents <mark style="color:green;">victim variables</mark>
  {% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

{% hint style="info" %}
On this event you can use **target player variables** and **to\_target actions**.
{% endhint %}

## PLAYER DAMAGE

Event called when a player is taking damage.

```yaml
example:
  type: player_damage
  conditions:
  - '%cause% == DROWNING'
  actions:
    default:
    - 'cancel_event: true'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%cause%</mark> (Cause of the event. How did the player got damaged. All causes here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html>)
* <mark style="color:green;">%damage%</mark> (Damage taken by the player)
* <mark style="color:green;">%original\_damage%</mark> (Original damage taken by the player)
* <mark style="color:green;">%damager\_type%</mark> (If the player takes damage from an entity, which type of entity. All types on this link: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html>)
* <mark style="color:green;">%damager\_name%</mark> (If the player takes damage from an entity, the name of this entity without color codes)
* <mark style="color:green;">%damager\_color\_format\_name%</mark> (The name of the damager including color codes)
  {% endhint %}

## PLAYER ARMOR

Event called when a player equips or unequips armor.

```yaml
example:
  type: player_armor
  conditions:
  - '%armor_type% == HELMET'
  - '%equip_type% == EQUIP'
  - '%item_name% == Super Diamond Helmet'
  - '%player_has_permission_items.super_diamond_helmet% == false'
  actions:
    default:
    - 'cancel_event: true'
    - "message: &cYou don't have permissions to equip that item!"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%armor\_type%</mark> (Type of the armor. Could be: HELMET, CHESTPLATE, LEGGINGS or BOOTS)
* <mark style="color:green;">%equip\_type%</mark> (Could be: EQUIP or UNEQUIP)
* ConditionalEvents <mark style="color:green;">item variables</mark>
  {% endhint %}

{% hint style="warning" %}
**If you are using EssentialsX:** EssentialsX changes the way interactions behave in player armor, so if you want to use the player\_armor event, set `allow-direct-hat: false` on EssentialsX config.
{% endhint %}

## PLAYER TELEPORT

Event called when a player teleports somehow.

```yaml
example:
  type: player_teleport
  conditions:
  - "%cause% == NETHER_PORTAL"
  actions:
    default:
    - 'cancel_event: true'
    - "message: &cYou can't use nether portals!"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%cause%</mark> (Cause of the event. Why is the player teleporting. All causes here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/player/PlayerTeleportEvent.TeleportCause.html>)
* <mark style="color:green;">%from\_x%</mark> (Coordinate X of the previous location)
* <mark style="color:green;">%from\_y%</mark> (Coordinate Y of the previous location)
* <mark style="color:green;">%from\_z%</mark> (Coordinate Z of the previous location)
* <mark style="color:green;">%from\_world%</mark> (World of the previous location)
* <mark style="color:green;">%from\_yaw%</mark> (Yaw of the previous location)
* <mark style="color:green;">%from\_pitch%</mark> (Pitch of the previous location)
* <mark style="color:green;">%to\_x%</mark> (Coordinate X of the new location)
* <mark style="color:green;">%to\_y%</mark> (Coordinate Y of the new location)
* <mark style="color:green;">%to\_z%</mark> (Coordinate Z of the new location)
* <mark style="color:green;">%to\_world%</mark> (World of the new location)
* <mark style="color:green;">%to\_yaw%</mark> (Yaw of the new location)
* <mark style="color:green;">%to\_pitch%</mark> (Pitch of the new location)
  {% endhint %}

## PLAYER BED ENTER

Event called when a player enters a bed.

```yaml
example:
  type: player_bed_enter
  conditions:
  - "%result% == OK"
  - "%player_world% == spawn"
  actions:
    default:
    - "cancel_event: true"
    - "message: &cYou can't sleep on this world."
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%result%</mark> (Result of the event. Can the player really use the bed? All results here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/player/PlayerBedEnterEvent.BedEnterResult.html>)
  {% endhint %}

{% hint style="warning" %}
Only works on 1.13+!
{% endhint %}

## PLAYER OFFHAND

Event called when players interact with their offhand.

* Swap items between main hand and offhand using the hotkey.
* Use the inventory to move items to the offhand.
* Use the inventory to recover items from the offhand.

```yaml
example:
  type: player_offhand
  conditions:
  - "%item% endsWith _SWORD"
  actions:
    default:
    - "message: &cYou can't place swords in your offhand!"
    - "cancel_event: true"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%movement\_type%</mark> (Could be: SWAP, PLACE, RECOVER, NOTHING)
* ConditionalEvents <mark style="color:green;">item variables</mark> (for the item the player is trying to put in the offhand)
* ConditionalEvents <mark style="color:green;">item variables</mark> (for the item the player is trying to recover from the offhand: `%offhand:<variable>%`)
  {% endhint %}

## PLAYER FISH

Event called when a player is fishing.

{% tabs %}
{% tab title="Example 1" %}

```yaml
example:
  type: player_fish
  conditions:
  - "%state% == CAUGHT_ENTITY"
  - "%caught_type% == COW or %caught_type% == PIG"
  actions:
    default:
    - "cancel_event: true"
    - "message: &cYou can't use a fishing rod on animals!"
```

{% endtab %}

{% tab title="Example 2" %}

```yaml
example:
    type: player_fish
    conditions:
    - "%state% == CAUGHT_ENTITY"
    - "%caught_type% == PLAYER"
    actions:
      default:
      - "message: &eYou've captured %target:player%"
      - "to_target: message: &eYou've been captured by %player%"
      - "to_target: give_potion_effect: BLINDNESS;120;1;false"
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%state%</mark> (Current state of fishing. All states here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/player/PlayerFishEvent.State.html>)
* <mark style="color:green;">%caught\_type%</mark> (Entity caught. All entity types here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html>)
* <mark style="color:green;">%caught\_x%</mark> (Coordinate X of the caught location)
* <mark style="color:green;">%caught\_y%</mark> (Coordinate Y of the caught location)
* <mark style="color:green;">%caught\_z%</mark> (Coordinate Z of the caught location)
* ConditionalEvents <mark style="color:green;">item variables</mark> (For caught item if present. %state% must be CAUGHT\_FISH and %caught\_type% must be ITEM or DROPPED\_ITEM)
  {% endhint %}

{% hint style="info" %}
On this event you can use **target player variables** and **to\_target actions** (Only if %state% is CAUGHT\_ENTITY and %caught\_type% is a Living Entity)
{% endhint %}

## PLAYER OPEN INVENTORY

Event called when a player opens an inventory.

```yaml
example:
  type: player_open_inventory
  conditions:
  - "%inventory_type% == MERCHANT"
  actions:
    default:
    - "message: &cVillager trading is disabled."
    - "cancel_event: true"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%inventory\_type%</mark> (Type of the opened inventory. All types here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/InventoryType.html>)
* <mark style="color:green;">%inventory\_title%</mark> (Title of the opened inventory without color codes)
  {% endhint %}

## PLAYER CLOSE INVENTORY

Event called when a players closes an inventory.

```yaml
example:
  type: player_close_inventory
  conditions:
  - "%inventory_type% == MERCHANT"
  actions:
    default:
    - "message: &cClosing villager trading..."
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%inventory\_type%</mark> (Type of the closed inventory. All types here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/InventoryType.html>)
* <mark style="color:green;">%inventory\_title%</mark> (Title of the closed inventory without color codes)
  {% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER CLICK INVENTORY

Event called when a player clicks on an inventory.

```yaml
example:
  type: player_click_inventory
  conditions:
  - "%inventory_title% == Custom Craftings"
  - "%slot% == 14"
  - "%item% == CHEST"
  - "%click_type% == LEFT"
  actions:
    default:
    - "message: &aLeft clicking on a Chest on slot 14 on inventory 'Custom Craftings'"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%inventory\_type%</mark> (Type of the clicked inventory. All types here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/InventoryType.html>)
* <mark style="color:green;">%inventory\_title%</mark> (Title of the clicked inventory without color codes)
* <mark style="color:green;">%inventory\_title\_color\_format%</mark> (Title of the clicked inventory with color codes)
* <mark style="color:green;">%click\_type%</mark> (Click type. How is the player clicking on the inventory. All types here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/ClickType.html>)
* <mark style="color:green;">%action\_type%</mark> (Action type. What is the player doing in the inventory. All types here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/InventoryAction.html>)
* <mark style="color:green;">%slot\_type%</mark> (Type of the clicked slot. All types here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/InventoryType.SlotType.html>)
* <mark style="color:green;">%slot%</mark> (Position of the inventory clicked)
* ConditionalEvents <mark style="color:green;">item variables</mark> (for clicked item)
* ConditionalEvents <mark style="color:green;">item variables</mark> (for item in cursor: `%cursor:<variable>%`)
  {% endhint %}

## PLAYER STATISTIC

Event called when a player statistic is incremented, like certain blocks breaked, jumps, items pickup...

```yaml
example:
  type: player_statistic
  one_time: true
  conditions:
  - "%statistic_name% == MINE_BLOCK"
  - "%block% == EMERALD_ORE"
  - "%new_value% == 5"
  actions:
    default:
    - "centered_message: &a&lAchievement Unlocked!"
    - "centered_message:  "
    - "centered_message:  &eMine 5 Emerald Blocks."
    - "centered_message:  "
    - "centered_message:  &aRewards:"
    - "centered_message:  &7- $500"
    - "console_command: eco give %player% 500"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%statistic\_name%</mark> (Name of the incremented statistic. All names here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Statistic.html>)
* <mark style="color:green;">%new\_value%</mark> (New value of this statistic)
* <mark style="color:green;">%previous\_value%</mark> (Previous value of this statistic)
* <mark style="color:green;">%entity%</mark> (Associated entity type for this statistic, if present. All types here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html>)
* <mark style="color:green;">%block%</mark> (Associated block type for this statistic, if present. All types here: <https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html>)
  {% endhint %}

## PLAYER SNEAK

Event called when a player toggles their sneaking state.

```yaml
example:
  type: player_sneak
  conditions:
  - "%is_sneaking% == true execute actions1"
  actions:
    actions1:
    - "message: &eSneaking"
    default:
    - "message: &eCancelling sneak"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%is\_sneaking%</mark> (Whether the player is sneaking or not. Will return "true" or "false")
  {% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER RUN

Event called when a player toggles their running state (starts or stops running).

```yaml
example:
  type: player_run
  conditions:
  - "%is_running% == true execute actions1"
  actions:
    actions1:
    - "message: &eRunning"
    default:
    - "message: &eStopped running"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%is\_running%</mark> (Whether the player is running or not. Will return "true" or "false")
  {% endhint %}

{% hint style="warning" %}
This event can't be cancelled with **cancel\_event** action.
{% endhint %}

## PLAYER JUMP

Event called when a player jumps.

```yaml
example:
  type: player_jump
  conditions:
  - "%player_health% <= 5"
  actions:
    default:
    - "message: &cYou can't jump when your health is low!"
    - "cancel_event: true"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%from\_x%</mark> (Coordinate X of the previous location)
* <mark style="color:green;">%from\_y%</mark> (Coordinate Y of the previous location)
* <mark style="color:green;">%from\_z%</mark> (Coordinate Z of the previous location)
* <mark style="color:green;">%from\_world%</mark> (World of the previous location)
* <mark style="color:green;">%from\_yaw%</mark> (Yaw of the previous location)
* <mark style="color:green;">%from\_pitch%</mark> (Pitch of the previous location)
* <mark style="color:green;">%to\_x%</mark> (Coordinate X of the new location)
* <mark style="color:green;">%to\_y%</mark> (Coordinate Y of the new location)
* <mark style="color:green;">%to\_z%</mark> (Coordinate Z of the new location)
* <mark style="color:green;">%to\_world%</mark> (World of the new location)
* <mark style="color:green;">%to\_yaw%</mark> (Yaw of the new location)
* <mark style="color:green;">%to\_pitch%</mark> (Pitch of the new location)
  {% endhint %}

{% hint style="warning" %}
Only works on **Paper** 1.12+!
{% endhint %}

## PLAYER REGAIN HEALTH

Event called when a player regains/regenerates health.

```yaml
example:
  type: player_regain_health
  conditions:
  - "%reason% == SATIATED"
  actions:
    default:
    - 'cancel_event: true'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%reason%</mark> (Reason of the event. Why is the player regenerating health. All reasons here: <https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityRegainHealthEvent.RegainReason.html>)
* <mark style="color:green;">%amount%</mark> (Amount of health regained)
  {% endhint %}

## PLAYER CHANGE FOOD

Event called when the food level of a player changes.

```yaml
example:
  type: player_change_food
  conditions:
  - "%player_world% == minigames"
  actions:
    default:
    - "cancel_event: true"
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%old\_food\_level%</mark> (The previous food level of the player)
* <mark style="color:green;">%new\_food\_level%</mark> (The new food level of the player)
  {% endhint %}

{% hint style="warning" %}
Only works on 1.16+!
{% endhint %}

## PLAYER TAB COMPLETE

Event called when a player is writing a command and about to display possible arguments. Mainly used with the [`tab_complete`](/conditionalevents/actions/event-actions.md#tab-complete) action.

```yaml
custom_help_command_tab:
    type: player_tab_complete
    conditions:
    - '%main_command% == /help'
    - '%args_length% == 1 execute show_arguments_1'
    - '%args_length% == 2 and %arg_1% == worlds execute show_worlds_arguments'
    actions:
      show_arguments_1:
      - 'tab_complete: clear'
      - 'tab_complete: set;commands,economy,worlds'
      show_worlds_arguments:
      - 'tab_complete: set;overworld,nether,plots'
```

{% hint style="success" %}
**Variables:**

* <mark style="color:green;">%main\_command%</mark> (The command involved in this event)
* <mark style="color:green;">%args\_length%</mark> (The current argument position of the command the player is trying to autocomplete)
* <mark style="color:green;">%arg\_X%</mark> ( The argument in the X position of the command. If the command is **`/help worlds plots`** the %arg\_1% variable would be "worlds" and the %arg\_2% would be "plots")
  {% endhint %}

{% hint style="warning" %}
This event will be detected ONLY if the command is already registered as a command, either by another plugin, or by ConditionalEvents. Remember that you can register commands on the `register_commands` option in the config.

Only works on 1.9+!
{% endhint %}