LuckPerms/README.md

64 lines
3.5 KiB
Markdown
Raw Normal View History

2016-09-14 21:16:36 +02:00
![alt text](https://i.imgur.com/7TwJZ5e.png "Banner")
2016-07-26 04:39:56 +02:00
# LuckPerms [![Build Status](https://ci.lucko.me/job/LuckPerms/badge/icon)](https://ci.lucko.me/job/LuckPerms/)
2017-01-27 21:37:27 +01:00
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.
[See the charts below](https://github.com/lucko/LuckPerms#luckperms-vs-other-plugins) for a partial list of features & comparison with other providers.
* [Spigot Plugin Release Page](https://www.spigotmc.org/resources/luckperms-an-advanced-permissions-system.28140/ "Spigot Plugin Page")
* [Sponge Plugin Release Page](https://forums.spongepowered.org/t/luckperms-an-advanced-permissions-system/14274 "Sponge Plugin Page")
2016-07-21 22:40:24 +02:00
2017-01-27 21:37:27 +01:00
## Useful Links
2016-08-02 15:12:06 +02:00
* **Development Builds** - <https://ci.lucko.me/job/LuckPerms>
2017-02-23 22:59:43 +01:00
* **Javadocs** - <https://luckperms.lucko.me/javadocs/>
2016-08-20 18:49:23 +02:00
* **Wiki** - <https://github.com/lucko/LuckPerms/wiki>
2016-07-26 04:39:56 +02:00
2017-01-27 21:37:27 +01:00
## Building
LuckPerms uses Maven to handle dependencies.
2016-08-19 22:54:40 +02:00
2017-01-27 21:37:27 +01:00
#### Requirements
2017-05-26 21:48:41 +02:00
* Java 8 JDK
2017-01-27 21:37:27 +01:00
* Maven 3.3.x (the older versions will not work.)
* Git
2016-11-12 18:27:15 +01:00
2017-01-27 21:37:27 +01:00
#### Then run
```sh
git clone https://github.com/lucko/LuckPerms.git
2017-05-26 21:48:41 +02:00
cd LuckPerms/
2017-01-27 21:37:27 +01:00
mvn clean package
```
2016-11-12 18:27:15 +01:00
2017-05-26 21:48:41 +02:00
You can find the output jars in the `target` directories.
## Contributing
In order to contribute to and make changes to the plugin, you will need the dependencies listed above, plus the [Lombok plugin](https://projectlombok.org/download.html) for your IDE.
#### Pull Requests
If you make any changes or improvements to the plugin which you think would be beneficial upstream, 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](https://google.github.io/styleguide/javaguide.html), with a few minor changes here and there. Generally, try to copy the style of code found in the class you're editing.
#### Project Layout
The project is split up into 5 seperate modules.
* **API** - The public facing API classes used by other plugins when integrating with LuckPerms. This is basically just a collection of interfaces implemented inside of the plugin.
* **Common** - This includes all of the classes shared by separate implementations of LuckPerms. This is where the bulk of the project is.
* **Bukkit, BungeeCord & Sponge** - Includes all of the platform specific classes used to implement LuckPerms on each of the 3 supported platforms.
2017-01-27 21:37:27 +01:00
## License
LuckPerms is licensed under the permissive MIT license. Please see [`LICENSE.txt`](https://github.com/lucko/LuckPerms/blob/master/LICENSE.txt) for more info.
2016-09-14 21:16:36 +02:00
2017-10-12 21:25:51 +02:00
## Why use LuckPerms?
The main features of LuckPerms are detailed on this wiki page: [Why LuckPerms?](https://github.com/lucko/LuckPerms/wiki/Why-LuckPerms)
2016-10-09 11:58:14 +02:00
### Bukkit
2017-10-12 21:25:51 +02:00
See [here](https://luckperms.lucko.me/assets/bukkit-compare.png) for a comparison chart showing the differences between LuckPerms and other permission plugins for Bukkit.
2017-03-11 00:30:08 +01:00
2016-10-09 11:58:14 +02:00
### Sponge
LuckPerms is currently the only maintained and 'working' permissions plugin for Sponge servers.
2017-03-11 00:30:08 +01:00
2016-09-10 10:04:59 +02:00
2017-01-27 21:37:27 +01:00
## Thanks
2017-02-23 22:59:43 +01:00
Thanks to ej-technologies for granting LuckPerms an open source licence to their [Java Profiling Software](http://www.ej-technologies.com/products/jprofiler/overview.html "Java Profiler").