Hello hello!
I’d like to take the opportinity to wish everyone a belated Merry Christmas, and a (slightly early) Happy New Year! Hopefully you’ve all been enjoying the holidays so far. :)
It’s time for an update - a late Christmas gift if you like!
Well well, it’s finally happening! After months of work, we’re finally ready to release the first version of LuckPerms v5.
This update is a bit more significant to others in the past, so please read until the end and take note of all of the details of the changelog.
Hundreds of developer hours have been put into this update, and approx 40k lines of code - it has been 6 months in the making (that’s honestly no exaggeration, the first commit was in back in May!).
As always, if you’d like to support the work I and many others put into the project (please!):
- Consider sponsoring me on Patreon (https://www.patreon.com/luckdev)
- ‘Star’ the project on GitHub (https://github.com/lucko/LuckPerms)
- Keep spreading the word!
What’s new?
- A brand new version of the Web Editor.
- We’ve taken the old version and just made it oh-so-much better.
- Completely rewritten, allowing so much more than was possible before. You can now control all aspects of your servers permissions setup from a sleek, modern web app in your browser.
- An all new & completely rewritten Developer API.
- After months of refinement, we’re releasing a brand new developer API for the plugin.
- Written to more closely encapsulate the functionality of the plugin, and (hopefully!) be easier to use and understand.
- Countless improvements to smaller features, including:
- An improved approach to file based action logging
- A new compressed import/export format for the LuckPerms backup commands
- Drastically improved performance for the verbose command.
What else has changed?
- Default assignments have been removed.
- We’ve taken the decision to remove this feature from the plugin - it was felt as being a bad fit in the functionality offered by a permission plugin. (and it was quite badly implemented too, oops)
- A number of “undocumented” command aliases have been removed.
- These were confusing to new users, and made it easy to mistakenly run a command that did x when you wanted y.
- A new extension system has been implemented, allowing “bolt on” functionality to be installed and run alongside the plugin.
- The first two extensions to be released are compatibility bridges, the first to allow existing plugins written against the now-removed v4 API to continue working, and another to re-implement default assignments for those that are still wanting to use them.
How do I update?
The all-new v5 release is available for download now at https://luckperms.net.
Before updating, I highly reccomend taking backups of your LuckPerms data (just using /lp export is probably good enough!)
If you have any other plugins on your server that use the existing v4 developer API, you’ll also want to install the extension-legacy-api extension.
For more information, please read the upgrade guide: https://github.com/lucko/LuckPerms/wiki/Upgrading-from-v4-to-v5.
Closing comments
I’d like to say an especially big ‘thank you’ to Turbo for all of his hard-work on the new version of the web editor. He’s done a fantastic job - if you see him around be sure to say thanks! And thank you to the projects Discord moderators, those who have contributed code/documentation/locale on GitHub, supporters on Patreon, and everyone else who has supported/reccomended/used the project over the past 3+ years.