quickstart.mdx

title	Quickstart
description	Install and run LockiPrefixes in a few minutes

Requirements

• Paper or Spigot server
• LuckPerms (required)
• PlaceholderAPI (required only when using TAB placeholders)
• Java version matching your server generation:
  • Java 8 for legacy Minecraft versions
  • Java 16 for 1.17 to 1.19
  • Java 21 for 1.20+

Step 1: Pick the correct plugin build

Use the JAR that matches your server:

JAR file	Minecraft versions
lockiprefixes-legacy-x.x.x.jar	1.8 - 1.12
lockiprefixes-mid-x.x.x.jar	1.13 - 1.18
lockiprefixes-modern-x.x.x.jar	1.19 - 1.19.4
lockiprefixes-latest-x.x.x.jar	1.20 - 1.21

Drop the selected JAR into your plugins folder.

Step 2: Start your server

Start or restart your server once. LockiPrefixes creates its config file automatically.

If chat formatting does not apply on modern Paper versions, set this in server.properties:

enforce-secure-profile=false

Step 3: Configure ranks in-game

Use the GUI command:

/lpx menu

Create and edit ranks directly in-game. LockiPrefixes also creates LuckPerms groups automatically when a new rank is created.

Optional: TAB integration

Set the tab name in TAB to:

customtabname: "%lockiprefixes_tablist%"

Then run:

/tab reload

Continue with:

• Versions page for compatibility details
• Commands page for permissions and command list
• Placeholders page for TAB and PlaceholderAPI values