LuckPerms Facts

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

permission — String

The node to check.

In Group

groupName — String

The group to check membership for.

Meta Fact

key — String

The meta key to retrieve.

Example Usage

# Only trigger if the player has essentials.fly
condition:
  has_permission_fact:
    permission: "essentials.fly"

# Check if player is an Admin
condition:
  primary_group_fact:
    equals: "admin"