Getting Started with LuckPerms: Managing Permissions for Minecraft Servers

LuckPerms: A Modern Permissions Plugin for Litebyte Servers

What is LuckPerms: In most Minecraft servers you tend to have plugins, these plugins add certain features to the game. You might not want to have members using certain features and that’s why plugin developers implement permissions into their plugins. The problem is it’s extremely hard to assign these permissions to certain players or groups of players, plugins like LuckPerms make this much easier. 

Overview of LuckPerms: LuckPerms is an advanced, flexible, and modern permissions plugin designed for configuring server permissions precisely to your needs. It is recommended over PermissionsEx (PEx), as PEx is currently unmaintained, and offers more flexibility and support than GroupManager.

Why Use LuckPerms?

LuckPerms is preferred over PermissionsEx or GroupManager for several reasons:

• Active Maintenance: LuckPerms is actively maintained, meaning you receive regular updates, bug fixes, and security patches.
• Advanced Features: Provides highly customizable permissions management, including inheritance, temporary permissions, and contextual permissions.
• Compatibility: Works seamlessly across major server platforms like Bukkit, BungeeCord, and SpongeForge.

Installing LuckPerms on Your Litebyte Server

1. Download: Get the latest LuckPerms version from the LuckPerms website. 
2. Upload the Plugin: Use our File Manager to place the LuckPerms jar file into your server’s plugins directory.
3. Start and Stop the Server: Restart the server and wait for LuckPerms to load, then stop the server.
4. Database Setup:
• (This isn’t a necessary step and LuckPerms works fine saving the data locally, however using a database is recommended)
• Create a MySQL database through the Litebyte panel if you haven’t already.
• Edit the config.yml in plugins/LuckPerms/:
• Change storage-method: h2 to storage-method: mysql.
• Update address: localhost to the MySQL Host from the Litebyte panel.
• Update database, username, and password to the values provided in the Litebyte panel.
5. Restart Server: Start your server again. LuckPerms is now fully installed and connected to the database.

Setting Up Basic Permissions and Groups

Creating an Admin Group

• In the server console, type: lp creategroup admin
• To assign yourself to the group: lp user <yourname> parent add admin
• Add permissions to the group: lp group admin permission set <permission>

Adding a Prefix to Groups

1. Prerequisites: Ensure you have a chat manager (e.g., EssentialsXChat) and Vault installed.
2. Set Prefix Weight: Each prefix should have a "weight" to decide which prefix displays when a user is in multiple groups. For example, set owner to 100, admin to 90, and moderator to 80.
3. Add Prefix Command: Use lp group <name> meta addprefix <weight> <prefix>.

Additional information is available on the LuckPerms Wiki.

Migrating Permissions from Other Plugins

LuckPerms supports easy migration from plugins like PermissionsEx.

1. Install LuckPerms as per the steps above and keep PermissionsEx or GroupManager temporarily installed.
2. In the console, type: lp migration <plugin>, e.g., lp migration PermissionsEx.
3. Follow any prompts from LuckPerms for additional information.

Additional Resources

Check out the LuckPerms Wiki to explore advanced configurations and features. Keep in mind we offer live support in through Discord support tickets so feel free to reach out if you can't get the hang of it!