A permissions plugin for Minecraft servers.
Go to file
Luck d859085056
Update Fabric/Forge to Minecraft 1.20
Co-authored-by: Aurelien <aurelien.domino@gmail.com>
2023-06-11 11:17:17 +01:00
.github Fix github action to fetch repo with tags 2023-06-08 22:16:16 +01:00
api Reformat import statements 2023-04-30 21:27:42 +01:00
bukkit Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
bukkit-legacy Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
bungee Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
common Fix issues with postgres storage backend (#3647) 2023-06-08 21:28:15 +01:00
fabric Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
forge Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
gradle/wrapper Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
nukkit Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
sponge Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
standalone Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
velocity Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
.gitignore Context & action log changes 2019-08-26 14:04:50 +01:00
build.gradle Implement standalone/cli app 2022-07-20 23:14:40 +01:00
CONTRIBUTING.md LuckPerms for Forge (#3262) 2022-05-20 20:09:04 +01:00
gradle.properties Increase memory allocation for Gradle 2022-06-12 10:55:51 +01:00
gradlew Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
gradlew.bat Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00
HEADER.txt misc tidying up 2018-11-10 20:21:08 +00:00
LICENSE.txt Update MIT license text to allow GitHub detection (#1400) 2019-01-28 10:46:05 +00:00
README.md Add integration tests for storage and messaging 2023-04-01 21:39:08 +01:00
settings.gradle Update Fabric/Forge to Minecraft 1.20 2023-06-11 11:17:17 +01:00

LuckPerms

Build Status javadoc Maven Central Discord

LuckPerms is a permissions plugin for Minecraft servers. It allows server admins to control what features players can use by creating groups and assigning permissions.

The latest downloads, wiki & other useful links can be found on the project homepage at luckperms.net.

It is:

  • fast - written with performance and scalability in mind.
  • reliable - trusted by thousands of server admins, and the largest of server networks.
  • easy to use - setup permissions using commands, directly in config files, or using the web editor.
  • flexible - supports a variety of data storage options, and works on lots of different server types.
  • extensive - a plethora of customization options and settings which can be changed to suit your server.
  • free - available for download and usage at no cost, and permissively licensed so it can remain free forever.

For more information, see the wiki article on Why LuckPerms?

Building

LuckPerms uses Gradle to handle dependencies & building.

Requirements

  • Java 8 JDK or newer
  • Git

Compiling from source

git clone https://github.com/lucko/LuckPerms.git
cd LuckPerms/
./gradlew build

You can find the output jars in the loader/build/libs or build/libs directories.

Tests

There are some automated tests which run during each build.

Contributing

Pull Requests

If you make any changes or improvements to the plugin which you think would be beneficial to others, please consider making a pull request to merge your changes back into the upstream project. (especially if your changes are bug fixes!)

LuckPerms loosely follows the Google Java Style Guide. Generally, try to copy the style of code found in the class you're editing.

Project Layout

The project is split up into a few separate modules.

  • API - The public, semantically versioned API used by other plugins wishing to integrate with and retrieve data from LuckPerms. This module (for the most part) does not contain any implementation itself, and is provided by the plugin.
  • Common - The common module contains most of the code which implements the respective LuckPerms plugins. This abstract module reduces duplicated code throughout the project.
  • Bukkit, BungeeCord, Fabric, Forge, Nukkit, Sponge & Velocity - Each use the common module to implement plugins on the respective server platforms.

License

LuckPerms is licensed under the permissive MIT license. Please see LICENSE.txt for more info.