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

# FAQs

> Frequently asked questions about the LuckPerms Configuration.

## Setup Guide

To setup the LuckPerms configuration, follow the given instructions:

<Steps>
  <Step title="Verify Requirements">
    Ensure you have [LuckPerms](https://luckperms.net/download) and a chat plugin installed on your server.
  </Step>

  <Step title="Extract Configuration">
    Extract the `LuckPerms.zip` file and open the folder to see the 3 style options.
  </Step>

  <Step title="Choose Configuration File">
    Select one of the 3 `.json.gz` files:

    * `Style1-SmallCaps.json.gz` - Modern small-caps styling
    * `Style2-DefaultFont.json.gz` - Clean default font
    * `Style3-DefaultBracket.json.gz` - Professional bracket formatting
  </Step>

  <Step title="Upload to Server">
    Paste your chosen `.json.gz` file into the `LuckPerms` folder in your server's plugins directory.
  </Step>

  <Step title="Import Configuration">
    Use one of the following commands in console or in-game:

    * `/lp import Style1-SmallCaps`
    * `/lp import Style2-DefaultFont`
    * `/lp import Style3-DefaultBracket`
  </Step>

  <Step title="Verify Installation">
    Check the console for a success message confirming the import completed.
  </Step>

  <Step title="Test Ranks">
    Give yourself or another player a rank and verify the prefix displays correctly.
  </Step>
</Steps>

<Note>
  The config will be loaded successfully and ready to use after import!
</Note>

## Switching Styles

<AccordionGroup>
  <Accordion icon="palette" title="Changing Your Style After Setup">
    If you want to switch to a different style:

    1. Keep a backup of your current style
    2. Delete the imported data (or backup first)
    3. Import the new style using the appropriate command
    4. Restart the server

    All rank data will be replaced with the new style's configuration.
  </Accordion>

  <Accordion icon="wrench" title="Customizing Rank Permissions">
    You can customize individual rank permissions:

    * Use `/lp group <group> permission set <permission> true/false`
    * Or use the web editor via `/lp editor`
    * All changes take effect immediately

    Refer to the [LuckPerms documentation](https://luckperms.net/wiki/Home) for advanced permission setup.
  </Accordion>

  <Accordion icon="users" title="Adding New Ranks">
    To create additional ranks beyond the 40 included:

    1. Use `/lp group create <group_name>`
    2. Set permissions with `/lp group <group> permission set <permission> true/false`
    3. Set display name with `/lp group <group> setdisplayname <name>`
    4. Set weight for ordering with `/lp group <group> setweight <weight>`
  </Accordion>

  <Accordion icon="link" title="Rank Inheritance">
    The configuration includes proper inheritance setup:

    * Staff ranks inherit from lower staff positions
    * Donator ranks are independent
    * Achievement ranks add bonuses without replacing base ranks
    * Use `/lp group <group> parent add <parent>` to add inheritance
  </Accordion>

  <Accordion icon="circle-info" title="Chat Plugin Integration">
    Rank prefixes and suffixes display through your chat plugin:

    * Ensure your chat plugin is configured to use LuckPerms placeholders
    * Common placeholders: `%luckperms_prefix%`, `%luckperms_suffix%`, `%player_name%`
    * Refer to your chat plugin's documentation for placeholder setup
  </Accordion>
</AccordionGroup>

## Common Topics

<AccordionGroup>
  <Accordion icon="wrench" title="Installation and setup">
    Questions about installing LuckPerms, uploading configuration files, and initial setup.
  </Accordion>

  <Accordion icon="palette" title="Style selection">
    Help choosing between the 3 different style options and how to change styles.
  </Accordion>

  <Accordion icon="users" title="Rank management">
    How to assign ranks, create new ranks, and manage rank permissions.
  </Accordion>

  <Accordion icon="link" title="Inheritance setup">
    Understanding and configuring rank inheritance relationships.
  </Accordion>

  <Accordion icon="plug" title="Plugin compatibility">
    Ensuring compatibility with chat plugins and other server plugins.
  </Accordion>
</AccordionGroup>

## Need Help?

<Note>
  If you encounter any issues or have questions that aren't covered here, please reach out to support on our [Discord](https://ph4ntom.org/discord). We're here to help!
</Note>