LuckPerms/README.md

42 lines
3.2 KiB
Markdown
Raw Normal View History

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/)
2016-08-05 12:58:27 +02:00
A permissions implementation for Bukkit/Spigot, BungeeCord and Sponge.
2016-07-21 22:40:24 +02:00
2016-07-26 04:39:56 +02:00
## Links
2016-08-02 15:12:06 +02:00
* **Development Builds** - <https://ci.lucko.me/job/LuckPerms>
* **Javadocs** - <https://jd.lucko.me/LuckPerms>
2016-08-20 18:49:23 +02:00
* **Wiki** - <https://github.com/lucko/LuckPerms/wiki>
2016-07-26 04:39:56 +02:00
2016-08-19 22:54:40 +02:00
## Why LuckPerms?
_Features checked on 19th Aug 2016. If you find any inaccuracies, please do let me know. I tried to be as fair as possible, and copy all major features from the respective plugin pages._
![alt text](https://static.lucko.me/luckperms-compare.png "Feature comparison")
2016-07-21 22:40:24 +02:00
## Features
* **Group inheritance** - users can be members of multiple groups, groups can inherit other groups
* **Temporary permissions** - users/groups can be given permissions that expire after a given time
2016-08-07 01:16:05 +02:00
* **Wildcard permissions** - users/groups can be given wildcard permissions (e.g. "minecraft.command.*"), even when plugins haven't implemented their own wildcards.
2016-07-21 22:40:24 +02:00
* **Temporary groups** - users/groups can be added to/inherit other groups temporarily
* **Multi-server support** - data is synced across all servers/platforms
2016-07-25 12:18:35 +02:00
* **Full offline-mode/mixed-mode support** - player permissions are synced properly over offline-mode or mixed online/offline-mode networks.
2016-07-21 22:40:24 +02:00
* **Per-server permissions/groups** - define user/group permissions that only apply on certain servers
2016-07-25 19:19:36 +02:00
* **Per-world permissions/groups** - define user/group permissions that only apply on certain worlds (on BungeeCord, a connected Bukkit/Spigot instance is treated as a world)
* **Tracks / paths / ladders** - users can be promoted/demoted along multiple group tracks
2016-07-21 22:40:24 +02:00
* **Vault Support** - hooks into Vault to integrate with other plugins
* **Developer API** - easily integrate LuckPerms into your own projects
* **Advanced action logging** - keep track of permission changes over time
2016-08-18 13:30:51 +02:00
* **Easily switch between storage systems** - export a log file from one datastore and import it into another
2016-07-21 22:40:24 +02:00
* **Easy and simple setup and configuration using commands** - no editing yml files, yuck
2016-07-25 19:19:36 +02:00
* **Negated permissions and groups** - define special rules for certain users/groups
* **Regex permissions** - define special permissions using regex
* **Shorthand nodes** - add nodes using the LuckPerms shorthand system
2016-07-25 19:19:36 +02:00
* **Full support for UUIDs, even in Offline Mode** - users can change their usernames without losing permissions. In offline mode, a single user has the same internal UUID across a network.
* **Permission data stored within MySQL in a json format** - easily integrate the LuckPerms backend into your other projects
* **Well documented** - API methods have comprehensive Java docs, it's clear what each method does.
2016-07-21 22:40:24 +02:00
* **Efficient/lightweight** - maybe? Who knows, it might be.
2016-07-25 19:19:36 +02:00
* **Open Sourced, Free...** - you shouldn't have to pay $10+ for a "powerful" permissions plugin.
2016-08-05 12:58:27 +02:00
* **BungeeCord compatible** - permissions, users and groups are synced across all LuckPerms instances
* **Sponge compatible** - permissions, users and groups are synced across all LuckPerms instances (bukkit --> sponge, for example)
* **Support for MySQL, MongoDB, SQLite, H2 & Flatfile (JSON)** - other storage methods coming soon (maybe)
2016-07-21 22:40:24 +02:00
## License
2016-08-06 18:28:38 +02:00
See LICENSE.md.