---
url: https://panomc.com/docs/platform/integrations/luckperms.md
---
# LuckPerms Integration

**LuckPerms** is the most advanced, fast, and secure permissions plugin for Minecraft servers. Pano provides a deep, bidirectional integration with LuckPerms, allowing you to manage your entire server's permission structure directly from the web panel.

Unlike traditional setups where web panels only view data, Pano acts as a **centralized management hub** for LuckPerms.

## What is LuckPerms Integration?

Pano's LuckPerms integration synchronizes your server's **Groups**, **Tracks**, and **Permission Nodes** in real-time. Changes made on the Pano Panel are instantly reflected in-game, and changes made in-game (via LuckPerms commands or other plugins) are automatically pushed to Pano.

## Features

* **Full Bidirectional Sync** — Real-time synchronization between Game and Web.
* **Group Management** — Create, edit, and delete groups from the panel.
* **Track Support** — Manage promotion and demotion paths (Tracks) seamlessly.
* **Permission Node Editor** — Add or remove permission nodes for groups and users.
* **Metadata Support** — Full support for **Prefixes**, **Suffixes**, **Display Names**, and **Weights**.
* **Context Awareness** — Support for LuckPerms contexts (server, world, etc.).
* **Temporary Permissions** — Manage permissions that expire automatically (Expiry support).
* **Managed States** — Pano uses markers (`pano-managed`) to safely manage entities without conflicting with manual in-game changes.

## Requirements

1. **LuckPerms** (v5.0+) installed on your Minecraft server (Spigot, Paper, Folia, BungeeCord, Velocity or Fabric).
2. **Pano MC Plugin** installed and connected to your Pano instance.
3. **Permission Integration** enabled for that server (it is by default).

## Setup Guide

### Step 1: Install LuckPerms

Ensure LuckPerms is installed and working on your Minecraft server.

* [Download LuckPerms →](https://luckperms.net/download)

### Step 2: Check the Integration

1. Log in to your **Pano Admin Panel**.
2. Select the server, then open its **Settings → Game Integration** (the settings are per server).
3. Make sure the **Permission Integration** toggle is on — it is by default.
4. Click **Save** if you changed it.

### Step 3: Wait for Synchronization

Once enabled, the Pano MC Plugin will automatically detect LuckPerms.

* It hooks into the LuckPerms Event Bus to listen for changes.
* It then applies Pano's permission data to LuckPerms; changes made in LuckPerms afterwards are pushed to Pano.

## Pano-Exclusive Permissions

> \[!IMPORTANT]
> When you add a permission node via the Pano Panel, it automatically includes a **`pano: true`** context. This indicates that the permission node is specific to the Pano platform. It is stored in LuckPerms with the `pano=true` context, which never applies in game, so it has **no effect in-game**.
>
> This feature allows you to manage web-only permissions (such as panel access levels or specific website features) without causing conflicts in-game.

## How Synchronization Works

### Pano to Game (Inbound)

When you save changes in the **Permissions** section of the Pano Panel:

1. Pano sends a snapshot update to the Pano MC Plugin.
2. The plugin applies these changes to LuckPerms instantly.
3. Groups and Tracks are updated, and nodes are synchronized.

### Game to Pano (Outbound)

When a permission change occurs in-game (e.g., using `/lp user ... permission set ...`):

1. LuckPerms triggers an event.
2. Pano MC Plugin catches this event and waits for a short debounce period (to handle bulk changes).
3. The plugin pushes a fresh snapshot of your current permissions state to Pano.

## Safety & Conflict Management

Pano is designed to coexist with manual LuckPerms usage:

* **Managed Markers:** Pano adds a `meta.pano-managed.true` node to entities it manages.
* **Wipe Protection:** When syncing, Pano carefully identifies which groups and tracks it should manage to avoid accidentally deleting your manually created server data.

## Troubleshooting

### Integration Not Loading

* Check if LuckPerms is installed (type `/plugins` in-game).
* Look for `[Pano] Permission integration is enabled, loading...` in your server console.
* Ensure the **Permission Integration** toggle is ON in the panel.

### Sync Delay

* Pano uses a short debounce period (approx. 1.5 seconds) for outbound syncs to prevent network flooding during bulk operations.
* If changes aren't appearing, check if the **Pano MC Plugin** is connected (the server's **Overview** page, or `/pano status` in game).

## Need Help?

If you encounter issues or have feedback:

* Visit our [**Discord community**](https://discord.gg/6vVy72wgXT).
* Open an issue on [**GitHub**](https://github.com/PanoMC/pano-mc-plugin/issues).

> LuckPerms integration makes managing complex server permissions as easy as clicking a button.