> ## 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 Facts

> Conditions to check player permissions and groups.

Facts allow you to create conditions based on a player's LuckPerms data. They return values that can be used in requirements or filters.

## Available Facts

| Fact ID                 | Type    | Description                                              |
| :---------------------- | :------ | :------------------------------------------------------- |
| `has_permission_fact`   | Boolean | Returns true if the player has the specified permission. |
| `in_group_fact`         | Boolean | Returns true if the player is a member of the group.     |
| `primary_group_fact`    | String  | Returns the name of the player's primary group.          |
| `luckperms_meta_fact`   | String  | Returns the value of a specific meta key.                |
| `luckperms_prefix_fact` | String  | Returns the player's current prefix.                     |
| `luckperms_suffix_fact` | String  | Returns the player's current suffix.                     |

## Configuration

### Has Permission

<ResponseField name="permission" type="String" required>
  The node to check.
</ResponseField>

### In Group

<ResponseField name="groupName" type="String" required>
  The group to check membership for.
</ResponseField>

### Meta Fact

<ResponseField name="key" type="String" required>
  The meta key to retrieve.
</ResponseField>

## Example Usage

<CodeGroup>
  ```yaml Permission Requirement theme={null}
  # Only trigger if the player has essentials.fly
  condition:
    has_permission_fact:
      permission: "essentials.fly"
  ```

  ```yaml Primary Group Check theme={null}
  # Check if player is an Admin
  condition:
    primary_group_fact:
      equals: "admin"
  ```
</CodeGroup>