> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# LuckPerms Events

> React to changes in LuckPerms data.

LuckPerms events allow TypeWriter mechanics to trigger when player data changes within the permission system.

## Available Events

| Event ID                    | Description                                                            |
| :-------------------------- | :--------------------------------------------------------------------- |
| `luckperms_node_add_event`  | Triggers when any node (permission, group, etc.) is added to a player. |
| `luckperms_user_load_event` | Triggers when LuckPerms finished loading or syncing a user's data.     |

## Configuration

These events typically don't require specific configuration properties but act as triggers for subsequent actions.

## Example Usage

<CodeGroup>
  ```yaml Welcome Loader theme={null}
  # Welcome a player once their permissions are ready
  luckperms_user_load_event:
    triggers:
      - action: "send_message_action"
        message: "Your permissions have been synchronized!"
  ```

  ```yaml Rank Up Message theme={null}
  # Trigger something when a node is added
  luckperms_node_add_event:
    triggers:
      - action: "some_custom_logic"
  ```
</CodeGroup>