RankGUI v1.1

• Purpose: A Spigot 1.12.2 plugin to assign LuckPerms v5 groups via an in-game GUI. Uses reflection so it compiles without the LuckPerms API present; LuckPerms v5 must be installed on the server at runtime.

Requirements

• Spigot (1.12.2)
• Java 8
• LuckPerms v5 installed on the server (runtime only)

Main features

• /rankgui [set|add] — open rank selection GUI. set replaces inheritance, add adds an extra parent.
• Confirm GUI before applying changes.
• Sounds and chat feedback.
• /opkit — gives 3 "God Shulker Boxes" (best-effort; falls back to chest on older APIs).

Installation

1. Build the plugin locally (already built in this workspace):

mvn -U clean package -DskipTests

2. Copy target/RankGUI-1.1.jar to your server plugins/ folder.
3. Start the server (ensure LuckPerms v5 is installed).
4. Grant appropriate permissions (example):

• rankgui.use — allow using /rankgui
• rankgui.opkit — allow using /opkit

Quick server test (manual)

1. Start a Spigot 1.12.2 server with LuckPerms v5 installed.
2. Drop RankGUI-1.1.jar into plugins/ and start the server.
3. Watch console for plugin enable message: RankGUI enabled.
4. In-game (OP or with rankgui.use), run:

/rankgui set

5. Select a rank, select a player, then confirm. Verify chat messages and that the target received the group change.

To test /opkit (must have permission):

/opkit

Sanity checks performed here

• Confirmed target/RankGUI-1.1.jar exists and contains plugin.yml and me/kharo/rankgui/RankGUIPlugin.class.
• Printed plugin.yml below so you can validate the main entry.

What I can do next

• Commit & push these changes to the repository.
• Prepare a small dockerized Spigot server for automated local tests (takes time and extra setup).
• Help you deploy and test on your own server (walkthrough).

File locations

• Plugin JAR: target/RankGUI-1.1.jar
• Main source: src/main/java/me/kharo/rankgui/RankGUIPlugin.java
• Manifest: plugin.yml
• README: README.md