LuckPerms

LuckPerms is a powerful permissions plugin and mod designed for Minecraft servers. It allows administrators to manage player permissions, groups, and ranks with ease, supporting a wide range of server software including Bukkit, Paper, Fabric, Forge, and Velocity.

Installing LuckPerms

On AwakeNode

1. Download the version of LuckPerms for your server's software and Minecraft version from its Modrinth page.
2. Open your server's Files tab, go to the plugins folder and upload the .jar file. You can also upload it over SFTP.
3. Restart your server from the Console tab.

On other hosts / manually

1. Download the latest LuckPerms jar file from the official Modrinth page.
2. Connect to your server via SFTP and upload the file to the /plugins (or /mods) directory.
3. Restart your server to generate the configuration files.

Common issues

• Plugin not loading: Ensure you have downloaded the correct version for your server software (e.g., the Bukkit version for Paper/Spigot, or the Fabric/Forge version for modded servers).
• Permissions not applying: Check the server console for startup errors and ensure you have assigned the correct nodes to your user or group.
• Database connection errors: If using an external database, verify your credentials in the config.yml file. For most small to medium servers, the default H2 file-based storage is sufficient.

Performance

LuckPerms is highly optimised and is designed to have a minimal impact on your server's CPU and RAM usage. It uses efficient caching to ensure permission checks are near-instantaneous. If you are running a very large network with thousands of players, ensure your server has sufficient RAM allocated to handle the data storage; if you need to upgrade your plan, AwakeNode will automatically update your startup flags to match your new memory allocation. For other hosts, ensure your flag in your startup script is set appropriately for your player count.