A permissions plugin for Minecraft servers.
Go to file
Luck 8eed4558f4
Release API v4.4
2019-04-02 16:36:22 +01:00
api Release API v4.4 2019-04-02 16:36:22 +01:00
bukkit Implement special handling in the LP Vault implementation for NPC players (#1470) 2019-04-01 15:09:58 +01:00
bukkit-legacy Buildscript changes 2019-01-07 21:25:11 +00:00
bungee Code style: move private constructors for singleton classes to the top of the file 2019-03-05 12:36:09 +00:00
common Release API v4.4 2019-04-02 16:36:22 +01:00
gradle/wrapper Update Gradle to 5.0 2018-12-15 22:24:17 +00:00
nukkit Code style: move private constructors for singleton classes to the top of the file 2019-03-05 12:36:09 +00:00
sponge Refactor the HolderType enum 2019-03-08 20:19:08 +00:00
velocity Code style: move private constructors for singleton classes to the top of the file 2019-03-05 12:36:09 +00:00
.gitignore Update gitignore 2018-08-31 20:27:13 +01:00
CONTRIBUTING.md Fix some small typos (#1389) 2019-01-18 09:47:03 +00: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 Update README.md 2018-11-06 16:36:34 +00:00
build.gradle Release API v4.4 2019-04-02 16:36:22 +01:00
gradlew Make gradlew script executable by default (#1338) 2018-12-19 09:24:44 +00:00
gradlew.bat Update Gradle to 5.0 2018-12-15 22:24:17 +00:00
settings.gradle replace LoadingCache with more simple LoadingMap alternative when no auto expiry is needed 2018-12-14 18:37:56 +00:00

README.md

alt text

LuckPerms

Build Status Javadocs Maven Central Discord

LuckPerms is an advanced permissions implementation aiming to be a fast, reliable and flexible alternative to existing permission plugins. The project's main goals are centered around high performance and a wide feature set, filling the gaps of functionality and building upon existing features found in other plugins.

LuckPerms also includes an extensive API for developers, and support for a variety of Minecraft server software & data storage options.

Still not convinced? More information can be found on the wiki, under: Why LuckPerms?

The latest downloads can be found on the project's homepage.

More information about the project & how to use the plugin can be found in the wiki.

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 build/libs directories.

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, Sponge, Nukkit & 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.