API 5.4

This reverts commit d6c810aa71.

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: lucko
+patreon: luckdev

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,63 @@
+name: 🐛 ​ Bug report
+description: Report an issue or problem with the way LuckPerms is functioning.
+labels: ["type: issue"]
+body:
+  - type: markdown
+    attributes:
+      value: "Before going any further, please check to see if your problem is fixed by updating to a newer version. The latest development builds can be obtained from https://luckperms.net/download"
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Please provide a short description of the issue in the space below.
+      placeholder: Description goes here!
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: Reproduction Steps
+      description: Please provide a clear list of steps we should follow in order to reproduce your issue in the space below.
+      placeholder: List reproduction steps here, please!
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behaviour
+    attributes:
+      label: Expected Behaviour
+      description: Please provide a description of what you expected to happen.
+      placeholder: Describe what you expected to happen here.
+    validations:
+      required: true
+  - type: input
+    id: server-info
+    attributes:
+      label: Server Details
+      description: Please provide a description of the server details, including type and specific version number.
+      placeholder: 'git-Paper-124 (MC: 1.17.1)'
+    validations:
+      required: true
+  - type: input
+    id: luckperms-version
+    attributes:
+      label: LuckPerms Version
+      description: Please provide the specific, precise version number of LuckPerms you are using to reproduce this bug.
+      placeholder: v5.3.70
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs and Configs
+      description: If you think it would be helpful, please also include a pastebin of any relevant config files or log output. You should use https://gist.github.com/ to upload, then include the link below. 
+      placeholder: https://gist.github.com/HelpfulBugReporter/ThisIsAVeryUsefulLogOutput
+    validations:
+      required: false
+  - type: textarea
+    id: extra-info
+    attributes:
+      label: Extra Details
+      description: Please include any other relevant details in the space below.
+      placeholder: I was able to reproduce this only at the end of a rainbow.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 ​ Ask a question
+    url: https://discord.gg/luckperms
+    about: We use Discord to provide support for the project. If you have a question, need help, or aren't sure if you've found a bug or not, please come and talk to us there!

.github/ISSUE_TEMPLATE/suggestion.yml

@@ -0,0 +1,31 @@
+name: 💡 ​ Suggestion
+description: Suggest an idea for an improvement or change to LuckPerms.
+labels: ["type: suggestion"]
+body:
+  - type: markdown
+    attributes:
+      value: "Before going any further, please check to see if your suggestion has already been added by checking the [wiki](https://luckperms.net/wiki/Home). The latest development builds can be obtained from https://luckperms.net/download"
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Please provide a short description of your suggestion in the space below.
+      placeholder: Hello, perhaps you should...
+    validations:
+      required: true
+  - type: textarea
+    id: proposed-behaviour
+    attributes:
+      label: Proposed Behaviour
+      description: Please provide a short explanation of how the feature should work / be changed, and how this will affect the project.
+      placeholder: It would...
+    validations:
+      required: true
+  - type: textarea
+    id: extra-info
+    attributes:
+      label: Extra Details
+      description: Please include any other relevant details in the space below.
+      placeholder: I think this should only function at the end of a rainbow.
+    validations:
+      required: false

.gitignore

@@ -1,40 +1,14 @@
-# Created by https://www.gitignore.io/
-
-### Intellij ###
-# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and Webstorm
-# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
-
-# User-specific stuff:
-.idea/
-*.iws
-/out/
+### Gradle & IntelliJ ###
+.gradle/
+/.idea/
+build/
+out/
+run/
 *.iml
 .idea_modules/
 
-# JIRA plugin
-atlassian-ide-plugin.xml
-
-# Crashlytics plugin (for Android Studio and IntelliJ)
-com_crashlytics_export_strings.xml
-crashlytics.properties
-crashlytics-build.properties
-fabric.properties
-
-
-### Maven ###
-target/
-pom.xml.tag
-pom.xml.releaseBackup
-pom.xml.versionsBackup
-pom.xml.next
-release.properties
-dependency-reduced-pom.xml
-buildNumber.properties
-.mvn/timing.properties
-
 
 ### Eclipse ###
-
 .metadata
 bin/
 tmp/
@@ -46,73 +20,29 @@ local.properties
 .settings/
 .loadpath
 .recommenders
-
-# Eclipse Core
-.project
-
-# External tool builders
 .externalToolBuilders/
-
-# Locally stored "Eclipse launch configurations"
 *.launch
-
-# PyDev specific (Python IDE for Eclipse)
-*.pydevproject
-
-# CDT-specific (C/C++ Development Tooling)
-.cproject
-
-# JDT-specific (Eclipse Java Development Tools)
-.classpath
-
-# Java annotation processor (APT)
 .factorypath
-
-# PDT-specific (PHP Development Tools)
-.buildpath
-
-# sbteclipse plugin
-.target
-
-# Tern plugin
-.tern-project
-
-# TeXlipse plugin
-.texlipse
-
-# STS (Spring Tool Suite)
-.springBeans
-
-# Code Recommenders
 .recommenders/
+.apt_generated/
+.project
+.classpath
 
 
 ### Linux ###
 *~
-
-# temporary files which can be created if a process still has a handle open of a deleted file
 .fuse_hidden*
-
-# KDE directory preferences
 .directory
-
-# Linux trash folder which might appear on any partition or disk
 .Trash-*
-
-# .nfs files are created when an open file is removed but is still being accessed
 .nfs*
 
 
 ### macOS ###
-*.DS_Store
+.DS_Store
 .AppleDouble
 .LSOverride
-
-# Icon must end with two \r
 Icon
-# Thumbnails
 ._*
-# Files that might appear in the root of a volume
 .DocumentRevisions-V100
 .fseventsd
 .Spotlight-V100
@@ -120,7 +50,6 @@ Icon
 .Trashes
 .VolumeIcon.icns
 .com.apple.timemachine.donotpresent
-# Directories potentially created on remote AFP share
 .AppleDB
 .AppleDesktop
 Network Trash Folder
@@ -128,37 +57,21 @@ Temporary Items
 .apdisk
 
 
+### NetBeans ###
+nbproject/private/
+build/
+nbbuild/
+dist/
+nbdist/
+.nb-gradle/
+
+
 ### Windows ###
-# Windows image file caches
+# Windows thumbnail cache files
 Thumbs.db
 ehthumbs.db
-
-# Folder config file
-Desktop.ini
-
-# Recycle Bin used on file shares
+ehthumbs_vista.db
+*.stackdump
+[Dd]esktop.ini
 $RECYCLE.BIN/
-
-# Windows Installer files
-*.cab
-*.msi
-*.msm
-*.msp
-
-# Windows shortcuts
 *.lnk
-
-
-### Java ###
-*.class
-
-# Mobile Tools for Java (J2ME)
-.mtj.tmp/
-
-# Package Files #
-*.jar
-*.war
-*.ear
-
-# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
-hs_err_pid*

.locale/en_US.yml

@@ -1,726 +0,0 @@
-# LuckPerms Language File
-# Locale: en_US (English)
-# Author: Luck
-
-prefix: "&7&l[&b&lL&3&lP&7&l] &c"
-log-info: "&7&l[&bL&3P&7&l] &3{0}"
-log-warn: "&7&l[&bLuck&3Perms&7&l] &c[WARN] {0}"
-log-error: "&7&l[&bLuck&3Perms&7&l] &4[ERROR] {0}"
-empty: "{0}"
-player-online: "&aOnline"
-player-offline: "&cOffline"
-loading-error: "Permissions data could not be loaded. Please try again later."
-op-disabled: "&bThe vanilla OP system is disabled on this server."
-op-disabled-sponge: "&2Server Operator status has no effect when a permission plugin is installed. Please edit user data directly."
-log: "&3LOG &3&l> {0}"
-verbose-log: "&3VERBOSE &3&l> {0}"
-export-log: "&3EXPORT &3&l> &f{0}"
-export-log-progress: "&3EXPORT &3&l> &7{0}"
-migration-log: "&3MIGRATION &7[&3{0}&7] &3&l> &f{1}"
-migration-log-progress: "&3MIGRATION &7[&3{0}&7] &3&l> &7{1}"
-command-not-recognised: "Command not recognised."
-command-no-permission: "You do not have permission to use this command!"
-already-haspermission: "{0} already has this permission!"
-does-not-havepermission: "{0} does not have this permission set."
-already-has-temp-permission: "{0} already has this permission set temporarily!"
-does-not-have-temp-permission: "{0} does not have this permission set temporarily."
-user-not-found: "&bUser could not be found."
-user-not-online: "&bUser &a{0}&b is not online."
-user-save-error: "There was an error whilst saving the user."
-group-not-found: "&bGroup could not be found."
-group-save-error: "There was an error whilst saving the group."
-track-not-found: "&bTrack could not be found."
-track-save-error: "There was an error whilst saving the track."
-user-invalid-entry: "&d{0}&c is not a valid username/uuid."
-group-invalid-entry: "Group names can only contain alphanumeric characters."
-track-invalid-entry: "Track names can only contain alphanumeric characters."
-server-world-invalid-entry: "Server/world names can only contain alphanumeric characters and cannot exceed 36 characters in length."
-use-inherit-command: "Use the 'parent add' and 'parent remove' commands instead of specifying the node."
-verbose-invalid-filter: "&cInvalid verbose filter: &f{0}"
-verbose-on: "&bVerbose checking output set to &aTRUE &bfor all permissions."
-verbose-on-query: "&bVerbose checking output set to &aTRUE &bfor permissions matching filter: &f{0}"
-verbose-off: "&bVerbose checking output set to &cFALSE&b."
-verbose-recording-on: "&bVerbose recording set to &aTRUE &bfor all permissions."
-verbose-recording-on-query: "&bVerbose recording set to &aTRUE &bfor permissions matching filter: &f{0}"
-verbose-recording-upload-start: "&bVerbose recording was disabled. Uploading results..."
-verbose-recording-url: "&aVerbose results URL:"
-tree-upload-start: "&bGenerating permission tree..."
-tree-empty: "&aUnable to generate tree. No results were found."
-tree-url: "&aPermission Tree URL:"
-search-searching: "&aSearching for users and groups with &b{0}&a..."
-search-searching-members: "&aSearching for users and groups who inherit from &b{0}&a..."
-search-result: "&aFound &b{0}&a entries from &b{1}&a users and &b{2}&a groups."
-search-showing-users: "&bShowing user entries:"
-search-showing-groups: "&bShowing group entries:"
-search-showing-users-with-page: "&bShowing user entries:  {0}"
-search-showing-groups-with-page: "&bShowing group entries:  {0}"
-apply-edits-invalid-code: "&aInvalid code. &7({0})"
-apply-edits-unable-to-read: "&aUnable to read data using the given code. &7({0})"
-apply-edits-no-target: "&aUnable to parse the target of the edit. Please supply it as an extra argument."
-apply-edits-target-group-not-exists: "&aTarget group &b{0}&a does not exist."
-apply-edits-target-user-not-uuid: "&aTarget user &b{0}&a is not a valid uuid."
-apply-edits-target-user-unable-to-load: "&aUnable to load target user &b{0}&a."
-apply-edits-target-unknown: "&aInvalid target. &7({0})"
-apply-edits-success: "&aSuccessfully applied &b{0}&a nodes to &b{1}&a."
-editor-upload-failure: "&cUnable to upload permission data to the editor."
-editor-url: "&aEditor URL:"
-check-result: "&aPermission check result on user &b{0}&a for permission &b{1}&a: &f{2}"
-create-success: "&b{0}&a was successfully created."
-delete-success: "&b{0}&a was successfully deleted."
-rename-success: "&b{0}&a was successfully renamed to &b{1}&a."
-clone-success: "&b{0}&a was successfully cloned onto &b{1}&a."
-already-inherits: "{0} already inherits '{1}'."
-does-not-inherit: "{0} does not inherit '{1}'."
-already-temp-inherits: "{0} already temporarily inherits '{1}'."
-does-not-temp-inherit: "{0} does not temporarily inherit '{1}'."
-track-already-contains: "Track {0} already contains the group '{1}'."
-track-does-not-contain: "Track {0} does not contain the group '{1}'."
-track-ambiguous-call: "The user specified is a member of multiple groups on this track. Unable to determine their location."
-group-already-exists: "That group already exists!"
-group-does-not-exist: "That group does not exist!"
-group-load-error: "An unexpected error occurred. Group not loaded."
-groups-load-error: "An unexpected error occurred. Unable to load all groups."
-track-already-exists: "That track already exists!"
-track-does-not-exist: "That track does not exist!"
-track-load-error: "An unexpected error occurred. Track not loaded."
-tracks-load-error: "An unexpected error occurred. Unable to load all tracks."
-track-empty: "The track cannot be used as it is empty or contains only one group."
-update-task-request: "&bUpdate task scheduled."
-update-task-complete: "&aUpdate task finished."
-update-task-complete-network: "&aUpdate task finished. Now attempting to push to other servers."
-update-task-push-success: "&aOther servers were notified via &b{0} Messaging &asuccessfully."
-update-task-push-failure: "&cError whilst pushing changes to other servers."
-update-task-push-failure-not-setup: "&cError whilst pushing changes to other servers. A messaging service has not been configured."
-reload-config-success: "&aThe configuration file was reloaded. &7(some options will only apply after the server has restarted.)"
-info-top: >
-  {PREFIX}&2Running &bLuckPerms v{0}&2 by &bLuck&2.\n
-  {PREFIX}&f-  &3Platform: &f{1}\n
-  {PREFIX}&f-  &3Server Brand: &f{2}\n
-  {PREFIX}&f-  &3Server Version: &f{3}
-info-middle: >
-  {PREFIX}&f-  &bMessaging Type: &f{0}\n
-  {PREFIX}&f-  &bInstance:\n
-  {PREFIX}&f-     &3Server Name: &f{1}\n
-  {PREFIX}&f-     &3Online Players: &a{2}\n
-  {PREFIX}&f-     &3Unique Connections: &a{3}\n
-  {PREFIX}&f-     &3Uptime: &7{4}\n
-  {PREFIX}&f-     &3Local Data: &a{5} &7users, &a{6} &7groups, &a{7} &7tracks\n
-  {PREFIX}&f-     &3Context Calculators: &a{8}\n
-  {PREFIX}&f-     &3Known permissions: &a{9}\n
-  {PREFIX}&f-     &3Active processors: &7{10}
-create-group-error: "There was an error whilst creating the group."
-delete-group-error: "There was an error whilst deleting the group."
-delete-group-error-default: "You cannot delete the default group."
-groups-list: "&aGroups: &7(name, weight, tracks)"
-groups-list-entry: "&f-  &3{0} &7- &b{1}"
-groups-list-entry-with-tracks: "&f-  &3{0} &7- &b{1} &7- [&3{2}&7]"
-create-track-error: "There was an error whilst creating the track."
-delete-track-error: "There was an error whilst deleting the track."
-tracks-list: "&aTracks: {0}"
-listnodes: "&b{0}'s Nodes:"
-listnodes-with-page: "&b{0}'s Nodes:  {1}"
-listnodes-temp: "&b{0}'s Temporary Nodes:"
-listnodes-temp-with-page: "&b{0}'s Temporary Nodes:  {1}"
-listparents: "&b{0}'s Parent Groups:"
-listparents-temp: "&b{0}'s Temporary Parent Groups:"
-list-tracks: >
-  &b{0}'s Tracks:\n
-  {1}
-list-tracks-empty: "{0} is not on any tracks."
-context-pair-inline: "&3{0}=&b{1}"
-context-pair--global-inline: "&eglobal"
-context-pair-sep: "&a, "
-context-pair: "&8(&7{0}=&f{1}&8)"
-check-permission: "&b{0}&a has permission &b{1}&a set to {2}&a in context {3}&a."
-check-inherits-permission: "&b{0}&a has permission &b{1}&a set to {2}&a in context {3}&a. &7(inherited from &a{4}&7)"
-setpermission-success: "&aSet &b{0}&a to &b{1}&a for &b{2}&a in context {3}&a."
-setpermission-temp-success: "&aSet &b{0}&a to &b{1}&a for &b{2}&a for a duration of &b{3}&a in context {4}&a."
-unsetpermission-success: "&aUnset &b{0}&a for &b{1}&a in context {2}&a."
-unset-temp-permission-success: "&aUnset temporary permission &b{0}&a for &b{1}&a in context {2}&a."
-set-inherit-success: "&b{0}&a now inherits permissions from &b{1}&a in context {2}&a."
-set-temp-inherit-success: "&b{0}&a now inherits permissions from &b{1}&a for a duration of &b{2}&a in context {3}&a."
-set-parent-success: "&b{0}&a had their existing parent groups cleared, and now only inherits &b{1}&a in context {2}&a."
-set-track-parent-success: "&b{0}&a had their existing parent groups on track &b{1}&a cleared, and now only inherits &b{2}&a in context {3}&a."
-unset-inherit-success: "&b{0}&a no longer inherits permissions from &b{1}&a in context {2}&a."
-unset-temp-inherit-success: "&b{0}&a no longer temporarily inherits permissions from &b{1}&a in context {2}&a."
-clear-success: "&b{0}&a's permissions were cleared in context {1}&a. (&b{2}&a nodes were removed.)"
-clear-success-singular: "&b{0}&a's permissions were cleared in context {1}&a. (&b{2}&a node was removed.)"
-parent-clear-success: "&b{0}&a's parents were cleared in context {1}&a. (&b{2}&a nodes were removed.)"
-parent-clear-success-singular: "&b{0}&a's parents were cleared in context {1}&a. (&b{2}&a node was removed.)"
-parent-clear-track-success: "&b{0}&a's parents on track &b{1}&a were cleared in context {2}&a. (&b{3}&a nodes were removed.)"
-parent-clear-track-success-singular: "&b{0}&a's parents on track &b{1}&a were cleared in context {2}&a. (&b{3}&a node was removed.)"
-meta-clear-success: "&b{0}&a's meta matching type &b{1}&a was cleared in context {2}&a. (&b{3}&a nodes were removed.)"
-meta-clear-success-singular: "&b{0}&a's meta matching type &b{1}&a was cleared in context {2}&a. (&b{3}&a node was removed.)"
-illegal-date-error: "Could not parse date '{0}'."
-past-date-error: "You cannot set a date in the past!"
-chat-meta-prefix-header: "&b{0}'s Prefixes"
-chat-meta-suffix-header: "&b{0}'s Suffixes"
-meta-header: "&b{0}'s Meta"
-chat-meta-entry: "&b-> {0} &f- &f\"{1}&f\" &8(&7inherited from &a{2}&8)"
-chat-meta-entry-with-context: "&b-> {0} &f- &f\"{1}&f\" &8(&7inherited from &a{2}&8){3}"
-meta-entry: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7inherited from &a{2}&8)"
-meta-entry-with-context: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7inherited from &a{2}&8){3}"
-chat-meta-prefix-none: "&b{0} has no prefixes."
-chat-meta-suffix-none: "&b{0} has no suffixes."
-meta-none: "&b{0} has no meta."
-meta-invalid-priority: "Invalid priority '{0}'. Expected a number."
-already-has-chat-meta: "{0} already has that {1} set."
-does-not-have-chat-meta: "{0} doesn't have that {1} set."
-add-chatmeta-success: "&b{0}&a had {1} &f\"{2}&f\"&a set at a priority of &b{3}&a in context {4}&a."
-add-temp-chatmeta-success: "&b{0}&a had {1} &f\"{2}&f\"&a set at a priority of &b{3}&a for a duration of &b{4}&a in context {5}&a."
-remove-chatmeta-success: "&b{0}&a had {1} &f\"{2}&f\"&a at priority &b{3}&a removed in context {4}&a."
-bulk-remove-chatmeta-success: "&b{0}&a had all {1}es at priority &b{2}&a removed in context {3}&a."
-remove-temp-chatmeta-success: "&b{0}&a had temporary {1} &f\"{2}&f\"&a at priority &b{3}&a removed in context {4}&a."
-bulk-remove-temp-chatmeta-success: "&b{0}&a had all temporary {1}es at priority &b{2}&a removed in context {3}&a."
-already-has-meta: "{0} already has that meta key value pair set."
-set-meta-success: "&aSet meta value for key &f\"{0}&f\"&a to &f\"{1}&f\"&a for &b{2}&a in context {3}&a."
-set-meta-temp-success: "&aSet meta value for key &f\"{0}&f\"&a to &f\"{1}&f\"&a for &b{2}&a for a duration of &b{3}&a in context {4}&a."
-unset-meta-success: "&aUnset meta value with key &f\"{0}&f\"&a for &b{1}&a in context {2}&a."
-unset-meta-temp-success: "&aUnset temporary meta value with key &f\"{0}&f\"&a for &b{1}&a in context {2}&a."
-bulk-update-invalid-data-type: "Invalid type. Was expecting 'all', 'users' or 'groups'."
-bulk-update-invalid-constraint: "Invalid constraint &4{0}&c. Constraints should be in the format '&f<field> <comparison operator> <value>&c'."
-bulk-update-invalid-comparison: "Invalid comparison operator '&4{0}&c'. Expected one of the following: &f==  !=  ~~  ~!"
-bulk-update-queued: "&aBulk update operation was queued. &7(&f{0}&7)"
-bulk-update-confirm: "&aRun &b/{0} bulkupdate confirm {1} &ato execute the update."
-bulk-update-unknown-id: "&aOperation with id &b{0}&a does not exist or has expired."
-bulk-update-starting: "&aRunning bulk update."
-bulk-update-success: "&bBulk update completed successfully."
-bulk-update-failure: "&cBulk update failed. Check the console for errors."
-user-info-general: >
-  {PREFIX}&b&l> &bUser Info: &f{0}\n
-  {PREFIX}&f- &3UUID: &f{1}\n
-  {PREFIX}&f- &3Status: {2}\n
-  {PREFIX}&f- &3Primary Group: &f{3}\n
-  {PREFIX}&f- &aCounts:\n
-  {PREFIX}&f-    &3Permissions: &a{4}\n
-  {PREFIX}&f-    &3Temporary Permissions: &a{5}\n
-  {PREFIX}&f-    &3Prefixes: &a{6}\n
-  {PREFIX}&f-    &3Suffixes: &a{7}\n
-  {PREFIX}&f-    &3Meta: &a{8}
-user-info-data: >
-  {PREFIX}&f- &aCached Data:\n
-  {PREFIX}&f-    &3Has contextual data: {0}\n
-  {PREFIX}&f-    &3Current Contexts: {1}\n
-  {PREFIX}&f-    &3Current Prefix: {2}\n
-  {PREFIX}&f-    &3Current Suffix: {3}
-info-parent-header: "&f- &aParent Groups:"
-info-temp-parent-header: "&f- &aTemporary Parent Groups:"
-user-removegroup-error-primary: "You cannot remove a user from their primary group."
-user-primarygroup-success: "&b{0}&a's primary group was set to &b{1}&a."
-user-primarygroup-warn-option: "&cWarning: The primary group calculation method being used by this server &7({0}) &cmay not reflect this change."
-user-primarygroup-error-alreadyhas: "The user already has this group set as their primary group."
-user-primarygroup-error-notmember: "&b{0}&a was not already a member of &b{1}&a, adding them now."
-user-track-error-not-contain-group: "The user specified isn't already in any groups on this track."
-user-track-added-to-first: "&b{0}&a isn't in any groups on this track, so they were added to the first group, &b{1}&a in context {2}&a."
-user-promote-success: "&aPromoting user along track &b{0}&a from &b{1}&a to &b{2}&a in context {3}&a."
-user-promote-error-endoftrack: "The end of track &4{0}&c was reached. Unable to promote user."
-user-promote-error-malformed: >
-  {PREFIX}The next group on the track, {0}, no longer exists. Unable to promote user.\n
-  {PREFIX}Either create the group, or remove it from the track and try again.
-user-demote-success: "&aDemoting user along track &b{0}&a from &b{1}&a to &b{2}&a in context {3}&a."
-user-demote-endoftrack: "The end of track &4{0}&c was reached, so &4{1}&c was removed from &4{2}&c."
-user-demote-error-malformed: >
-  {PREFIX}The previous group on the track, {0}, no longer exists. Unable to demote user.\n
-  {PREFIX}Either create the group, or remove it from the track and try again.
-group-info-general: >
-  {PREFIX}&b&l> &bGroup Info: &f{0}\n
-  {PREFIX}&f- &3Display Name: &f{1}\n
-  {PREFIX}&f- &3Weight: &f{2}\n
-  {PREFIX}&f- &aCounts:\n
-  {PREFIX}&f-    &3Permissions: &a{3}\n
-  {PREFIX}&f-    &3Temporary Permissions: &a{4}\n
-  {PREFIX}&f-    &3Prefixes: &a{5}\n
-  {PREFIX}&f-    &3Suffixes: &a{6}\n
-  {PREFIX}&f-    &3Meta: &a{7}
-group-set-weight: "&aSet weight to &b{0}&a for group &b{1}&a."
-track-info: >
-  {PREFIX}&b&l> &bShowing Track: &f{0}\n
-  {PREFIX}&f- &7Path: &f{1}
-track-clear: "&b{0}&a's groups track was cleared."
-track-append-success: "&aGroup &b{0}&a was successfully appended to track &b{1}&a."
-track-insert-success: "&aGroup &b{0}&a was successfully inserted into track &b{1}&a at position &b{2}&a."
-track-insert-error-number: "Expected number but instead received: {0}"
-track-insert-error-invalid-pos: "Unable to insert at position {0}. Index out of bounds."
-track-remove-success: "&aGroup &b{0}&a was successfully removed from track &b{1}&a."
-log-load-error: "The log could not be loaded."
-log-invalid-page: "Invalid page number."
-log-invalid-page-range: "Invalid page number. Please enter a value between 1 and {0}."
-log-no-entries: "&bNo log entries to show."
-log-entry: "&b#{0} -> &8(&7{1} ago&8) {2}"
-log-notify-console: "&cCannot toggle notifications for console."
-log-notify-toggle-on: "&aEnabled&b logging output."
-log-notify-toggle-off: "&cDisabled&b logging output."
-log-notify-already-on: "You are already receiving notifications."
-log-notify-already-off: "You aren't currently receiving notifications."
-log-notify-unknown: "State unknown. Expecting \"on\" or \"off\"."
-log-search-header: "&aShowing recent actions for query &b{0} &a(page &f{1}&a of &f{2}&a)"
-log-recent-header: "&aShowing recent actions (page &f{0}&a of &f{1}&a)"
-log-recent-by-header: "&aShowing recent actions by &b{0} &a(page &f{1}&a of &f{2}&a)"
-log-history-user-header: "&aShowing history for user &b{0} &a(page &f{1}&a of &f{2}&a)"
-log-history-group-header: "&aShowing history for group &b{0} &a(page &f{1}&a of &f{2}&a)"
-log-history-track-header: "&aShowing history for track &b{0} &a(page &f{1}&a of &f{2}&a)"
-log-export-already-exists: "Error: File {0} already exists."
-log-export-not-writable: "Error: File {0} is not writable."
-log-export-empty: "The log is empty and therefore cannot be exported."
-log-export-failure: "An unexpected error occured whilst writing to the file."
-log-export-success: "&aSuccessfully exported the log to &b{0}&a."
-import-already-running: "Another import process is already running. Please wait for it to finish and try again."
-export-already-running: "Another export process is already running. Please wait for it to finish and try again."
-import-log-doesnt-exist: "Error: File {0} does not exist."
-import-log-not-readable: "Error: File {0} is not readable."
-import-log-failure: "An unexpected error occured whilst reading from the log file."
-import-progress: "&b(Import) &b-> &f{0} &fpercent complete &7- &b{1}&f/&b{2} &foperations complete with &c{3} &ferrors."
-import-progress-sin: "&b(Import) &b-> &f{0} &fpercent complete &7- &b{1}&f/&b{2} &foperations complete with &c{3} &ferror."
-import-start: "&b(Import) &b-> &fStarting import process."
-import-end-complete: "&b(Import) &a&lCOMPLETED &7- took &b{0} &7seconds - &7No errors."
-import-end-complete-err: "&b(Import) &a&lCOMPLETED &7- took &b{0} &7seconds - &c{1} errors."
-import-end-complete-err-sin: "&b(Import) &a&lCOMPLETED &7- took &b{0} &7seconds - &c{1} error."
-import-end-error-header: >
-  {PREFIX}&b(Import) &7------------> &fShowing Error #&b{0} &7<------------\n
-  {PREFIX}&b(Import) &fWhilst executing: &3Command #{1}\n
-  {PREFIX}&b(Import) &fCommand: &7{2}\n
-  {PREFIX}&b(Import) &fType: &3{3}\n
-  {PREFIX}&b(Import) &fOutput:
-import-end-error-content: "&b(Import) &b-> &c{0}"
-import-end-error-footer: "&b(Import) &7<------------------------------------------>"
-
-command-specs:
-  user:
-    description: "User commands"
-    usage: "/%s user <user>"
-  group:
-    description: "Group commands"
-    usage: "/%s group <group>"
-  track:
-    description: "Track commands"
-    usage: "/%s track <track>"
-  log:
-    description: "Log commands"
-    usage: "/%s log"
-  sync:
-    description: "Sync changes with the storage"
-    usage: "/%s sync"
-  info:
-    description: "Print general plugin info"
-    usage: "/%s info"
-  verbose:
-    description: "Manage verbose permission checking"
-    usage: "/%s verbose <true|false> [filter]"
-    args:
-      "on|record|off|paste": "whether to enable/disable logging, or to paste the logged output"
-      "filter": "the filter to match entries against"
-  tree:
-    description: "Generate a tree view of permissions"
-    usage: "/%s tree [selection] [max level] [player]"
-    args:
-      "selection": "the root of the tree. specify \".\" to include all permissions"
-      "max level": "how many branch levels should be returned"
-      "player": "the name of an online player to check against"
-  search:
-    description: "Search for users/groups with a specific permission"
-    usage: "/%s search <permission>"
-    args:
-      "permission": "the permission to search for"
-      "page": "the page to view"
-  check:
-    description: "Perform a standard permission check on an online player"
-    usage: "/%s check <user> <permission>"
-    args:
-      "user": "the user to check"
-      "permission": "the permission to check for"
-  network-sync:
-    description: "Sync changes with the storage and request that all other servers on the network do the same"
-    usage: "/%s networksync"
-  import:
-    description: "Import data from a file"
-    usage: "/%s import <file>"
-    args:
-      "file": "the file to import from"
-  export:
-    description: "Export data to a file"
-    usage: "/%s export <file>"
-    args:
-      "file": "the file to export to"
-  reload-config:
-    description: "Reload some of the config options"
-    usage: "/%s reloadconfig"
-  bulk-update:
-    description: "Execute bulk change queries on all data"
-    usage: "/%s bulkupdate"
-    args:
-      "data type": "the type of data being changed. ('all', 'users' or 'groups')"
-      "action": "the action to perform on the data. ('update' or 'delete')"
-      "action field": "the field to act upon. only required for 'update'. ('permission', 'server' or 'world')"
-      "action value": "the value to replace with. only required for 'update'."
-      "constraint...": "the constraints required for the update"
-  migration:
-    description: "Migration commands"
-    usage: "/%s migration"
-  apply-edits:
-    description: "Applies permission changes made from the web editor"
-    usage: "/%s applyedits <code> [target]"
-    args:
-      "code": "the unique code for the data"
-      "target": "who to apply the data to"
-  create-group:
-    description: "Create a new group"
-    usage: "/%s creategroup <group>"
-    args:
-      "name": "the name of the group"
-  delete-group:
-    description: "Delete a group"
-    usage: "/%s deletegroup <group>"
-    args:
-      "name": "the name of the group"
-  list-groups:
-    description: "List all groups on the platform"
-    usage: "/%s listgroups"
-  create-track:
-    description: "Create a new track"
-    usage: "/%s createtrack <track>"
-    args:
-      "name": "the name of the track"
-  delete-track:
-    description: "Delete a track"
-    usage: "/%s deletetrack <track>"
-    args:
-      "name": "the name of the track"
-  list-tracks:
-    description: "List all tracks on the platform"
-    usage: "/%s listtracks"
-  user-info:
-    description: "Shows info about the user"
-  user-switchprimarygroup:
-    description: "Switches the user's primary group"
-    args:
-      "group": "the group to switch to"
-  user-promote:
-    description: "Promotes the user up a track"
-    args:
-      "track": "the track to promote the user up"
-      "context...": "the contexts to promote the user in"
-  user-demote:
-    description: "Demotes the user down a track"
-    args:
-      "track": "the track to demote the user down"
-      "context...": "the contexts to demote the user in"
-  group-info:
-    description: "Gives info about the group"
-  group-listmembers:
-    description: "Show the users/groups who inherit from this group"
-    args:
-      "page": "the page to view"
-  group-setweight:
-    description: "Set the groups weight"
-    args:
-      "weight": "the weight to set"
-  group-rename:
-    description: "Rename the group"
-    args:
-      "name": "the new name"
-  group-clone:
-    description: "Clone the group"
-    args:
-      "name": "the name of the group to clone onto"
-  holder-editor:
-    description: "Opens the web permission editor"
-  holder-showtracks:
-    description: "Lists the tracks that the object is on"
-  holder-clear:
-    description: "Removes all permissions, parents and meta"
-    args:
-      "context...": "the contexts to filter by"
-  permission:
-    description: "Edit permissions"
-  parent:
-    description: "Edit inheritances"
-  meta:
-    description: "Edit metadata values"
-  permission-info:
-    description: "Lists the permission nodes the object has"
-    args:
-      "page": "the page to view"
-      "filter": "the string to filter by"
-  permission-set:
-    description: "Sets a permission for the object"
-    args:
-      "node": "the permission node to set"
-      "true|false": "the value of the node"
-      "context...": "the contexts to add the permission in"
-  permission-unset:
-    description: "Unsets a permission for the object"
-    args:
-      "node": "the permission node to unset"
-      "context...": "the contexts to remove the permission in"
-  permission-settemp:
-    description: "Sets a permission for the object temporarily"
-    args:
-      "node": "the permission node to set"
-      "true|false": "the value of the node"
-      "duration": "the duration until the permission node expires"
-      "context...": "the contexts to add the permission in"
-  permission-unsettemp:
-    description: "Unsets a temporary permission for the object"
-    args:
-      "node": "the permission node to unset"
-      "context...": "the contexts to remove the permission in"
-  permission-check:
-    description: "Checks to see if the object has a certain permission node"
-    args:
-      "node": "the permission node to check for"
-      "context...": "the contexts to check in"
-  permission-check-inherits:
-    description: "Checks to see if the object inherits a certain permission node"
-    args:
-      "node": "the permission node to check for"
-      "context...": "the contexts to check in"
-  parent-info:
-    description: "Lists the groups that this object inherits from"
-  parent-set:
-    description: "Removes all other groups the object inherits already and adds them to the one given"
-    args:
-      "group": "the group to set to"
-      "context...": "the contexts to set the group in"
-  parent-add:
-    description: "Sets another group for the object to inherit permissions from"
-    args:
-      "group": "the group to inherit from"
-      "context...": "the contexts to inherit the group in"
-  parent-remove:
-    description: "Removes a previously set inheritance rule"
-    args:
-      "group": "the group to remove"
-      "context...": "the contexts to remove the group in"
-  parent-set-track:
-    description: "Removes all other groups the object inherits from already on the given track and adds them to the one given"
-    args:
-      "track": "the track to set on"
-      "group": "the group to set to, or a number relating to the position of the group on the given track"
-      "context...": "the contexts to set the group in"
-  parent-add-temp:
-    description: "Sets another group for the object to inherit permissions from temporarily"
-    args:
-      "group": "the group to inherit from"
-      "duration": "the duration of the group membership"
-      "context...": "the contexts to inherit the group in"
-  parent-remove-temp:
-    description: "Removes a previously set temporary inheritance rule"
-    args:
-      "group": "the group to remove"
-      "context...": "the contexts to remove the group in"
-  parent-clear:
-    description: "Clears all parents"
-    args:
-      "context...": "the contexts to filter by"
-  parent-clear-track:
-    description: "Clears all parents on a given track"
-    args:
-      "track": "the track to remove on"
-      "context...": "the contexts to filter by"
-  meta-info:
-    description: "Shows all chat meta"
-  meta-set:
-    description: "Sets a meta value"
-    args:
-      "key": "the key to set"
-      "value": "the value to set"
-      "context...": "the contexts to add the meta pair in"
-  meta-unset:
-    description: "Unsets a meta value"
-    args:
-      "key": "the key to unset"
-      "context...": "the contexts to remove the meta pair in"
-  meta-settemp:
-    description: "Sets a meta value temporarily"
-    args:
-      "key": "the key to set"
-      "value": "the value to set"
-      "duration": "the duration until the meta value expires"
-      "context...": "the contexts to add the meta pair in"
-  meta-unsettemp:
-    description: "Unsets a temporary meta value"
-    args:
-      "key": "the key to unset"
-      "context...": "the contexts to remove the meta pair in"
-  meta-addprefix:
-    description: "Adds a prefix"
-    args:
-      "priority": "the priority to add the prefix at"
-      "prefix": "the prefix string"
-      "context...": "the contexts to add the prefix in"
-  meta-addsuffix:
-    description: "Adds a suffix"
-    args:
-      "priority": "the priority to add the suffix at"
-      "suffix": "the suffix string"
-      "context...": "the contexts to add the suffix in"
-  meta-removeprefix:
-    description: "Removes a prefix"
-    args:
-      "priority": "the priority to remove the prefix at"
-      "prefix": "the prefix string"
-      "context...": "the contexts to remove the prefix in"
-  meta-removesuffix:
-    description: "Removes a suffix"
-    args:
-      "priority": "the priority to remove the suffix at"
-      "suffix": "the suffix string"
-      "context...": "the contexts to remove the suffix in"
-  meta-addtemp-prefix:
-    description: "Adds a prefix temporarily"
-    args:
-      "priority": "the priority to add the prefix at"
-      "prefix": "the prefix string"
-      "duration": "the duration until the prefix expires"
-      "context...": "the contexts to add the prefix in"
-  meta-addtemp-suffix:
-    description: "Adds a suffix temporarily"
-    args:
-      "priority": "the priority to add the suffix at"
-      "suffix": "the suffix string"
-      "duration": "the duration until the suffix expires"
-      "context...": "the contexts to add the suffix in"
-  meta-removetemp-prefix:
-    description: "Removes a temporary prefix"
-    args:
-      "priority": "the priority to remove the prefix at"
-      "prefix": "the prefix string"
-      "context...": "the contexts to remove the prefix in"
-  meta-removetemp-suffix:
-    description: "Removes a temporary suffix"
-    args:
-      "priority": "the priority to remove the suffix at"
-      "suffix": "the suffix string"
-      "context...": "the contexts to remove the suffix in"
-  meta-clear:
-    description: "Clears all meta"
-    args:
-      "type": "the type of meta to remove"
-      "context...": "the contexts to filter by"
-  track-info:
-    description: "Gives info about the track"
-  track-append:
-    description: "Appends a group onto the end of the track"
-    args:
-      "group": "the group to append"
-  track-insert:
-    description: "Inserts a group at a given position along the track"
-    args:
-      "group": "the group to insert"
-      "position": "the position to insert the group at (the first position on the track is 1)"
-  track-remove:
-    description: "Removes a group from the track"
-    args:
-      "group": "the group to remove"
-  track-clear:
-    description: "Clears the groups on the track"
-  track-rename:
-    description: "Rename the track"
-    args:
-      "name": "the new name"
-  track-clone:
-    description: "Clone the track"
-    args:
-      "name": "the name of the track to clone onto"
-  log-recent:
-    description: "View recent actions"
-    args:
-      "user": "the name/uuid of the user to filter by"
-      "page": "the page number to view"
-  log-search:
-    description: "Search the log for an entry"
-    args:
-      "query": "the query to search by"
-      "page": "the page number to view"
-  log-notify:
-    description: "Toggle log notifications"
-    args:
-      "on|off": "whether to toggle on or off"
-  log-user-history:
-    description: "View a user's history"
-    args:
-      "user": "the name/uuid of the user"
-      "page": "the page number to view"
-  log-group-history:
-    description: "View an group's history"
-    args:
-      "group": "the name of the group"
-      "page": "the page number to view"
-  log-track-history:
-    description: "View a track's history"
-    args:
-      "track": "the name of the track"
-      "page": "the page number to view"
-  sponge:
-    description: "Edit extra Sponge data"
-    usage: "/%s sponge <collection> <subject>"
-    args:
-      "collection": "the collection to query"
-      "subject": "the subject to modify"
-  sponge-permission-info:
-    description: "Shows info about the subject's permissions"
-    args:
-      "contexts...": "the contexts to filter by"
-  sponge-permission-set:
-    description: "Sets a permission for the Subject"
-    args:
-      "node": "the permission node to set"
-      "tristate": "the value to set the permission to"
-      "contexts...": "the contexts to set the permission in"
-  sponge-permission-clear:
-    description: "Clears the Subjects permissions"
-    args:
-      "contexts...": "the contexts to clear permissions in"
-  sponge-parent-info:
-    description: "Shows info about the subject's parents"
-    args:
-      "contexts...": "the contexts to filter by"
-  sponge-parent-add:
-    description: "Adds a parent to the Subject"
-    args:
-      "collection": "the subject collection where the parent Subject is"
-      "subject": "the name of the parent Subject"
-      "contexts...": "the contexts to add the parent in"
-  sponge-parent-remove:
-    description: "Removes a parent from the Subject"
-    args:
-      "collection": "the subject collection where the parent Subject is"
-      "subject": "the name of the parent Subject"
-      "contexts...": "the contexts to remove the parent in"
-  sponge-parent-clear:
-    description: "Clears the Subjects parents"
-    args:
-      "contexts...": "the contexts to clear parents in"
-  sponge-option-info:
-    description: "Shows info about the subject's options"
-    args:
-      "contexts...": "the contexts to filter by"
-  sponge-option-set:
-    description: "Sets an option for the Subject"
-    args:
-      "key": "the key to set"
-      "value": "the value to set the key to"
-      "contexts...": "the contexts to set the option in"
-  sponge-option-unset:
-    description: "Unsets an option for the Subject"
-    args:
-      "key": "the key to unset"
-      "contexts...": "the contexts to unset the key in"
-  sponge-option-clear:
-    description: "Clears the Subjects options"
-    args:
-      "contexts...": "the contexts to clear options in"
-  migration-command:
-    description: "Migration command"
-  migration-groupmanager:
-    description: "Migration command"
-    args:
-      "migrate as global": "if world permissions should be ignored, and just migrated as global"
-  migration-powerfulperms:
-    description: "Migration command"
-    args:
-      "address": "the address of the PP database"
-      "database": "the name of the PP database"
-      "username": "the username to log into the DB"
-      "password": "the password to log into the DB"
-      "db table": "the name of the PP table where player data is stored"

.locale/es_ES.yml

@@ -1,338 +0,0 @@
-# LuckPerms Language File
-# Locale: es_ES (Spanish)
-# Author: Jose Chavez (Twitter: @JoCHav3z)
-
-prefix: "&7&l[&b&lL&3&lP&7&l] &c"
-log-info: "&7&l[&bL&3P&7&l] &3{0}"
-log-warn: "&7&l[&bLuck&3Perms&7&l] &c[ADVERTENCIA] {0}"
-log-error: "&7&l[&bLuck&3Perms&7&l] &4[ERROR] {0}"
-empty: "{0}"
-player-online: "&aConectado"
-player-offline: "&cDesconectado"
-loading-error: "La Informacion de los permisos no pudo ser cargada. Por favor contacte al administrador."
-op-disabled: "&bEl sistema OP de Vanilla esta deshabilitado en este servidor."
-op-disabled-sponge: "&2El estado de operador del servidor no tiene efecto cuando un plugin de permisos esta instalado. Por favor edite la informacion de usuario directamente."
-log: "&3LOG &3&l> {0}"
-export-log: "&3EXPORTAR &3&l> &f{0}"
-export-log-progress: "&3EXPORTADO &3&l> &7{0}"
-migration-log: "&3MIGRACION &7[&3{0}&7] &3&l> &f{1}"
-migration-log-progress: "&3MIGRADO &7[&3{0}&7] &3&l> &7{1}"
-command-not-recognised: "Comando no reconocido."
-command-no-permission: "¡No tienes permiso de usar este comando!"
-already-haspermission: "{0} ¡Ya tienes este permiso!"
-does-not-havepermission: "{0} No tienes este permiso establecido."
-already-has-temp-permission: "{0} ¡Ya tienes este permiso establecido temporalmente!"
-does-not-have-temp-permission: "{0} No tienes este permiso establecido temporalmente."
-user-not-found: "&bNo se pudo encontrar al usuario."
-user-not-online: "&bUsuario &a{0}&b no esta conectado."
-user-no-data: "&bUsuario &a{0}&b no tiene ningún dato cargado."
-user-save-success: "&7(Los datos del usuario se guardaron en el almacenamiento)"
-user-save-error: "Se ha producido un error al guardar el usuario."
-user-create-fail: "Se produjo un error al crear un nuevo usuario."
-group-not-found: "&bEl Grupo no se pudo encontrar."
-group-save-success: "&7(Los datos del grupo se guardaron en el almacenamiento)"
-group-save-error: "Se ha producido un error al guardar el grupo."
-track-not-found: "&bNo se pudo encontrar la pista."
-track-save-success: "&7(Los datos de la pista se guardaron en el almacenamiento)"
-track-save-error: "Se ha producido un error al guardar la pista."
-user-invalid-entry: "&d{0}&c El username/uuid no es valido."
-group-invalid-entry: "Los nombres de grupo sólo pueden contener caracteres alfanuméricos."
-track-invalid-entry: "Los nombres de pista sólo pueden contener caracteres alfanuméricos."
-server-invalid-entry: "Los nombres de servidor sólo pueden contener caracteres alfanuméricos."
-use-inherit-command: "Usa el comando 'parent add' y 'parent remove' en vez de especificar el nodo."
-verbose-invalid-filter: "&cFiltro Verbose invalido: &f{0}"
-verbose-on: "&bEl chequeo Verbose de salida se ha establecido en &aTRUE &bpara todos los permisos."
-verbose-on-query: "&bEl chequeo Verbose de salida que se establecio en &aTRUE &bpara los permisos se ha pareado con los siguientes filtros: &f{0}"
-verbose-off: "&bEl chequeo Verbose de salida que se establecio en &cFALSE&b."
-verbose-recording-on: "&bGrabacion de Verbose establecida en &aTRUE &bpara todos los permisos."
-verbose-recording-on-query: "&bGrabacion de Verbose establecida en &aTRUE &bpara los permisos se ha pareado con los siguientes filtros: &f{0}"
-verbose-recording-upload-start: "&bGrabacion de Verbose se ha deshabilitado. Cargando resultados..."
-verbose-recording-url: "&aURL de resultados de Verbose:"
-tree-upload-start: "&bGenerando arbol de permisos..."
-tree-empty: "&aNo se puede generar el árbol. No se encontraron resultados."
-tree-url: "&aURL de arbol de permisos:"
-search-searching: "&aBúsqueda de usuarios y grupos con &b{0}&a..."
-search-result: "&aEncontradas &b{0}&a entradas por parte de &b{1}&a usuarios y &b{2}&a grupos."
-search-showing-users: "&bMostrando entradas del usuario:"
-search-showing-groups: "&bMostrando entradas del grupo:"
-search-showing-users-with-page: "&bMostrando entradas del usuario:  {0}"
-search-showing-groups-with-page: "&bMostrando entradas del grupo:  {0}"
-check-result: "&aResultado de la comprobación del permiso en el usuario &b{0}&a para permiso &b{1}&a: &f{2}"
-create-success: "&b{0}&a se creó correctamente."
-delete-success: "&b{0}&a fue eliminado correctamente."
-rename-success: "&b{0}&a fue exitosamente renombrado a &b{1}&a."
-clone-success: "&b{0}&a fue clonado con éxito en &b{1}&a."
-already-inherits: "{0} ya hereda '{1}'."
-does-not-inherit: "{0} no hereda '{1}'."
-already-temp-inherits: "{0} ya lo heredo temporalmente a '{1}'."
-does-not-temp-inherit: "{0} no lo heredo temporalmente a '{1}'."
-track-already-contains: "La pista {0} ya contiene el grupo '{1}'."
-track-does-not-contain: "La pista {0} no contiene el grupo '{1}'."
-track-ambiguous-call: "El usuario especificado es miembro de varios grupos en esta pista. No se puede determinar su ubicación."
-group-already-exists: "¡Ese grupo ya existe!"
-group-does-not-exist: "¡Ese grupo no existe!"
-group-load-error: "Ocurrió un error inesperado. No se pudo cargar el grupo."
-groups-load-error: "Ocurrió un error inesperado. No se pueden cargar todos los grupos."
-track-already-exists: "¡La pista ya existe!"
-track-does-not-exist: "¡La pista no existe!"
-track-load-error: "Ocurrió un error inesperado. No se pudo cargar la pista."
-tracks-load-error: "Ocurrió un error inesperado. No se pueden cargar todas las pistas."
-track-empty: "La pista no se puede utilizar porque está vacía o contiene sólo un grupo."
-update-task-request: "&bActualizar tarea programada."
-update-task-complete: "&aLa actualizacion de la tarea a finalizado."
-update-task-complete-network: "&aLa actualizacion de la tarea a finalizado. Ahora intentando enviar a otros servidores."
-update-task-push-success: "&aOtros servidores fueron notificados vía &b{0} Mensajería &aexitoxamente."
-update-task-push-failure: "&cError al empujar cambios a otros servidores."
-update-task-push-failure-not-setup: "&cError al presionar los cambios a otros servidores. No se ha configurado un servicio de mensajería."
-reload-config-success: "&aSe ha vuelto a cargar el archivo de configuración. &7(Algunas opciones sólo se aplicarán después de que el servidor se haya reiniciado.)"
-info: >
-  {PREFIX}&2Running &bLuckPerms v{0}&2 by &bLuck&2.\n
-  {PREFIX}&f-  &3Platform: &f{1}\n
-  {PREFIX}&f-  &3Storage Method: &f{2}\n
-  {PREFIX}&f-  &3Server Name: &f{3}\n
-  {PREFIX}&f-  &3Sync Interval: &a{4} &fminutes\n
-  {PREFIX}&f-  &3Messaging Service: &f{5}\n
-  {PREFIX}&f-  &bCounts:\n
-  {PREFIX}&f-     &3Online Players: &a{6}\n
-  {PREFIX}&f-     &3Loaded Users: &a{7}\n
-  {PREFIX}&f-     &3Loaded Groups: &a{8}\n
-  {PREFIX}&f-     &3Loaded Tracks: &a{9}\n
-  {PREFIX}&f-     &3Log size: &a{10}\n
-  {PREFIX}&f-     &3UUID Cache size: &a{11}\n
-  {PREFIX}&f-     &3Translations loaded: &a{12}\n
-  {PREFIX}&f-     &3Pre-process contexts: &a{13}\n
-  {PREFIX}&f-     &3Context Calculators: &a{14}\n
-  {PREFIX}&f-     &3Unique permissions: &a{15}\n
-  {PREFIX}&f-  &bConfiguration:\n
-  {PREFIX}&f-     &3Use Server UUIDs: {16}\n
-  {PREFIX}&f-     &bPermission Calculation:\n
-  {PREFIX}&f-        &3Including Global: {17}\n
-  {PREFIX}&f-        &3Including Global World: {18}\n
-  {PREFIX}&f-        &3Applying Global Groups: {19}\n
-  {PREFIX}&f-        &3Applying Global World Groups: {20}\n
-  {PREFIX}&f-        &3Applying Wildcards: {21}\n
-  {PREFIX}&f-        &3Applying Regex: {22}\n
-  {PREFIX}&f-        &3Applying Shorthand: {23}
-create-group-error: "Se produjo un error al crear el grupo."
-delete-group-error: "Se produjo un error al eliminar el grupo."
-delete-group-error-default: "No puede eliminar el grupo predeterminado."
-groups-list: "&aGrupos: {0}"
-create-track-error: "Se produjo un error al crear la pista."
-delete-track-error: "Se produjo un error al eliminar la pista."
-tracks-list: "&aPistas: {0}"
-listnodes: "&b{0}'s Nodos:"
-listnodes-with-page: "&b{0}'s Nodos:  {1}"
-listnodes-temp: >
-  &b{0}'s Temporary Nodes:\n
-  {1}
-listparents: >
-  &b{0}'s Parent Groups:\n
-  {1}
-listparents-temp: >
-  &b{0}'s Temporary Parent Groups:\n
-  {1}
-listgroups: >
-  &b{0}'s Groups:\n
-  {1}
-listgroups-temp: >
-  &b{0}'s Temporary Groups:\n
-  {1}
-list-tracks: >
-  &b{0}'s Tracks:\n
-  {1}
-list-tracks-empty: "{0} no está en ninguna pista."
-setpermission-success: "&aEstablecer &b{0}&a a &b{1}&a para &b{2}&a."
-setpermission-server-success: "&aEstablecer &b{0}&a a &b{1}&a para &b{2}&a en el servidor &b{3}&a."
-setpermission-server-world-success: "&aEstablecer &b{0}&a a &b{1}&a para &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a."
-setpermission-temp-success: "&aEstablecer &b{0}&a a &b{1}&a para &b{2}&a por una duracion de &b{3}&a."
-setpermission-temp-server-success: "&aEstablecer &b{0}&a a &b{1}&a para &b{2}&a en el servidor &b{3}&a por una duracion de &b{4}&a."
-setpermission-temp-server-world-success: "&aEstablecer &b{0}&a a &b{1}&a para &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a, por una duracion de &b{5}&a."
-unsetpermission-success: "&aDesestablecer &b{0}&a para &b{1}&a."
-unsetpermission-server-success: "&aDesestablecer &b{0}&a para &b{1}&a en el servidor &b{2}&a."
-unsetpermission-server-world-success: "&aDesestablecer &b{0}&a para &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a."
-unset-temp-permission-success: "&aDesestablecer temporalmente el permiso &b{0}&a para &b{1}&a."
-unset-temp-permission-server-success: "&aDesestablecer temporalmente el permiso &b{0}&a para &b{1}&a en el servidor &b{2}&a."
-unset-temp-permission-server-world-success: "&aDesestablecer temporalmente el permiso &b{0}&a para &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a."
-set-inherit-success: "&b{0}&a ahora hereda los permisos de &b{1}&a."
-set-inherit-server-success: "&b{0}&a ahora hereda los permisos de &b{1}&a en el servidor &b{2}&a."
-set-inherit-server-world-success: "&b{0}&a ahora hereda los permisos de &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a."
-set-parent-success: "&b{0}&a sus grupos parentales existentes han sido borrados, y ahora solo heredan &b{1}&a."
-set-parent-server-success: "&b{0}&a sus grupos parentales existentes han sido borrados, y ahora solo heredan &b{1}&a en el servidor &b{2}&a."
-set-parent-server-world-success: "&b{0}&a sus grupos parentales existentes han sido borrados, y ahora solo heredan &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a."
-set-temp-inherit-success: "&b{0}&a ahora heredan permisos de &b{1}&a por una duracion de &b{2}&a."
-set-temp-inherit-server-success: "&b{0}&a ahora heredan permisos de &b{1}&a en el servidor &b{2}&a por una duracion de &b{3}&a."
-set-temp-inherit-server-world-success: "&b{0}&a ahora heredan permisos de &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a, por una duracion de &b{4}&a."
-unset-inherit-success: "&b{0}&a ya no hereda los permisos de &b{1}&a."
-unset-inherit-server-success: "&b{0}&a ya no hereda los permisos de &b{1}&a en el servidor &b{2}&a."
-unset-inherit-server-world-success: "&b{0}&a ya no hereda los permisos de &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a."
-unset-temp-inherit-success: "&b{0}&a ya no hereda temporalmente los permisos de &b{1}&a."
-unset-temp-inherit-server-success: "&b{0}&a ya no hereda temporalmente los permisos &b{1}&a en el servidor &b{2}&a."
-unset-temp-inherit-server-world-success: "&b{0}&a ya no hereda temporalmente los permisos &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a."
-clear-success: "&b{0}&a's permisos fueron borrados. (&b{1}&a nodos fueron removidos.)"
-clear-success-singular: "&b{0}&a's permisos fueron borrados. (&b{1}&a nodo fue removido.)"
-parent-clear-success: "&b{0}&a's los padres fueron eliminados. (&b{1}&a nodos fueron removidos.)"
-parent-clear-success-singular: "&b{0}&a's los padres fueron eliminados. (&b{1}&a nodo fue removido.)"
-meta-clear-success: "&b{0}&a's meta fue eliminada. (&b{1}&a nodos fueron removidos.)"
-meta-clear-success-singular: "&b{0}&a's meta fue eliminada. (&b{1}&a nodo fue removido.)"
-illegal-date-error: "No se pudo analizar la fecha '{0}'."
-past-date-error: "¡No puedes fijar una fecha en el pasado!"
-chat-meta-prefix-header: "&b{0}'s Prefijos"
-chat-meta-suffix-header: "&b{0}'s Sufijos"
-meta-header: "&b{0}'s Meta"
-chat-meta-entry: "&b-> {0} &f- &f\"{1}&f\" &8(&7heredado de &a{2}&8)"
-chat-meta-entry-with-context: "&b-> {0} &f- &f\"{1}&f\" &8(&7heredado de &a{2}&8){3}"
-meta-entry: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7heredado de &a{2}&8)"
-meta-entry-with-context: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7heredado de &a{2}&8){3}"
-chat-meta-prefix-none: "&b{0} no tiene prefijos."
-chat-meta-suffix-none: "&b{0} no tiene sufijos."
-meta-none: "&b{0} no tiene meta."
-meta-invalid-priority: "Prioridad no válida '{0}'. Se esperaba un número."
-already-has-prefix: "{0} ya tiene ese prefijo establecido."
-already-has-suffix: "{0} ya tiene ese sufijo establecido."
-does-not-have-prefix: "{0} no tiene ese prefijo establecido."
-does-not-have-suffix: "{0} no tiene ese sufijo establecido."
-addprefix-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a establecido como prioridad de &b{2}&a."
-addprefix-server-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a establecido como prioridad de &b{2}&a en el servidor &b{3}&a."
-addprefix-server-world-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a establecido como prioridad de &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a."
-removeprefix-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido."
-removeprefix-server-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido en el servidor &b{3}&a."
-removeprefix-server-world-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido en el servidor &b{3}&a, mundo &b{4}&a."
-addsuffix-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a establecido en prioridad de &b{2}&a."
-addsuffix-server-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a establecido en prioridad de &b{2}&a en el servidor &b{3}&a."
-addsuffix-server-world-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a establecido en prioridad de &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a."
-removesuffix-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido."
-removesuffix-server-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido en el servidor &b{3}&a."
-removesuffix-server-world-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido en el servidor &b{3}&a, mundo &b{4}&a."
-add-temp-prefix-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a en prioridad de &b{2}&a por una duracion de &b{3}&a."
-add-temp-prefix-server-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a establecido en prioridad de &b{2}&a en el servidor &b{3}&a, por una duracion de &b{4}&a."
-add-temp-prefix-server-world-success: "&b{0}&a tiene el prefijo &f\"{1}&f\"&a establecido en prioridad de &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a, por una duracion de &b{5}&a."
-remove-temp-prefix-success: "&b{0}&a tiene temporalmente el prefijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido."
-remove-temp-prefix-server-success: "&b{0}&a tiene temporalmente el prefijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido en el servidor &b{3}&a."
-remove-temp-prefix-server-world-success: "&b{0}&a tiene temporalmente el prefijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido en el servidor &b{3}&a, mundo &b{4}&a."
-add-temp-suffix-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a establecido en prioridad de &b{2}&a por una duracion de &b{3}&a."
-add-temp-suffix-server-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a establecido en prioridad de &b{2}&a en el servidor &b{3}&a, por una duracion de &b{4}&a."
-add-temp-suffix-server-world-success: "&b{0}&a tiene el sufijo &f\"{1}&f\"&a establecido en prioridad de &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a, por una duracion de &b{5}&a."
-remove-temp-suffix-success: "&b{0}&a tiene temporalmente el sufijo &f\"{1}&f\"&a en prioridad de &b{1}&a removido."
-remove-temp-suffix-server-success: "&b{0}&a tiene temporalmente el sufijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido en el servidor &b{3}&a."
-remove-temp-suffix-server-world-success: "&b{0}&a tiene temporalmente el sufijo &f\"{1}&f\"&a en prioridad de &b{2}&a removido en el servidor &b{3}&a, mundo &b{4}&a."
-already-has-meta: "{0} ya tiene ese par de valores de llave meta establecido."
-set-meta-success: "&aEstablecer el valor meta para la llave &f\"{0}&f\"&a a &f\"{1}&f\"&a para &b{2}&a."
-set-meta-server-success: "&aEstablecer el valor meta para la llave &f\"{0}&f\"&a a &f\"{1}&f\"&a para &b{2}&a en el servidor &b{3}&a."
-set-meta-server-world-success: "&aEstablecer el valor meta para la llave &f\"{0}&f\"&a a &f\"{1}&f\"&a para &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a."
-set-meta-temp-success: "&aEstablecer el valor meta para la llave &f\"{0}&f\"&a a &f\"{1}&f\"&a para &b{2}&a por una duracion de &b{3}&a."
-set-meta-temp-server-success: "&aEstablecer el valor meta para la llave &f\"{0}&f\"&a a &f\"{1}&f\"&a para &b{2}&a en el servidor &b{3}&a por una duracion de &b{4}&a."
-set-meta-temp-server-world-success: "&aEstablecer el valor meta para la llave &f\"{0}&f\"&a a &f\"{1}&f\"&a para &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a, por una duracion de &b{5}&a."
-unset-meta-success: "&aDesestablecer el valor meta con la llave &f\"{0}&f\"&a para &b{1}&a."
-unset-meta-server-success: "&aDesestablecer el valor meta con la llave &f\"{0}&f\"&a para &b{1}&a en el servidor &b{2}&a."
-unset-meta-server-world-success: "&aDesestablecer el valor meta con la llave &f\"{0}&f\"&a for &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a."
-unset-meta-temp-success: "&aDesestablecer temporalmente el valor meta con la llave &f\"{0}&f\"&a para &b{1}&a."
-unset-meta-temp-server-success: "&aDesestablecer temporalmente el valor meta con la llave &f\"{0}&f\"&a para &b{1}&a en el servidor &b{2}&a."
-unset-meta-temp-server-world-success: "&aDesestablecer temporalmente el valor meta con la llave &f\"{0}&f\"&a para &b{1}&a en el servidor &b{2}&a, mundo &b{3}&a."
-bulk-change-type-error: "Tipo no válido. Se estaba esperando 'server' o 'world'."
-bulk-change-success: "&aEl cambio masivo fue aplicado correctamente. {0} los registros fueron cambiados."
-user-info-general: >
-  {PREFIX}&b&l> &bUser Info: &f{0}\n
-  {PREFIX}&f- &3UUID: &f{1}\n
-  {PREFIX}&f- &3Status: {2}\n
-  {PREFIX}&f- &3Primary Group: &f{3}\n
-  {PREFIX}&f- &aCounts:\n
-  {PREFIX}&f-    &3Permissions: &a{4}\n
-  {PREFIX}&f-    &3Temporary Permissions: &a{5}\n
-  {PREFIX}&f-    &3Prefixes: &a{6}\n
-  {PREFIX}&f-    &3Suffixes: &a{7}\n
-  {PREFIX}&f-    &3Meta: &a{8}
-user-info-data: >
-  {PREFIX}&f- &aCached Data:\n
-  {PREFIX}&f-    &3Is Loaded: {0}\n
-  {PREFIX}&f-    &3Current Contexts: {1}\n
-  {PREFIX}&f-    &3Current Prefix: {2}\n
-  {PREFIX}&f-    &3Current Suffix: {3}
-info-parent-header: "&f- &aGrupos Parentales:"
-info-temp-parent-header: "&f- &aGrupos Temporalmente Parentales:"
-user-getuuid: "&bEl UUID de &b{0}&b es &b{1}&b."
-user-removegroup-error-primary: "No puede eliminar un usuario de su grupo principal."
-user-primarygroup-success: "&b{0}&a's grupo primario se estableció &b{1}&a."
-user-primarygroup-warn-option: "&cAdvertencia: El método de cálculo de grupo primario utilizado por este servidor &7({0}) &cpuede no reflejar este cambio."
-user-primarygroup-error-alreadyhas: "El usuario ya tiene este grupo configurado como su grupo principal."
-user-primarygroup-error-notmember: "&b{0}&a ya no era miembro de &b{1}&a, agregándolos ahora."
-user-track-error-not-contain-group: "El usuario especificado ya no está en ningún grupo de esta pista."
-user-track-added-to-first: "&b{0}&a no está en ningún grupo en esta pista, por lo que se agregaron al primer grupo, &b{1}&a."
-user-track-added-to-first-server: "&b{0}&a no está en ningún grupo en esta pista, por lo que se agregaron al primer grupo, &b{1}&a, en el servidor &b{2}&a."
-user-track-added-to-first-server-world: "&b{0}&a no está en ningún grupo en esta pista, por lo que se agregaron al primer grupo, &b{1}&a, en el servidor &b{2}&a, mundo &b{3}&a."
-user-promote-success: "&aPromover al usuario a lo largo de la pista &b{0}&a desde &b{1}&a a &b{2}&a."
-user-promote-success-server: "&aPromover al usuario a lo largo de la pista &b{0}&a desde &b{1}&a a &b{2}&a en el servidor &b{3}&a."
-user-promote-success-server-world: "&aPromover al usuario a lo largo de la pista &b{0}&a desde &b{1}&a a &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a."
-user-promote-error-endoftrack: "El final de la pista &4{0}&c fue alcanzado. No se puede promover al usuario."
-user-promote-error-malformed: >
-  {PREFIX}The next group on the track, {0}, no longer exists. Unable to promote user.\n
-  {PREFIX}Either create the group, or remove it from the track and try again.
-user-demote-success: "&aDegradando al usuario a lo largo de la pista &b{0}&a desde &b{1}&a a &b{2}&a."
-user-demote-success-server: "&aDegradando al usuario a lo largo de la pista &b{0}&a desde &b{1}&a a &b{2}&a en el servidor &b{3}&a."
-user-demote-success-server-world: "&aDegradando al usuario a lo largo de la pista &b{0}&a desde &b{1}&a a &b{2}&a en el servidor &b{3}&a, mundo &b{4}&a."
-user-demote-endoftrack: "El final de la pista &4{0}&c fue alcanzado, asi que &4{1}&c fue removido de &4{2}&c."
-user-demote-error-malformed: >
-  {PREFIX}The previous group on the track, {0}, no longer exists. Unable to demote user.\n
-  {PREFIX}Either create the group, or remove it from the track and try again.
-user-showpos: >
-  &aShowing &b{0}&a's position on track &b{1}&a.\n
-  {2}
-group-info-general: >
-  {PREFIX}&b&l> &bGroup Info: &f{0}\n
-  {PREFIX}&f- &3Display Name: &f{1}\n
-  {PREFIX}&f- &3Weight: &f{2}\n
-  {PREFIX}&f- &aCounts:\n
-  {PREFIX}&f-    &3Permissions: &a{3}\n
-  {PREFIX}&f-    &3Temporary Permissions: &a{4}\n
-  {PREFIX}&f-    &3Prefixes: &a{5}\n
-  {PREFIX}&f-    &3Suffixes: &a{6}\n
-  {PREFIX}&f-    &3Meta: &a{7}
-group-set-weight: "&aEstablesca el peso a &b{0}&a para el grupo &b{1}&a."
-track-info: >
-  {PREFIX}&b&l> &bShowing Track: &f{0}\n
-  {PREFIX}&f- &7Path: &f{1}
-track-clear: "&b{0}&a's pista de grupos fue borrada."
-track-append-success: "&aGrupo &b{0}&a fue añadido con éxito a la pista &b{1}&a."
-track-insert-success: "&aGrupo &b{0}&a fue insertado con éxito en la pista &b{1}&a en la posicion &b{2}&a."
-track-insert-error-number: "Numero esperado en lugar de recibido: {0}"
-track-insert-error-invalid-pos: "No se puede insertar en la posición {0}. Indice fuera de los limites."
-track-remove-success: "&aGrupo &b{0}&a se eliminó correctamente de la pista &b{1}&a."
-log-load-error: "No se pudo cargar el registro."
-log-invalid-page: "Número de página no válido."
-log-invalid-page-range: "Número de página no válido. Por favor introduzca un valor entre 1 y {0}."
-log-no-entries: "&bNo hay entradas de registro que mostrar."
-log-entry: "&b#{0} -> &8(&7{1} hace&8) {2}"
-log-notify-toggle-on: "&aHabilitada&b salida de registro."
-log-notify-toggle-off: "&cDeshabilitada&b salida de registro."
-log-notify-already-on: "Ya está recibiendo notificaciones."
-log-notify-already-off: "Actualmente no estás recibiendo notificaciones."
-log-notify-unknown: "Estado desconocido. Esperando \"on\" o \"off\"."
-log-search-header: "&aMostrar acciones recientes para la consulta &b{0} &a(pagina &f{1}&a de &f{2}&a)"
-log-recent-header: "&aMostrando acciones recientes (pagina &f{0}&a de &f{1}&a)"
-log-recent-by-header: "&aMostrando las acciones recientes por &b{0} &a(pagina &f{1}&a de &f{2}&a)"
-log-history-user-header: "&aMostrando el historial del usuario &b{0} &a(pagina &f{1}&a de &f{2}&a)"
-log-history-group-header: "&aMostrando la historia del grupo &b{0} &a(pagina &f{1}&a de &f{2}&a)"
-log-history-track-header: "&aMostrando la historia de la pista &b{0} &a(pagina &f{1}&a de &f{2}&a)"
-log-export-already-exists: "Error: Archivo {0} ya existe."
-log-export-not-writable: "Error: Archivo {0} no se puede escribir."
-log-export-empty: "El registro está vacío y por lo tanto no puede ser exportado."
-log-export-failure: "Se ha producido un error inesperado al escribir en el archivo."
-log-export-success: "&aExitosamente exportó el registro a &b{0}&a."
-import-already-running: "Ya se está ejecutando otro proceso de importación. Por favor espere a que finalice e inténtelo de nuevo."
-export-already-running: "Ya se está ejecutando otro proceso de exportación. Por favor espere a que finalice e inténtelo de nuevo."
-import-log-doesnt-exist: "Error: Archivo {0} no existe."
-import-log-not-readable: "Error: Archivo {0} no es legible."
-import-log-failure: "Se ha producido un error inesperado al leer del archivo de registro."
-import-progress: "&b(Import) &b-> &f{0} &fporcentaje completado &7- &b{1}&f/&b{2} &fOperaciones completas con &c{3} &ferrores."
-import-progress-sin: "&b(Import) &b-> &f{0} &fporcentaje completado &7- &b{1}&f/&b{2} &fOperaciones completas con &c{3} &ferrores."
-import-start: "&b(Import) &b-> &fInicio del proceso de importación."
-import-end-complete: "&b(Import) &a&lCOMPLETADO &7- tomo &b{0} &7segundos - &7No errores."
-import-end-complete-err: "&b(Import) &a&lCOMPLETADO &7- tomo &b{0} &7segundos - &c{1} errores."
-import-end-complete-err-sin: "&b(Import) &a&lCOMPLETADO &7- tomo &b{0} &7segundos - &c{1} errores."
-import-end-error-header: >
-  {PREFIX}&b(Import) &7------------> &fShowing Error #&b{0} &7<------------\n
-  {PREFIX}&b(Import) &fWhilst executing: &3Command #{1}\n
-  {PREFIX}&b(Import) &fCommand: &7{2}\n
-  {PREFIX}&b(Import) &fType: &3{3}\n
-  {PREFIX}&b(Import) &fOutput:
-import-end-error-content: "&b(Import) &b-> &c{0}"
-import-end-error-footer: "&b(Import) &7<------------------------------------------>"

.locale/pl_PL.yml

@@ -1,290 +0,0 @@
-# LuckPerms Language File
-# Locale: pl_PL (Polish)
-# Author: dzegarek
-
-prefix: "&7&l[&b&lL&3&lP&7&l] &c"
-log-info: "&7&l[&bL&3P&7&l] &3{0}"
-log-warn: "&7&l[&bLuck&3Perms&7&l] &c[UWAGA] {0}"
-log-error: "&7&l[&bLuck&3Perms&7&l] &4[BŁĄD] {0}"
-empty: "{0}"
-player-online: "&aOnline"
-player-offline: "&cOffline"
-loading-error: "Nie można załadować danych uprawnień. Spróbuj ponownie później."
-op-disabled: "&bSystem vanilla OP jest wyłączony na tym serwerze."
-op-disabled-sponge: "&2Stan operatora serwera nie ma wpływu na instalację wtyczki uprawnień. Proszę bezpośrednio edytować dane użytkownika."
-log: "&3LOG &3&l> {0}"
-export-log: "&3Eksport &3&l> &f{0}"
-export-log-progress: "&3Eksport &3&l> &7{0}"
-migration-log: "&3MIGRACJA &7[&3{0}&7] &3&l> &f{1}"
-migration-log-progress: "&3MIGRACJA &7[&3{0}&7] &3&l> &7{1}"
-command-not-recognised: "Komenda nie została rozpoznana."
-command-no-permission: "Nie masz uprawnień do korzystania z tego polecenia!"
-already-haspermission: "{0} ma już to uprawnienie!"
-does-not-havepermission: "{0} nie ma tego zestawu uprawnień."
-already-has-temp-permission: "{0} ma już tymczasowo uprawnienie!"
-does-not-have-temp-permission: "{0} nie ma tymczasowego zezwolenia."
-user-not-found: "&bNie można znaleźć użytkownika."
-user-not-online: "&bUżytkownik &a{0}&b nie jest online."
-user-save-success: "&7(Dane użytkownika zostały zapisane w pamięci)"
-user-save-error: "Podczas zapisywania użytkownika wystąpił błąd."
-group-not-found: "&bNie można odnaleźć grupy."
-group-save-success: "&7(Dane grupy zostały zapisane w pamięci)"
-group-save-error: "Podczas zapisywania grupy wystąpił błąd."
-track-not-found: "&bŚcieżka nie została odnaleziona."
-track-save-success: "&7(Dane ścieżki zostały zapisane w pamięci)"
-track-save-error: "Podczas zapisywania ścieżki wystąpił błąd."
-user-invalid-entry: "&d{0}&c nie jest poprawną nazwą użytkownika/uuid."
-group-invalid-entry: "Nazwy grup mogą zawierać tylko znaki alfanumeryczne."
-track-invalid-entry: "Nazwy dróg mogą zawierać tylko znaki alfanumeryczne."
-server-world-invalid-entry: "Nazwy serwerów/świata mogą zawierać znaki alfanumeryczne, ale nie mogą przekraczać 36 znaków."
-use-inherit-command: "Użyj komendy 'parent add' lub 'parent remove' zamiast określenia węzła."
-verbose-invalid-filter: "&cNieprawidłowy szczegółowy filtr: &f{0}"
-verbose-on: "&bZapis szczegółowych plików wyjściowych ustawiony jest na & aTRUE & bdla wszystkich uprawnień."
-verbose-on-query: "&bZapis szczegółowych plików wyjściowych ustawiony jest na & aTRUE & bdla wszystkich pasujących do filtra: &f{0}"
-verbose-off: "&bZapis szczegółowych plików wyjściowych jest ustawiony na &cFALSE&b."
-verbose-recording-on: "&bVerbose recording set to &aTRUE &bfor all permissions."
-verbose-recording-on-query: "&bZapis szczegółowych zapisów jest ustawiony na &aTRUE &bdla wszystkich uprawnień pasujących do filtra: &f{0}"
-verbose-recording-upload-start: "&Zapis szczegółowych zapisów został wyłączony. Przesyłanie wyników..."
-verbose-recording-url: "&aSzczegółowe URL wyników:"
-tree-upload-start: "&bGenerowanie drzewa uprawnień..."
-tree-empty: "&aNie można wygenerować drzewa. Nie znaleziono żadnych wyników."
-tree-url: "&aURL drzewa uprawnień:"
-search-searching: "&aPoszukiwanie użytkowników i grup &b{0}&a..."
-search-searching-members: "&aWyszukiwanie użytkowników i grup, które dziedziczą &b{0}&a..."
-search-result: "&aZnaleziono &b{0}&a wpisy z &b{1}&a użytkowników i &b{2}&a grup."
-search-showing-users: "&bWyświetlanie wpisów użytkownika:"
-search-showing-groups: "&bWyświetlanie wpisów grup:"
-search-showing-users-with-page: "&bWyświetlanie wpisów użytkownika:  {0}"
-search-showing-groups-with-page: "&bWyświetlanie wpisów grup:  {0}"
-check-result: "&aWynik sprawdzenia uprawnień dla użytkownika &b{0}&a dla uprawnień &b{1}&a: &f{2}"
-create-success: "&b{0}&a został pomyślnie utworzone."
-delete-success: "&b{0}&a został pomyślnie usunięty."
-rename-success: "&b{0}&a został pomyślnie zmieniony na &b{1}&a."
-clone-success: "&b{0}&a został pomyślnie sklonowany na &b{1}&a."
-already-inherits: "{0} już dziedziczy '{1}'."
-does-not-inherit: "{0} nie dziedziczy '{1}'."
-already-temp-inherits: "{0} już tymczasowo dziedziczy '{1}'."
-does-not-temp-inherit: "{0} nie dziedziczy tymczasowo '{1}'."
-track-already-contains: "Ścieżka {0} zawiera już grupę '{1}'."
-track-does-not-contain: "Ścieżka {0} nie zawiera tej grupy '{1}'."
-track-ambiguous-call: "Podany użytkownik jest członkiem wielu grup na tej ścieżce. Nie można określić ich lokalizacji."
-group-already-exists: "Ta grupa już istnieje!"
-group-does-not-exist: "Ta grupa nie istnieje!"
-group-load-error: "Wystąpił nieoczekiwany błąd. Grupa nie została załadowana."
-groups-load-error: "Wystąpił nieoczekiwany błąd. Nie można załadować wszystkich grup."
-track-already-exists: "Ta ścieżka już istnieje!"
-track-does-not-exist: "Ta ścieżka nie istnieje!"
-track-load-error: "Wystąpił nieoczekiwany błąd. Ścieżka nie została załadowana."
-tracks-load-error: "Wystąpił nieoczekiwany błąd. Nie można wczytać wszystkich ścieżek."
-track-empty: "Ścieżka nie może być używana jako pusta lub zawierać tylko jedną grupę."
-update-task-request: "&bZaktualizuj zaplanowane zadanie."
-update-task-complete: "&aZaktualizowano zadanie."
-update-task-complete-network: "&aZaktualizowano zadanie. Teraz próbuj wejść na inne serwery."
-update-task-push-success: "&aInne serwery zostały powiadomione za pośrednictwem & b {0} wiadomości &apomyślnie."
-update-task-push-failure: "&cPodczas przesyłania zmian do innych serwerów wystąpił błąd."
-update-task-push-failure-not-setup: "&cPodczas przesyłania zmian do innych serwerów wystąpił błąd. Usługa wiadomości nie została skonfigurowana."
-reload-config-success: "&aPlik konfiguracyjny został ponownie załadowany. &7(niektóre opcje będą obowiązywać tylko po ponownym uruchomieniu serwera.)"
-info: >
-  {PREFIX}&2Uruchamianie &bLuckPerms v{0}&2 by &bLuck&2.\n
-  {PREFIX}&f-  &3Platforma: &f{1}\n
-  {PREFIX}&f-  &3Metoda Składowania: &f{2}\n
-  {PREFIX}&f-  &3Nazwa Serwera: &f{3}\n
-  {PREFIX}&f-  &3Synchronizacja Czasu: &a{4} &fminuty\n
-  {PREFIX}&f-  &3Usługa wiadomości: &f{5}\n
-  {PREFIX}&f-  &bLiczba:\n
-  {PREFIX}&f-     &3Online Graczy: &a{6}\n
-  {PREFIX}&f-     &3Załadowanych użytkowników: &a{7}\n
-  {PREFIX}&f-     &3Załadowanych grup: &a{8}\n
-  {PREFIX}&f-     &3Załadowanych Ścieżek: &a{9}\n
-  {PREFIX}&f-     &3Rozmiar Loga: &a{10}\n
-  {PREFIX}&f-     &3Rozmiar pamięci podręcznej UUID: &a{11}\n
-  {PREFIX}&f-     &3Załadowane tłumaczenia: &a{12}\n
-  {PREFIX}&f-     &3Kontrole wstępne: &a{13}\n
-  {PREFIX}&f-     &3Kalkulatory Kontekstu: &a{14}\n
-  {PREFIX}&f-     &3Unikalne uprawnienia: &a{15}\n
-  {PREFIX}&f-  &bKonfiguracja:\n
-  {PREFIX}&f-     &3Używany Server UUIDs: {16}\n
-  {PREFIX}&f-     &bObliczanie uprawnień:\n
-  {PREFIX}&f-        &3Łącznie ze światem: {17}\n
-  {PREFIX}&f-        &3Łącznie z globalnym światem: {18}\n
-  {PREFIX}&f-        &3Stosowanie grup globalnych: {19}\n
-  {PREFIX}&f-        &3Stosowanie Globalnych Grup Światowych: {20}\n
-  {PREFIX}&f-        &3Stosowanie symboli wieloznacznych: {21}\n
-  {PREFIX}&f-        &3Stosowanie Regex: {22}\n
-  {PREFIX}&f-        &3Stosowanie skrótu: {23}
-create-group-error: "Podczas tworzenia grupy wystąpił błąd."
-delete-group-error: "Podczas usuwania grupy wystąpił błąd."
-delete-group-error-default: "Nie można usunąć grupy domyślnej."
-groups-list: "&aGrupy: {0}"
-create-track-error: "Podczas tworzenia ścieżki wystąpił błąd."
-delete-track-error: "Podczas usuwania ścieżki wystąpił błąd."
-tracks-list: "&aŚcieżki: {0}"
-listnodes: "&b{0}'s Węzły:"
-listnodes-with-page: "&b{0}'s Węzły:  {1}"
-listnodes-temp: >
-  &b{0}'s Tymczasowe Węzły:\n
-  {1}
-listparents: >
-  &b{0}'s Grupy Rodzicielskie:\n
-  {1}
-listparents-temp: >
-  &b{0}'s Tymczasowe Grupy Rodzicielskie:\n
-  {1}
-list-tracks: >
-  &b{0}'s Ścieżki:\n
-  {1}
-list-tracks-empty: "{0} nie jest na żadnej ścieżce."
-context-pair-inline: "&3{0}=&b{1}"
-context-pair--global-inline: "&eglobalnie"
-context-pair-sep: "&a, "
-context-pair: "&8(&7{0}=&f{1}&8)"
-check-permission: "&b{0}&a ma uprawnienia &b{1}&a ustawione na {2}&a w kontekście {3}&a."
-setpermission-success: "&aUstawiono &b{0}&a na &b{1}&a dla &b{2}&a w kontekście {3}&a."
-setpermission-temp-success: "&aUstawiono &b{0}&a na &b{1}&a dla &b{2}&a na czas trwania &b{3}&a w kontekście {4}&a."
-unsetpermission-success: "&aUsunięto &b{0}&a dla &b{1}&a w kontekście {2}&a."
-unset-temp-permission-success: "&aTymczasowe uprawnienia &b{0}&a dla &b{1}&a w kontekście {2}&a."
-set-inherit-success: "&b{0}&a teraz dziedziczy uprawnienia od &b{1}&a w kontekście {2}&a."
-set-temp-inherit-success: "&b{0}&a teraz dziedziczy uprawnienia &b{1}&a na czas trwania &b{2}&a w kontekście {3}&a."
-set-parent-success: "&b{0}&a gdyby istniejące grupy macierzyste zostały wyczyszczone, a teraz tylko dziedziczą &b{1}&a w kontekście {2}&a."
-set-track-parent-success: "&b{0}&a miały istniejące grupy macierzyste na ścieżce &b{1}&a wyczyszczone, a teraz dziedziczą &b{2}&a w kontekście {3}&a."
-unset-inherit-success: "&b{0}&a już nie dziedziczy uprawnień &b{1}&a w kontekście {2}&a."
-unset-temp-inherit-success: "&b{0}&a przestaje tymczasowo dziedziczyć uprawnienia &b{1}&a w kontekście {2}&a."
-clear-success: "&b{0}&a's uprawnienia zostały wyczyszczone w kontekście {1}&a. (&b{2}&a węzły zostały usunięte.)"
-clear-success-singular: "&b{0}&a's uprawnienia zostały wyczyszczone w kontekście {1}&a. (&b{2}&a węzeł został usunięty.)"
-parent-clear-success: "&b{0}&a's rodzice zostali wyczyszczeni w kontekście {1}&a. &b{2}&a węzły zostały usunięte.)"
-parent-clear-success-singular: "&b{0}&a's rodzice zostali wyczyszczeni w kontekście {1}&a. &b{2}&a węzeł został usunięty.)"
-parent-clear-track-success: "&b{0}&a's rodzice na ścieżce &b{1}&a zostali wyczyszczeni w kontekście {2}&a. &b{3}&a węzły zostały usunięte.)"
-parent-clear-track-success-singular: "&b{0}&a's parents on track &b{1}&a were cleared in context {2}&a. &b{3}&a węzeł został usunięty.)"
-meta-clear-success: "&b{0}&a's meta zostały usunięte w kontekście {1}&a. &b{2}&a węzły zostały usunięte.)"
-meta-clear-success-singular: "&b{0}&a's meta zostały usunięte w kontekście {1}&a. &b{2}&a węzeł został usunięty.)"
-illegal-date-error: "Nie można przeanalizować daty '{0}'."
-past-date-error: "W przeszłości nie można ustawić daty!"
-chat-meta-prefix-header: "&b{0}'s Prefiksy"
-chat-meta-suffix-header: "&b{0}'s Suffiksy"
-meta-header: "&b{0}'s Meta"
-chat-meta-entry: "&b-> {0} &f- &f\"{1}&f\" &8(&7odziedziczone po &a{2}&8)"
-chat-meta-entry-with-context: "&b-> {0} &f- &f\"{1}&f\" &8(&7odziedziczone po &a{2}&8){3}"
-meta-entry: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7odziedziczone po &a{2}&8)"
-meta-entry-with-context: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7odziedziczone po &a{2}&8){3}"
-chat-meta-prefix-none: "&b{0} nie ma prefiksów."
-chat-meta-suffix-none: "&b{0} has no suffiksów."
-meta-none: "&b{0} nie ma meta."
-meta-invalid-priority: "Nieprawidłowy priorytet '{0}'. Spodziewany numer."
-already-has-chat-meta: "{0} już to ma {1} ustawione."
-does-not-have-chat-meta: "{0} nie ma tego {1} ustawionego."
-add-chatmeta-success: "&b{0}&a ma {1} &f\"{2}&f\"&a ustawiony priorytet z &b{3}&a w kontekście {4}&a."
-add-temp-chatmeta-success: "&b{0}&a ma {1} &f\"{2}&f\"&a ustawiony priorytet z &b{3}&a na czas trwania &b{4}&a w kontekście {5}&a."
-remove-chatmeta-success: "&b{0}&a ma {1} &f\"{2}&f\"&a at priority &b{3}&a removed in context {4}&a."
-bulk-remove-chatmeta-success: "&b{0}&a ma cały {1}es na priorytecie &b{2}&a usunięte w kontekście {3}&a."
-remove-temp-chatmeta-success: "&b{0}&a ma tymczasowo {1} &f\"{2}&f\"&a at priority &b{3}&a usunięte w kontekście {4}&a."
-bulk-remove-temp-chatmeta-success: "&b{0}&a miał wszystkie tymczasowe {1}es na priorytecie &b{2}&a usunięte w kontekście {3}&a."
-already-has-meta: "{0} ma już tę parę par kluczy meta."
-set-meta-success: "&aUstawiono wartość meta dla klucza &f\"{0}&f\"&a do &f\"{1}&f\"&a dla &b{2}&a w kontekście {3}&a."
-set-meta-temp-success: "&aUstawiono wartości meta dla klucza &f\"{0}&f\"&a do &f\"{1}&f\"&a dla &b{2}&a na czas trwania &b{3}&a w kontekście {4}&a."
-unset-meta-success: "&aUsunięto wartość meta za pomocą klucza &f\"{0}&f\"&a dla &b{1}&a w kontekście {2}&a."
-unset-meta-temp-success: "&aUsunięcie tymczasowej wartości meta za pomocą klucza &f\"{0}&f\"&a dla &b{1}&a w kontekście {2}&a."
-bulk-update-invalid-data-type: "Nieprawidłowy typ. Spodziewane 'all', 'users' lub 'groups'."
-bulk-update-invalid-constraint: "Nieprawidłowe ograniczenie &4{0}&c. Ograniczenia powinny być w formacie '&f<field> <comparison operator> <value>&c'."
-bulk-update-invalid-comparison: "Nieprawidłowy operator porównania '&4{0}&c'. Oczekiwany jeden z poniższych: &f==  !=  ~~  ~!"
-bulk-update-queued: "&aOperacja aktualizacji została w kolejce. &7(&f{0}&7)"
-bulk-update-confirm: "&aUruchom &b/{0} uaktualnianie zbiorcze {1} &a i wykonaj aktualizacje."
-bulk-update-unknown-id: "&aOperacja z id &b{0}&a nie istnieje lub upłynął."
-bulk-update-starting: "&aUaktualnianie zbiorcze."
-bulk-update-success: "&bAktualizacja zbiorcza powiodła się pomyślnie."
-bulk-update-failure: "&cAktualizacja zbiorcza nie powiodła się. Sprawdź, czy konsola nie zawiera błędów."
-user-info-general: >
-  {PREFIX}&b&l> &bInfo Użytkownika: &f{0}\n
-  {PREFIX}&f- &3UUID: &f{1}\n
-  {PREFIX}&f- &3Status: {2}\n
-  {PREFIX}&f- &3Grupa Podstawowa: &f{3}\n
-  {PREFIX}&f- &aLiczba:\n
-  {PREFIX}&f-    &3Uprawnień: &a{4}\n
-  {PREFIX}&f-    &3Tymczasowych uprawnień: &a{5}\n
-  {PREFIX}&f-    &3Prefiksów: &a{6}\n
-  {PREFIX}&f-    &3Suffiksów: &a{7}\n
-  {PREFIX}&f-    &3Meta: &a{8}
-user-info-data: >
-  {PREFIX}&f- &aDane buforowane:\n
-  {PREFIX}&f-    &3Posiada dane kontekstowe: {0}\n
-  {PREFIX}&f-    &3Obecne konteksty: {1}\n
-  {PREFIX}&f-    &3Obecny Prefiks: {2}\n
-  {PREFIX}&f-    &3Obecny Suffiks: {3}
-info-parent-header: "&f- &aGrupy Rodziców:"
-info-temp-parent-header: "&f- &aTymczasowe Grupy Rodziców:"
-user-removegroup-error-primary: "Nie można usunąć użytkownika z podstawowej grupy."
-user-primarygroup-success: "&b{0}&a's pierwsza grupa została ustawiona na &b{1}&a."
-user-primarygroup-warn-option: "&cUwaga: Podstawowa metoda obliczania grupy jest używana przez ten serwer &7({0}) &cmoże nie odzwierciedlać tej zmiany."
-user-primarygroup-error-alreadyhas: "Użytkownik ma już tę grupę jako pierwszą."
-user-primarygroup-error-notmember: "&b{0}&a nie był już użytkownikiem z &b{1}&a, dodając je teraz."
-user-track-error-not-contain-group: "Podany przez Ciebie użytkownik nie jest jeszcze w żadnej z grup na tej ścieżce."
-user-track-added-to-first: "&b{0}&a nie jest w żadnej grupie na tej ścieżce, więc został dodany do pierwszej grupy, &b{1}&a w kontekście {2}&a."
-user-promote-success: "&aPromowanie użytkownika wzdłuż toru &b{0}&a z &b{1}&a do &b{2}&a w kontekście {3}&a."
-user-promote-error-endoftrack: "Koniec ścieżki &4{0}&c został osiągnięty. Nie można promować użytkownika."
-user-promote-error-malformed: >
-  {PREFIX}Następna grupa na ścieżce, {0}, już nie istnieje. Nie można promować użytkownika..\n
-  {PREFIX}Albo utwórz grupę lub usuń ją ze ścieżki i spróbuj ponownie.
-user-demote-success: "&aObniżanie użytkownika wzdłuż ścieżki &b{0}&a z &b{1}&a do &b{2}&a w kontekście {3}&a."
-user-demote-endoftrack: "Koniec ścieżki &4{0}&c został osiągnięty, więc &4{1}&c zostało usunięte z &4{2}&c."
-user-demote-error-malformed: >
-  {PREFIX}Poprzednia grupa na ścieżce, {0}, już nie istnieje. Nie można obniżyć użytkownika.\n
-  {PREFIX}Albo utwórz grupę lub usuń ją ze ścieżki i spróbuj ponownie.
-group-info-general: >
-  {PREFIX}&b&l> &bInfo Grupy: &f{0}\n
-  {PREFIX}&f- &3Wyświetlana Nazwa: &f{1}\n
-  {PREFIX}&f- &3Rola: &f{2}\n
-  {PREFIX}&f- &aLiczba:\n
-  {PREFIX}&f-    &3Uprawnienia: &a{3}\n
-  {PREFIX}&f-    &3Tymczasowe Uprawnienia: &a{4}\n
-  {PREFIX}&f-    &3Prefiksy: &a{5}\n
-  {PREFIX}&f-    &3Suffiksy: &a{6}\n
-  {PREFIX}&f-    &3Meta: &a{7}
-group-set-weight: "&aSet weight to &b{0}&a for group &b{1}&a."
-track-info: >
-  {PREFIX}&b&l> &bWyświetlanie ścieżki: &f{0}\n
-  {PREFIX}&f- &7Ścieżka: &f{1}
-track-clear: "&b{0}&a grupy zostały usunięte"
-track-append-success: "&aGrupa &b{0}&a została z powodzeniem dodana do śledzenia &b{1}&a."
-track-insert-success: "&aGrupa &b{0}&a została pomyślnie wstawiona do ścieżki &b{1}&a na pozycji &b{2}&a."
-track-insert-error-number: "Przewidywany numer, ale otrzymany: {0}"
-track-insert-error-invalid-pos: "Nie można wstawić w pozycji {0}. Wyloguj się z granic."
-track-remove-success: "&aGrupa &b{0}&a została z powodzeniem usunięta ze ścieżki &b{1}&a."
-log-load-error: "Nie można załadować loga."
-log-invalid-page: "Nieprawidłowy numer strony."
-log-invalid-page-range: "Nieprawidłowy numer strony. Wprowadź wartość między 1 a {0}."
-log-no-entries: "&bBrak wpisów do logów."
-log-entry: "&b#{0} -> &8(&7{1} temu&8) {2}"
-log-notify-toggle-on: "&aWłączone&b wyjście z logowania."
-log-notify-toggle-off: "&cWyłączone&b wyjście z logowania."
-log-notify-already-on: "Obecnie otrzymujesz powiadomienia."
-log-notify-already-off: "Obecnie nie otrzymujesz powiadomień."
-log-notify-unknown: "Stan nieznany. Oczekiwanie na \"on\" lub \"off\"."
-log-search-header: "&aWyświetlanie ostatnich działań dotyczących zapytania &b{0} &a(strona &f{1}&a z &f{2}&a)"
-log-recent-header: "&aWyświetlanie ostatnich działań (strona &f{0}&a z &f{1}&a)"
-log-recent-by-header: "&aPokazanie ostatnich działań przez &b{0} &a(strona &f{1}&a z &f{2}&a)"
-log-history-user-header: "&aWyświetlanie historii dla użytkowników &b{0} &a(strona &f{1}&a z &f{2}&a)"
-log-history-group-header: "&aWyświetlanie historii dla grup &b{0} &a(strona &f{1}&a z &f{2}&a)"
-log-history-track-header: "&aWyświetlanie historii dla ścieżki &b{0} &a(strona &f{1}&a z &f{2}&a)"
-log-export-already-exists: "Błąd: Plik {0} już istnieje."
-log-export-not-writable: "Błąd: Plik {0} jest tylko do odczytu."
-log-export-empty: "Log jest pusty i dlatego nie może być eksportowany"
-log-export-failure: "Podczas zapisywania do pliku wystąpił nieoczekiwany błąd."
-log-export-success: "&aPomyślnie exportowano log do &b{0}&a."
-import-already-running: "Inny proces importowania jest już uruchomiony. Spróbuj ponownie później."
-export-already-running: "Inny proces eksportowania jest już uruchomiony. Spróbuj ponownie później."
-import-log-doesnt-exist: "Błąd: Plik {0} nie istnieje."
-import-log-not-readable: "Błąd: Plik {0} nie można odczytać."
-import-log-failure: "Podczas odtwarzania loga wystąpił nieoczekiwany błąd."
-import-progress: "&b(Import) &b-> &f{0} &fprocent kompletne &7- &b{1}&f/&b{2} &foperacja zakończona z &c{3} &fbłędami."
-import-progress-sin: "&b(Import) &b-> &f{0} &fprocent kompletne &7- &b{1}&f/&b{2} &foperacja zakończona z &c{3} &fbłędami."
-import-start: "&b(Import) &b-> &fUruchamianie procesu importowania."
-import-end-complete: "&b(Import) &a&lZAKOŃCZONE &7- zajęło &b{0} &7sekundy - &7Nie ma błędów."
-import-end-complete-err: "&b(Import) &a&lZAKOŃCZONE &7- zajęło &b{0} &7sekundy - &c{1} błędy."
-import-end-complete-err-sin: "&b(Import) &a&lZAKOŃCZONE &7- zajęło &b{0} &7sekundy - &c{1} błąd."
-import-end-error-header: >
-  {PREFIX}&b(Import) &7------------> &fWyświetlanie błędu #&b{0} &7<------------\n
-  {PREFIX}&b(Import) &fWykonując: &3Komende #{1}\n
-  {PREFIX}&b(Import) &fKomenda: &7{2}\n
-  {PREFIX}&b(Import) &fWpisane: &3{3}\n 
-  {PREFIX}&b(Import) &fWyjście:
-import-end-error-content: "&b(Import) &b-> &c{0}"
-import-end-error-footer: "&b(Import) &7<------------------------------------------>"

.locale/ru_RU.yml

@@ -1,303 +0,0 @@
-# LuckPerms Language File
-# Locale: ru_RU
-# Author: Pixelmon.PRO
-
-prefix: "&7&l[&b&lL&3&lP&7&l] &c"
-log-info: "&7&l[&bL&3P&7&l] &3{0}"
-log-warn: "&7&l[&bLuck&3Perms&7&l] &c[ПРЕДУПРЕЖДЕНИЕ] {0}"
-log-error: "&7&l[&bLuck&3Perms&7&l] &4[ОШИБКА] {0}"
-empty: "{0}"
-player-online: "&aОнлайн"
-player-offline: "&cОффлайн"
-loading-error: "Не удалось загрузить данные разрешений. Пожалуйста обратитесь к Администратору."
-op-disabled: "&bНа этом сервере отключена ванильная система OP."
-op-disabled-sponge: "&2Статус Оператора Сервера не влияет на установленный плагин разрешений. Пожалуйста, отредактируйте данные пользователя напрямую."
-log: "&3LOG &3&l> {0}"
-export-log: "&3ЭКСПОРТ &3&l> &f{0}"
-export-log-progress: "&3ЭКСПОРТ &3&l> &7{0}"
-migration-log: "&3ПЕРЕМЕЩЕНИЕ &7[&3{0}&7] &3&l> &f{1}"
-migration-log-progress: "&3ПЕРЕМЕЩЕНИЕ &7[&3{0}&7] &3&l> &7{1}"
-command-not-recognised: "Команда не распознана."
-command-no-permission: "У вас нет разрешения на использование этой команды!"
-already-haspermission: "{0} уже имеет такое разрешение!"
-does-not-havepermission: "{0} не имеет этого набора разрешений."
-already-has-temp-permission: "{0} уже имеет этот набор временных разрешений!"
-does-not-have-temp-permission: "{0} не имеет этого набора временных разрешений."
-user-not-found: "&bНе удалось найти пользователя."
-user-not-online: "&bПользователь &a{0}&b не онлайн."
-user-no-data: "&bПользователь &a{0}&b не имеет загруженных данных."
-user-save-success: "&7(Пользовательские данные были сохранены на хранение)"
-user-save-error: "При сохранении пользователя произошла ошибка."
-user-create-fail: "При создании нового пользователя возникла ошибка."
-group-not-found: "&bНе удалось найти группу."
-group-save-success: "&7(Групповые данные были сохранены на хранение)"
-group-save-error: "При сохранении группы произошла ошибка."
-track-not-found: "&bНе удалось найти путь."
-track-save-success: "&7(Данные о путе сохранены на хранение)"
-track-save-error: "При сохранении пути произошла ошибка."
-user-invalid-entry: "&d{0}&c не является допустимым именем пользователя/uuid."
-group-invalid-entry: "Имена групп могут содержать только буквенно-цифровые символы."
-track-invalid-entry: "Имена путей могут содержать только буквенно-цифровые символы."
-server-invalid-entry: "Имена серверов могут содержать только буквенно-цифровые символы."
-use-inherit-command: "Используйте команды «parent add» и «parent remove» вместо указания узла (node)."
-verbose-invalid-filter: "&cНедопустимый подробный (verbose) фильтр: &f{0}"
-verbose-on: "&Запись подробной проверки установлена на &aTRUE &bдля всех разрешений (пермов)."
-verbose-on-query: "&Запись подробной проверки установлена на &aTRUE &bДля разрешений, соответствующих следующим фильтрам: &f{0}"
-verbose-off: "&Запись подробной проверки установлена на &cFALSE&b."
-verbose-recording-on: "&Запись подробной записи установлена ​​на &aTRUE &bдля всех разрешений."
-verbose-recording-on-query: "&Запись подробной записи установлена ​​на &aTRUE &bДля разрешений, соответствующих следующим фильтрам: &f{0}"
-verbose-recording-upload-start: "&bЗапись подробной информации была отключена. Загрузка результатов..."
-verbose-recording-url: "&aПодробный URL результатов:"
-tree-upload-start: "&bСоздание дерева разрешений..."
-tree-empty: "&aНе удалось создать дерево. Ничего не найдено."
-tree-url: "&aURL дерева разрешений:"
-search-searching: "&aПоиск пользователей и групп с помощью &b{0}&a..."
-search-searching-members: "&aПоиск пользователей и групп, унаследовавших от &b{0}&a..."
-search-result: "&aНайдено &b{0}&a записи из &b{1}&a пользователей и &b{2}&a групп."
-search-showing-users: "&bПросмотр записей пользователя:"
-search-showing-groups: "&bПросмотр записей в группах:"
-search-showing-users-with-page: "&bПросмотр записей пользователя:  {0}"
-search-showing-groups-with-page: "&bПросмотр записей в группах:  {0}"
-check-result: "&aРезультат проверки разрешения пользователя &b{0}&a на разрешение &b{1}&a: &f{2}"
-create-success: "&b{0}&a было успешно создано."
-delete-success: "&b{0}&a успешно удален."
-rename-success: "&b{0}&a был успешно переименован в &b{1}&a."
-clone-success: "&b{0}&a был успешно клонирован на &b{1}&a."
-already-inherits: "{0} уже наследует '{1}'."
-does-not-inherit: "{0} не наследует '{1}'."
-already-temp-inherits: "{0} уже временно наследует '{1}'."
-does-not-temp-inherit: "{0} временно не наследует '{1}'."
-track-already-contains: "Путь {0} уже содержит группу '{1}'."
-track-does-not-contain: "Путь {0} не содержит группу '{1}'."
-track-ambiguous-call: "Указанный пользователь является членом нескольких групп на этом пути. Невозможно определить их местоположение."
-group-already-exists: "Эта группа уже существует!"
-group-does-not-exist: "Эта группа не существует!"
-group-load-error: "Произошла непредвиденная ошибка. Группа не загружена."
-groups-load-error: "Произошла непредвиденная ошибка. Не удалось загрузить все группы."
-track-already-exists: "Этот путь уже существует!"
-track-does-not-exist: "Этот путь не существует!"
-track-load-error: "Произошла непредвиденная ошибка. Путь не загружен."
-tracks-load-error: "Произошла непредвиденная ошибка. Не удалось загрузить все пути."
-track-empty: "Путь нельзя использовать, так как он пуст или содержит только одну группу."
-update-task-request: "&bОбновление задачи запланировано."
-update-task-complete: "&aОбновление задачи завершено."
-update-task-complete-network: "&aОбновление задачи завершено. Теперь пытаемся подключиться к другим серверам."
-update-task-push-success: "&aДругие серверы были уведомлены через &b{0} cообщения и удаленный доступ."
-update-task-push-failure: "&cОшибка при нажатии изменений на других серверах."
-update-task-push-failure-not-setup: "&cОшибка при нажатии изменений на других серверах. Служба обмена сообщениями не настроена."
-reload-config-success: "&aФайл конфигурации был перезагружен. &7(Некоторые параметры будут применяться только после перезапуска сервера.)"
-info: >
-  {PREFIX}&2Выполнение &bLuckPerms v{0}&2 by &bLuck&2.\n
-  {PREFIX}&f-  &3Платформа: &f{1}\n
-  {PREFIX}&f-  &3Способ Хранения: &f{2}\n
-  {PREFIX}&f-  &3Имя Сервера: &f{3}\n
-  {PREFIX}&f-  &3Интервал Синхронизации: &a{4} &fминут\n
-  {PREFIX}&f-  &3Служба обмена сообщениями: &f{5}\n
-  {PREFIX}&f-  &bГрафы:\n
-  {PREFIX}&f-     &3Игроки Онлайн: &a{6}\n
-  {PREFIX}&f-     &3Загруженные пользователи: &a{7}\n
-  {PREFIX}&f-     &3Загруженные группы: &a{8}\n
-  {PREFIX}&f-     &3Загруженные пути: &a{9}\n
-  {PREFIX}&f-     &3Размер лога: &a{10}\n
-  {PREFIX}&f-     &3UUID Размер кеша: &a{11}\n
-  {PREFIX}&f-     &3Переводы загружены: &a{12}\n
-  {PREFIX}&f-     &3Контексты перед обработкой: &a{13}\n
-  {PREFIX}&f-     &3Счетчик контекста: &a{14}\n
-  {PREFIX}&f-     &3Уникальные разрешения: &a{15}\n
-  {PREFIX}&f-  &bКонфигурация:\n
-  {PREFIX}&f-     &3Использует сервер UUIDs: {16}\n
-  {PREFIX}&f-     &bСчетчик разрешений:\n
-  {PREFIX}&f-        &3Включая глобальные: {17}\n
-  {PREFIX}&f-        &3Включая глобальный мир: {18}\n
-  {PREFIX}&f-        &3Применения глобальных групп: {19}\n
-  {PREFIX}&f-        &3Применения глобальных групп мира: {20}\n
-  {PREFIX}&f-        &3Применения подстановочных знаков (Wildcards): {21}\n
-  {PREFIX}&f-        &3Применение регулярных выражений: {22}\n
-  {PREFIX}&f-        &3Применение стенографии (Shorthand): {23}
-create-group-error: "При создании группы произошла ошибка."
-delete-group-error: "При удалении группы произошла ошибка."
-delete-group-error-default: "Вы не можете удалить группу по умолчанию."
-groups-list: "&aГруппы: {0}"
-create-track-error: "При создании пути произошла ошибка."
-delete-track-error: "При удалении пути произошла ошибка."
-tracks-list: "&aГенеральные пути: {0}"
-listnodes: "&b{0}'s Узлы:"
-listnodes-with-page: "&b{0}'s Узлы:  {1}"
-listnodes-temp: >
-  &b{0}'s Временные узлы:\n
-  {1}
-listparents: >
-  &b{0}'s Родительские группы:\n
-  {1}
-listparents-temp: >
-  &b{0}'s Временные родительские группы:\n
-  {1}
-listgroups: >
-  &b{0}'s Группы:\n
-  {1}
-listgroups-temp: >
-  &b{0}'s Временные группы:\n
-  {1}
-list-tracks: >
-  &b{0}'s Пути:\n
-  {1}
-list-tracks-empty: "{0} не на каких-либо путях."
-context-pair-inline: "&3{0}=&b{1}"
-context-pair--global-inline: "&eГлобальный"
-context-pair-end: "&a."
-context-pair-sep: "&a, "
-context-pair: "&8(&7{0}=&f{1}&8)"
-check-permission: "&b{0}&a имеет разрешение &b{1}&a установленое в {2}&a в контексте {3}&a."
-check-permission-inherited: "&b{0}&a имеет разрешение &b{1}&a установленое в {2}&a в контексте {3}&a, наследованный от &b{4}&a."
-setpermission-success: "&aУстановить &b{0}&a к &b{1}&a для &b{2}&a."
-setpermission-temp-success: "&aУстановить &b{0}&a к &b{1}&a для &b{2}&a На срок &b{3}&a."
-unsetpermission-success: "&aСбросить &b{0}&a для &b{1}&a."
-unset-temp-permission-success: "&aСбросить временное разрешение &b{0}&a для &b{1}&a."
-set-inherit-success: "&b{0}&a теперь наследует разрешения от &b{1}&a."
-set-parent-success: "&b{0}&a их существующие родительские группы очищены, и теперь только наследуют &b{1}&a."
-set-temp-inherit-success: "&b{0}&a теперь наследует разрешения от &b{1}&a на срок &b{2}&a."
-unset-inherit-success: "&b{0}&a больше не наследует разрешения от &b{1}&a."
-unset-temp-inherit-success: "&b{0}&a больше не наследует временные разрешения (пермы) &b{1}&a."
-clear-success: "&b{0}&a's разрешения были очищены. (&b{1}&a узлы были удалены.)"
-clear-success-singular: "&b{0}&a's разрешения были очищены. (&b{1}&a узел удален.)"
-parent-clear-success: "&b{0}&a's родители очищены. (&b{1}&a узлы были удалены.)"
-parent-clear-success-singular: "&b{0}&a's родители очищены. (&b{1}&a узел удален.)"
-meta-clear-success: "&b{0}&a's мета очищена. (&b{1}&a узлы были удалены.)"
-meta-clear-success-singular: "&b{0}&a's мета очищена. (&b{1}&a узел удален.)"
-illegal-date-error: "Не удалось выполнить синтаксический анализ даты '{0}'."
-past-date-error: "Вы не можете установить дату в прошлом!"
-chat-meta-prefix-header: "&b{0}'s Префиксы"
-chat-meta-suffix-header: "&b{0}'s Суффиксы"
-meta-header: "&b{0}'s Мета"
-chat-meta-entry: "&b-> {0} &f- &f\"{1}&f\" &8(&7унаследованный от &a{2}&8)"
-chat-meta-entry-with-context: "&b-> {0} &f- &f\"{1}&f\" &8(&7унаследованный от &a{2}&8){3}"
-meta-entry: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7унаследованный от &a{2}&8)"
-meta-entry-with-context: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7унаследованный от &a{2}&8){3}"
-chat-meta-prefix-none: "&b{0} не имеет префиксов."
-chat-meta-suffix-none: "&b{0} не имеет суффиксов."
-meta-none: "&b{0} не имеет мету."
-meta-invalid-priority: "Недопустимый приоритет '{0}'. Ожидается число."
-already-has-chat-meta: "{0} уже имеет этот {1}."
-does-not-have-chat-meta: "{0} не имеет этого {1}."
-add-chatmeta-success: "&b{0}&a имеет {1} &f\"{2}&f\"&a установлен в приоритете &b{3}&a в контексте {4}&a."
-add-temp-chatmeta-success: "&b{0}&a имеет {1} &f\"{2}&f\"&a установлен в приоритете &b{3}&a на срок &b{4}&a в контексте {5}&a."
-remove-chatmeta-success: "&b{0}&a имеет {1} &f\"{2}&f\"&a в приоритете &b{3}&a удален из контекста {4}&a."
-bulk-remove-chatmeta-success: "&b{0}&a все временные {1}es в приоритете &b{3}&a были удалены из контекста {4}&a."
-remove-temp-chatmeta-success: "&b{0}&a временно установленный {1} &f\"{2}&f\"&a в приоритете &b{3}&a был удален из контекста {4}&a."
-bulk-remove-temp-chatmeta-success: "&b{0}&a все временные {1}es в приоритете &b{3}&a были удалены из контекста {4}&a."
-already-has-meta: "{0} уже установлено, что установлена ​​пара мета-значения клавиши."
-set-meta-success: "&aУстановить метазначение для клавиши &f\"{0}&f\"&a к &f\"{1}&f\"&a для &b{2}&a."
-set-meta-temp-success: "&aУстановить метазначение для клавиши &f\"{0}&f\"&a к &f\"{1}&f\"&a для &b{2}&a на срок &b{3}&a."
-unset-meta-success: "&aСбросить метазначение с помощью клавиши &f\"{0}&f\"&a для &b{1}&a."
-unset-meta-temp-success: "&aСбросить временное мета-значение с помощью клавиши &f\"{0}&f\"&a для &b{1}&a."
-bulk-update-invalid-data-type: "Недопустимый тип. Выберите 'all', 'users' или 'groups'."
-bulk-update-invalid-constraint: "Недопустимое ограничение &4{0}&c. Ограничения должны быть в формате '&f<поле> <оператор сравнения> <значение>&c'."
-bulk-update-invalid-comparison: "Недопустимый оператор сравнения '&4{0}&c'. Выберите одно из следующих: &f==  !=  ~~  ~!"
-bulk-update-queued: "&aМассовое обновление было поставлено в очередь. &7(&f{0}&7)"
-bulk-update-confirm: "&aВведите &b/{0} bulkupdate confirm {1} &aчтобы подтвердить выполнение массового обновления."
-bulk-update-unknown-id: "&aОперация с id &b{0} &aне существует или истек срок действия."
-bulk-update-starting: "&aВыполнение массового обновления."
-bulk-update-success: "&bМассовое обновление успешно завершено."
-bulk-update-failure: "&cНе удалось выполнить массовое обновление. Проверьте консоль на наличие ошибок."
-bulk-change-type-error: "Недопустимый тип. Введите 'server' или 'world'."
-bulk-change-success: "&aПрименение изменения успешно. {0} записей изменено."
-user-info-general: >
-  {PREFIX}&b&l> &bИнформация о пользователе: &f{0}\n
-  {PREFIX}&f- &3UUID: &f{1}\n
-  {PREFIX}&f- &3Статус: {2}\n
-  {PREFIX}&f- &3Первичная группа: &f{3}\n
-  {PREFIX}&f- &aГрафы:\n
-  {PREFIX}&f-    &3Разрешения: &a{4}\n
-  {PREFIX}&f-    &3Временные разрешения: &a{5}\n
-  {PREFIX}&f-    &3Префиксы: &a{6}\n
-  {PREFIX}&f-    &3Суффиксы: &a{7}\n
-  {PREFIX}&f-    &3Мета: &a{8}
-user-info-data: >
-  {PREFIX}&f- &aКэшированные данные:\n
-  {PREFIX}&f-    &3Загружается: {0}\n
-  {PREFIX}&f-    &3Текущие контексты: {1}\n
-  {PREFIX}&f-    &3Текущие префиксы: {2}\n
-  {PREFIX}&f-    &3Текущие суффиксы: {3}
-info-parent-header: "&f- &aРодительские группы:"
-info-temp-parent-header: "&f- &aВременные родительские группы:"
-user-getuuid: "&bUUID для &b{0}&b это &b{1}&b."
-user-removegroup-error-primary: "Вы не можете удалить пользователя из своей основной группы."
-user-primarygroup-success: "&b{0}&a's для основной группы установил значение &b{1}&a."
-user-primarygroup-warn-option: "&cВнимание: метод расчета основной группы, используемый этим сервером &7({0}) &cМожет не отражать это изменение."
-user-primarygroup-error-alreadyhas: "Пользователь уже установил эту группу в качестве основной группы."
-user-primarygroup-error-notmember: "&b{0}&a еще не был членом &b{1}&a, Добавить его сейчас."
-user-track-error-not-contain-group: "Указанный пользователь не находится ни в каких группах на этом  пути."
-user-track-added-to-first: "&b{0}&a не находится ни в каких группах на этом треке, поэтому они были добавлены в первую группу &b{1}&a в контексте {2}&a."
-user-promote-success: "&aПовышение пользователя &b{0}&a от &b{1}&a к &b{2}&a в контексте {3}&a."
-user-promote-error-endoftrack: "Конец пути &4{0}&c, был достигнут. Не удалось повысить пользователя."
-user-promote-error-malformed: >
-  {PREFIX}Следующая группа на пути, {0}, более не существует. Не удалось продвинуть пользователя.\n
-  {PREFIX}Создайте группу или удалите ее с пути и повторите попытку.
-user-demote-success: "&aПонижение пользователя по пути &b{0}&a от &b{1}&a к &b{2}&a в контексте {3}&a."
-user-demote-endoftrack: "Конец пути &4{0}&c был достингут, поэтому &4{1}&c был удален из &4{2}&c."
-user-demote-error-malformed: >
-  {PREFIX}Предыдущая группа на пути, {0}, более не существуют. Невозможно понизить рейтинг пользователя.\n
-  {PREFIX}Создайте группу или удалите ее с пути и повторите попытку.
-user-showpos: >
-  &aпоказывает &b{0}&a's позицию на пути &b{1}&a.\n
-  {2}
-group-info-general: >
-  {PREFIX}&b&l> &bИнфо о группе: &f{0}\n
-  {PREFIX}&f- &3Отображаемое имя: &f{1}\n
-  {PREFIX}&f- &3Значение: &f{2}\n
-  {PREFIX}&f- &aГрафы:\n
-  {PREFIX}&f-    &3Разрешения: &a{3}\n
-  {PREFIX}&f-    &3Временные разрешения: &a{4}\n
-  {PREFIX}&f-    &3Префиксы: &a{5}\n
-  {PREFIX}&f-    &3Суффиксы: &a{6}\n
-  {PREFIX}&f-    &3Мета: &a{7}
-group-set-weight: "&aУстановить значение &b{0}&a для группы &b{1}&a."
-track-info: >
-  {PREFIX}&b&l> &bПоказать путь: &f{0}\n
-  {PREFIX}&f- &7Путь: &f{1}
-track-clear: "&b{0}&a's путь групп был очищен."
-track-append-success: "&aГруппа &b{0}&a успешно добавлен в путь &b{1}&a."
-track-insert-success: "&aГруппа &b{0}&a был успешно добавлен в путь &b{1}&a на позиции &b{2}&a."
-track-insert-error-number: "Ожидаемое число, но вместо этого получено: {0}"
-track-insert-error-invalid-pos: "Невозможно вставить в позицию {0}. Индекс вне пределов."
-track-remove-success: "&aГруппа &b{0}&a Успешно удален с пути &b{1}&a."
-log-load-error: "Не удалось загрузить лог."
-log-invalid-page: "Недействительный номер страницы."
-log-invalid-page-range: "Недопустимый номер страницы. Введите значение от 1 до {0}."
-log-no-entries: "&bНет логов для отображения."
-log-entry: "&b#{0} -> &8(&7{1} тому назад&8) {2}"
-log-notify-toggle-on: "&aВключен&b вывод лога."
-log-notify-toggle-off: "&cОтключен&b вывод лога."
-log-notify-already-on: "Вы уже получаете оповещения."
-log-notify-already-off: "Вы не получаете оповещений."
-log-notify-unknown: "Состояние неизвестно. Ожидание \"on\" или \"off\"."
-log-search-header: "&aПросмотр недавних действий для запроса &b{0} &a(страница &f{1}&a из &f{2}&a)"
-log-recent-header: "&aПоследние действия (страница &f{0}&a из &f{1}&a)"
-log-recent-by-header: "&aПоказывать последние действия &b{0} &a(страница &f{1}&a из &f{2}&a)"
-log-history-user-header: "&aОтображение истории для пользователя &b{0} &a(страница &f{1}&a из &f{2}&a)"
-log-history-group-header: "&aОтображение истории для группы &b{0} &a(страница &f{1}&a из &f{2}&a)"
-log-history-track-header: "&aОтображение истории для пути &b{0} &a(страница &f{1}&a из &f{2}&a)"
-log-export-already-exists: "Ошибка: файл {0} уже существует."
-log-export-not-writable: "Ошибка: файл {0} недоступен для записи."
-log-export-empty: "Логи пусты и поэтому не могут быть экспортированы."
-log-export-failure: "Произошла непредвиденная ошибка во время записи в файл."
-log-export-success: "&aФайл логов успешно экспортирован в &b{0}&a."
-import-already-running: "Другой процесс импорта уже запущен. Дождитесь завершения и повторите попытку."
-export-already-running: "Другой процесс экспорта уже запущен. Дождитесь завершения и повторите попытку."
-import-log-doesnt-exist: "Ошибка: файл {0} не существует."
-import-log-not-readable: "Ошибка: файл {0} не читается."
-import-log-failure: "Произошла непредвиденная ошибка при чтении лога."
-import-progress: "&b(Импортировать) &b-> &f{0} &fПроцент завершен &7- &b{1}&f/&b{2} &fОперации в комплекте с &c{3} &fошибками."
-import-progress-sin: "&b(Импортировать) &b-> &f{0} &fПроцент завершен &7- &b{1}&f/&b{2} &fОперации в комплекте с &c{3} &fошибками."
-import-start: "&b(Импортировать) &b-> &fЗапуск процесса импорта."
-import-end-complete: "&b(Импортировать) &a&lЗАВЕРШЕНО &7- заняло &b{0} &7секунд - &7Нет ошибок."
-import-end-complete-err: "&b(Импортировать) &a&lЗАВЕРШЕНО &7- заняло &b{0} &7секунд - &c{1} ошибок."
-import-end-complete-err-sin: "&b(Импортировать) &a&lЗАВЕРШЕНО &7- заняло &b{0} &7секунд - &c{1} ошибок."
-import-end-error-header: >
-  {PREFIX}&b(Import) &7------------> &fОтображение ошибки #&b{0} &7<------------\n
-  {PREFIX}&b(Import) &fВыполняя: &3Команду #{1}\n
-  {PREFIX}&b(Import) &fКоманда: &7{2}\n
-  {PREFIX}&b(Import) &fТип: &3{3}\n
-  {PREFIX}&b(Import) &fВывод:
-import-end-error-content: "&b(Импортировать) &b-> &c{0}"
-import-end-error-footer: "&b(Импортировать) &7<------------------------------------------>"

.locale/zh-CN.yml

@@ -1,738 +0,0 @@
-# LuckPerms Language File
-# Locale: zh-CN (Simplified Chinese)
-# Author: EuropeJing
-
-prefix: "&7&l[&b&lL&3&lP&7&l] &c"
-log-info: "&7&l[&bL&3P&7&l] &3{0}"
-log-warn: "&7&l[&bLuck&3Perms&7&l] &c[警告] {0}"
-log-error: "&7&l[&bLuck&3Perms&7&l] &4[错误] {0}"
-empty: "{0}"
-player-online: "&a在线"
-player-offline: "&c离线"
-loading-error: "无法加载权限数据，请稍后再试。"
-op-disabled: "&b此服务器上禁用了vanilla OP系统。"
-op-disabled-sponge: "&2安装了权限插件时，服务器OP状态无效，请直接编辑用户数据。"
-log: "&3日志 &3&l> {0}"
-verbose-log: "&3详细 &3&l> {0}"
-export-log: "&3输出 &3&l> &f{0}"
-export-log-progress: "&3输出 &3&l> &7{0}"
-migration-log: "&3移动 &7[&3{0}&7] &3&l> &f{1}"
-migration-log-progress: "&3移动 &7[&3{0}&7] &3&l> &7{1}"
-command-not-recognised: "命令未被识别。"
-command-no-permission: "你没有权限使用这个命令!"
-already-haspermission: "{0}已经有这个权限!"
-does-not-havepermission: "{0}没有这个权限。"
-already-has-temp-permission: "{0}已经设置此临时权限!"
-does-not-have-temp-permission: "{0}没有设置此临时权限。"
-user-not-found: "&b找不到用户。"
-user-not-online: "&b用户&a{0}&b不在线。"
-user-save-success: "&7(保存用户数据到文件)"
-user-save-error: "保存用户数据时出错。"
-group-not-found: "&b找不到组。"
-group-save-success: "&7(保存组数据到文件)"
-group-save-error: "保存组数据时出错。"
-track-not-found: "&b无法找到权限组轨道。"
-track-save-success: "&7(保存权限组轨道到文件)"
-track-save-error: "保存权限组轨道时出错。"
-user-invalid-entry: "&d{0}&c不是有效的用户名/uuid。"
-group-invalid-entry: "组名只能包含字母数字字符。"
-track-invalid-entry: "权限组轨道名称只能包含字母数字字符。"
-server-world-invalid-entry: "服务器/世界名称只能包含字母数字字符，长度不能超过36个字符。"
-use-inherit-command: "使用'parent add'和'parent remove'命令，而不是指定节点。"
-verbose-invalid-filter: "&c无效的详细过滤器: &f{0}"
-verbose-on: "&b所有权限的详细输出设置为&a开&b。"
-verbose-on-query: "&b将匹配过滤器:&f{0}&b的权限详细输出设置为&a开&b。"
-verbose-off: "&b所有权限的详细输出设置为&c关&b。"
-verbose-recording-on: "&b所有权限的详细记录设置为&a开&b。"
-verbose-recording-on-query: "&b将匹配过滤器:&f{0}&b的权限详细记录设置为&a开&b。"
-verbose-recording-upload-start: "&b详细记录被禁用。正在上传结果..."
-verbose-recording-url: "&a详细结果的网址:"
-tree-upload-start: "&b生成权限树..."
-tree-empty: "&a无法生成树，没有找到结果。"
-tree-url: "&a权限树网址:"
-search-searching: "&a使用&b{0}&a搜索用户和组..."
-search-searching-members: "&a正在搜索继承自&b{0}&a的用户和组..."
-search-result: "&a从&b{1}&a用户和&b{2}&a组找到&b{0}&a个条目。"
-search-showing-users: "&b显示用户条目:"
-search-showing-groups: "&b显示组条目:"
-search-showing-users-with-page: "&b显示用户条目: {0}"
-search-showing-groups-with-page: "&b显示组条目: {0}"
-apply-edits-invalid-code: "&a无效的代码。&7({0})"
-apply-edits-unable-to-read: "&a无法使用给定代码读取数据。&7({0})"
-apply-edits-no-target: "&a无法解析编辑的目标。请提供它作为一个额外的参数。"
-apply-edits-target-group-not-exists: "&a目标组&b{0}&a不存在。"
-apply-edits-target-user-not-uuid: "&a目标用户&b{0}&a不是一个有效的uuid。"
-apply-edits-target-user-unable-to-load: "&a无法加载目标用户&b{0}&a。"
-apply-edits-target-unknown: "&a目标无效。&7({0})"
-apply-edits-success: "&a成功应用&b{0}&a节点到&b{1}&a。"
-editor-upload-failure: "&c无法将权限数据上传到编辑器。"
-editor-url: "&a编辑器URL:"
-check-result: "&a用户&b{0}&a获得允许&b{1}&a权限的检查结果&a: &f{2}"
-create-success: "&b{0}&a创建成功。"
-delete-success: "&b{0}&a删除成功。"
-rename-success: "&b{0}&a成功被重命名为&b{1}&a。"
-clone-success: "&b{0}&a成功地复制到&b{1}&a。"
-already-inherits: "{0}已经继承'{1}'。"
-does-not-inherit: "{0}不再继承'{1}'。"
-already-temp-inherits: "{0}已临时继承'{1}'。"
-does-not-temp-inherit: "{0}不再临时继承'{1}'。"
-track-already-contains: "权限组轨道{0}已经包含组'{1}'。"
-track-does-not-contain: "权限组轨道{0}不包含组'{1}'。"
-track-ambiguous-call: "指定的用户是此权限组轨道上多个组的成员，无法确定他们的位置。"
-group-already-exists: "该组已存在!"
-group-does-not-exist: "组不存在!"
-group-load-error: "发生意外错误，组未加载。"
-groups-load-error: "发生意外错误，无法加载所有组。"
-track-already-exists: "权限组轨道已存在!"
-track-does-not-exist: "权限组轨道不存在!"
-track-load-error: "发生意外错误。权限组轨道未加载。"
-tracks-load-error: "出现意外错误，无法加载所有权限组轨道。"
-track-empty: "权限组轨道不能使用，因为它是空的或只包含一个组。"
-update-task-request: "&b安排更新任务。"
-update-task-complete: "&a更新任务完成。"
-update-task-complete-network: "&a更新任务完成，现在尝试推送到其他服务器。"
-update-task-push-success: "&a其他服务器通过&b{0}消息传递成功通知。"
-update-task-push-failure: "&c将更改推送到其他服务器时出错。"
-update-task-push-failure-not-setup: "&c将更改推送到其他服务器时出错，未配置消息传递服务。"
-reload-config-success: "&a重新加载配置文件。&7(一些选项将仅在服务器重新启动后才应用。)"
-info: >
-  {PREFIX}&2运行 &bLuckPerms v{0}&2 by &bLuck&2。\n
-  {PREFIX}&f-  &3平台: &f{1}\n
-  {PREFIX}&f-  &3存储方式: &f{2}\n
-  {PREFIX}&f-  &3服务器名称: &f{3}\n
-  {PREFIX}&f-  &3同步间隔: &a{4} &f分钟\n
-  {PREFIX}&f-  &3消息服务: &f{5}\n
-  {PREFIX}&f-  &b统计:\n
-  {PREFIX}&f-     &3在线玩家: &a{6}\n
-  {PREFIX}&f-     &3加载用户: &a{7}\n
-  {PREFIX}&f-     &3加载组: &a{8}\n
-  {PREFIX}&f-     &3加载权限组轨道: &a{9}\n
-  {PREFIX}&f-     &3日志大小: &a{10}\n
-  {PREFIX}&f-     &3UUID缓存大小: &a{11}\n
-  {PREFIX}&f-     &3翻译加载: &a{12}\n
-  {PREFIX}&f-     &3预处理环境: &a{13}\n
-  {PREFIX}&f-     &3环境计算器: &a{14}\n
-  {PREFIX}&f-     &3唯一权限: &a{15}\n
-  {PREFIX}&f-  &b配置:\n
-  {PREFIX}&f-     &3使用服务器UUIDs: {16}\n
-  {PREFIX}&f-     &b权限计算:\n
-  {PREFIX}&f-        &3包括全部: {17}\n
-  {PREFIX}&f-        &3包括全部世界: {18}\n
-  {PREFIX}&f-        &3应用全部组: {19}\n
-  {PREFIX}&f-        &3应用全部世界组: {20}\n
-  {PREFIX}&f-        &3应用通配符: {21}\n
-  {PREFIX}&f-        &3应用正则表达式: {22}\n
-  {PREFIX}&f-        &3应用速记: {23}
-create-group-error: "创建组时出错。"
-delete-group-error: "删除组时出错。"
-delete-group-error-default: "您不能删除默认组。"
-groups-list: "&a组: &7(名字，权重，权限组轨道)"
-groups-list-entry: "&f-  &3{0} &7- &b{1}"
-groups-list-entry-with-tracks: "&f-  &3{0} &7- &b{1} &7- [&3{2}&7]"
-create-track-error: "创建权限组轨道时出错。"
-delete-track-error: "删除权限组轨道时出错。"
-tracks-list: "&a权限组轨道: {0}"
-listnodes: "&b{0}的节点:"
-listnodes-with-page: "&b{0}的节点:  {1}"
-listnodes-temp: "&b{0}的临时节点:"
-listnodes-temp-with-page: "&b{0}的临时节点:  {1}"
-listparents: "&b{0}的父组"
-listparents-temp: "&b{0}的临时父组:"
-list-tracks: >
-  &b{0}的权限组轨道:\n
-  {1}
-list-tracks-empty: "{0}不在任何权限组轨道上。"
-context-pair-inline: "&3{0}=&b{1}"
-context-pair--global-inline: "&e全局"
-context-pair-sep: "&a，"
-context-pair: "&8(&7{0}=&f{1}&8)"
-check-permission: "&b在环境&b{3}&b中，&b{0}&b的权限&b{1}&b被设置为&b{2}&b。"
-setpermission-success: "&a在环境&b{3}&a中将&b{2}&a的&b{0}&a权限设置为&b{1}&a。"
-setpermission-temp-success: "&a在环境&b{4}&a中将&b{2}&a的&b{0}&a临时权限设为&b{1}&a，持续时间&b{3}&a。"
-unsetpermission-success: "&a在环境&b{2}&a中取消&b{1}&a的&b{0}&a权限。"
-unset-temp-permission-success: "&a在环境&b{2}&a中取消&b{1}&a的临时权限&b{0}&a。"
-set-inherit-success: "&b{0}&a现在在环境&b{2}&a中继承&b{1}&a的权限&a。"
-set-temp-inherit-success: "&b{0}&a现在在环境&b{3}&a中继承&b{1}&a的权限，持续时间&b{2}&a。"
-set-parent-success: "&b{0}&a现有的父组被清除，现在只在&b{2}&a中继承&b{1}&a。"
-set-track-parent-success: "在权限组轨道&b{1}&a上&b{0}&a现有的父组被清除，现在只在&b{3}&a中继承&b{2}&a。"
-unset-inherit-success: "&b{0}&a不再继承环境&b{2}&a中&b{1}&a的权限。"
-unset-temp-inherit-success: "&b{0}&a在环境&b{2}&a中不再继承临时权限&b{1}&a。"
-clear-success: "&b{0}&a的权限在环境&b{1}&a中被清除。(&b{2}&a节点已被删除。)"
-clear-success-singular: "&b{0}&a的权限在环境&b{1}&a中被清除。(&b{2}&a节点已被删除。)"
-parent-clear-success: "&b{0}&a的父组在环境&b{1}&a中被清除。&b{2}&a节点被删除。)"
-parent-clear-success-singular: "&b{0}&a的父组在环境&b{1}&a中被清除。&b{2}&a节点被删除。)"
-parent-clear-track-success: "在权限组轨道&b{1}&a上，&b{0}&a的父组在环境&b{2}&a中被清除。&b{3}&a节点被删除。)"
-parent-clear-track-success-singular: "在权限组轨道&b{1}&a上，&b{0}&a的父组在环境&b{2}&a中被清除。&b{3}&a节点被删除。)"
-meta-clear-success: "&b{0}&a的元数据在环境&b{1}&a中被清除。&b{2}&a节点已被删除。)"
-meta-clear-success-singular: "&b{0}&a的元数据在环境&b{1}&a中被清除。&b{2}&a节点已被删除。)"
-illegal-date-error: "无法解析日期'{0}'。"
-past-date-error: "您不能设定一个过去的日期!"
-chat-meta-prefix-header: "&b{0}的前缀"
-chat-meta-suffix-header: "&b{0}的后缀"
-meta-header: "&b{0}的元信息"
-chat-meta-entry: "&b-> {0} &f- &f\"{1}&f\" &8(&7继承自&a{2}&8)"
-chat-meta-entry-with-context: "&b-> {0} &f- &f\"{1}&f\" &8(&7继承自&a{2}&8){3}"
-meta-entry: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7继承自&a{2}&8)"
-meta-entry-with-context: "&b-> &a{0} &f= &f\"{1}&f\" &8(&7继承自&a{2}&8){3}"
-chat-meta-prefix-none: "&b{0}没有前缀。"
-chat-meta-suffix-none: "&b{0}没有后缀。"
-meta-none: "&b{0}没有元信息。"
-meta-invalid-priority: "优先级'{0}'无效。应该是一个数字。"
-already-has-chat-meta: "{0}已经设置了{1}。"
-does-not-have-chat-meta: "{0}没有设置{1}。"
-add-chatmeta-success: "在环境&b{4}&a中将&b{0}&a的{1}设置为&f\"{2}&f\"，优先级&b{3}&a。"
-add-temp-chatmeta-success: "在环境&b{5}&a中将&b{0}&a的{1}设置为&f\"{2}&f\"&a，优先级&b{3}&a，持续时间为&b{4}&a。"
-remove-chatmeta-success: "在环境&b{3}&a中删除了&b{0}&a优先级为&b{3}&a的{1} &f\"{2}&f\"&a。"
-bulk-remove-chatmeta-success: "在环境&b{3}&a中删除了&b{0}&a优先级&b{2}&a的所有&b{1}&a。"
-remove-temp-chatmeta-success: "在环境&b{4}&a中删除了&b{0}&a优先级&b{3}&a的临时{1} &f\"{2}&f\"&a。"
-bulk-remove-temp-chatmeta-success: "在环境&b{3}&a中删除了&b{0}&a优先级&b{2}&a的所有临时&b{1}&a。"
-already-has-meta: "{0}已经有了这个元信息集。"
-set-meta-success: "将环境&b{3}&a中&b{2}&a的键&f\"{0}&f\"&a的元信息设置为&f\"{1}&f\"&a。"
-set-meta-temp-success: "&a在环境&b{4}&a中将&b{2}&a的键&f\"{0}&f\"&a的值设置为&f\"{1}&f\"&a，持续时间为&b{3}&a。"
-unset-meta-success: "&a在环境{2}中取消设置&b{1}&a的键&f\"{0}&f\"&a的元信息。"
-unset-meta-temp-success: "&a在环境{2}中取消设置&b{1}&a的键&f\"{0}&f\"&a的临时元信息。"
-bulk-update-invalid-data-type: "类型无效。期望类型是'全部'、'用户'或'组'。"
-bulk-update-invalid-constraint: "无效的约束&4{0}&c。约束的格式应该是'&f<field> <comparison operator> <value>&c'。"
-bulk-update-invalid-comparison: "比较运算符无效'&4{0}&c'。应该以下之一: &f==  !=  ~~  ~!"
-bulk-update-queued: "&a批量更新操作已排队。&7(&f{0}&7)"
-bulk-update-confirm: "&a运行&b/{0} bulkupdate &a确认{1}执行更新。"
-bulk-update-unknown-id: "&a使用id&b{0}&a的操作不存在或已过期。"
-bulk-update-starting: "&a运行批量更新。"
-bulk-update-success: "&b批量更新已成功完成。"
-bulk-update-failure: "&c批量更新失败。检查控制台是否有错误。"
-user-info-general: >
-  {PREFIX}&b&l> &b用户信息: &f{0}\n
-  {PREFIX}&f- &3UUID: &f{1}\n
-  {PREFIX}&f- &3状态: {2}\n
-  {PREFIX}&f- &3主组: &f{3}\n
-  {PREFIX}&f- &a统计:\n
-  {PREFIX}&f-    &3权限: &a{4}\n
-  {PREFIX}&f-    &3临时权限: &a{5}\n
-  {PREFIX}&f-    &3前缀: &a{6}\n
-  {PREFIX}&f-    &3后缀: &a{7}\n
-  {PREFIX}&f-    &3元信息: &a{8}
-user-info-data: >
-  {PREFIX}&f- &a缓存数据:\n
-  {PREFIX}&f-    &3具有环境数据: {0}\n
-  {PREFIX}&f-    &3当前环境: {1}\n
-  {PREFIX}&f-    &3当前前缀: {2}\n
-  {PREFIX}&f-    &3当前后缀: {3}
-info-parent-header: "&f- &a父组:"
-info-temp-parent-header: "&f- &a临时父组:"
-user-removegroup-error-primary: "您不能从其主组中删除用户。"
-user-primarygroup-success: "&b{0}&a的主组已设为&b{1}&a。"
-user-primarygroup-warn-option: "&c警告：此服务器&7({0})&c使用的主组计算方法可能无法反映此更改。"
-user-primarygroup-error-alreadyhas: "用户已将此组设置为其主组。"
-user-primarygroup-error-notmember: "&b{0}&a不是&b{1}&a的成员，现在添加它们。"
-user-track-error-not-contain-group: "指定的用户尚未在此权限组轨道上的任何组中。"
-user-track-added-to-first: "&b{0}&a不在此权限组轨道上的任何组中，因此在环境&b{2}&a中将其添加到第一组&b{2}&a。"
-user-promote-success: "&a在环境&b{3}&a中将用户沿权限组轨道&b{0}&a从&b{1}&a提升到&b{2}&a。"
-user-promote-error-endoftrack: "已达到权限组轨道&4{0}&c的结尾，所以无法提升用户。"
-user-promote-error-malformed: >
-  {PREFIX}权限组轨道上的下一个组{0}不存在。无法提升用户。\n
-  {PREFIX}创建组，或将其从权限组轨道中删除，然后重试。
-user-demote-success: "&a在环境&b{3}&a中将用户沿权限组轨道&b{0}&a从&b{1}&a下降到&b{2}&a。"
-user-demote-endoftrack: "已达到权限组轨道&4{0}&c的结尾，所以&4{1}&c已从&4{2}&c中移除。"
-user-demote-error-malformed: >
-  {PREFIX}权限组轨道上的上一组{0}不存在。无法降级用户。\n
-  {PREFIX}创建组，或将其从权限组轨道中删除，然后重试。
-group-info-general: >
-  {PREFIX}&b&l> &b组信息: &f{0}\n
-  {PREFIX}&f- &3显示名称: &f{1}\n
-  {PREFIX}&f- &3权重: &f{2}\n
-  {PREFIX}&f- &a统计:\n
-  {PREFIX}&f-    &3权限: &a{3}\n
-  {PREFIX}&f-    &3临时权限: &a{4}\n
-  {PREFIX}&f-    &3前缀: &a{5}\n
-  {PREFIX}&f-    &3后缀: &a{6}\n
-  {PREFIX}&f-    &3元信息: &a{7}
-group-set-weight: "&a将组&b{1}&a的权重设置为&b{0}&a。"
-track-info: >
-  {PREFIX}&b&l> &b显示权限组轨道: &f{0}\n
-  {PREFIX}&f- &7路径: &f{1}
-track-clear: "&b{0}&a的权限组轨道已被清除。"
-track-append-success: "&a组&b{0}&a已成功添加到权限组轨道&b{1}&a。"
-track-insert-success: "&a组&b{0}&a已成功插入权限组轨道&b{1}&a的&b{2}&a位置。"
-track-insert-error-number: "没有预期的数量，而是收到: {0}"
-track-insert-error-invalid-pos: "无法插入位置{0}。索引超出范围。"
-track-remove-success: "&a组&b{0}&a已成功从权限组轨道&b{1}&a移除。"
-log-load-error: "日志无法加载。"
-log-invalid-page: "页码无效。"
-log-invalid-page-range: "页码无效，请输入1和{0}之间的值。"
-log-no-entries: "&b没有日志条目显示。"
-log-entry: "&b#{0} -> &8(&7{1} ago&8) {2}"
-log-notify-toggle-on: "&a启用&b记录输出。"
-log-notify-toggle-off: "&c禁用&b记录输出。"
-log-notify-already-on: "您已经收到通知。"
-log-notify-already-off: "您目前没有收到通知。"
-log-notify-unknown: "状态未知。输入 \"on\" 或者 \"off\"。"
-log-search-header: "&a显示最近的查询操作&b{0} &a(&f{1}&a/&f{2}&a)"
-log-recent-header: "&a显示最近操作 (&f{0}&a/&f{1}&a)"
-log-recent-by-header: "&a显示&b{0}&a的最近操作 (&f{1}&a/&f{2}&a)"
-log-history-user-header: "&a显示用户的历史记录&b{0} &a(&f{1}&a/&f{2}&a)"
-log-history-group-header: "&a显示组的历史记录 &b{0} &a(&f{1}&a/&f{2}&a)"
-log-history-track-header: "&a显示权限组轨道的历史记录 &b{0} &a(&f{1}&a/&f{2}&a)"
-log-export-already-exists: "错误: 文件{0}已经存在。"
-log-export-not-writable: "错误: 文件{0}不可写。"
-log-export-empty: "日志为空，因此无法导出。"
-log-export-failure: "写入文件时出现意外错误。"
-log-export-success: "&a成功导出日志&b{0}&a。"
-import-already-running: "另一个导入过程已经在运行，请等待完成，然后重试。"
-export-already-running: "另一个导出过程已经在运行，请等待完成，然后重试。"
-import-log-doesnt-exist: "错误: 文件{0}不存在。"
-import-log-not-readable: "错误: 文件{0}不可读。"
-import-log-failure: "从日志文件读取时发生意外错误。"
-import-progress: "&b(导入) &b-> &f百分之{0}完成 &7- &b{1}&f/&b{2} &f完成 &c{3}&f错误。"
-import-progress-sin: "&b(导入) &b-> &f百分之{0}完成 &7- &b{1}&f/&b{2} &f完成 &c{3}&f错误。"
-import-start: "&b(导入) &b-> &f开始导入过程。"
-import-end-complete: "&b(导入) &a&l已完成 &7- 用了 &b{0} &7秒 - &7没有错误。"
-import-end-complete-err: "&b(导入) &a&l已完成 &7- 用了 &b{0} &7秒 - &c{1}错误。"
-import-end-complete-err-sin: "&b(导入) &a&l已完成 &7- 用了 &b{0} &7秒 - &c{1}错误。"
-import-end-error-header: >
-  {PREFIX}&b(导入) &7------------> &f显示错误 #&b{0} &7<------------\n
-  {PREFIX}&b(导入) &f执行: &3命令 #{1}\n
-  {PREFIX}&b(导入) &f命令: &7{2}\n
-  {PREFIX}&b(导入) &f类型: &3{3}\n
-  {PREFIX}&b(导入) &f输出:
-import-end-error-content: "&b(导入) &b-> &c{0}"
-import-end-error-footer: "&b(导入) &7<------------------------------------------>"
-
-command-specs:
-  user:
-    description: "用户命令"
-    usage: "/%s user <用户>"
-  group:
-    description: "组命令"
-    usage: "/%s group <组>"
-  track:
-    description: "权限组轨道指令"
-    usage: "/%s track <权限组轨道>"
-  log:
-    description: "日志命令"
-    usage: "/%s log"
-  sync:
-    description: "与存储同步更改"
-    usage: "/%s sync"
-  info:
-    description: "打印通用插件信息"
-    usage: "/%s info"
-  verbose:
-    description: "管理详细权限检查"
-    usage: "/%s verbose <true|false> [filter]"
-    args:
-      "on|record|off|paste": "是否启用/禁用日志记录，或粘贴记录的输出"
-      "filter": "过滤器匹配项"
-  tree:
-    description: "生成权限的树视图"
-    usage: "/%s tree [selection] [max level] [player]"
-    args:
-      "selection": "树的根，指定\".\"包括所有权限"
-      "max level": "应该返回多少分支级别"
-      "player": "要检查的在线玩家的名称"
-  search:
-    description: "搜索具有特定权限的用户/组"
-    usage: "/%s search <permission>"
-    args:
-      "permission": "权限搜索"
-      "page": "页面查看"
-  check:
-    description: "对用户执行标准的权限检查"
-    usage: "/%s check <user> <permission>"
-    args:
-      "user": "检查用户"
-      "permission": "允许检查"
-  network-sync:
-    description: "与存储同步更改并请求网络上所有其他服务器都同步"
-    usage: "/%s networksync"
-  import:
-    description: "从文件导入数据"
-    usage: "/%s import <file>"
-    args:
-      "file": "要导入的文件"
-  export:
-    description: "将数据导出到文件"
-    usage: "/%s export <file>"
-    args:
-      "file": "要导出的文件"
-  reload-config:
-    description: "重新加载部分配置选项"
-    usage: "/%s reloadconfig"
-  bulk-update:
-    description: "对所有数据执行批量更改查询"
-    usage: "/%s bulkupdate"
-    args:
-      "data type": "正在更改的数据类型。('all'、'users'、'groups')"
-      "action": "对数据执行的操作。('update' or 'delete')"
-      "action field": "要采取行动的领域。只需要'update'。('permission'、'server'、'world')"
-      "action value": "替换的值。只需要'update'。"
-      "constraint...": "更新所需的限制"
-  migration:
-    description: "迁移命令"
-    usage: "/%s migration"
-  apply-edits:
-    description: "应用从Web编辑器进行的权限更改"
-    usage: "/%s applyedits <code> [target]"
-    args:
-      "code": "数据的唯一代码"
-      "target": "应用数据到谁"
-  create-group:
-    description: "创建新组"
-    usage: "/%s creategroup <group>"
-    args:
-      "name": "组的名称"
-  delete-group:
-    description: "删除组"
-    usage: "/%s deletegroup <group>"
-    args:
-      "name": "组的名称"
-  list-groups:
-    description: "列出平台上的所有组"
-    usage: "/%s listgroups"
-  create-track:
-    description: "创建新权限组轨道"
-    usage: "/%s createtrack <track>"
-    args:
-      "name": "权限组轨道的名称"
-  delete-track:
-    description: "删除权限组轨道"
-    usage: "/%s deletetrack <track>"
-    args:
-      "name": "权限组轨道的名称"
-  list-tracks:
-    description: "列出平台上的所有权限组轨道"
-    usage: "/%s listtracks"
-  user-info:
-    description: "显示有关用户的信息"
-  user-switchprimarygroup:
-    description: "切换用户的主组"
-    args:
-      "group": "组切换到"
-  user-promote:
-    description: "在权限组轨道提升用户"
-    args:
-      "track": "提升用户的权限组轨道"
-      "context...": "提升用户使用的环境"
-  user-demote:
-    description: "在权限组轨道降低用户"
-    args:
-      "track": "降低用户的权限组轨道"
-      "context...": "降低用户使用的环境"
-  group-info:
-    description: "提供有关组的信息"
-  group-listmembers:
-    description: "显示从该组继承的用户/组"
-    args:
-      "page": "页面查看"
-  group-setweight:
-    description: "设置组权重"
-    args:
-      "weight": "设定权重"
-  group-rename:
-    description: "重命名组"
-    args:
-      "name": "新名字"
-  group-clone:
-    description: "克隆组"
-    args:
-      "name": "要克隆到的组的名称"
-  holder-editor:
-    description: "打开网页权限编辑器"
-  holder-showtracks:
-    description: "列出对象所在的权限组轨道"
-  holder-clear:
-    description: "删除所有权限，父组和元"
-    args:
-      "context...": "过滤的环境"
-  permission:
-    description: "编辑权限"
-  parent:
-    description: "编辑继承"
-  meta:
-    description: "编辑元数据值"
-  permission-info:
-    description: "列出对象拥有的权限节点"
-    args:
-      "page": "页面查看"
-      "filter": "要过滤的字符串"
-  permission-set:
-    description: "设置对象的权限"
-    args:
-      "node": "要添加的权限"
-      "true|false": "节点的值"
-      "context...": "添加权限的环境"
-  permission-unset:
-    description: "取消对象的权限"
-    args:
-      "node": "取消的权限节点"
-      "context...": "删除权限的环境"
-  permission-settemp:
-    description: "设置对象的临时权限"
-    args:
-      "node": "要添加的权限"
-      "true|false": "节点的值"
-      "duration": "到期时间"
-      "context...": "权限的环境"
-  permission-unsettemp:
-    description: "取消对对象的临时权限"
-    args:
-      "node": "要取消的权限"
-      "context...": "权限的环境"
-  permission-check:
-    description: "检查对象是否具有某个权限节点"
-    args:
-      "node": "要检查的权限"
-      "context...": "权限的环境"
-  permission-check-inherits:
-    description: "检查对象是否继承某个权限节点"
-    args:
-      "node": "要检查的权限"
-      "context...": "权限的环境"
-  parent-info:
-    description: "列出此对象从哪里继承的组"
-  parent-set:
-    description: "删除对象已经继承的所有其他组，并将其添加到给定的对象组中。"
-    args:
-      "group": "组设为"
-      "context...": "设置组的环境"
-  parent-add:
-    description: "为该对象设置另一个组来继承权限"
-    args:
-      "group": "要继承的组"
-      "context...": "继承该组的环境"
-  parent-remove:
-    description: "删除先前设置的继承规则"
-    args:
-      "group": "删除的组"
-      "context...": "删除组的环境"
-  parent-set-track:
-    description: "删除对象在给定权限组轨道上继承的所有其他组，并将其添加到给定的权限组轨道上。"
-    args:
-      "track": "设置的权限组轨道"
-      "group": "组中设置的组，或与组中在给定权限组轨道上的位置相关的数字"
-      "context...": "设置组的环境"
-  parent-add-temp:
-    description: "为对象设置另一个组，以便从临时继承权限"
-    args:
-      "group": "要继承的组"
-      "duration": "持续时间"
-      "context...": "继承该组的环境"
-  parent-remove-temp:
-    description: "删除以前设置的临时继承规则"
-    args:
-      "group": "组删除"
-      "context...": "删除组的环境"
-  parent-clear:
-    description: "清除所有的父组"
-    args:
-      "context...": "过滤的环境"
-  parent-clear-track:
-    description: "清除给定权限组轨道上的所有父组"
-    args:
-      "track": "删除的权限组轨道"
-      "contexts...": "选择的环境"
-  meta-info:
-    description: "显示所有聊天元"
-  meta-set:
-    description: "设置元值"
-    args:
-      "key": "设定的键"
-      "value": "要设置的值"
-      "context...": "将元添加到"
-  meta-unset:
-    description: "取消设定元值"
-    args:
-      "key": "要取消的键"
-      "context...": "删除元的环境"
-  meta-settemp:
-    description: "暂时设置一个元值"
-    args:
-      "key": "设定的键"
-      "value": "要设置的值"
-      "duration": "持续时间"
-      "context...": "将元组添加到"
-  meta-unsettemp:
-    description: "取消设置临时元值"
-    args:
-      "key": "要取消的键"
-      "context...": "删除元的环境"
-  meta-addprefix:
-    description: "添加前缀"
-    args:
-      "priority": "添加的前缀优先级"
-      "prefix": "前缀字符串"
-      "context...": "添加前缀的环境"
-  meta-addsuffix:
-    description: "添加后缀"
-    args:
-      "priority": "添加的后缀优先级"
-      "suffix": "后缀字符串"
-      "context...": "添加后缀的环境"
-  meta-removeprefix:
-    description: "删除前缀"
-    args:
-      "priority": "删除的前缀优先级"
-      "prefix": "前缀字符串"
-      "context...": "删除前缀的环境"
-  meta-removesuffix:
-    description: "删除后缀"
-    args:
-      "priority": "删除的后缀优先级"
-      "suffix": "后缀字符串"
-      "context...": "删除后缀的环境"
-  meta-addtemp-prefix:
-    description: "添加临时前缀"
-    args:
-      "priority": "删除的前缀优先级"
-      "prefix": "前缀字符串"
-      "duration": "持续时间"
-      "context...": "添加前缀的环境"
-  meta-addtemp-suffix:
-    description: "添加临时后缀"
-    args:
-      "priority": "添加的后缀优先级"
-      "suffix": "后缀字符串"
-      "duration": "持续时间"
-      "context...": "添加后缀的环境"
-  meta-removetemp-prefix:
-    description: "删除临时前缀"
-    args:
-      "priority": "删除的前缀优先级"
-      "prefix": "前缀字符串"
-      "context...": "删除前缀的环境"
-  meta-removetemp-suffix:
-    description: "删除临时后缀"
-    args:
-      "priority": "删除的后缀优先级"
-      "suffix": "后缀字符串"
-      "context...": "删除后缀的环境"
-  meta-clear:
-    description: "清除所有聊天元"
-    args:
-      "context...": "过滤的环境"
-  track-info:
-    description: "提供有关权限组轨道的信息"
-  track-append:
-    description: "追加一个组到权限组轨道的最后"
-    args:
-      "group": "追加的组"
-  track-insert:
-    description: "在权限组轨道上的给定位置插入一个组"
-    args:
-      "group": "插入的组"
-      "position": "插入组的位置（权限组轨道上的第一个位置为1）"
-  track-remove:
-    description: "从权限组轨道中删除一个组"
-    args:
-      "group": "删除的组"
-  track-clear:
-    description: "清除权限组轨道上的组"
-  track-rename:
-    description: "重命名权限组轨道"
-    args:
-      "name": "新名字"
-  track-clone:
-    description: "克隆权限组轨道"
-    args:
-      "name": "要克隆的权限组轨道的名称"
-  log-recent:
-    description: "查看最近的登陆"
-    args:
-      "user": "用户的名称/uuid"
-      "page": "要查看的页码"
-  log-search:
-    description: "搜索日志中的条目"
-    args:
-      "query": "搜索的查询"
-      "page": "要查看的页码"
-  log-notify:
-    description: "切换日志通知"
-    args:
-      "on|off": "是否打开或关闭"
-  log-user-history:
-    description: "查看用户的历史记录"
-    args:
-      "user": "用户名/ uuid"
-      "page": "要查看的页码"
-  log-group-history:
-    description: "查看组的历史"
-    args:
-      "group": "组名"
-      "page": "要查看的页码"
-  log-track-history:
-    description: "查看权限组轨道的历史"
-    args:
-      "track": "权限组轨道的名称"
-      "page": "要查看的页码"
-  sponge:
-    description: "编辑额外的Sponge数据"
-    usage: "/%s sponge <collection> <subject>"
-    args:
-      "collection": "要查询的集合"
-      "subject": "修改的主题"
-  sponge-permission-info:
-    description: "显示有关主题权限的信息"
-    args:
-      "contexts...": "选择的环境"
-  sponge-permission-set:
-    description: "设置一个主题的权限"
-    args:
-      "node": "要设置的权限节点"
-      "tristate": "设置允许值"
-      "contexts...": "选择的环境"
-  sponge-permission-clear:
-    description: "清除一个主题的权限"
-    args:
-      "contexts...": "清除的环境"
-  sponge-parent-info:
-    description: "显示关于该主题父项的信息"
-    args:
-      "contexts...": "选择的环境"
-  sponge-parent-add:
-    description: "向主题添加父项"
-    args:
-      "collection": "父主题的主题集合"
-      "subject": "父主题的名称"
-      "contexts...": "添加父项的环境"
-  sponge-parent-remove:
-    description: "从主题中删除父项"
-    args:
-      "collection": "父主题的主题集合"
-      "subject": "父主题的名称"
-      "contexts...": "删除父项的环境"
-  sponge-parent-clear:
-    description: "清除主题父项"
-    args:
-      "contexts...": "清除父项的主题"
-  sponge-option-info:
-    description: "显示有关主题选项的信息"
-    args:
-      "contexts...": "选择的环境"
-  sponge-option-set:
-    description: "为主题设置一个选项"
-    args:
-      "key": "设定键"
-      "value": "设置的键"
-      "contexts...": "设置选项的环境"
-  sponge-option-unset:
-    description: "取消主题一个选项"
-    args:
-      "key": "取消的键"
-      "contexts...": "取消选项的环境"
-  sponge-option-clear:
-    description: "清除对象的选择"
-    args:
-      "contexts...": "清除选项的环境"
-  migration-command:
-    description: "迁移命令"
-  migration-groupmanager:
-    description: "迁移命令"
-    args:
-      "migrate as global": "如果世界权限应该被忽略，并且刚刚迁移为全局"
-  migration-powerfulperms:
-    description: "迁移命令"
-    args:
-      "address": "PP数据库的地址"
-      "database": "PP数据库的名称"
-      "username": "登录DB的用户名"
-      "password": "登录DB的用密码"
-      "db table": "存储用户数据的PP表的名称"

CONTRIBUTING.md

@@ -0,0 +1,26 @@
+### :speech_balloon: Looking for support?
+
+Details about support for the project can be found [here, on the Wiki Homepage](https://luckperms.net/wiki/Home#support).
+
+### :bug: Reporting bugs?
+
+Before reporting a bug or issue, please make sure that the issue is actually being caused by or related to LuckPerms. We get a lot of reports which are caused by other software - please double check!
+
+If you're unsure, feel free to ask using the above resources BEFORE making a report.
+
+Bugs or issues should be reported using the [GitHub Issues tab](https://github.com/lucko/LuckPerms/issues).
+
+### :pencil: Want to contribute code?
+#### 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](https://google.github.io/styleguide/javaguide.html). Generally, try to copy the style of code found in the class you're editing. 
+
+If you're considering submitting a substantial pull request, please open an issue so we can discuss the change before starting work on the contribution. Most pull requests are happily accepted, but larger changes may have an impact on the maintainability of the project, and require more consideration. 
+
+#### 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 & Fabric** - Each use the common module to implement plugins on the respective server platforms.

HEADER.txt

@@ -0,0 +1,22 @@
+This file is part of LuckPerms, licensed under the MIT License.
+
+ Copyright (c) lucko (Luck) <luck@lucko.me>
+ Copyright (c) contributors
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to deal
+ in the Software without restriction, including without limitation the rights
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice shall be included in all
+ copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ SOFTWARE.

LICENSE.txt

@@ -1,4 +1,4 @@
-The MIT License.
+MIT License
 
 Copyright (c) lucko (Luck) <luck@lucko.me>
 Copyright (c) contributors
@@ -19,4 +19,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

README.md

@@ -1,63 +1,53 @@
-![alt text](https://i.imgur.com/7TwJZ5e.png "Banner")
-# LuckPerms [![Build Status](https://ci.lucko.me/job/LuckPerms/badge/icon)](https://ci.lucko.me/job/LuckPerms/)
-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.
+![](https://raw.githubusercontent.com/LuckPerms/branding/master/banner/banner.png "Banner")
+# LuckPerms
+[![Build Status](https://ci.lucko.me/job/LuckPerms/badge/icon)](https://ci.lucko.me/job/LuckPerms/)
+[![javadoc](https://javadoc.io/badge2/net.luckperms/api/javadoc.svg)](https://javadoc.io/doc/net.luckperms/api)
+[![Maven Central](https://img.shields.io/maven-metadata/v/https/repo1.maven.org/maven2/net/luckperms/api/maven-metadata.xml.svg?label=maven%20central&colorB=brightgreen)](https://search.maven.org/artifact/net.luckperms/api)
+[![Discord](https://img.shields.io/discord/241667244927483904.svg?label=discord&logo=discord)](https://discord.gg/luckperms)
 
-LuckPerms also includes an extensive API for developers, and support for a variety of Minecraft server software & data storage options.
+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.
 
-[See the charts below](https://github.com/lucko/LuckPerms#luckperms-vs-other-plugins) for a partial list of features & comparison with other providers.
+The latest downloads, wiki & other useful links can be found on the project homepage at [luckperms.net](https://luckperms.net/).
 
-* [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")
+It is:
 
-## Useful Links
-* **Development Builds** - <https://ci.lucko.me/job/LuckPerms>
-* **Javadocs** - <https://luckperms.lucko.me/javadocs/>
-* **Wiki** - <https://github.com/lucko/LuckPerms/wiki>
+* **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?](https://luckperms.net/wiki/Why-LuckPerms)
 
 ## Building
-LuckPerms uses Maven to handle dependencies.
+LuckPerms uses Gradle to handle dependencies & building.
 
 #### Requirements
-* Java 8 JDK
-* Maven 3.3.x (the older versions will not work.)
+* Java 8 JDK or newer
 * Git
 
-#### Then run
+#### Compiling from source
 ```sh
 git clone https://github.com/lucko/LuckPerms.git
 cd LuckPerms/
-mvn clean package
+./gradlew build
 ```
 
-You can find the output jars in the `target` directories.
+You can find the output jars in the `loader/build/libs` or `build/libs` 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!)
+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](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. 
+LuckPerms loosely follows the [Google Java Style Guide](https://google.github.io/styleguide/javaguide.html). 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.
+The project is split up into a few separate 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.
+* **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, Fabric, 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`](https://github.com/lucko/LuckPerms/blob/master/LICENSE.txt) for more info.
-
-## LuckPerms vs Other Plugins
-### Bukkit
-![alt text](https://luckperms.lucko.me/assets/bukkit-compare.png "Feature comparison")
-
-### Sponge
-![alt text](https://luckperms.lucko.me/assets/sponge-compare.png "Feature comparison")
-
-
-## Thanks
-[![JProfiler](https://www.ej-technologies.com/images/product_banners/jprofiler_large.png)](http://www.ej-technologies.com/products/jprofiler/overview.html)
-
-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").

api/build.gradle

@@ -0,0 +1,116 @@
+group = 'net.luckperms'
+project.version = '5.3'
+
+dependencies {
+    compileOnly 'org.checkerframework:checker-qual:3.12.0'
+    compileOnly 'org.jetbrains:annotations:20.1.0'
+}
+
+// Only used occasionally for deployment - not needed for normal builds.
+/*
+if (project.hasProperty('sonatypeUsername') && project.hasProperty('sonatypePassword')) {
+    apply plugin: 'signing'
+
+    javadoc {
+        title = 'LuckPerms API (v' + project.ext.apiVersion + ')'
+        options.overview = 'javadoc/overview.html'
+        options.encoding = 'UTF-8'
+        options.charSet = 'UTF-8'
+        options.links(
+                'https://checkerframework.org/api/',
+                'https://javadoc.io/static/org.jetbrains/annotations/20.1.0/'
+        )
+        options.addStringOption('Xdoclint:none', '-quiet')
+
+        if (JavaVersion.current() > JavaVersion.VERSION_1_8) {
+            options.addBooleanOption('-no-module-directories', true)
+            options.links.add('https://docs.oracle.com/en/java/javase/11/docs/api/')
+        } else {
+            options.links.add('https://docs.oracle.com/javase/8/docs/api/')
+        }
+    }
+
+    task javadocJar(type: Jar, dependsOn: javadoc) {
+        classifier 'javadoc'
+        from javadoc.destinationDir
+    }
+
+    task sourcesJar(type: Jar) {
+        classifier 'sources'
+        from sourceSets.main.allSource
+    }
+
+    artifacts {
+        archives javadocJar
+        archives sourcesJar
+    }
+
+    signing {
+        useGpgCmd()
+        sign configurations.archives
+    }
+
+    publishing {
+        repositories {
+            maven {
+                def releasesRepoUrl = 'https://oss.sonatype.org/service/local/staging/deploy/maven2/'
+                def snapshotsRepoUrl = 'https://oss.sonatype.org/content/repositories/snapshots/'
+                url = version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
+
+                credentials {
+                    username sonatypeUsername
+                    password sonatypePassword
+                }
+            }
+        }
+
+        publications {
+            mavenJava(MavenPublication) {
+                artifactId = 'api'
+
+                from components.java
+                artifact sourcesJar
+                artifact javadocJar
+
+                pom {
+                    name 'LuckPerms API'
+                    description 'A permissions plugin for Minecraft servers.'
+                    url 'https://luckperms.net'
+
+                    licenses {
+                        license {
+                            name 'MIT'
+                            url 'https://opensource.org/licenses/MIT'
+                        }
+                    }
+
+                    developers {
+                        developer {
+                            id 'lucko'
+                            name 'Luck'
+                            url 'https://lucko.me'
+                            email 'git@lucko.me'
+                        }
+                    }
+
+                    scm {
+                        connection 'scm:git:https://github.com/lucko/LuckPerms.git'
+                        developerConnection 'scm:git:git@github.com:lucko/LuckPerms.git'
+                        url 'https://github.com/lucko/LuckPerms'
+                    }
+
+                    ciManagement {
+                        system 'Jenkins'
+                        url 'https://ci.lucko.me/job/LuckPerms'
+                    }
+
+                    issueManagement {
+                        system 'GitHub'
+                        url 'https://github.com/lucko/LuckPerms/issues'
+                    }
+                }
+            }
+        }
+    }
+}
+*/

api/javadoc/overview.html

@@ -0,0 +1,19 @@
+<body>
+<p>
+    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.
+</p>
+<h4>Useful Links</h4>
+<ul>
+    <li><a target="_top" href="https://luckperms.net">Project Website</a></li>
+    <li><a target="_top" href="https://luckperms.net/wiki/Developer-API">Wiki - API Introduction</a></li>
+    <li><a target="_top" href="https://luckperms.net/wiki/Developer-API-Usage">Wiki - API Usage</a></li>
+</ul>
+<h4>Maven</h4>
+<p>
+    The API artifact is deployed to Maven Central under
+    <a target="_top" href="https://search.maven.org/artifact/net.luckperms/api">
+        group id: <b><code>net.luckperms</code></b>, artifact id: <b><code>api</code></b>.
+    </a>
+</p>
+</body>

api/pom.xml

@@ -1,116 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xmlns="http://maven.apache.org/POM/4.0.0"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-    <parent>
-        <artifactId>luckperms</artifactId>
-        <groupId>me.lucko.luckperms</groupId>
-        <version>3.4-SNAPSHOT</version>
-    </parent>
-    <modelVersion>4.0.0</modelVersion>
-
-    <artifactId>luckperms-api</artifactId>
-
-    <build>
-        <finalName>LuckPerms-API-${release.version}</finalName>
-        <resources>
-            <resource>
-                <directory>../</directory>
-                <filtering>false</filtering>
-                <includes>
-                    <include>LICENSE.txt</include>
-                </includes>
-            </resource>
-        </resources>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <version>${compiler.version}</version>
-                <configuration>
-                    <source>1.8</source>
-                    <target>1.8</target>
-                </configuration>
-            </plugin>
-        </plugins>
-    </build>
-
-    <profiles>
-        <profile>
-            <id>deployment</id>
-            <build>
-                <plugins>
-                    <plugin>
-                        <groupId>org.apache.maven.plugins</groupId>
-                        <artifactId>maven-source-plugin</artifactId>
-                        <version>3.0.1</version>
-                        <executions>
-                            <execution>
-                                <id>attach-sources</id>
-                                <goals>
-                                    <goal>jar</goal>
-                                </goals>
-                            </execution>
-                        </executions>
-                    </plugin>
-                    <plugin>
-                        <groupId>org.apache.maven.plugins</groupId>
-                        <artifactId>maven-javadoc-plugin</artifactId>
-                        <version>2.10.4</version>
-                        <executions>
-                            <execution>
-                                <id>attach-javadocs</id>
-                                <goals>
-                                    <goal>jar</goal>
-                                </goals>
-                            </execution>
-                        </executions>
-                        <configuration>
-                            <links>
-                                <link>https://google.github.io/guava/releases/21.0/api/docs/</link>
-                            </links>
-                        </configuration>
-                    </plugin>
-                </plugins>
-            </build>
-        </profile>
-        <profile>
-            <id>sign</id>
-            <build>
-                <plugins>
-                    <plugin>
-                        <groupId>org.apache.maven.plugins</groupId>
-                        <artifactId>maven-gpg-plugin</artifactId>
-                        <version>${gpg.version}</version>
-                        <executions>
-                            <execution>
-                                <id>sign-artifacts</id>
-                                <phase>verify</phase>
-                                <goals>
-                                    <goal>sign</goal>
-                                </goals>
-                            </execution>
-                        </executions>
-                    </plugin>
-                </plugins>
-            </build>
-        </profile>
-    </profiles>
-
-    <dependencies>
-        <!-- guava -->
-        <dependency>
-            <groupId>com.google.guava</groupId>
-            <artifactId>guava</artifactId>
-            <version>19.0</version>
-            <scope>provided</scope>
-        </dependency>
-        <dependency>
-            <groupId>com.google.code.findbugs</groupId>
-            <artifactId>jsr305</artifactId>
-            <version>3.0.2</version>
-            <scope>provided</scope>
-        </dependency>
-    </dependencies>
-
-</project>

api/src/main/java/me/lucko/luckperms/LuckPerms.java

@@ -1,94 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms;
-
-import me.lucko.luckperms.api.LuckPermsApi;
-
-import java.util.Optional;
-
-import javax.annotation.Nonnull;
-
-/**
- * Provides static access to the {@link LuckPermsApi}.
- *
- * <p>Ideally, the ServiceManager for the platform should be used to obtain an instance,
- * however, this provider can be used if you need static access.</p>
- */
-public final class LuckPerms {
-    private static LuckPermsApi instance = null;
-
-    /**
-     * Gets an instance of the {@link LuckPermsApi},
-     * throwing {@link IllegalStateException} if an instance is not yet loaded.
-     *
-     * <p>Will never return null.</p>
-     *
-     * @return an api instance
-     * @throws IllegalStateException if the api is not loaded
-     */
-    @Nonnull
-    public static LuckPermsApi getApi() {
-        if (instance == null) {
-            throw new IllegalStateException("API is not loaded.");
-        }
-        return instance;
-    }
-
-    /**
-     * Gets an instance of {@link LuckPermsApi}, if it is loaded.
-     *
-     * <p>Unlike {@link LuckPerms#getApi}, this method will not throw an
-     * {@link IllegalStateException} if an instance is not yet loaded, rather return
-     * an empty {@link Optional}.
-     *
-     * @return an optional api instance
-     */
-    @Nonnull
-    public static Optional<LuckPermsApi> getApiSafe() {
-        return Optional.ofNullable(instance);
-    }
-
-    /**
-     * Registers an instance of the {@link LuckPermsApi} with this provider.
-     *
-     * @param instance the instance
-     */
-    static void registerProvider(LuckPermsApi instance) {
-        LuckPerms.instance = instance;
-    }
-
-    /**
-     * Removes the current instance from this provider.
-     */
-    static void unregisterProvider() {
-        LuckPerms.instance = null;
-    }
-
-    private LuckPerms() {
-        throw new UnsupportedOperationException("This class cannot be instantiated.");
-    }
-
-}

api/src/main/java/me/lucko/luckperms/api/ChatMetaType.java

@@ -1,126 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import com.google.common.base.Preconditions;
-
-import java.util.Map;
-import java.util.Optional;
-
-import javax.annotation.Nonnull;
-
-/**
- * Represents a type of chat meta
- *
- * @since 3.2
- */
-public enum ChatMetaType {
-
-    /**
-     * Represents a prefix
-     */
-    PREFIX {
-        @Override
-        public boolean matches(Node node) {
-            return Preconditions.checkNotNull(node, "node").isPrefix();
-        }
-
-        @Override
-        public boolean shouldIgnore(Node node) {
-            return !Preconditions.checkNotNull(node, "node").isPrefix();
-        }
-
-        @Override
-        public Map.Entry<Integer, String> getEntry(Node node) {
-            return Preconditions.checkNotNull(node, "node").getPrefix();
-        }
-    },
-
-    /**
-     * Represents a suffix
-     */
-    SUFFIX {
-        @Override
-        public boolean matches(Node node) {
-            return Preconditions.checkNotNull(node, "node").isSuffix();
-        }
-
-        @Override
-        public boolean shouldIgnore(Node node) {
-            return !Preconditions.checkNotNull(node, "node").isSuffix();
-        }
-
-        @Override
-        public Map.Entry<Integer, String> getEntry(Node node) {
-            return Preconditions.checkNotNull(node, "node").getSuffix();
-        }
-    };
-
-    /**
-     * Returns if the passed node matches the type
-     *
-     * @param node the node to test
-     * @return true if the node has the same type
-     */
-    public abstract boolean matches(@Nonnull Node node);
-
-    /**
-     * Returns if the passed node should be ignored when searching for meta of this type
-     *
-     * @param node the node to test
-     * @return true if the node does not share the same type
-     */
-    public abstract boolean shouldIgnore(@Nonnull Node node);
-
-    /**
-     * Maps the corresponding entry from the given node
-     *
-     * @param node the node to retrieve the entry from
-     * @return the entry
-     * @throws IllegalStateException if the node does not share the same type
-     */
-    @Nonnull
-    public abstract Map.Entry<Integer, String> getEntry(@Nonnull Node node);
-
-    /**
-     * Parses a ChatMetaType from the given node.
-     *
-     * @param node the node
-     * @return the parsed chat meta type
-     * @since 3.4
-     */
-    @Nonnull
-    public static Optional<ChatMetaType> ofNode(@Nonnull Node node) {
-        if (node.isPrefix()) {
-            return Optional.of(PREFIX);
-        } else if (node.isSuffix()) {
-            return Optional.of(SUFFIX);
-        } else {
-            return Optional.empty();
-        }
-    }
-
-}

api/src/main/java/me/lucko/luckperms/api/Contexts.java

@@ -1,236 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import me.lucko.luckperms.api.context.ContextSet;
-
-import javax.annotation.Nonnull;
-
-/**
- * Context and options for a permission lookup.
- *
- * <p>All values are immutable.</p>
- *
- * @since 2.11
- */
-public class Contexts {
-    public static final String SERVER_KEY = "server";
-    public static final String WORLD_KEY = "world";
-
-    private static final Contexts GLOBAL = new Contexts(ContextSet.empty(), true, true, true, true, true, false);
-
-    /**
-     * Gets the {@link FullySatisfiedContexts} instance.
-     *
-     * @return a context that will satisfy all contextual requirements.
-     */
-    @Nonnull
-    public static Contexts allowAll() {
-        return FullySatisfiedContexts.getInstance();
-    }
-
-    /**
-     * A contexts instance with no defined context.
-     *
-     * @return the global contexts
-     * @since 3.3
-     */
-    @Nonnull
-    public static Contexts global() {
-        return GLOBAL;
-    }
-
-    public static Contexts of(@Nonnull ContextSet context, boolean includeGlobal, boolean includeGlobalWorld, boolean applyGroups, boolean applyGlobalGroups, boolean applyGlobalWorldGroups, boolean op) {
-        return new Contexts(context, includeGlobal, includeGlobalWorld, applyGroups, applyGlobalGroups, applyGlobalWorldGroups, op);
-    }
-
-    /**
-     * The contexts that apply for this lookup
-     * The keys for servers and worlds are defined as static values.
-     */
-    private final ContextSet context;
-
-    /**
-     * The mode to parse defaults on Bukkit
-     *
-     * @since 2.12
-     */
-    private final boolean op;
-
-    /**
-     * If global or non server specific nodes should be applied
-     */
-    private final boolean includeGlobal;
-
-    /**
-     * If global or non world specific nodes should be applied
-     */
-    private final boolean includeGlobalWorld;
-
-    /**
-     * If parent groups should be applied
-     */
-    private final boolean applyGroups;
-
-    /**
-     * If global or non server specific group memberships should be applied
-     */
-    private final boolean applyGlobalGroups;
-
-    /**
-     * If global or non world specific group memberships should be applied
-     */
-    private final boolean applyGlobalWorldGroups;
-
-    public Contexts(@Nonnull ContextSet context, boolean includeGlobal, boolean includeGlobalWorld, boolean applyGroups, boolean applyGlobalGroups, boolean applyGlobalWorldGroups, boolean op) {
-        if (context == null) {
-            throw new NullPointerException("context");
-        }
-
-        this.context = context.makeImmutable();
-        this.includeGlobal = includeGlobal;
-        this.includeGlobalWorld = includeGlobalWorld;
-        this.applyGroups = applyGroups;
-        this.applyGlobalGroups = applyGlobalGroups;
-        this.applyGlobalWorldGroups = applyGlobalWorldGroups;
-        this.op = op;
-    }
-
-    /**
-     * Gets the contexts that apply for this lookup
-     *
-     * @return an immutable set of context key value pairs
-     * @since 2.13
-     */
-    @Nonnull
-    public ContextSet getContexts() {
-        return this.context;
-    }
-
-    /**
-     * Gets if OP defaults should be included
-     *
-     * @return true if op defaults should be included
-     */
-    public boolean isOp() {
-        return this.op;
-    }
-
-    /**
-     * Gets if global or non server specific nodes should be applied
-     *
-     * @return true if global or non server specific nodes should be applied
-     */
-    public boolean isIncludeGlobal() {
-        return this.includeGlobal;
-    }
-
-    /**
-     * Gets if global or non world specific nodes should be applied
-     *
-     * @return true if global or non world specific nodes should be applied
-     */
-    public boolean isIncludeGlobalWorld() {
-        return this.includeGlobalWorld;
-    }
-
-    /**
-     * Gets if parent groups should be applied
-     *
-     * @return true if parent groups should be applied
-     */
-    public boolean isApplyGroups() {
-        return this.applyGroups;
-    }
-
-    /**
-     * Gets if global or non server specific group memberships should be applied
-     *
-     * @return true if global or non server specific group memberships should be applied
-     */
-    public boolean isApplyGlobalGroups() {
-        return this.applyGlobalGroups;
-    }
-
-    /**
-     * Gets if global or non world specific group memberships should be applied
-     *
-     * @return true if global or non world specific group memberships should be applied
-     */
-    public boolean isApplyGlobalWorldGroups() {
-        return this.applyGlobalWorldGroups;
-    }
-
-    @Override
-    @Nonnull
-    public String toString() {
-        return "Contexts(" +
-                "context=" + this.getContexts() + ", " +
-                "op=" + this.isOp() + ", " +
-                "includeGlobal=" + this.isIncludeGlobal() + ", " +
-                "includeGlobalWorld=" + this.isIncludeGlobalWorld() + ", " +
-                "applyGroups=" + this.isApplyGroups() + ", " +
-                "applyGlobalGroups=" + this.isApplyGlobalGroups() + ", " +
-                "applyGlobalWorldGroups=" + this.isApplyGlobalWorldGroups() +
-                ")";
-    }
-
-    /*
-     * Ugly auto-generated lombok code
-     */
-
-    @Override
-    public boolean equals(Object o) {
-        if (o == this) return true;
-        if (o == allowAll()) return false;
-        if (!(o instanceof Contexts)) return false;
-
-        final Contexts other = (Contexts) o;
-        return this.getContexts().equals(other.getContexts()) &&
-                this.isOp() == other.isOp() &&
-                this.isIncludeGlobal() == other.isIncludeGlobal() &&
-                this.isIncludeGlobalWorld() == other.isIncludeGlobalWorld() &&
-                this.isApplyGroups() == other.isApplyGroups() &&
-                this.isApplyGlobalGroups() == other.isApplyGlobalGroups() &&
-                this.isApplyGlobalWorldGroups() == other.isApplyGlobalWorldGroups();
-    }
-
-    @Override
-    public int hashCode() {
-        final int PRIME = 59;
-        int result = 1;
-        final Object contexts = this.getContexts();
-        result = result * PRIME + contexts.hashCode();
-        result = result * PRIME + (this.isOp() ? 79 : 97);
-        result = result * PRIME + (this.isIncludeGlobal() ? 79 : 97);
-        result = result * PRIME + (this.isIncludeGlobalWorld() ? 79 : 97);
-        result = result * PRIME + (this.isApplyGroups() ? 79 : 97);
-        result = result * PRIME + (this.isApplyGlobalGroups() ? 79 : 97);
-        result = result * PRIME + (this.isApplyGlobalWorldGroups() ? 79 : 97);
-        return result;
-    }
-
-}

api/src/main/java/me/lucko/luckperms/api/DataMutateResult.java

@@ -1,111 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import me.lucko.luckperms.exceptions.ObjectAlreadyHasException;
-import me.lucko.luckperms.exceptions.ObjectLacksException;
-
-import java.util.function.Supplier;
-
-/**
- * Represents the result of a mutation call.
- */
-public enum DataMutateResult {
-
-    /**
-     * Indicates the mutation was a success
-     */
-    SUCCESS(true, null),
-
-    /**
-     * Indicates the mutation failed because the subject already has something
-     */
-    ALREADY_HAS(false, ObjectAlreadyHasException::new),
-
-    /**
-     * Indicates the mutation failed because the subject lacks something
-     */
-    LACKS(false, ObjectLacksException::new),
-
-    /**
-     * Indicates the mutation failed
-     */
-    FAIL(false, RuntimeException::new);
-
-    private boolean value;
-    private final Supplier<? extends Exception> exceptionSupplier;
-
-    DataMutateResult(boolean value, Supplier<? extends Exception> exceptionSupplier) {
-        this.value = value;
-        this.exceptionSupplier = exceptionSupplier;
-    }
-
-    public void throwException() {
-        if (exceptionSupplier != null) {
-            sneakyThrow(exceptionSupplier.get());
-        }
-    }
-
-    /**
-     * Gets a boolean representation of the result.
-     *
-     * @return a boolean representation
-     */
-    public boolean asBoolean() {
-        return value;
-    }
-
-    /**
-     * Gets if the result indicates a success
-     *
-     * @return if the result indicates a success
-     * @since 3.4
-     */
-    public boolean wasSuccess() {
-        return value;
-    }
-
-    /**
-     * Gets if the result indicates a failure
-     *
-     * @return if the result indicates a failure
-     * @since 3.4
-     */
-    public boolean wasFailure() {
-        return !value;
-    }
-
-    // allows us to throw checked exceptions without declaring it, as #throwException throws a number of
-    // exception types.
-    private static void sneakyThrow(Throwable t) {
-        sneakyThrow0(t);
-    }
-
-    private static <T extends Throwable> void sneakyThrow0(Throwable t) throws T {
-        throw (T) t;
-    }
-
-}

api/src/main/java/me/lucko/luckperms/api/Group.java

@@ -1,319 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import me.lucko.luckperms.api.context.ContextSet;
-import me.lucko.luckperms.exceptions.ObjectAlreadyHasException;
-import me.lucko.luckperms.exceptions.ObjectLacksException;
-
-import java.util.List;
-import java.util.OptionalInt;
-
-import javax.annotation.Nonnull;
-
-/**
- * An inheritable holder of permission data.
- */
-public interface Group extends PermissionHolder {
-
-    /**
-     * Get the name of the group
-     *
-     * @return the name of the group
-     */
-    @Nonnull
-    String getName();
-
-    /**
-     * Check to see if a group inherits another group directly
-     *
-     * @param group The group to check membership of
-     * @return true if the group inherits the other group
-     * @throws NullPointerException  if the group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     */
-    boolean inheritsGroup(@Nonnull Group group);
-
-    /**
-     * Check to see if a group inherits another group directly
-     *
-     * @param group The group to check membership of
-     * @param contextSet the context set to filter by
-     * @return true if the group inherits the other group
-     * @throws NullPointerException  if the group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     * @since 3.2
-     */
-    boolean inheritsGroup(@Nonnull Group group, @Nonnull ContextSet contextSet);
-
-    /**
-     * Gets the weight of this group, if present.
-     *
-     * @return the group weight
-     * @since 2.17
-     */
-    @Nonnull
-    OptionalInt getWeight();
-
-    /**
-     * Check to see if the group inherits a group on a specific server
-     *
-     * @param group  The group to check membership of
-     * @param server The server to check on
-     * @return true if the group inherits the group on the server
-     * @throws NullPointerException     if the group or server is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the server is invalid
-     * @deprecated in favour of {@link #inheritsGroup(Group, ContextSet)}
-     */
-    @Deprecated
-    boolean inheritsGroup(@Nonnull Group group, @Nonnull String server);
-
-    /**
-     * Check to see if the group inherits a group on a specific server and world
-     *
-     * @param group  The group to check membership of
-     * @param server The server to check on
-     * @param world  The world to check on
-     * @return true if the group inherits the group on the server and world
-     * @throws NullPointerException     if the group, server or world is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the server or world is invalid
-     * @deprecated in favour of {@link #inheritsGroup(Group, ContextSet)}
-     */
-    @Deprecated
-    boolean inheritsGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world);
-
-    /**
-     * Make this group inherit another group
-     *
-     * @param group the group to be inherited
-     * @throws ObjectAlreadyHasException if the group already inherits the group
-     * @throws NullPointerException      if the group is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void setInheritGroup(@Nonnull Group group) throws ObjectAlreadyHasException;
-
-    /**
-     * Make this group inherit another group on a specific server
-     *
-     * @param group  the group to be inherited
-     * @param server The server to inherit the group on
-     * @throws ObjectAlreadyHasException if the group already inherits the group on that server
-     * @throws NullPointerException      if the group or server is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the server is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void setInheritGroup(@Nonnull Group group, @Nonnull String server) throws ObjectAlreadyHasException;
-
-    /**
-     * Make this group inherit another group on a specific server and world
-     *
-     * @param group  the group to be inherited
-     * @param server The server to inherit the group on
-     * @param world  The world to inherit the group on
-     * @throws ObjectAlreadyHasException if the group already inherits the group on that server and world
-     * @throws NullPointerException      if the group, server or world is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the server or world is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void setInheritGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world) throws ObjectAlreadyHasException;
-
-    /**
-     * Make this group inherit another group temporarily
-     *
-     * @param group    the group to be inherited
-     * @param expireAt the unix time when the group should expire
-     * @throws ObjectAlreadyHasException if the group already inherits the group temporarily
-     * @throws NullPointerException      if the group is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the expiry time is in the past
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void setInheritGroup(@Nonnull Group group, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Make this group inherit another group on a specific server temporarily
-     *
-     * @param group    the group to be inherited
-     * @param server   The server inherit add the group on
-     * @param expireAt when the group should expire
-     * @throws ObjectAlreadyHasException if the group already inherits the group on that server temporarily
-     * @throws NullPointerException      if the group or server is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the expiry time is in the past or the server is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void setInheritGroup(@Nonnull Group group, @Nonnull String server, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Make this group inherit another group on a specific server and world temporarily
-     *
-     * @param group    the group to be inherited
-     * @param server   The server to inherit the group on
-     * @param world    The world to inherit the group on
-     * @param expireAt when the group should expire
-     * @throws ObjectAlreadyHasException if the group already inherits the group on that server and world temporarily
-     * @throws NullPointerException      if the group, server or world is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the expiry time is in the past or the server/world is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void setInheritGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Remove a previously set inheritance rule
-     *
-     * @param group the group to uninherit
-     * @throws ObjectLacksException  if the group does not already inherit the group
-     * @throws NullPointerException  if the group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void unsetInheritGroup(@Nonnull Group group) throws ObjectLacksException;
-
-    /**
-     * Remove a previously set inheritance rule
-     *
-     * @param group     the group to uninherit
-     * @param temporary if the group being removed is temporary
-     * @throws ObjectLacksException  if the group does not already inherit the group
-     * @throws NullPointerException  if the group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void unsetInheritGroup(@Nonnull Group group, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Remove a previously set inheritance rule on a specific server
-     *
-     * @param group  the group to uninherit
-     * @param server The server to remove the group on
-     * @throws ObjectLacksException     if the group does not already inherit the group on that server
-     * @throws NullPointerException     if the group or server is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the server is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void unsetInheritGroup(@Nonnull Group group, @Nonnull String server) throws ObjectLacksException;
-
-    /**
-     * Remove a previously set inheritance rule on a specific server and world
-     *
-     * @param group  the group to uninherit
-     * @param server The server to remove the group on
-     * @param world  The world to remove the group on
-     * @throws ObjectLacksException     if the group does not already inherit the group
-     * @throws NullPointerException     if the group, server or world is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the server or world is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void unsetInheritGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world) throws ObjectLacksException;
-
-    /**
-     * Remove a previously set inheritance rule on a specific server
-     *
-     * @param group     the group to uninherit
-     * @param server    The server to remove the group on
-     * @param temporary if the group being removed is temporary
-     * @throws ObjectLacksException     if the group does not already inherit the group
-     * @throws NullPointerException     if the group or server is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the expiry time is in the past or the server is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void unsetInheritGroup(@Nonnull Group group, @Nonnull String server, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Remove a previously set inheritance rule on a specific server and world
-     *
-     * @param group     the group to uninherit
-     * @param server    The server to remove the group on
-     * @param world     The world to remove the group on
-     * @param temporary if the group being removed was set temporarily
-     * @throws ObjectLacksException     if the group does not already inherit the group
-     * @throws NullPointerException     if the group, server or world is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the expiry time is in the past or the server/world is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void unsetInheritGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Get a {@link List} of all of the groups the group inherits, on all servers
-     *
-     * @return a {@link List} of group names
-     * @deprecated in favour of just querying a users permissions
-     */
-    @Deprecated
-    @Nonnull
-    List<String> getGroupNames();
-
-    /**
-     * Get a {@link List} of the groups the group inherits on a specific server
-     *
-     * @param server the server to check
-     * @return a {@link List} of group names
-     * @throws NullPointerException     if the server is null
-     * @throws IllegalArgumentException if the server is invalid
-     * @deprecated in favour of just querying a users permissions
-     */
-    @Deprecated
-    @Nonnull
-    List<String> getLocalGroups(@Nonnull String server);
-
-
-    /**
-     * Get a {@link List} of the groups the group inherits on a specific server and world
-     *
-     * @param server the server to check
-     * @param world  the world to check
-     * @return a {@link List} of group names
-     * @throws NullPointerException     if the server or world is null
-     * @throws IllegalArgumentException if the server or world is invalid
-     * @deprecated in favour of just querying a users permissions
-     */
-    @Deprecated
-    @Nonnull
-    List<String> getLocalGroups(@Nonnull String server, @Nonnull String world);
-
-}

api/src/main/java/me/lucko/luckperms/api/HeldPermission.java

@@ -1,116 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import com.google.common.collect.Multimap;
-
-import me.lucko.luckperms.api.context.ContextSet;
-
-import java.util.Optional;
-import java.util.OptionalLong;
-
-import javax.annotation.Nonnull;
-
-/**
- * A relationship between a PermissionHolder and a permission
- *
- * @param <T> the identifier type of the holder
- * @since 2.17
- */
-public interface HeldPermission<T> {
-
-    /**
-     * Gets the holder of the permission
-     *
-     * @return the holder
-     */
-    @Nonnull
-    T getHolder();
-
-    /**
-     * Gets the permission being held
-     *
-     * @return the permission
-     */
-    @Nonnull
-    String getPermission();
-
-    /**
-     * Gets the value of the permission
-     *
-     * @return the value
-     */
-    boolean getValue();
-
-    /**
-     * Gets the server where the permission is held
-     *
-     * @return the server
-     */
-    @Nonnull
-    Optional<String> getServer();
-
-    /**
-     * Gets the world where the permission is held
-     *
-     * @return the world
-     */
-    @Nonnull
-    Optional<String> getWorld();
-
-    /**
-     * Gets the time in unix time when the permission will expire
-     *
-     * @return the expiry time
-     */
-    OptionalLong getExpiry();
-
-    /**
-     * Gets the context for the permission.
-     *
-     * @return the context
-     * @deprecated in favour of {@link #getContexts()}.
-     */
-    @Nonnull
-    @Deprecated
-    Multimap<String, String> getContext();
-
-    /**
-     * Gets the extra context for the permission.
-     *
-     * @return the extra context
-     */
-    ContextSet getContexts();
-
-    /**
-     * Converts this permission into a Node
-     *
-     * @return a Node copy of this permission
-     */
-    @Nonnull
-    Node asNode();
-
-}

api/src/main/java/me/lucko/luckperms/api/LPConfiguration.java

@@ -1,216 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import me.lucko.luckperms.api.data.DatastoreConfiguration;
-
-import java.util.Map;
-
-import javax.annotation.Nonnull;
-
-/**
- * Wrapper around parts of the LuckPerms configuration file
- */
-public interface LPConfiguration {
-
-    /**
-     * Gets the name of this server
-     *
-     * @return the name of this server
-     */
-    @Nonnull
-    String getServer();
-
-    /**
-     * Gets how often a sync task will run in minutes
-     *
-     * @return how often a sync task will run in minutes
-     */
-    int getSyncTime();
-
-    /**
-     * Gets if the users on this server will have their global permissions applied
-     *
-     * @return if the users on this server will have their global permissions applied
-     */
-    boolean getIncludeGlobalPerms();
-
-    /**
-     * Gets if the users on this server will have their global world permissions applied
-     *
-     * @return if the users on this server will have their global world permissions applied
-     * @since 2.9
-     */
-    boolean getIncludeGlobalWorldPerms();
-
-    /**
-     * Gets if the platform is applying global groups
-     *
-     * @return true if the platform is applying global groups
-     * @since 2.9
-     */
-    boolean getApplyGlobalGroups();
-
-    /**
-     * Gets if the platform is applying global world groups
-     *
-     * @return true if the platform is applying global world groups
-     * @since 2.9
-     */
-    boolean getApplyGlobalWorldGroups();
-
-    /**
-     * Gets the online mode setting
-     *
-     * @return the online mode setting
-     */
-    boolean getOnlineMode();
-
-    /**
-     * Gets if LuckPerms is applying wildcard permissions
-     *
-     * @return if LuckPerms is applying wildcard permissions
-     */
-    boolean getApplyWildcards();
-
-    /**
-     * Returns if LuckPerms is resolving and applying regex permissions
-     *
-     * @return if LuckPerms is resolving and applying regex permissions
-     */
-    boolean getApplyRegex();
-
-    /**
-     * Gets if LuckPerms is expanding shorthand permissions
-     *
-     * @return if LuckPerms is expanding shorthand permissions
-     */
-    boolean getApplyShorthand();
-
-    /**
-     * Gets if LuckPerms will send notifications to users when permissions are modified
-     *
-     * @return if LuckPerms will send notifications to users when permissions are modified
-     * @since 2.7
-     */
-    boolean getLogNotify();
-
-    /**
-     * Gets if the vanilla op system is enabled
-     *
-     * @return true if the vanilla op system is enabled
-     * @since 2.8
-     */
-    boolean getEnableOps();
-
-    /**
-     * Gets if opped players are allowed to use LuckPerms commands
-     *
-     * @return true if opped players are allowed to use LuckPerms commands
-     * @since 2.8
-     */
-    boolean getCommandsAllowOp();
-
-    /**
-     * Gets if auto op is enabled
-     *
-     * @return true if auto op is enabled
-     * @since 2.9
-     */
-    boolean getAutoOp();
-
-    /**
-     * Gets the name of the server used within Vault operations
-     *
-     * @return the name of the server used within Vault operations
-     * @since 2.7
-     */
-    @Nonnull
-    String getVaultServer();
-
-    /**
-     * Gets if global permissions should be considered when retrieving meta or player groups
-     *
-     * @return true if global permissions should be considered when retrieving meta or player groups
-     * @since 2.7
-     */
-    boolean getVaultIncludeGlobal();
-
-    /**
-     * Gets the values set for data storage in the configuration
-     *
-     * @return the values set for data storage in the configuration
-     */
-    @Nonnull
-    DatastoreConfiguration getDatastoreConfig();
-
-    /**
-     * Gets the storage method string from the configuration
-     *
-     * @return the storage method string from the configuration
-     */
-    @Nonnull
-    String getStorageMethod();
-
-    /**
-     * Gets true if split storage is enabled
-     *
-     * @return true if split storage is enabled
-     * @since 2.7
-     */
-    boolean getSplitStorage();
-
-    /**
-     * Gets a map of split storage options
-     *
-     * @return a map of split storage options, where the key is the storage section, and the value is the storage
-     * method. For example: key = user, value = json
-     * @since 2.7
-     */
-    @Nonnull
-    Map<String, String> getSplitStorageOptions();
-
-    @Nonnull
-    Unsafe unsafe();
-
-    interface Unsafe {
-
-        /**
-         * Gets an Object from the config.
-         *
-         * <p>This method is nested under {@link Unsafe} because the keys
-         * and return types may change between versions without warning.</p>
-         *
-         * @param key the key, as defined as a parameter name in
-         *            the "ConfigKeys" class.
-         * @return the corresponding object, if one is present
-         * @throws IllegalArgumentException if the key isn't known
-         */
-        @Nonnull
-        Object getObject(String key);
-    }
-
-}

api/src/main/java/me/lucko/luckperms/api/Log.java

@@ -1,230 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import java.util.SortedMap;
-import java.util.SortedSet;
-import java.util.UUID;
-
-import javax.annotation.Nonnull;
-
-/**
- * Represents the internal LuckPerms log.
- *
- * <p>The returned instance provides a copy of the data at the time of retrieval.</p>
- *
- * <p>Any changes made to log entries will only apply to this instance of the log.
- * You can add to the log using the {@link Storage}, and then request an updated copy.</p>
- *
- * <p>All methods are thread safe, and return immutable & thread safe collections.</p>
- */
-public interface Log {
-
-    /**
-     * Get the content of the log
-     *
-     * @return a {@link SortedSet} of all of the {@link LogEntry} objects in this {@link Log}
-     */
-    @Nonnull
-    SortedSet<LogEntry> getContent();
-
-    /**
-     * Get the content of the log
-     *
-     * @return all content in this log
-     */
-    @Nonnull
-    SortedSet<LogEntry> getRecent();
-
-    /**
-     * Gets the recent content separated by page
-     *
-     * @param pageNo the page number
-     * @return the page content
-     * @throws IllegalArgumentException if the pageNo is less than 1
-     * @throws IllegalStateException if the log doesn't contain enough entries to populate the page. See {@link #getRecentMaxPages()}
-     */
-    @Nonnull
-    SortedMap<Integer, LogEntry> getRecent(int pageNo);
-
-    /**
-     * Gets the max page number for the recent pages.
-     *
-     * @return the max page number allowed in the {@link #getRecent(int)} method
-     */
-    int getRecentMaxPages();
-
-
-    /**
-     * Gets the recent content for a given actor
-     *
-     * @param actor the uuid of the actor to filter by
-     * @return all content in this log where is actor = uuid
-     */
-    @Nonnull
-    SortedSet<LogEntry> getRecent(@Nonnull UUID actor);
-
-    /**
-     * Gets the recent content for a given actor, separated by page
-     *
-     * @param pageNo the page number
-     * @param actor  the uuid of the actor to filter by
-     * @return the page content
-     * @throws IllegalArgumentException if the pageNo is less than 1
-     * @throws IllegalStateException if the log doesn't contain enough entries to populate the page. See {@link #getRecentMaxPages(UUID)}
-     */
-    @Nonnull
-    SortedMap<Integer, LogEntry> getRecent(int pageNo, @Nonnull UUID actor);
-
-    /**
-     * Gets the max page number for the recent pages.
-     *
-     * @param actor the actor to filter by
-     * @return the max page number allowed in the {@link #getRecent(int, UUID)} method
-     */
-    int getRecentMaxPages(@Nonnull UUID actor);
-
-
-    /**
-     * Gets the log content for a given user
-     *
-     * @param uuid the uuid to filter by
-     * @return all content in this log where the user = uuid
-     */
-    @Nonnull
-    SortedSet<LogEntry> getUserHistory(@Nonnull UUID uuid);
-
-    /**
-     * Gets the log content for a given user, separated by page
-     *
-     * @param pageNo the page number
-     * @param uuid   the uuid of the acted user to filter by
-     * @return the page content
-     * @throws IllegalArgumentException if the pageNo is less than 1
-     * @throws IllegalStateException if the log doesn't contain enough entries to populate the page. See {@link #getUserHistoryMaxPages(UUID)}
-     */
-    @Nonnull
-    SortedMap<Integer, LogEntry> getUserHistory(int pageNo, @Nonnull UUID uuid);
-
-    /**
-     * Gets the max page number for the user history pages.
-     *
-     * @param uuid the uuid to filter by
-     * @return the max page number allowed in the {@link #getUserHistory(int, UUID)} method
-     */
-    int getUserHistoryMaxPages(@Nonnull UUID uuid);
-
-
-    /**
-     * Gets the log content for a given group
-     *
-     * @param name the name to filter by
-     * @return all content in this log where the group = name
-     */
-    @Nonnull
-    SortedSet<LogEntry> getGroupHistory(@Nonnull String name);
-
-    /**
-     * Gets the log content for a given group, separated by page
-     *
-     * @param pageNo the page number
-     * @param name   the name of the acted group to filter by
-     * @return the page content
-     * @throws IllegalArgumentException if the pageNo is less than 1
-     * @throws IllegalStateException if the log doesn't contain enough entries to populate the page. See {@link #getGroupHistoryMaxPages(String)}
-     */
-    @Nonnull
-    SortedMap<Integer, LogEntry> getGroupHistory(int pageNo, @Nonnull String name);
-
-    /**
-     * Gets the max page number for the group history pages.
-     *
-     * @param name the name to filter by
-     * @return the max page number allowed in the {@link #getGroupHistory(int, String)} method
-     */
-    int getGroupHistoryMaxPages(@Nonnull String name);
-
-
-    /**
-     * Gets the log content for a given track
-     *
-     * @param name the name to filter by
-     * @return all content in this log where the track = name
-     */
-    @Nonnull
-    SortedSet<LogEntry> getTrackHistory(@Nonnull String name);
-
-    /**
-     * Gets the log content for a given track, separated by page
-     *
-     * @param pageNo the page number
-     * @param name   the name of the acted track to filter by
-     * @return the page content
-     * @throws IllegalArgumentException if the pageNo is less than 1
-     * @throws IllegalStateException if the log doesn't contain enough entries to populate the page. See {@link #getTrackHistoryMaxPages(String)}
-     */
-    @Nonnull
-    SortedMap<Integer, LogEntry> getTrackHistory(int pageNo, @Nonnull String name);
-
-    /**
-     * Gets the max page number for the track history pages.
-     *
-     * @param name the name to filter by
-     * @return the max page number allowed in the {@link #getTrackHistory(int, String)} method
-     */
-    int getTrackHistoryMaxPages(@Nonnull String name);
-
-
-    /**
-     * Gets the log content for a given search query
-     *
-     * @param query the query to filter by
-     * @return all content in this log where the content matches query
-     */
-    @Nonnull
-    SortedSet<LogEntry> getSearch(@Nonnull String query);
-
-    /**
-     * Gets the log content for a given search query, separated by page
-     *
-     * @param pageNo the page number
-     * @param query  the query to filter by
-     * @return the page content
-     * @throws IllegalArgumentException if the pageNo is less than 1
-     * @throws IllegalStateException if the log doesn't contain enough entries to populate the page. See {@link #getSearchMaxPages(String)}}
-     */
-    @Nonnull
-    SortedMap<Integer, LogEntry> getSearch(int pageNo, @Nonnull String query);
-
-    /**
-     * Gets the max page number for the search query pages.
-     *
-     * @param query the query to filter by
-     * @return the max page number allowed in the {@link #getSearch(int, String)} method
-     */
-    int getSearchMaxPages(@Nonnull String query);
-
-}

api/src/main/java/me/lucko/luckperms/api/LogEntry.java

@@ -1,554 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import com.google.common.base.Preconditions;
-
-import java.util.Comparator;
-import java.util.UUID;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-/**
- * A single entry in the log.
- */
-public class LogEntry implements Comparable<LogEntry> {
-
-    /**
-     * Compares two LogEntries
-     *
-     * @since 3.3
-     */
-    public static final Comparator<LogEntry> COMPARATOR = Comparator
-            .comparingLong(LogEntry::getTimestamp)
-            .thenComparing(LogEntry::getActor)
-            .thenComparing(LogEntry::getActorName, String.CASE_INSENSITIVE_ORDER)
-            .thenComparing(LogEntry::getEntryType)
-            .thenComparing(e -> {
-                UUID u = e.getActed();
-                return u == null ? "" : u.toString();
-            })
-            .thenComparing(LogEntry::getActedName, String.CASE_INSENSITIVE_ORDER)
-            .thenComparing(LogEntry::getAction);
-
-    /**
-     * Compares two LogEntries in reverse order
-     *
-     * @since 3.3
-     * @see #COMPARATOR
-     */
-    public static final Comparator<LogEntry> REVERSE_ORDER = COMPARATOR.reversed();
-
-    private static final String FORMAT = "&8(&e%s&8) [&a%s&8] (&b%s&8) &7--> &f%s";
-
-    /**
-     * Creates a new LogEntry builder
-     *
-     * @return a new builder
-     */
-    @Nonnull
-    public static LogEntryBuilder builder() {
-        return new LogEntryBuilder();
-    }
-
-    /**
-     * The time when the log event occurred in unix seconds.
-     */
-    private long timestamp;
-
-    /**
-     * The player who enacted the change
-     */
-    @Nonnull
-    private UUID actor;
-
-    /**
-     * The name of the player who enacted the change
-     */
-    @Nonnull
-    private String actorName;
-
-    /**
-     * The entry type.
-     */
-    @Nonnull
-    private Type type;
-
-    /**
-     * The user who was acted upon
-     */
-    @Nullable
-    private UUID acted;
-
-    /**
-     * The name of the object who was acted upon
-     */
-    @Nonnull
-    private String actedName;
-
-    /**
-     * A description of the action
-     */
-    @Nonnull
-    private String action;
-
-    /**
-     * Creates a new log entry
-     *
-     * @param timestamp the timestamp
-     * @param actor the actor
-     * @param actorName the actorName
-     * @param type the type
-     * @param acted the acted object, or null
-     * @param actedName the acted object name
-     * @param action the action
-     * @since 3.3
-     */
-    public LogEntry(long timestamp, @Nonnull UUID actor, @Nonnull String actorName, @Nonnull Type type, @Nullable UUID acted, @Nonnull String actedName, @Nonnull String action) {
-        Preconditions.checkNotNull(actor, "actor");
-        Preconditions.checkNotNull(actorName, "actorName");
-        Preconditions.checkNotNull(type, "type");
-        Preconditions.checkNotNull(actedName, "actedName");
-        Preconditions.checkNotNull(action, "action");
-
-        this.timestamp = timestamp;
-        this.actor = actor;
-        this.actorName = actorName;
-        this.type = type;
-        this.acted = acted;
-        this.actedName = actedName;
-        this.action = action;
-    }
-
-    /**
-     * Creates a new log entry
-     *
-     * @param timestamp the timestamp
-     * @param actor the actor
-     * @param actorName the actorName
-     * @param type the type code
-     * @param acted the acted object, or null
-     * @param actedName the acted object name
-     * @param action the action
-     */
-    public LogEntry(long timestamp, @Nonnull UUID actor, @Nonnull String actorName, char type, @Nullable UUID acted, @Nonnull String actedName, @Nonnull String action) {
-        Preconditions.checkNotNull(actor, "actor");
-        Preconditions.checkNotNull(actorName, "actorName");
-        Preconditions.checkNotNull(actedName, "actedName");
-        Preconditions.checkNotNull(action, "action");
-
-        this.timestamp = timestamp;
-        this.actor = actor;
-        this.actorName = actorName;
-        this.type = Type.valueOf(type);
-        this.acted = acted;
-        this.actedName = actedName;
-        this.action = action;
-    }
-
-    /**
-     * Creates a new LogEntry and copies the values from another
-     *
-     * @param other the entry to copy values from
-     * @since 3.3
-     */
-    protected LogEntry(@Nonnull LogEntry other) {
-        this.timestamp = other.timestamp;
-        this.actor = other.actor;
-        this.actorName = other.actorName;
-        this.type = other.type;
-        this.acted = other.acted;
-        this.actedName = other.actedName;
-        this.action = other.action;
-    }
-
-    protected LogEntry() {
-        this.timestamp = 0L;
-        this.actor = null;
-        this.actorName = null;
-        this.type = null;
-        this.acted = null;
-        this.actedName = null;
-        this.action = null;
-    }
-
-    @Override
-    public int compareTo(@Nonnull LogEntry other) {
-        Preconditions.checkNotNull(other, "other");
-        return COMPARATOR.compare(this, other);
-    }
-
-    /**
-     * Creates a copy of this log entry
-     *
-     * @return a copy of this log entry
-     * @since 3.3
-     */
-    public LogEntry copy() {
-        return new LogEntry(this);
-    }
-
-    public long getTimestamp() {
-        return timestamp;
-    }
-
-    void setTimestamp(long timestamp) {
-        this.timestamp = timestamp;
-    }
-
-    @Nonnull
-    public UUID getActor() {
-        return Preconditions.checkNotNull(actor, "actor");
-    }
-
-    void setActor(@Nonnull UUID actor) {
-        this.actor = Preconditions.checkNotNull(actor, "actor");
-    }
-
-    @Nonnull
-    public String getActorName() {
-        return Preconditions.checkNotNull(actorName, "actorName");
-    }
-
-    void setActorName(@Nonnull String actorName) {
-        this.actorName = Preconditions.checkNotNull(actorName, "actorName");
-    }
-
-    /**
-     * Gets the type of this entry
-     *
-     * @return the type of this entry
-     * @since 3.3
-     */
-    @Nonnull
-    public Type getEntryType() {
-        return Preconditions.checkNotNull(type, "type");
-    }
-
-    /**
-     * Sets the type of this entry
-     *
-     * @param type the new type
-     * @since 3.3
-     */
-    public void setEntryType(@Nonnull Type type) {
-        this.type = Preconditions.checkNotNull(type, "type");
-    }
-
-    /**
-     * Gets the code representing this entry type
-     *
-     * @return the code representing this entry type
-     * @deprecated in favour of {@link #getEntryType()}
-     */
-    @Deprecated
-    public char getType() {
-        return getEntryType().getCode();
-    }
-
-    /**
-     * Sets the type of this entry by code
-     *
-     * @param code the code type
-     * @deprecated in favour of {@link #setEntryType(Type)}
-     */
-    @Deprecated
-    void setType(char code) {
-        setEntryType(Type.valueOf(code));
-    }
-
-    @Nullable
-    public UUID getActed() {
-        return acted;
-    }
-
-    void setActed(@Nullable UUID acted) {
-        this.acted = acted;
-    }
-
-    @Nonnull
-    public String getActedName() {
-        return Preconditions.checkNotNull(actedName, "actedName");
-    }
-
-    void setActedName(@Nonnull String actedName) {
-        this.actedName = Preconditions.checkNotNull(actedName, "actedName");
-    }
-
-    @Nonnull
-    public String getAction() {
-        return Preconditions.checkNotNull(action, "action");
-    }
-
-    void setAction(@Nonnull String action) {
-        this.action = Preconditions.checkNotNull(action, "action");
-    }
-
-    public boolean matchesSearch(@Nonnull String query) {
-        query = Preconditions.checkNotNull(query, "query").toLowerCase();
-        return actorName.toLowerCase().contains(query) ||
-                actedName.toLowerCase().contains(query) ||
-                action.toLowerCase().contains(query);
-    }
-
-    @Nonnull
-    public String getFormatted() {
-        return String.format(FORMAT,
-                String.valueOf(actorName).equals("null") ? actor.toString() : actorName,
-                Character.toString(type.getCode()),
-                String.valueOf(actedName).equals("null") && acted != null ? acted.toString() : actedName,
-                action
-        );
-    }
-
-    @Override
-    public String toString() {
-        return "LogEntry(" +
-                "timestamp=" + this.getTimestamp() + ", " +
-                "actor=" + this.getActor() + ", " +
-                "actorName=" + this.getActorName() + ", " +
-                "type=" + this.getEntryType() + ", " +
-                "acted=" + this.getActed() + ", " +
-                "actedName=" + this.getActedName() + ", " +
-                "action=" + this.getAction() + ")";
-    }
-
-    @Override
-    public boolean equals(Object o) {
-        if (o == this) return true;
-        if (!(o instanceof LogEntry)) return false;
-        final LogEntry other = (LogEntry) o;
-
-        return this.getTimestamp() == other.getTimestamp() &&
-                this.getActor().equals(other.getActor()) &&
-                this.getActorName().equals(other.getActorName()) &&
-                this.getEntryType() == other.getEntryType() &&
-                (this.getActed() == null ? other.getActed() == null : this.getActed().equals(other.getActed())) &&
-                this.getActedName().equals(other.getActedName()) &&
-                this.getAction().equals(other.getAction());
-    }
-
-    @Override
-    public int hashCode() {
-        final int PRIME = 59;
-        int result = 1;
-        result = result * PRIME + (int) (this.getTimestamp() >>> 32 ^ this.getTimestamp());
-        result = result * PRIME + this.getActor().hashCode();
-        result = result * PRIME + this.getActorName().hashCode();
-        result = result * PRIME + this.getEntryType().hashCode();
-        result = result * PRIME + (this.getActed() == null ? 43 : this.getActed().hashCode());
-        result = result * PRIME + this.getActedName().hashCode();
-        result = result * PRIME + this.getAction().hashCode();
-        return result;
-    }
-
-    /**
-     * The LogEntry type
-     * @since 3.3
-     */
-    public enum Type {
-        USER('U'),
-        GROUP('G'),
-        TRACK('T');
-
-        private final char code;
-
-        Type(char code) {
-            this.code = code;
-        }
-
-        public char getCode() {
-            return this.code;
-        }
-
-        public static Type valueOf(char code) {
-            switch (code) {
-                case 'U':
-                case 'u':
-                    return USER;
-                case 'G':
-                case 'g':
-                    return GROUP;
-                case 'T':
-                case 't':
-                    return TRACK;
-                default:
-                    throw new IllegalArgumentException("Unknown code: " + code);
-            }
-        }
-    }
-
-    /**
-     * Builds LogEntry instances
-     */
-    public static class LogEntryBuilder extends AbstractLogEntryBuilder<LogEntry, LogEntry.LogEntryBuilder> {
-
-        @Override
-        protected LogEntry createEmptyLog() {
-            return new LogEntry();
-        }
-
-        @Override
-        protected LogEntryBuilder getThisBuilder() {
-            return this;
-        }
-
-    }
-
-    /**
-     * An abstract log entry builder
-     *
-     * @param <T> the log type
-     * @param <B> the log builder type
-     */
-    public static abstract class AbstractLogEntryBuilder<T extends LogEntry, B extends AbstractLogEntryBuilder<T, B>> {
-        private T obj;
-        private B thisObj;
-
-        public AbstractLogEntryBuilder() {
-            obj = createEmptyLog();
-            thisObj = getThisBuilder();
-        }
-
-        protected abstract T createEmptyLog();
-
-        protected abstract B getThisBuilder();
-
-        public long getTimestamp() {
-            return obj.getTimestamp();
-        }
-
-        @Nonnull
-        public UUID getActor() {
-            return obj.getActor();
-        }
-
-        @Nonnull
-        public String getActorName() {
-            return obj.getActorName();
-        }
-
-        @Nonnull
-        public Type getEntryType() {
-            return obj.getEntryType();
-        }
-
-        @Nonnull
-        @Deprecated
-        public char getType() {
-            return obj.getType();
-        }
-
-        @Nullable
-        public UUID getActed() {
-            return obj.getActed();
-        }
-
-        @Nonnull
-        public String getActedName() {
-            return obj.getActedName();
-        }
-
-        @Nonnull
-        public String getAction() {
-            return obj.getAction();
-        }
-
-        @Nonnull
-        public B timestamp(long timestamp) {
-            obj.setTimestamp(timestamp);
-            return thisObj;
-        }
-
-        @Nonnull
-        public B actor(@Nonnull UUID actor) {
-            obj.setActor(actor);
-            return thisObj;
-        }
-
-        @Nonnull
-        public B actorName(@Nonnull String actorName) {
-            obj.setActorName(actorName);
-            return thisObj;
-        }
-
-        @Nonnull
-        public B entryType(@Nonnull Type type) {
-            obj.setEntryType(type);
-            return thisObj;
-        }
-
-        @Nonnull
-        @Deprecated
-        public B type(char type) {
-            obj.setType(type);
-            return thisObj;
-        }
-
-        @Nonnull
-        public B acted(@Nullable UUID acted) {
-            obj.setActed(acted);
-            return thisObj;
-        }
-
-        @Nonnull
-        public B actedName(@Nonnull String actedName) {
-            obj.setActedName(actedName);
-            return thisObj;
-        }
-
-        @Nonnull
-        public B action(@Nonnull String action) {
-            obj.setAction(action);
-            return thisObj;
-        }
-
-        @Nonnull
-        public T build() {
-            Preconditions.checkNotNull(getActor(), "actor");
-            Preconditions.checkNotNull(getActorName(), "actorName");
-            Preconditions.checkNotNull(getEntryType(), "type");
-            Preconditions.checkNotNull(getActedName(), "actedName");
-            Preconditions.checkNotNull(getAction(), "action");
-
-            return obj;
-        }
-
-        @Override
-        public String toString() {
-            return "LogEntry.LogEntryBuilder(" +
-                    "timestamp=" + this.getTimestamp() + ", " +
-                    "actor=" + this.getActor() + ", " +
-                    "actorName=" + this.getActorName() + ", " +
-                    "type=" + this.getEntryType() + ", " +
-                    "acted=" + this.getActed() + ", " +
-                    "actedName=" + this.getActedName() + ", " +
-                    "action=" + this.getAction() + ")";
-        }
-    }
-
-}

api/src/main/java/me/lucko/luckperms/api/LuckPermsApi.java

@@ -1,365 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import me.lucko.luckperms.LuckPerms;
-import me.lucko.luckperms.api.context.ContextCalculator;
-import me.lucko.luckperms.api.context.ContextSet;
-import me.lucko.luckperms.api.event.EventBus;
-import me.lucko.luckperms.api.metastacking.MetaStackFactory;
-
-import java.util.Optional;
-import java.util.Set;
-import java.util.UUID;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-/**
- * The LuckPerms API.
- *
- * <p>This interface is the base of the entire API package. All API functions
- * are accessed via this interface.</p>
- *
- * <p>An instance can be obtained via {@link LuckPerms#getApi()}, or the platforms
- * Services Manager.</p>
- */
-public interface LuckPermsApi {
-
-    /**
-     * Schedules an update task to run
-     */
-    void runUpdateTask();
-
-    /**
-     * Gets the API version
-     *
-     * @return the version of the API running on the platform
-     * @since 2.6
-     */
-    double getApiVersion();
-
-    /**
-     * Gets the plugin version
-     *
-     * @return the version of the plugin running on the platform
-     */
-    @Nonnull
-    String getVersion();
-
-    /**
-     * Gets the platform LuckPerms is running on
-     *
-     * @return the platform LuckPerms is running on
-     * @since 2.7
-     */
-    @Nonnull
-    PlatformType getPlatformType();
-
-    /**
-     * Gets the event bus, used for subscribing to events
-     *
-     * @return the event bus
-     * @since 3.0
-     */
-    @Nonnull
-    EventBus getEventBus();
-
-    /**
-     * Gets a wrapped {@link LPConfiguration} instance, with read only access
-     *
-     * @return a configuration instance
-     */
-    @Nonnull
-    LPConfiguration getConfiguration();
-
-    /**
-     * Gets a wrapped {@link Storage} instance.
-     *
-     * @return a storage instance
-     * @since 2.14
-     */
-    @Nonnull
-    Storage getStorage();
-
-    /**
-     * Gets the messaging service in use on the platform, if present.
-     *
-     * @return an optional that may contain a messaging service instance.
-     */
-    @Nonnull
-    Optional<MessagingService> getMessagingService();
-
-    /**
-     * Gets the {@link Logger} wrapping used by the platform
-     *
-     * @return the logger instance
-     */
-    @Nonnull
-    Logger getLogger();
-
-    /**
-     * Gets a wrapped {@link UuidCache} instance, providing read access to the LuckPerms internal uuid caching system
-     *
-     * @return a uuid cache instance
-     */
-    @Nonnull
-    UuidCache getUuidCache();
-
-    /**
-     * Gets a wrapped user object from the user storage
-     *
-     * @param uuid the uuid of the user to get
-     * @return a {@link User} object, if one matching the uuid is loaded, or null if not
-     * @throws NullPointerException if the uuid is null
-     */
-    @Nullable
-    User getUser(@Nonnull UUID uuid);
-
-    /**
-     * Gets a wrapped user object from the user storage.
-     *
-     * <p>This method does not return null, unlike {@link #getUser(UUID)}</p>
-     *
-     * @param uuid the uuid of the user to get
-     * @return an optional {@link User} object
-     * @throws NullPointerException if the uuid is null
-     */
-    @Nonnull
-    Optional<User> getUserSafe(@Nonnull UUID uuid);
-
-    /**
-     * Gets a wrapped user object from the user storage
-     *
-     * @param name the username of the user to get
-     * @return a {@link User} object, if one matching the uuid is loaded, or null if not
-     * @throws NullPointerException if the name is null
-     */
-    @Nullable
-    User getUser(@Nonnull String name);
-
-    /**
-     * Gets a wrapped user object from the user storage.
-     *
-     * <p>This method does not return null, unlike {@link #getUser(String)}</p>
-     *
-     * @param name the username of the user to get
-     * @return an optional {@link User} object
-     * @throws NullPointerException if the name is null
-     */
-    @Nonnull
-    Optional<User> getUserSafe(@Nonnull String name);
-
-    /**
-     * Gets a set of all loaded users.
-     *
-     * @return a {@link Set} of {@link User} objects
-     */
-    @Nonnull
-    Set<User> getUsers();
-
-    /**
-     * Check if a user is loaded in memory
-     *
-     * @param uuid the uuid to check for
-     * @return true if the user is loaded
-     * @throws NullPointerException if the uuid is null
-     */
-    boolean isUserLoaded(@Nonnull UUID uuid);
-
-    /**
-     * Unload a user from the internal storage, if they're not currently online.
-     *
-     * @param user the user to unload
-     * @throws NullPointerException if the user is null
-     * @since 2.6
-     */
-    void cleanupUser(@Nonnull User user);
-
-    /**
-     * Gets a wrapped group object from the group storage
-     *
-     * @param name the name of the group to get
-     * @return a {@link Group} object, if one matching the name exists, or null if not
-     * @throws NullPointerException if the name is null
-     */
-    @Nullable
-    Group getGroup(@Nonnull String name);
-
-    /**
-     * Gets a wrapped group object from the group storage.
-     *
-     * <p>This method does not return null, unlike {@link #getGroup}</p>
-     *
-     * @param name the name of the group to get
-     * @return an optional {@link Group} object
-     * @throws NullPointerException if the name is null
-     */
-    @Nonnull
-    Optional<Group> getGroupSafe(@Nonnull String name);
-
-    /**
-     * Gets a set of all loaded groups.
-     *
-     * @return a {@link Set} of {@link Group} objects
-     */
-    @Nonnull
-    Set<Group> getGroups();
-
-    /**
-     * Check if a group is loaded in memory
-     *
-     * @param name the name to check for
-     * @return true if the group is loaded
-     * @throws NullPointerException if the name is null
-     */
-    boolean isGroupLoaded(@Nonnull String name);
-
-    /**
-     * Gets a wrapped track object from the track storage
-     *
-     * @param name the name of the track to get
-     * @return a {@link Track} object, if one matching the name exists, or null if not
-     * @throws NullPointerException if the name is null
-     */
-    @Nullable
-    Track getTrack(@Nonnull String name);
-
-    /**
-     * Gets a wrapped track object from the track storage.
-     *
-     * <p>This method does not return null, unlike {@link #getTrack}</p>
-     *
-     * @param name the name of the track to get
-     * @return an optional {@link Track} object
-     * @throws NullPointerException if the name is null
-     */
-    @Nonnull
-    Optional<Track> getTrackSafe(@Nonnull String name);
-
-    /**
-     * Gets a set of all loaded tracks.
-     *
-     * @return a {@link Set} of {@link Track} objects
-     */
-    @Nonnull
-    Set<Track> getTracks();
-
-    /**
-     * Check if a track is loaded in memory
-     *
-     * @param name the name to check for
-     * @return true if the track is loaded
-     * @throws NullPointerException if the name is null
-     */
-    boolean isTrackLoaded(@Nonnull String name);
-
-    /**
-     * Gets the node factory instance for the platform
-     *
-     * @return the node factory
-     */
-    @Nonnull
-    NodeFactory getNodeFactory();
-
-    /**
-     * Gets the MetaStackFactory, used for creating MetaStacks.
-     *
-     * @return the meta stack factory
-     * @since 3.2
-     */
-    @Nonnull
-    MetaStackFactory getMetaStackFactory();
-
-    /**
-     * Returns a permission builder instance
-     *
-     * @param permission the main permission node to build
-     * @return a {@link Node.Builder} instance
-     * @throws IllegalArgumentException if the permission is invalid
-     * @throws NullPointerException     if the permission is null
-     * @since 2.6
-     */
-    @Nonnull
-    Node.Builder buildNode(@Nonnull String permission) throws IllegalArgumentException;
-
-    /**
-     * Register a custom context calculator to the server
-     *
-     * @param contextCalculator the context calculator to register. The type MUST be the player class of the platform.
-     * @throws ClassCastException if the type is not the player class of the platform.
-     */
-    void registerContextCalculator(@Nonnull ContextCalculator<?> contextCalculator);
-
-    /**
-     * Gets a calculated context instance for the user using the rules of the platform.
-     *
-     * <p> These values are calculated using the options in the configuration, and the provided calculators.
-     *
-     * @param user the user to get contexts for
-     * @return an optional containing contexts. Will return empty if the user is not online.
-     */
-    @Nonnull
-    Optional<Contexts> getContextForUser(@Nonnull User user);
-
-    /**
-     * Gets set of contexts applicable to a player using the platforms {@link ContextCalculator}s.
-     *
-     * @param player the player to calculate for. Must be the player instance for the platform.
-     * @return a set of contexts.
-     * @since 2.17
-     */
-    @Nonnull
-    ContextSet getContextForPlayer(@Nonnull Object player);
-
-    /**
-     * Gets a Contexts instance for the player using the platforms {@link ContextCalculator}s.
-     *
-     * @param player the player to calculate for. Must be the player instance for the platform.
-     * @return a set of contexts.
-     * @since 3.3
-     */
-    @Nonnull
-    Contexts getContextsForPlayer(@Nonnull Object player);
-
-    /**
-     * Gets the unique players which have connected to the server since it started.
-     *
-     * @return the unique connections
-     * @since 3.3
-     */
-    @Nonnull
-    Set<UUID> getUniqueConnections();
-
-    /**
-     * Gets the time when the plugin first started in milliseconds.
-     *
-     * @return the enable time
-     * @since 3.3
-     */
-    long getStartTime();
-
-}

api/src/main/java/me/lucko/luckperms/api/MetaUtils.java

@@ -1,287 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import me.lucko.luckperms.LuckPerms;
-import me.lucko.luckperms.exceptions.ObjectAlreadyHasException;
-import me.lucko.luckperms.exceptions.ObjectLacksException;
-
-import java.util.HashSet;
-import java.util.Map;
-import java.util.Set;
-
-/**
- * A collection of utilities to help retrieve meta values for {@link PermissionHolder}s
- *
- * @since 2.7
- * @deprecated in favour of using {@link NodeFactory#makeMetaNode(String, String)} or {@link me.lucko.luckperms.api.caching.MetaData}.
- */
-@Deprecated
-public class MetaUtils {
-    private static final String[] DELIMS = new String[]{".", "/", "-", "$"};
-
-    private static String escapeDelimiters(String s, String... delims) {
-        for (String delim : delims) {
-            s = s.replace(delim, "\\" + delim);
-        }
-        return s;
-    }
-
-    private static String unescapeDelimiters(String s, String... delims) {
-        for (String delim : delims) {
-            s = s.replace("\\" + delim, delim);
-        }
-        return s;
-    }
-
-    /**
-     * Escapes special characters used within LuckPerms, so the string can be saved without issues
-     *
-     * @param s the string to escape
-     * @return an escaped string
-     * @throws NullPointerException if the string is null
-     */
-    public static String escapeCharacters(String s) {
-        if (s == null) {
-            throw new NullPointerException();
-        }
-
-        return escapeDelimiters(s, DELIMS);
-    }
-
-    /**
-     * Unescapes special characters used within LuckPerms, the inverse of {@link #escapeCharacters(String)}
-     *
-     * @param s the string to unescape
-     * @return an unescaped string
-     * @throws NullPointerException if the string is null
-     */
-    public static String unescapeCharacters(String s) {
-        if (s == null) {
-            throw new NullPointerException();
-        }
-
-        s = s.replace("{SEP}", ".");
-        s = s.replace("{FSEP}", "/");
-        s = s.replace("{DSEP}", "$");
-        s = unescapeDelimiters(s, DELIMS);
-
-        return s;
-    }
-
-    /**
-     * Sets a meta value on a holder
-     *
-     * @param holder the holder to apply the meta node to
-     * @param server the server to apply the meta on, can be null
-     * @param world  the world to apply the meta on, can be null
-     * @param key    the meta key
-     * @param value  the meta value
-     * @throws NullPointerException     if the holder, node or value is null
-     * @throws IllegalArgumentException if the node or value is empty
-     */
-    public static void setMeta(PermissionHolder holder, String server, String world, String key, String value) {
-        if (holder == null) throw new NullPointerException("holder");
-        if (key == null) throw new NullPointerException("node");
-        if (value == null) throw new NullPointerException("value");
-        if (key.equals("")) throw new IllegalArgumentException("node is empty");
-        if (value.equals("")) throw new IllegalArgumentException("value is empty");
-
-        key = escapeCharacters(key);
-        value = escapeCharacters(value);
-
-        Set<Node> toRemove = new HashSet<>();
-        for (Node n : holder.getEnduringPermissions()) {
-            if (n.isMeta() && n.getMeta().getKey().equals(key)) {
-                toRemove.add(n);
-            }
-        }
-
-        for (Node n : toRemove) {
-            try {
-                holder.unsetPermission(n);
-            } catch (ObjectLacksException ignored) {}
-        }
-
-        Node.Builder metaNode = LuckPerms.getApi().buildNode("meta." + key + "." + value).setValue(true);
-        if (server != null) {
-            metaNode.setServer(server);
-        }
-        if (world != null) {
-            metaNode.setWorld(world);
-        }
-
-        try {
-            holder.setPermission(metaNode.build());
-        } catch (ObjectAlreadyHasException ignored) {}
-    }
-
-    /**
-     * Gets a meta value for the holder
-     *
-     * @param holder        the holder to get the meta from
-     * @param server        the server to retrieve the meta on, can be null
-     * @param world         the world to retrieve the meta on, can be null
-     * @param node          the node to get
-     * @param defaultValue  the default value to return if the node is not set
-     * @param includeGlobal if global nodes should be considered when retrieving the meta
-     * @return a meta string, or the default value if the user does not have the meta node
-     * @throws NullPointerException     if the holder or node is null
-     * @throws IllegalArgumentException if the node is empty
-     */
-    public static String getMeta(PermissionHolder holder, String server, String world, String node, String defaultValue, boolean includeGlobal) {
-        if (holder == null) throw new NullPointerException("holder");
-        if (node == null) throw new NullPointerException("node");
-        if (node.equals("")) {
-            throw new IllegalArgumentException("node is empty");
-        }
-
-        node = escapeCharacters(node);
-
-        for (Node n : holder.getPermissions()) {
-            if (!n.getValuePrimitive() || !n.isMeta()) continue;
-
-            if (!n.shouldApplyOnServer(server, includeGlobal, false)) continue;
-            if (!n.shouldApplyOnWorld(world, includeGlobal, false)) continue;
-
-            Map.Entry<String, String> meta = n.getMeta();
-            if (meta.getKey().equalsIgnoreCase(node)) {
-                return unescapeCharacters(meta.getValue());
-            }
-        }
-
-        return defaultValue;
-    }
-
-    private static void setChatMeta(boolean prefix, PermissionHolder holder, String value, int priority, String server, String world) {
-        if (holder == null) throw new NullPointerException("holder");
-        if (value == null || value.equals("")) {
-            throw new IllegalArgumentException("value is null/empty");
-        }
-
-        Node.Builder node = LuckPerms.getApi().buildNode(prefix ? "prefix" : "suffix" + "." + priority + "." + escapeCharacters(value));
-        node.setValue(true);
-        if (server != null) {
-            node.setServer(server);
-        }
-        if (world != null) {
-            node.setWorld(world);
-        }
-
-        try {
-            holder.setPermission(node.build());
-        } catch (ObjectAlreadyHasException ignored) {}
-    }
-
-    /**
-     * Adds a prefix to a holder on a specific server and world
-     *
-     * @param holder   the holder to set the prefix for
-     * @param prefix   the prefix value
-     * @param priority the priority to set the prefix at
-     * @param server   the server to set the prefix on, can be null
-     * @param world    the world to set the prefix on, can be null
-     * @throws NullPointerException     if the holder is null
-     * @throws IllegalArgumentException if the prefix is null or empty
-     */
-    public static void setPrefix(PermissionHolder holder, String prefix, int priority, String server, String world) {
-        setChatMeta(true, holder, prefix, priority, server, world);
-    }
-
-    /**
-     * Adds a suffix to a holder on a specific server and world
-     *
-     * @param holder   the holder to set the suffix for
-     * @param suffix   the suffix value
-     * @param priority the priority to set the suffix at
-     * @param server   the server to set the suffix on, can be null
-     * @param world    the world to set the suffix on, can be null
-     * @throws NullPointerException     if the holder is null
-     * @throws IllegalArgumentException if the suffix is null or empty
-     */
-    public static void setSuffix(PermissionHolder holder, String suffix, int priority, String server, String world) {
-        setChatMeta(false, holder, suffix, priority, server, world);
-    }
-
-    private static String getChatMeta(boolean prefix, PermissionHolder holder, String server, String world, boolean includeGlobal) {
-        if (holder == null) {
-            throw new NullPointerException("holder");
-        }
-
-        int priority = Integer.MIN_VALUE;
-        String meta = null;
-        for (Node n : holder.getAllNodes(Contexts.allowAll())) {
-            if (!n.getValuePrimitive()) continue;
-
-            if (!n.shouldApplyOnServer(server, includeGlobal, false)) continue;
-            if (!n.shouldApplyOnWorld(world, includeGlobal, false)) continue;
-
-            if (prefix ? !n.isPrefix() : !n.isSuffix()) {
-                continue;
-            }
-
-            Map.Entry<Integer, String> value = prefix ? n.getPrefix() : n.getSuffix();
-            if (value.getKey() > priority) {
-                meta = value.getValue();
-                priority = value.getKey();
-            }
-        }
-
-        return meta == null ? "" : unescapeCharacters(meta);
-    }
-
-    /**
-     * Returns a holders highest priority prefix, if they have one
-     *
-     * @param holder        the holder
-     * @param server        the server to retrieve the prefix on
-     * @param world         the world to retrieve the prefix on
-     * @param includeGlobal if global nodes should be considered when retrieving the prefix
-     * @return a prefix string, if the holder has one, or an empty string if not.
-     * @throws NullPointerException if the holder is null
-     */
-    public static String getPrefix(PermissionHolder holder, String server, String world, boolean includeGlobal) {
-        return getChatMeta(true, holder, server, world, includeGlobal);
-    }
-
-    /**
-     * Returns a holders highest priority suffix, if they have one
-     *
-     * @param holder        the holder
-     * @param server        the server to retrieve the suffix on
-     * @param world         the world to retrieve the suffix on
-     * @param includeGlobal if global nodes should be considered when retrieving the suffix
-     * @return a suffix string, if the holder has one, or an empty string if not.
-     * @throws NullPointerException if the holder is null
-     */
-    public static String getSuffix(PermissionHolder holder, String server, String world, boolean includeGlobal) {
-        return getChatMeta(false, holder, server, world, includeGlobal);
-    }
-
-    private MetaUtils() {
-    }
-
-}

api/src/main/java/me/lucko/luckperms/api/Node.java

@@ -1,482 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import me.lucko.luckperms.api.context.ContextSet;
-
-import java.util.Date;
-import java.util.List;
-import java.util.Map;
-import java.util.Optional;
-import java.util.Set;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-/**
- * Represents a permission node.
- *
- * <p>All implementations of this interface must be immutable.</p>
- *
- * <p>Use the {@link NodeFactory} to obtain and construct instances.</p>
- *
- * @since 2.6
- */
-public interface Node extends Map.Entry<String, Boolean> {
-
-    /**
-     * Gets the permission string
-     *
-     * @return the actual permission node
-     */
-    @Nonnull
-    String getPermission();
-
-    /**
-     * Gets the value.
-     *
-     * <p>A negated node would return a value of <code>false</code>.</p>
-     *
-     * @return the permission's value
-     */
-    @Override
-    @Nonnull
-    default Boolean getValue() {
-        return getValuePrimitive();
-    }
-
-    /**
-     * Gets the value.
-     *
-     * <p>A negated node would return a value of <code>false</code>.</p>
-     *
-     * @return the permission's value
-     */
-    boolean getValuePrimitive();
-
-    /**
-     * Gets the value of this node as a {@link Tristate}
-     *
-     * @return the value of this node as a Tristate
-     */
-    @Nonnull
-    default Tristate getTristate() {
-        return Tristate.fromBoolean(getValuePrimitive());
-    }
-
-    /**
-     * Gets if the node is negated
-     *
-     * @return true if the node is negated
-     */
-    default boolean isNegated() {
-        return !getValuePrimitive();
-    }
-
-    /**
-     * Gets if this node is set to override explicitly.
-     *
-     * <p>This value does not persist across saves, and is therefore only useful for transient nodes</p>
-     *
-     * @return true if this node is set to override explicitly
-     */
-    boolean isOverride();
-
-    /**
-     * Gets the server this node applies on, if the node is server specific
-     *
-     * @return an {@link Optional} containing the server, if one is defined
-     */
-    @Nonnull
-    Optional<String> getServer();
-
-    /**
-     * Gets the world this node applies on, if the node is world specific
-     *
-     * @return an {@link Optional} containing the world, if one is defined
-     */
-    @Nonnull
-    Optional<String> getWorld();
-
-    /**
-     * Gets if this node is server specific
-     *
-     * @return true if this node is server specific
-     */
-    boolean isServerSpecific();
-
-    /**
-     * Gets if this node is server specific
-     *
-     * @return true if this node is server specific
-     */
-    boolean isWorldSpecific();
-
-    /**
-     * Gets if this node applies globally, and therefore has no specific context
-     *
-     * @return true if this node applies globally, and has no specific context
-     * @since 3.1
-     */
-    boolean appliesGlobally();
-
-    /**
-     * Gets if this node has any specific context in order for it to apply
-     *
-     * @return true if this node has specific context
-     * @since 3.1
-     */
-    boolean hasSpecificContext();
-
-    /**
-     * Gets if this node is able to apply in the given context
-     *
-     * @param includeGlobal if global server values should apply
-     * @param includeGlobalWorld if global world values should apply
-     * @param server the server being checked against, or null
-     * @param world the world being checked against, or null
-     * @param context the context being checked against, or null
-     * @param applyRegex if regex should be applied
-     * @return true if the node should apply, otherwise false
-     * @since 3.1
-     */
-    boolean shouldApply(boolean includeGlobal, boolean includeGlobalWorld, @Nullable String server, @Nullable String world, @Nullable ContextSet context, boolean applyRegex);
-
-    /**
-     * Gets if this node should apply on a specific server
-     *
-     * @param server        the name of the server
-     * @param includeGlobal if global permissions should apply
-     * @param applyRegex    if regex should be applied
-     * @return true if the node should apply
-     */
-    boolean shouldApplyOnServer(@Nullable String server, boolean includeGlobal, boolean applyRegex);
-
-    /**
-     * Gets if this node should apply on a specific world
-     *
-     * @param world         the name of the world
-     * @param includeGlobal if global permissions should apply
-     * @param applyRegex    if regex should be applied
-     * @return true if the node should apply
-     */
-    boolean shouldApplyOnWorld(@Nullable String world, boolean includeGlobal, boolean applyRegex);
-
-    /**
-     * Gets if this node should apply in the given context
-     *
-     * @param context        the context key value pairs
-     * @param worldAndServer if world and server contexts should be checked
-     * @return true if the node should apply
-     * @since 2.13
-     */
-    boolean shouldApplyWithContext(@Nonnull ContextSet context, boolean worldAndServer);
-
-    /**
-     * Gets if this node should apply in the given context
-     *
-     * @param context the context key value pairs
-     * @return true if the node should apply
-     * @since 2.13
-     */
-    boolean shouldApplyWithContext(@Nonnull ContextSet context);
-
-    /**
-     * Similar to {@link #shouldApplyOnServer(String, boolean, boolean)}, except this method accepts a List
-     *
-     * @param servers       the list of servers
-     * @param includeGlobal if global permissions should apply
-     * @return true if the node should apply
-     */
-    boolean shouldApplyOnAnyServers(@Nonnull List<String> servers, boolean includeGlobal);
-
-    /**
-     * Similar to {@link #shouldApplyOnWorld(String, boolean, boolean)}, except this method accepts a List
-     *
-     * @param worlds        the list of world
-     * @param includeGlobal if global permissions should apply
-     * @return true if the node should apply
-     */
-    boolean shouldApplyOnAnyWorlds(@Nonnull List<String> worlds, boolean includeGlobal);
-
-    /**
-     * Resolves a list of wildcards that match this node
-     *
-     * @param possibleNodes a list of possible permission nodes
-     * @return a list of permissions that match this wildcard
-     * @deprecated as this is no longer used internally to resolve wildcards
-     */
-    @Nonnull
-    @Deprecated
-    List<String> resolveWildcard(@Nonnull List<String> possibleNodes);
-
-    /**
-     * Resolves any shorthand parts of this node and returns the full list
-     *
-     * @return a list of full nodes
-     */
-    @Nonnull
-    List<String> resolveShorthand();
-
-    /**
-     * Gets if this node will expire in the future
-     *
-     * @return true if this node will expire in the future
-     */
-    boolean isTemporary();
-
-    /**
-     * Gets if this node will not expire
-     *
-     * @return true if this node will not expire
-     */
-    default boolean isPermanent() {
-        return !isTemporary();
-    }
-
-    /**
-     * Gets a unix timestamp in seconds when this node will expire
-     *
-     * @return the time in Unix time when this node will expire
-     * @throws IllegalStateException if the node is not temporary
-     */
-    long getExpiryUnixTime() throws IllegalStateException;
-
-    /**
-     * Gets the date when this node will expire
-     *
-     * @return the {@link Date} when this node will expire
-     * @throws IllegalStateException if the node is not temporary
-     */
-    @Nonnull
-    Date getExpiry() throws IllegalStateException;
-
-    /**
-     * Gets the number of seconds until this permission will expire
-     *
-     * @return the number of seconds until this permission will expire
-     * @throws IllegalStateException if the node is not temporary
-     */
-    long getSecondsTilExpiry() throws IllegalStateException;
-
-    /**
-     * Gets if the node has expired.
-     *
-     * <p>This also returns false if the node is not temporary.</p>
-     *
-     * @return true if this node has expired
-     */
-    boolean hasExpired();
-
-    /**
-     * Gets the extra contexts required for this node to apply
-     *
-     * @return the extra contexts required for this node to apply
-     * @since 2.13
-     */
-    @Nonnull
-    ContextSet getContexts();
-
-    /**
-     * The same as {@link #getContexts()}, but also includes values for "server" and "world" keys if present.
-     *
-     * @return the full contexts required for this node to apply
-     * @since 3.1
-     */
-    @Nonnull
-    ContextSet getFullContexts();
-
-    /**
-     * Converts this node into a serialized form
-     *
-     * @return a serialized node string
-     * @deprecated because this serialized form is no longer used by the implementation.
-     */
-    @Deprecated
-    @Nonnull
-    String toSerializedNode();
-
-    /**
-     * Gets if this is a group node
-     *
-     * @return true if this is a group node
-     */
-    boolean isGroupNode();
-
-    /**
-     * Gets the name of the group, if this is a group node.
-     *
-     * @return the name of the group
-     * @throws IllegalStateException if this is not a group node. See {@link #isGroupNode()}
-     */
-    @Nonnull
-    String getGroupName() throws IllegalStateException;
-
-    /**
-     * Gets if this node is a wildcard node
-     *
-     * @return true if this node is a wildcard node
-     */
-    boolean isWildcard();
-
-    /**
-     * Gets the level of this wildcard, higher is more specific
-     *
-     * @return the wildcard level
-     * @throws IllegalStateException if this is not a wildcard
-     */
-    int getWildcardLevel() throws IllegalStateException;
-
-    /**
-     * Gets if this node is a meta node
-     *
-     * @return true if this node is a meta node
-     */
-    boolean isMeta();
-
-    /**
-     * Gets the meta value from this node
-     *
-     * @return the meta value
-     * @throws IllegalStateException if this node is not a meta node
-     */
-    @Nonnull
-    Map.Entry<String, String> getMeta() throws IllegalStateException;
-
-    /**
-     * Gets if this node is a prefix node
-     *
-     * @return true if this node is a prefix node
-     */
-    boolean isPrefix();
-
-    /**
-     * Gets the prefix value from this node
-     *
-     * @return the prefix value
-     * @throws IllegalStateException if this node is a not a prefix node
-     */
-    @Nonnull
-    Map.Entry<Integer, String> getPrefix() throws IllegalStateException;
-
-    /**
-     * Gets if this node is a suffix node
-     *
-     * @return true if this node is a suffix node
-     */
-    boolean isSuffix();
-
-    /**
-     * Gets the suffix value from this node
-     *
-     * @return the suffix value
-     * @throws IllegalStateException if this node is a not a suffix node
-     */
-    @Nonnull
-    Map.Entry<Integer, String> getSuffix() throws IllegalStateException;
-
-    /**
-     * Checks if this Node is equal to another node
-     *
-     * @param obj the other node
-     * @return true if this node is equal to the other provided
-     * @see #equalsIgnoringValue(Node) for a less strict implementation of this method
-     */
-    @Override
-    boolean equals(Object obj);
-
-    /**
-     * Similar to {@link Node#equals(Object)}, except doesn't take note of the value
-     *
-     * @param other the other node
-     * @return true if the two nodes are almost equal
-     */
-    boolean equalsIgnoringValue(@Nonnull Node other);
-
-    /**
-     * Similar to {@link Node#equals(Object)}, except doesn't take note of the expiry time or value
-     *
-     * @param other the other node
-     * @return true if the two nodes are almost equal
-     */
-    boolean almostEquals(@Nonnull Node other);
-
-    /**
-     * Similar to {@link Node#equals(Object)}, except doesn't take note of the value or if the node is temporary
-     *
-     * @param other the other node
-     * @return true if the two nodes are almost equal
-     * @since 2.8
-     */
-    boolean equalsIgnoringValueOrTemp(@Nonnull Node other);
-
-    /**
-     * Builds a Node instance
-     */
-    interface Builder {
-
-        @Nonnull
-        Builder setNegated(boolean negated);
-
-        @Nonnull
-        Builder setValue(boolean value);
-
-        /**
-         * Warning: this value does not persist, and disappears when the holder is re-loaded.
-         * It is therefore only useful for transient nodes.
-         */
-        @Nonnull
-        Builder setOverride(boolean override);
-
-        @Nonnull
-        Builder setExpiry(long expireAt);
-
-        @Nonnull
-        Builder setWorld(@Nonnull String world);
-
-        @Nonnull
-        Builder setServer(@Nonnull String server) throws IllegalArgumentException;
-
-        @Nonnull
-        Builder withExtraContext(@Nonnull String key, @Nonnull String value);
-
-        @Nonnull
-        Builder withExtraContext(@Nonnull Map<String, String> map);
-
-        @Nonnull
-        Builder withExtraContext(@Nonnull Set<Map.Entry<String, String>> context);
-
-        @Nonnull
-        Builder withExtraContext(@Nonnull Map.Entry<String, String> entry);
-
-        @Nonnull
-        Builder withExtraContext(@Nonnull ContextSet set);
-
-        @Nonnull
-        Node build();
-    }
-
-}

api/src/main/java/me/lucko/luckperms/api/NodeFactory.java

@@ -1,146 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import javax.annotation.Nonnull;
-
-/**
- * Assists with constructing {@link Node} instances.
- *
- * @since 2.17
- */
-public interface NodeFactory {
-
-    /**
-     * Creates a new node builder from a given base permission string
-     *
-     * @param permission the permission
-     * @return a node builder instance
-     * @throws NullPointerException if the permission is null
-     */
-    @Nonnull
-    Node.Builder newBuilder(@Nonnull String permission);
-
-    /**
-     * Creates a node builder instance from an existing node
-     *
-     * @param other the other node
-     * @return a node builder instance
-     * @throws NullPointerException if the other node is null
-     */
-    @Nonnull
-    Node.Builder newBuilderFromExisting(@Nonnull Node other);
-
-
-    /**
-     * Creates a node builder from a group
-     *
-     * @param group the group
-     * @return a node builder instance
-     * @throws NullPointerException  if the group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     * @since 3.1
-     */
-    @Nonnull
-    Node.Builder makeGroupNode(@Nonnull Group group);
-
-    /**
-     * Creates a node builder from a key value pair
-     *
-     * @param key   the key
-     * @param value the value
-     * @return a node builder instance
-     * @throws NullPointerException if the key or value is null
-     */
-    @Nonnull
-    Node.Builder makeMetaNode(@Nonnull String key, @Nonnull String value);
-
-    /**
-     * Creates a node builder for the given chat meta type
-     *
-     * @param priority the priority
-     * @param value the value for the prefix/suffix
-     * @return a node builder instance
-     * @throws NullPointerException if the type or value is null
-     * @since 3.2
-     */
-    @Nonnull
-    Node.Builder makeChatMetaNode(@Nonnull ChatMetaType type, int priority, @Nonnull String value);
-
-    /**
-     * Creates a node builder from a prefix string and priority
-     *
-     * @param priority the priority
-     * @param prefix   the prefix string
-     * @return a node builder instance
-     * @throws NullPointerException if the prefix is null
-     */
-    @Nonnull
-    Node.Builder makePrefixNode(int priority, @Nonnull String prefix);
-
-    /**
-     * Creates a node builder from a prefix string and priority
-     *
-     * @param priority the priority
-     * @param suffix   the suffix string
-     * @return a node builder instance
-     * @throws NullPointerException if the suffix is null
-     */
-    @Nonnull
-    Node.Builder makeSuffixNode(int priority, @Nonnull String suffix);
-
-
-    /**
-     * Creates a node from a serialised node string
-     *
-     * <p>This format is what was previously used in YAML/JSON storage files.</p>
-     *
-     * @param serialisedPermission the serialised permission string
-     * @param value                the value of the node
-     * @return a node instance
-     * @throws NullPointerException if the permission is null
-     * @deprecated since this format isn't used internally for permissions anymore
-     * @see Node#toSerializedNode()
-     */
-    @Deprecated
-    @Nonnull
-    Node fromSerialisedNode(@Nonnull String serialisedPermission, boolean value);
-
-    /**
-     * Creates a node builder from a serialised node string
-     *
-     * @param serialisedPermission the serialised permission string
-     * @param value                the value of the node
-     * @return a node builder instance
-     * @throws NullPointerException if the permission is null
-     * @deprecated since this format isn't used internally for permissions anymore
-     * @see Node#toSerializedNode()
-     */
-    @Deprecated
-    @Nonnull
-    Node.Builder newBuilderFromSerialisedNode(@Nonnull String serialisedPermission, boolean value);
-
-}

api/src/main/java/me/lucko/luckperms/api/PermissionHolder.java

@@ -1,875 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import com.google.common.collect.ImmutableSetMultimap;
-import com.google.common.collect.Multimap;
-
-import me.lucko.luckperms.api.context.ContextSet;
-import me.lucko.luckperms.api.context.ImmutableContextSet;
-import me.lucko.luckperms.exceptions.ObjectAlreadyHasException;
-import me.lucko.luckperms.exceptions.ObjectLacksException;
-
-import java.util.List;
-import java.util.Map;
-import java.util.Set;
-import java.util.SortedSet;
-import java.util.function.Predicate;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-/**
- * An object which holds permissions.
- *
- * <p>Any changes made to permission holding objects will be lost unless the
- * instance is saved back to the {@link Storage}.</p>
- */
-public interface PermissionHolder {
-
-    /**
-     * Gets the objects name.
-     *
-     * <p>{@link User#getUuid()}, {@link User#getName()} or {@link Group#getName()} should normally be used instead of
-     * this method.</p>
-     *
-     * @return the identifier for this object. Either a uuid string or name.
-     */
-    @Nonnull
-    String getObjectName();
-
-    /**
-     * Gets a friendly name for this holder, to be displayed in command output, etc.
-     *
-     * <p>This will <strong>always</strong> return a value, eventually falling back to {@link #getObjectName()} if no
-     * other "friendlier" identifiers are present.</p>
-     *
-     * @return a friendly identifier for this holder
-     * @since 3.2
-     */
-    @Nonnull
-    String getFriendlyName();
-
-    /**
-     * Gets the backing multimap containing every permission this holder has.
-     *
-     * <p>This method <b>does not</b> resolve inheritance rules, and returns a
-     * view of what's 'in the file'.</p>
-     *
-     * @return the holders own permissions
-     * @since 3.3
-     */
-    @Nonnull
-    ImmutableSetMultimap<ImmutableContextSet, Node> getNodes();
-
-    /**
-     * Gets the backing multimap containing every transient permission this holder has.
-     *
-     * <p>This method <b>does not</b> resolve inheritance rules.</p>
-     *
-     * <p>Transient permissions only exist for the duration of the session.</p>
-     *
-     * @return the holders own permissions
-     * @since 3.3
-     */
-    @Nonnull
-    ImmutableSetMultimap<ImmutableContextSet, Node> getTransientNodes();
-
-    /**
-     * Gets a flattened/squashed view of the holders permissions.
-     *
-     * <p>This list is constructed using the {@link Multimap#values()} method
-     * of both the transient and enduring backing multimaps.</p>
-     *
-     * <p>This means that it <b>may contain</b> duplicate entries.</p>
-     *
-     * <p>Use {@link #getPermissions()} for a view without duplicates.</p>
-     *
-     * @return a list of the holders own nodes.
-     * @since 3.3
-     */
-    @Nonnull
-    List<Node> getOwnNodes();
-
-    /**
-     * Gets a sorted set of all held permissions.
-     *
-     * @return an immutable set of permissions in priority order
-     * @since 2.6
-     */
-    @Nonnull
-    SortedSet<? extends Node> getPermissions();
-
-    /**
-     * Similar to {@link #getPermissions()}, except without transient permissions.
-     *
-     * <p>Unlike transient permissions, enduring permissions will be saved to storage, and exist after the session.</p>
-     *
-     * @return a set of nodes
-     * @since 2.6
-     */
-    @Nonnull
-    Set<? extends Node> getEnduringPermissions();
-
-    /**
-     * Similar to {@link #getPermissions()}, except without enduring permissions.
-     *
-     * <p>Transient permissions only exist for the duration of the session.</p>
-     *
-     * @return a set of nodes
-     * @since 2.6
-     */
-    @Nonnull
-    Set<? extends Node> getTransientPermissions();
-
-    /**
-     * Processes the nodes and returns the non-temporary ones.
-     *
-     * @return a set of permanent nodes
-     * @since 2.6
-     */
-    @Nonnull
-    Set<Node> getPermanentPermissionNodes();
-
-    /**
-     * Processes the nodes and returns the temporary ones.
-     *
-     * @return a set of temporary nodes
-     * @since 2.6
-     */
-    @Nonnull
-    Set<Node> getTemporaryPermissionNodes();
-
-    /**
-     * Recursively resolves this holders permissions.
-     *
-     * <p>The returned list will contain every inherited
-     * node the holder has, in the order that they were inherited in.</p>
-     *
-     * <p>This means the list will contain duplicates.</p>
-     *
-     * @param contexts the contexts for the lookup
-     * @return a list of nodes
-     * @since 3.3
-     */
-    @Nonnull
-    List<LocalizedNode> resolveInheritances(Contexts contexts);
-
-    /**
-     * Recursively resolves this holders permissions.
-     *
-     * <p>The returned list will contain every inherited
-     * node the holder has, in the order that they were inherited in.</p>
-     *
-     * <p>This means the list will contain duplicates.</p>
-     *
-     * <p>Unlike {@link #resolveInheritances(Contexts)}, this method does not
-     * filter by context, at all.</p>
-     *
-     * @return a list of nodes
-     * @since 3.3
-     */
-    @Nonnull
-    List<LocalizedNode> resolveInheritances();
-
-    /**
-     * Gets a mutable sorted set of the nodes that this object has and inherits, filtered by context
-     *
-     * <p>Unlike {@link #getAllNodesFiltered(Contexts)}, this method will not filter individual nodes. The context is only
-     * used to determine which groups should apply.</p>
-     *
-     * <p>Nodes are sorted into priority order.</p>
-     *
-     * @param contexts the context for the lookup
-     * @return a mutable sorted set of permissions
-     * @throws NullPointerException if the context is null
-     * @since 2.11
-     */
-    @Nonnull
-    SortedSet<LocalizedNode> getAllNodes(@Nonnull Contexts contexts);
-
-    /**
-     * Gets a mutable sorted set of the nodes that this object has and inherits.
-     *
-     * <p>Unlike {@link #getAllNodes(Contexts)}, this method does not filter by context, at all.</p>
-     *
-     * <p>Nodes are sorted into priority order.</p>
-     *
-     * @return a mutable sorted set of permissions
-     * @throws NullPointerException if the context is null
-     * @since 3.3
-     */
-    @Nonnull
-    SortedSet<LocalizedNode> getAllNodes();
-
-    /**
-     * Gets a mutable set of the nodes that this object has and inherits, filtered by context.
-     *
-     * <p>Unlike {@link #getAllNodes(Contexts)}, this method WILL filter individual nodes, and only return ones that fully
-     * meet the context provided.</p>
-     *
-     * @param contexts the context for the lookup
-     * @return a mutable set of permissions
-     * @throws NullPointerException if the context is null
-     * @since 2.11
-     */
-    @Nonnull
-    Set<LocalizedNode> getAllNodesFiltered(@Nonnull Contexts contexts);
-
-    /**
-     * Converts the output of {@link #getAllNodesFiltered(Contexts)}, and expands shorthand permissions.
-     *
-     * @param contexts the context for the lookup
-     * @param lowerCase if the keys should be made lowercase whilst being exported
-     * @return a mutable map of permissions
-     */
-    @Nonnull
-    Map<String, Boolean> exportNodes(@Nonnull Contexts contexts, boolean lowerCase);
-
-    /**
-     * Removes temporary permissions that have expired
-     */
-    void auditTemporaryPermissions();
-
-    /**
-     * Checks to see if the object has a certain permission
-     *
-     * @param node the node to check for
-     * @return a Tristate for the holders permission status for the node
-     * @throws NullPointerException if the node is null
-     * @since 2.6
-     */
-    @Nonnull
-    Tristate hasPermission(@Nonnull Node node);
-
-    /**
-     * Checks to see if the object has a certain permission
-     *
-     * @param node the node to check for
-     * @return a Tristate for the holders permission status for the node
-     * @throws NullPointerException if the node is null
-     * @since 2.6
-     */
-    @Nonnull
-    Tristate hasTransientPermission(@Nonnull Node node);
-
-    /**
-     * Checks to see if the object inherits a certain permission
-     *
-     * @param node the node to check for
-     * @return a Tristate for the holders inheritance status for the node
-     * @throws NullPointerException if the node is null
-     * @since 2.6
-     */
-    @Nonnull
-    Tristate inheritsPermission(@Nonnull Node node);
-
-    /**
-     * Sets a permission for the object
-     *
-     * @param node The node to be set
-     * @throws ObjectAlreadyHasException if the object already has the permission
-     * @throws NullPointerException      if the node is null
-     * @since 2.6
-     */
-    void setPermission(@Nonnull Node node) throws ObjectAlreadyHasException;
-
-    /**
-     * Sets a permission for the object
-     *
-     * @param node The node to be set
-     * @throws NullPointerException if the node is null
-     * @return the result of the operation
-     * @since 3.1
-     */
-    @Nonnull
-    DataMutateResult setPermissionUnchecked(@Nonnull Node node);
-
-    /**
-     * Sets a transient permission for the object
-     *
-     * <p>A transient node is a permission that does not persist.
-     * Whenever a user logs out of the server, or the server restarts, this permission will disappear.
-     * It is never saved to the datastore, and therefore will not apply on other servers.</p>
-     *
-     * <p>This is useful if you want to temporarily set a permission for a user while they're online, but don't
-     * want it to persist, and have to worry about removing it when they log out.</p>
-     *
-     * <p>For unsetting a transient permission, see {@link #unsetTransientPermission(Node)}</p>
-     *
-     * @param node The node to be set
-     * @throws ObjectAlreadyHasException if the object already has the permission
-     * @throws NullPointerException      if the node is null
-     * @since 2.6
-     */
-    void setTransientPermission(@Nonnull Node node) throws ObjectAlreadyHasException;
-
-    /**
-     * Sets a transient permission for the object
-     *
-     * <p>A transient node is a permission that does not persist.
-     * Whenever a user logs out of the server, or the server restarts, this permission will disappear.
-     * It is never saved to the datastore, and therefore will not apply on other servers.</p>
-     *
-     * <p>This is useful if you want to temporarily set a permission for a user while they're online, but don't
-     * want it to persist, and have to worry about removing it when they log out.</p>
-     *
-     * <p>For unsetting a transient permission, see {@link #unsetTransientPermission(Node)}</p>
-     *
-     * @param node The node to be set
-     * @throws NullPointerException      if the node is null
-     * @return the result of the operation
-     * @since 3.1
-     */
-    @Nonnull
-    DataMutateResult setTransientPermissionUnchecked(@Nonnull Node node);
-
-    /**
-     * Unsets a permission for the object
-     *
-     * @param node The node to be unset
-     * @throws ObjectLacksException if the node wasn't already set
-     * @throws NullPointerException if the node is null
-     * @since 2.6
-     */
-    void unsetPermission(@Nonnull Node node) throws ObjectLacksException;
-
-    /**
-     * Unsets a permission for the object
-     *
-     * @param node The node to be unset
-     * @throws NullPointerException if the node is null
-     * @return the result of the operation
-     * @since 3.1
-     */
-    @Nonnull
-    DataMutateResult unsetPermissionUnchecked(@Nonnull Node node);
-
-    /**
-     * Unsets a transient permission for the object
-     *
-     * @param node The node to be unset
-     * @throws ObjectLacksException if the node wasn't already set
-     * @throws NullPointerException if the node is null
-     * @since 2.6
-     */
-    void unsetTransientPermission(@Nonnull Node node) throws ObjectLacksException;
-
-    /**
-     * Unsets a transient permission for the object
-     *
-     * @param node The node to be unset
-     * @throws NullPointerException if the node is null
-     * @return the result of the operation
-     * @since 3.1
-     */
-    @Nonnull
-    DataMutateResult unsetTransientPermissionUnchecked(@Nonnull Node node);
-
-    /**
-     * Clears any nodes from the holder which pass the predicate
-     *
-     * @param test the predicate to test for nodes which should be removed
-     * @since 3.2
-     */
-    void clearMatching(@Nonnull Predicate<Node> test);
-
-    /**
-     * Clears any transient nodes from the holder which pass the predicate
-     *
-     * @param test the predicate to test for nodes which should be removed
-     * @since 3.2
-     */
-    void clearMatchingTransient(@Nonnull Predicate<Node> test);
-
-    /**
-     * Clears all nodes held by the object
-     *
-     * @since 2.17
-     */
-    void clearNodes();
-
-    /**
-     * Clears all nodes held by the object in a specific context
-     *
-     * @param contextSet the contexts to filter by
-     * @since 3.2
-     */
-    void clearNodes(@Nonnull ContextSet contextSet);
-
-    /**
-     * Clears all parent groups
-     *
-     * @since 2.17
-     */
-    void clearParents();
-
-    /**
-     * Clears all parent groups in a specific context
-     *
-     * @param contextSet the contexts to filter by
-     * @since 3.2
-     */
-    void clearParents(@Nonnull ContextSet contextSet);
-
-    /**
-     * Clears all meta held by the object
-     *
-     * @since 2.17
-     */
-    void clearMeta();
-
-    /**
-     * Clears all meta held by the object in a specific context
-     *
-     * @param contextSet the contexts to filter by
-     * @since 3.2
-     */
-    void clearMeta(@Nonnull ContextSet contextSet);
-
-    /**
-     * Clears all transient permissions the holder has.
-     */
-    void clearTransientNodes();
-
-    /**
-     * Checks to see if the object has a certain permission
-     *
-     * @param node The permission node
-     * @param b    If the node is true/false(negated)
-     * @return true if the object has the permission
-     * @throws NullPointerException     if the node is null
-     * @throws IllegalArgumentException if the node is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean hasPermission(@Nonnull String node, boolean b);
-
-    /**
-     * Checks to see the the object has a permission on a certain server
-     *
-     * @param node   The permission node
-     * @param b      If the node is true/false(negated)
-     * @param server The server
-     * @return true if the object has the permission
-     * @throws NullPointerException     if the node or server is null
-     * @throws IllegalArgumentException if the node or server is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean hasPermission(@Nonnull String node, boolean b, @Nonnull String server);
-
-    /**
-     * Checks to see the the object has a permission on a certain server and world
-     *
-     * @param node   The permission node
-     * @param b      If the node is true/false(negated)
-     * @param server The server
-     * @param world  The world
-     * @return true if the object has the permission
-     * @throws NullPointerException     if the node, server or world is null
-     * @throws IllegalArgumentException if the node, server or world is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean hasPermission(@Nonnull String node, boolean b, @Nonnull String server, @Nonnull String world);
-
-    /**
-     * Checks to see the the object has a permission
-     *
-     * @param node      The permission node
-     * @param b         If the node is true/false(negated)
-     * @param temporary if the permission is temporary
-     * @return true if the object has the permission
-     * @throws NullPointerException     if the node is null
-     * @throws IllegalArgumentException if the node is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean hasPermission(@Nonnull String node, boolean b, boolean temporary);
-
-    /**
-     * Checks to see the the object has a permission on a certain server
-     *
-     * @param node      The permission node
-     * @param b         If the node is true/false(negated)
-     * @param server    The server to check on
-     * @param temporary if the permission is temporary
-     * @return true if the object has the permission
-     * @throws NullPointerException     if the node or server is null
-     * @throws IllegalArgumentException if the node or server is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean hasPermission(@Nonnull String node, boolean b, @Nonnull String server, boolean temporary);
-
-    /**
-     * Checks to see the the object has a permission on a certain server and world
-     *
-     * @param node      The permission node
-     * @param b         If the node is true/false(negated)
-     * @param server    The server to check on
-     * @param world     The world to check on
-     * @param temporary if the permission is temporary
-     * @return true if the object has the permission
-     * @throws NullPointerException     if the node, server or world is null
-     * @throws IllegalArgumentException if the node, server or world is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean hasPermission(@Nonnull String node, boolean b, @Nonnull String server, @Nonnull String world, boolean temporary);
-
-    /**
-     * Checks to see if the object inherits a certain permission
-     *
-     * @param node The permission node
-     * @param b    If the node is true/false(negated)
-     * @return true if the object inherits the permission
-     * @throws NullPointerException     if the node is null
-     * @throws IllegalArgumentException if the node is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean inheritsPermission(@Nonnull String node, boolean b);
-
-    /**
-     * Checks to see the the object inherits a permission on a certain server
-     *
-     * @param node   The permission node
-     * @param b      If the node is true/false(negated)
-     * @param server The server
-     * @return true if the object inherits the permission
-     * @throws NullPointerException     if the node or server is null
-     * @throws IllegalArgumentException if the node or server is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean inheritsPermission(@Nonnull String node, boolean b, @Nonnull String server);
-
-    /**
-     * Checks to see the the object inherits a permission on a certain server and world
-     *
-     * @param node   The permission node
-     * @param b      If the node is true/false(negated)
-     * @param server The server
-     * @param world  The world
-     * @return true if the object inherits the permission
-     * @throws NullPointerException     if the node, server or world is null
-     * @throws IllegalArgumentException if the node server or world is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean inheritsPermission(@Nonnull String node, boolean b, @Nonnull String server, @Nonnull String world);
-
-    /**
-     * Checks to see if the object inherits a permission
-     *
-     * @param node      The permission node
-     * @param b         If the node is true/false(negated)
-     * @param temporary if the permission is temporary
-     * @return true if the object inherits the permission
-     * @throws NullPointerException     if the node is null
-     * @throws IllegalArgumentException if the node is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean inheritsPermission(@Nonnull String node, boolean b, boolean temporary);
-
-    /**
-     * Checks to see if the object inherits a permission on a certain server
-     *
-     * @param node      The permission node
-     * @param b         If the node is true/false(negated)
-     * @param server    The server
-     * @param temporary if the permission is temporary
-     * @return true if the object inherits the permission
-     * @throws NullPointerException     if the node or server is null
-     * @throws IllegalArgumentException if the node or server is invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean inheritsPermission(@Nonnull String node, boolean b, @Nonnull String server, boolean temporary);
-
-    /**
-     * Checks to see if the object inherits a permission on a certain server and world
-     *
-     * @param node      The permission node
-     * @param b         If the node is true/false(negated)
-     * @param server    The server
-     * @param world     The world
-     * @param temporary if the permission is temporary
-     * @return true if the object inherits the permission
-     * @throws NullPointerException     if the node, server or world is null
-     * @throws IllegalArgumentException if the node, server or world if invalid
-     * @deprecated in favour of {@link #hasPermission(Node)}
-     */
-    @Deprecated
-    boolean inheritsPermission(@Nonnull String node, boolean b, @Nonnull String server, @Nonnull String world, boolean temporary);
-
-    /**
-     * Sets a permission for the object
-     *
-     * @param node  The node to be set
-     * @param value What to set the node to - true/false(negated)
-     * @throws ObjectAlreadyHasException if the object already has the permission
-     * @throws NullPointerException      if the node is null
-     * @throws IllegalArgumentException  if the node is invalid
-     * @deprecated in favour of {@link #setPermission(Node)}
-     */
-    @Deprecated
-    void setPermission(@Nonnull String node, boolean value) throws ObjectAlreadyHasException;
-
-    /**
-     * Sets a permission for the object on a specific server
-     *
-     * @param node   The node to set
-     * @param value  What to set the node to - true/false(negated)
-     * @param server The server to set the permission on
-     * @throws ObjectAlreadyHasException if the object already has the permission
-     * @throws NullPointerException      if the node or server is null
-     * @throws IllegalArgumentException  if the node or server is invalid
-     * @deprecated in favour of {@link #setPermission(Node)}
-     */
-    @Deprecated
-    void setPermission(@Nonnull String node, boolean value, @Nonnull String server) throws ObjectAlreadyHasException;
-
-    /**
-     * Sets a permission for the object on a specific server and world
-     *
-     * @param node   The node to set
-     * @param value  What to set the node to - true/false(negated)
-     * @param server The server to set the permission on
-     * @param world  The world to set the permission on
-     * @throws ObjectAlreadyHasException if the object already has the permission
-     * @throws NullPointerException      if the node, server or world is null
-     * @throws IllegalArgumentException  if the node, server or world is invalid
-     * @deprecated in favour of {@link #setPermission(Node)}
-     */
-    @Deprecated
-    void setPermission(@Nonnull String node, boolean value, @Nonnull String server, @Nonnull String world) throws ObjectAlreadyHasException;
-
-    /**
-     * Sets a temporary permission for the object
-     *
-     * @param node     The node to set
-     * @param value    What to set the node to - true/false(negated)
-     * @param expireAt The time in unixtime when the permission will expire
-     * @throws ObjectAlreadyHasException if the object already has the permission
-     * @throws NullPointerException      if the node is null
-     * @throws IllegalArgumentException  if the node is invalid or if the expiry time is in the past
-     * @deprecated in favour of {@link #setPermission(Node)}
-     */
-    @Deprecated
-    void setPermission(@Nonnull String node, boolean value, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Sets a temporary permission for the object on a specific server
-     *
-     * @param node     The node to set
-     * @param value    What to set the node to - true/false(negated)
-     * @param server   The server to set the permission on
-     * @param expireAt The time in unixtime when the permission will expire
-     * @throws ObjectAlreadyHasException if the object already has the permission
-     * @throws NullPointerException      if the node or server is null
-     * @throws IllegalArgumentException  if the node/server is invalid or if the expiry time is in the past
-     * @deprecated in favour of {@link #setPermission(Node)}
-     */
-    @Deprecated
-    void setPermission(@Nonnull String node, boolean value, @Nonnull String server, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Sets a temporary permission for the object on a specific server and world
-     *
-     * @param node     The node to set
-     * @param value    What to set the node to - true/false(negated)
-     * @param server   The server to set the permission on
-     * @param world    The world to set the permission on
-     * @param expireAt The time in unixtime when the permission will expire
-     * @throws ObjectAlreadyHasException if the object already has the permission
-     * @throws NullPointerException      if the node, server or world is null
-     * @throws IllegalArgumentException  if the node/server/world is invalid, or if the expiry time is in the past
-     * @deprecated in favour of {@link #setPermission(Node)}
-     */
-    @Deprecated
-    void setPermission(String node, boolean value, @Nonnull String server, @Nonnull String world, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Unsets a permission for the object
-     *
-     * @param node      The node to be unset
-     * @param temporary if the permission being removed is temporary
-     * @throws ObjectLacksException     if the node wasn't already set
-     * @throws NullPointerException     if the node is null
-     * @throws IllegalArgumentException if the node is invalid
-     * @deprecated in favour of {@link #unsetPermission(Node)}
-     */
-    @Deprecated
-    void unsetPermission(@Nonnull String node, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Unsets a permission for the object
-     *
-     * @param node The node to be unset
-     * @throws ObjectLacksException     if the node wasn't already set
-     * @throws NullPointerException     if the node is null
-     * @throws IllegalArgumentException if the node is invalid
-     * @deprecated in favour of {@link #unsetPermission(Node)}
-     */
-    @Deprecated
-    void unsetPermission(@Nonnull String node) throws ObjectLacksException;
-
-    /**
-     * Unsets a permission for the object on a specific server
-     *
-     * @param node   The node to be unset
-     * @param server The server to unset the node on
-     * @throws ObjectLacksException     if the node wasn't already set
-     * @throws NullPointerException     if the node or server is null
-     * @throws IllegalArgumentException if the node or server is invalid
-     * @deprecated in favour of {@link #unsetPermission(Node)}
-     */
-    @Deprecated
-    void unsetPermission(@Nonnull String node, @Nonnull String server) throws ObjectLacksException;
-
-    /**
-     * Unsets a permission for the object on a specific server and world
-     *
-     * @param node   The node to be unset
-     * @param server The server to unset the node on
-     * @param world  The world to unset the node on
-     * @throws ObjectLacksException     if the node wasn't already set
-     * @throws NullPointerException     if the node, server or world is null
-     * @throws IllegalArgumentException if the node, server or world is invalid
-     * @deprecated in favour of {@link #unsetPermission(Node)}
-     */
-    @Deprecated
-    void unsetPermission(@Nonnull String node, @Nonnull String server, @Nonnull String world) throws ObjectLacksException;
-
-    /**
-     * Unsets a permission for the object on a specific server
-     *
-     * @param node      The node to be unset
-     * @param server    The server to unset the node on
-     * @param temporary if the permission being unset is temporary
-     * @throws ObjectLacksException     if the node wasn't already set
-     * @throws NullPointerException     if the node or server is null
-     * @throws IllegalArgumentException if the node or server is invalid
-     * @deprecated in favour of {@link #unsetPermission(Node)}
-     */
-    @Deprecated
-    void unsetPermission(@Nonnull String node, @Nonnull String server, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Unsets a permission for the object on a specific server and world
-     *
-     * @param node      The node to be unset
-     * @param server    The server to unset the node on
-     * @param world     The world to unset the node on
-     * @param temporary if the permission being unset is temporary
-     * @throws ObjectLacksException     if the node wasn't already set
-     * @throws NullPointerException     if the node, server or world is null
-     * @throws IllegalArgumentException if the node, server or world is invalid
-     * @deprecated in favour of {@link #unsetPermission(Node)}
-     */
-    @Deprecated
-    void unsetPermission(@Nonnull String node, @Nonnull String server, @Nonnull String world, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Clears all nodes held by the object on a specific server
-     *
-     * @param server the server to filter by, can be null
-     * @since 2.17
-     * @deprecated in favour of {@link #clearNodes(ContextSet)}
-     */
-    @Deprecated
-    void clearNodes(@Nullable String server);
-
-    /**
-     * Clears all nodes held by the object on a specific server and world
-     *
-     * @param server the server to filter by, can be null
-     * @param world the world to filter by, can be null
-     * @since 2.17
-     * @deprecated in favour of {@link #clearNodes(ContextSet)}
-     */
-    @Deprecated
-    void clearNodes(@Nullable String server, @Nullable String world);
-
-    /**
-     * Clears all parents on a specific server
-     *
-     * @param server the server to filter by, can be null
-     * @since 2.17
-     * @deprecated in favour of {@link #clearParents(ContextSet)}
-     */
-    @Deprecated
-    void clearParents(@Nullable String server);
-
-    /**
-     * Clears all parents on a specific server and world
-     *
-     * @param server the server to filter by, can be null
-     * @param world the world to filter by, can be null
-     * @since 2.17
-     * @deprecated in favour of {@link #clearParents(ContextSet)}
-     */
-    @Deprecated
-    void clearParents(@Nullable String server, @Nullable String world);
-
-    /**
-     * Clears all meta held by the object on a specific server
-     *
-     * @param server the server to filter by, can be null
-     * @since 2.17
-     * @deprecated in favour of {@link #clearMeta(ContextSet)}
-     */
-    @Deprecated
-    void clearMeta(@Nullable String server);
-
-    /**
-     * Clears all meta held by the object on a specific server and world
-     *
-     * @param server the server to filter by, can be null
-     * @param world the world to filter by, can be null
-     * @since 2.17
-     * @deprecated in favour of {@link #clearMeta(ContextSet)}
-     */
-    @Deprecated
-    void clearMeta(@Nullable String server, @Nullable String world);
-
-    /**
-     * Clears all meta for a given key.
-     *
-     * @param key the meta key
-     * @param server the server to filter by, can be null
-     * @param world the world to filter by, can be null
-     * @param temporary whether the query is for temporary nodes or not.
-     * @deprecated in favour of {@link #clearMatching(Predicate)}
-     */
-    @Deprecated
-    void clearMetaKeys(@Nonnull String key, @Nullable String server, @Nullable String world, boolean temporary);
-
-}

api/src/main/java/me/lucko/luckperms/api/Storage.java

@@ -1,315 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import java.util.List;
-import java.util.Set;
-import java.util.UUID;
-import java.util.concurrent.CompletableFuture;
-import java.util.concurrent.Executor;
-import java.util.function.Consumer;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-/**
- * A means of loading and saving permission data to/from the backend.
- *
- * <p>All blocking methods return {@link CompletableFuture}s, which will be populated with the result once the data has been
- * loaded/saved asynchronously. Care should be taken when using such methods to ensure that the main server thread is not
- * blocked.</p>
- *
- * <p>Methods such as {@link CompletableFuture#get()} and equivalent should <strong>not</strong> be called on the main
- * server thread. If you need to use the result of these operations on the main server thread, register a
- * callback using {@link CompletableFuture#thenAcceptAsync(Consumer, Executor)} and {@link #getSyncExecutor()}.</p>
- *
- * @since 2.14
- */
-public interface Storage {
-
-    /**
-     * Get the name of the storage implementation.
-     *
-     * @return the name of the implementation
-     */
-    @Nonnull
-    String getName();
-
-    /**
-     * Gets whether the storage instance is allowing logins on the platform.
-     *
-     * @return true if logins are enabled
-     */
-    boolean isAcceptingLogins();
-
-    /**
-     * Returns an executor which will run all passed runnables on the main server thread.
-     *
-     * @return an executor instance
-     */
-    @Nonnull
-    Executor getSyncExecutor();
-
-    /**
-     * Returns an executor which will run all passed runnables asynchronously using the platforms scheduler and thread
-     * pools.
-     *
-     * @return an executor instance
-     */
-    @Nonnull
-    Executor getAsyncExecutor();
-
-    /**
-     * Saves an action to storage
-     *
-     * @param entry the log entry to be saved
-     * @return true if the operation completed successfully.
-     * @throws NullPointerException if entry is null
-     */
-    @Nonnull
-    CompletableFuture<Boolean> logAction(@Nonnull LogEntry entry);
-
-    /**
-     * Loads and returns the entire log from storage
-     *
-     * @return a log instance, could be null if loading failed
-     */
-    @Nonnull
-    CompletableFuture<Log> getLog();
-
-    /**
-     * Loads a user's data from the main storage into the plugins local storage.
-     *
-     * @param uuid     the uuid of the user to load
-     * @param username the users username, or null if it is not known.
-     * @return if the operation completed successfully
-     * @throws NullPointerException if uuid is null
-     */
-    @Nonnull
-    CompletableFuture<Boolean> loadUser(@Nonnull UUID uuid, @Nullable String username);
-
-    /**
-     * Loads a user's data from the main storage into the plugins local storage.
-     *
-     * @param uuid the uuid of the user to load
-     * @return if the operation completed successfully
-     * @throws NullPointerException if uuid is null
-     */
-    @Nonnull
-    default CompletableFuture<Boolean> loadUser(@Nonnull UUID uuid) {
-        return loadUser(uuid, null);
-    }
-
-    /**
-     * Saves a user object back to storage. You should call this after you make any changes to a user.
-     *
-     * @param user the user to save
-     * @return true if the operation completed successfully.
-     * @throws NullPointerException  if user is null
-     * @throws IllegalStateException if the user instance was not obtained from LuckPerms.
-     */
-    @Nonnull
-    CompletableFuture<Boolean> saveUser(@Nonnull User user);
-
-    /**
-     * Removes users from the main storage who are "default". This is called every time the plugin loads.
-     *
-     * @return true if the operation completed successfully
-     */
-    @Nonnull
-    CompletableFuture<Boolean> cleanupUsers();
-
-    /**
-     * Gets a set all "unique" user UUIDs.
-     *
-     * <p>"Unique" meaning the user isn't just a member of the "default" group.</p>
-     *
-     * @return a set of uuids, or null if the operation failed.
-     */
-    @Nonnull
-    CompletableFuture<Set<UUID>> getUniqueUsers();
-
-    /**
-     * Searches for a list of users with a given permission.
-     *
-     * @param permission the permission to search for
-     * @return a list of held permissions, or null if the operation failed
-     * @throws NullPointerException if the permission is null
-     * @since 2.17
-     */
-    @Nonnull
-    CompletableFuture<List<HeldPermission<UUID>>> getUsersWithPermission(@Nonnull String permission);
-
-    /**
-     * Creates and loads a group into the plugins local storage
-     *
-     * @param name the name of the group
-     * @return true if the operation completed successfully
-     * @throws NullPointerException     if name is null
-     * @throws IllegalArgumentException if the name is invalid
-     */
-    @Nonnull
-    CompletableFuture<Boolean> createAndLoadGroup(@Nonnull String name);
-
-    /**
-     * Loads a group into the plugins local storage.
-     *
-     * @param name the name of the group
-     * @return true if the operation completed successfully
-     * @throws NullPointerException     if name is null
-     * @throws IllegalArgumentException if the name is invalid
-     */
-    @Nonnull
-    CompletableFuture<Boolean> loadGroup(@Nonnull String name);
-
-    /**
-     * Loads all groups from the storage into memory
-     *
-     * @return true if the operation completed successfully.
-     */
-    @Nonnull
-    CompletableFuture<Boolean> loadAllGroups();
-
-    /**
-     * Saves a group back to storage. You should call this after you make any changes to a group.
-     *
-     * @param group the group to save
-     * @return true if the operation completed successfully.
-     * @throws NullPointerException  if group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     */
-    @Nonnull
-    CompletableFuture<Boolean> saveGroup(@Nonnull Group group);
-
-    /**
-     * Permanently deletes a group from storage.
-     *
-     * @param group the group to delete
-     * @return true if the operation completed successfully.
-     * @throws NullPointerException  if group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     */
-    @Nonnull
-    CompletableFuture<Boolean> deleteGroup(@Nonnull Group group);
-
-    /**
-     * Searches for a list of groups with a given permission.
-     *
-     * @param permission the permission to search for
-     * @return a list of held permissions, or null if the operation failed
-     * @throws NullPointerException if the permission is null
-     * @since 2.17
-     */
-    @Nonnull
-    CompletableFuture<List<HeldPermission<String>>> getGroupsWithPermission(@Nonnull String permission);
-
-    /**
-     * Creates and loads a track into the plugins local storage
-     *
-     * @param name the name of the track
-     * @return true if the operation completed successfully
-     * @throws NullPointerException     if name is null
-     * @throws IllegalArgumentException if the name is invalid
-     */
-    @Nonnull
-    CompletableFuture<Boolean> createAndLoadTrack(@Nonnull String name);
-
-    /**
-     * Loads a track into the plugins local storage.
-     *
-     * @param name the name of the track
-     * @return true if the operation completed successfully
-     * @throws NullPointerException     if name is null
-     * @throws IllegalArgumentException if the name is invalid
-     */
-    @Nonnull
-    CompletableFuture<Boolean> loadTrack(@Nonnull String name);
-
-    /**
-     * Loads all tracks from the storage into memory
-     *
-     * @return true if the operation completed successfully.
-     */
-    @Nonnull
-    CompletableFuture<Boolean> loadAllTracks();
-
-    /**
-     * Saves a track back to storage. You should call this after you make any changes to a track.
-     *
-     * @param track the track to save
-     * @return true if the operation completed successfully.
-     * @throws NullPointerException  if track is null
-     * @throws IllegalStateException if the track instance was not obtained from LuckPerms.
-     */
-    @Nonnull
-    CompletableFuture<Boolean> saveTrack(@Nonnull Track track);
-
-    /**
-     * Permanently deletes a track from storage
-     *
-     * @param track the track to delete
-     * @return true if the operation completed successfully.
-     * @throws NullPointerException  if track is null
-     * @throws IllegalStateException if the track instance was not obtained from LuckPerms.
-     */
-    @Nonnull
-    CompletableFuture<Boolean> deleteTrack(@Nonnull Track track);
-
-    /**
-     * Saves UUID caching data to the global cache
-     *
-     * @param username the users username
-     * @param uuid     the users mojang unique id
-     * @return true if the operation completed successfully.
-     * @throws NullPointerException     if either parameters are null
-     * @throws IllegalArgumentException if the username is invalid
-     */
-    @Nonnull
-    CompletableFuture<Boolean> saveUUIDData(@Nonnull String username, @Nonnull UUID uuid);
-
-    /**
-     * Gets a UUID from a username
-     *
-     * @param username the corresponding username
-     * @return a uuid object, could be null
-     * @throws NullPointerException     if either parameters are null
-     * @throws IllegalArgumentException if the username is invalid
-     */
-    @Nonnull
-    CompletableFuture<UUID> getUUID(@Nonnull String username);
-
-    /**
-     * Gets a username from a UUID
-     *
-     * @param uuid the corresponding uuid
-     * @return a name string, could be null
-     * @throws NullPointerException if either parameters are null
-     * @since 2.17
-     */
-    @Nonnull
-    CompletableFuture<String> getName(@Nonnull UUID uuid);
-
-}

api/src/main/java/me/lucko/luckperms/api/User.java

@@ -1,378 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import me.lucko.luckperms.api.caching.UserData;
-import me.lucko.luckperms.api.context.ContextSet;
-import me.lucko.luckperms.exceptions.ObjectAlreadyHasException;
-import me.lucko.luckperms.exceptions.ObjectLacksException;
-
-import java.util.List;
-import java.util.Optional;
-import java.util.UUID;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-/**
- * A player which holds permission data.
- */
-public interface User extends PermissionHolder {
-
-    /**
-     * Gets the users unique ID
-     *
-     * @return the users Mojang assigned unique id
-     */
-    @Nonnull
-    UUID getUuid();
-
-    /**
-     * Gets the users username
-     *
-     * <p>Returns null if no username is associated with this user.</p>
-     *
-     * @return the users username
-     */
-    @Nullable
-    String getName();
-
-    /**
-     * Gets the users current primary group.
-     *
-     * <p>The result of this method depends on which method is configured for primary group calculation. It may not
-     * be the same as any value set through {@link #setPrimaryGroup(String)}.</p>
-     *
-     * @return the users primary group
-     */
-    @Nonnull
-    String getPrimaryGroup();
-
-    /**
-     * Sets a users primary group. This will only take effect if platform is using stored primary groups.
-     *
-     * @param group the new primary group
-     * @throws ObjectAlreadyHasException if the user already has this set as their primary group
-     * @throws IllegalStateException     if the user is not a member of that group
-     * @throws NullPointerException      if the group is null
-     */
-    void setPrimaryGroup(@Nonnull String group) throws ObjectAlreadyHasException;
-
-    /**
-     * Refresh and re-assign the users permissions.
-     *
-     * <p>This request is not buffered, and the refresh call will be ran directly. This should be called on an
-     * asynchronous thread.</p>
-     */
-    void refreshPermissions();
-
-    /**
-     * Gets the user's {@link UserData} cache.
-     *
-     * @return the users cached data.
-     * @since 3.2
-     */
-    @Nonnull
-    UserData getCachedData();
-
-    /**
-     * Pre-calculates some values in the user's data cache.
-     *
-     * <p>Is it <b>not</b> necessary to call this method before
-     * using {@link #getCachedData()}.</p>
-     *
-     * @since 2.17
-     */
-    void setupDataCache();
-
-    /**
-     * Check to see if the user is a direct member of a group
-     *
-     * @param group The group to check membership of
-     * @return true if the user is a member of the group
-     * @throws NullPointerException if the group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     */
-    boolean isInGroup(@Nonnull Group group);
-
-    /**
-     * Check to see if the user is a direct member of a group in a specific context
-     *
-     * @param group the group to check membership of
-     * @param contextSet the context set to filter by
-     * @return true if the user is a member of the group
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     * @since 3.2
-     */
-    boolean isInGroup(@Nonnull Group group, @Nonnull ContextSet contextSet);
-
-    /**
-     * Gets the user's {@link UserData} cache, if they have one setup.
-     *
-     * @return an optional, possibly containing the user's cached lookup data.
-     * @since 2.13
-     * @deprecated in version 3.2, as this cache is now always loaded
-     */
-    @Deprecated
-    @Nonnull
-    Optional<UserData> getUserDataCache();
-
-    /**
-     * Check to see if a user is a member of a group on a specific server
-     *
-     * @param group  The group to check membership of
-     * @param server The server to check on
-     * @return true if the user is a member of the group
-     * @throws NullPointerException     if the group or server is null
-     * @throws IllegalArgumentException if the server is invalid
-     * @deprecated in favour of {@link #isInGroup(Group, ContextSet)}
-     */
-    @Deprecated
-    boolean isInGroup(@Nonnull Group group, @Nonnull String server);
-
-    /**
-     * Check to see if a user is a member of a group on a specific server and world
-     *
-     * @param group  The group to check membership of
-     * @param server The server to check on
-     * @param world  The world to check on
-     * @return true if the user is a member of the group
-     * @throws NullPointerException     if the group, server or world is null
-     * @throws IllegalArgumentException if the server or world is invalid
-     * @deprecated in favour of {@link #isInGroup(Group, ContextSet)}
-     */
-    @Deprecated
-    boolean isInGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world);
-
-    /**
-     * Add a user to a group
-     *
-     * @param group The group to add the user to
-     * @throws ObjectAlreadyHasException if the user is already a member of the group
-     * @throws NullPointerException      if the group is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void addGroup(@Nonnull Group group) throws ObjectAlreadyHasException;
-
-    /**
-     * Add a user to a group on a specific server
-     *
-     * @param group  The group to add the user to
-     * @param server The server to add the group on
-     * @throws ObjectAlreadyHasException if the user is already a member of the group on that server
-     * @throws NullPointerException      if the group or server is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the server is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void addGroup(@Nonnull Group group, @Nonnull String server) throws ObjectAlreadyHasException;
-
-    /**
-     * Add a user to a group on a specific server and world
-     *
-     * @param group  The group to add the user to
-     * @param server The server to add the group on
-     * @param world  The world to add the group on
-     * @throws ObjectAlreadyHasException if the user is already a member of the group on that server
-     * @throws NullPointerException      if the group, server or world is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the server or world is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void addGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world) throws ObjectAlreadyHasException;
-
-    /**
-     * Add a user to a group temporarily on a specific server
-     *
-     * @param group    The group to add the user to
-     * @param expireAt when the group should expire
-     * @throws ObjectAlreadyHasException if the user is already a member of the group on that server
-     * @throws NullPointerException      if the group is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the expiry time is in the past
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void addGroup(@Nonnull Group group, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Add a user to a group temporarily on a specific server
-     *
-     * @param group    The group to add the user to
-     * @param server   The server to add the group on
-     * @param expireAt when the group should expire
-     * @throws ObjectAlreadyHasException if the user is already a member of the group on that server
-     * @throws NullPointerException      if the group or server is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the expiry time is in the past or the server is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void addGroup(@Nonnull Group group, @Nonnull String server, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Add a user to a group temporarily on a specific server and world
-     *
-     * @param group    The group to add the user to
-     * @param server   The server to add the group on
-     * @param world    The world to add the group on
-     * @param expireAt when the group should expire
-     * @throws ObjectAlreadyHasException if the user is already a member of the group on that server
-     * @throws NullPointerException      if the group, server or world is null
-     * @throws IllegalStateException     if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException  if the expiry time is in the past or the server/world is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void addGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world, long expireAt) throws ObjectAlreadyHasException;
-
-    /**
-     * Remove the user from a group
-     *
-     * @param group the group to remove the user from
-     * @throws ObjectLacksException  if the user isn't a member of the group
-     * @throws NullPointerException  if the group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void removeGroup(@Nonnull Group group) throws ObjectLacksException;
-
-    /**
-     * Remove the user from a group
-     *
-     * @param group     the group to remove the user from
-     * @param temporary if the group being removed is temporary
-     * @throws ObjectLacksException  if the user isn't a member of the group
-     * @throws NullPointerException  if the group is null
-     * @throws IllegalStateException if the group instance was not obtained from LuckPerms.
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void removeGroup(@Nonnull Group group, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Remove the user from a group on a specific server
-     *
-     * @param group  The group to remove the user from
-     * @param server The server to remove the group on
-     * @throws ObjectLacksException     if the user isn't a member of the group
-     * @throws NullPointerException     if the group or server is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the server is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void removeGroup(@Nonnull Group group, @Nonnull String server) throws ObjectLacksException;
-
-    /**
-     * Remove the user from a group on a specific server and world
-     *
-     * @param group  The group to remove the user from
-     * @param server The server to remove the group on
-     * @param world  The world to remove the group on
-     * @throws ObjectLacksException     if the user isn't a member of the group
-     * @throws NullPointerException     if the group, server or world is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the server or world is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void removeGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world) throws ObjectLacksException;
-
-    /**
-     * Remove the user from a group on a specific server
-     *
-     * @param group     The group to remove the user from
-     * @param server    The server to remove the group on
-     * @param temporary if the group being removed is temporary
-     * @throws ObjectLacksException     if the user isn't a member of the group
-     * @throws NullPointerException     if the group or server is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the expiry time is in the past or the server is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void removeGroup(@Nonnull Group group, @Nonnull String server, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Remove the user from a group on a specific server and world
-     *
-     * @param group     The group to remove the user from
-     * @param server    The server to remove the group on
-     * @param world     The world to remove the group on
-     * @param temporary if the group being removed is temporary
-     * @throws ObjectLacksException     if the user isn't a member of the group
-     * @throws NullPointerException     if the group, server or world is null
-     * @throws IllegalStateException    if the group instance was not obtained from LuckPerms.
-     * @throws IllegalArgumentException if the expiry time is in the past or the server/world is invalid
-     * @deprecated in favour of {@link NodeFactory#makeGroupNode(Group)}
-     */
-    @Deprecated
-    void removeGroup(@Nonnull Group group, @Nonnull String server, @Nonnull String world, boolean temporary) throws ObjectLacksException;
-
-    /**
-     * Get a {@link List} of all of the groups the user is a member of, on all servers
-     *
-     * @return a {@link List} of group names
-     * @deprecated in favour of just querying a users permissions
-     */
-    @Deprecated
-    @Nonnull
-    List<String> getGroupNames();
-
-    /**
-     * Get a {@link List} of the groups the user is a member of on a specific server
-     *
-     * @param server the server to check
-     * @param world  the world to check
-     * @return a {@link List} of group names
-     * @throws NullPointerException     if the server or world is null
-     * @throws IllegalArgumentException if the server or world is invalid
-     * @deprecated in favour of just querying a users permissions
-     */
-    @Deprecated
-    @Nonnull
-    List<String> getLocalGroups(@Nonnull String server, @Nonnull String world);
-
-    /**
-     * Get a {@link List} of the groups the user is a member of on a specific server
-     *
-     * @param server the server to check
-     * @return a {@link List} of group names
-     * @throws NullPointerException     if the server is null
-     * @throws IllegalArgumentException if the server is invalid
-     * @deprecated in favour of just querying a users permissions
-     */
-    @Deprecated
-    @Nonnull
-    List<String> getLocalGroups(@Nonnull String server);
-
-}

api/src/main/java/me/lucko/luckperms/api/UuidCache.java

@@ -1,65 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api;
-
-import java.util.UUID;
-
-import javax.annotation.Nonnull;
-
-/**
- * A UUID cache for online users, between external Mojang UUIDs, and internal LuckPerms UUIDs.
- *
- * <p>A user's internal LuckPerms UUID is always the same as their Mojang one,
- * unless <code>use-server-uuids</code> is disabled.</p>
- *
- * <p>When this setting is disabled, this cache becomes active, and allows you to convert
- * between 'internal' and 'server provided' uuids.</p>
- *
- * <p><strong>This is only effective for online players. Use {@link Storage#getUUID(String)} for offline players.</strong></p>
- */
-public interface UuidCache {
-
-    /**
-     * Gets a users "internal" LuckPerms UUID, from the one given by the server.
-     *
-     * <p>When <code>use-server-uuids</code> is true, this returns the same UUID instance.</p>
-     *
-     * @param mojangUuid the UUID assigned by the server, through <code>Player#getUniqueId</code> or <code>ProxiedPlayer#getUniqueId</code>
-     * @return the corresponding internal UUID
-     */
-    @Nonnull
-    UUID getUUID(@Nonnull UUID mojangUuid);
-
-    /**
-     * Gets a users "external", server assigned unique id, from the internal one used within LuckPerms.
-     *
-     * @param internalUuid the UUID used within LuckPerms, through <code>User#getUuid</code>
-     * @return the corresponding external UUID
-     */
-    @Nonnull
-    UUID getExternalUUID(@Nonnull UUID internalUuid);
-
-}

api/src/main/java/me/lucko/luckperms/api/caching/MetaContexts.java

@@ -1,118 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api.caching;
-
-import com.google.common.base.Preconditions;
-
-import me.lucko.luckperms.api.Contexts;
-import me.lucko.luckperms.api.metastacking.MetaStackDefinition;
-
-import javax.annotation.Nonnull;
-
-/**
- * Represents the context for a meta lookup.
- *
- * <p>Consisting of a standard {@link Contexts} element, plus options to define how
- * the meta stack should be constructed.</p>
- *
- * @since 3.2
- */
-public final class MetaContexts {
-
-    /**
-     * Creates a new meta contexts instance
-     *
-     * @param contexts the standard contexts for the query
-     * @param prefixStackDefinition the prefix stack definition to be used
-     * @param suffixStackDefinition the suffix stack definition to be used
-     * @return the new instance
-     */
-    public static MetaContexts of(@Nonnull Contexts contexts, @Nonnull MetaStackDefinition prefixStackDefinition, @Nonnull MetaStackDefinition suffixStackDefinition) {
-        return new MetaContexts(contexts, prefixStackDefinition, suffixStackDefinition);
-    }
-
-    private final Contexts contexts;
-    private final MetaStackDefinition prefixStackDefinition;
-    private final MetaStackDefinition suffixStackDefinition;
-
-    /**
-     * Creates a new meta contexts instance
-     *
-     * @param contexts the standard contexts for the query
-     * @param prefixStackDefinition the prefix stack definition to be used
-     * @param suffixStackDefinition the suffix stack definition to be used
-     */
-    public MetaContexts(@Nonnull Contexts contexts, @Nonnull MetaStackDefinition prefixStackDefinition, @Nonnull MetaStackDefinition suffixStackDefinition) {
-        this.contexts = Preconditions.checkNotNull(contexts, "contexts");
-        this.prefixStackDefinition = Preconditions.checkNotNull(prefixStackDefinition, "prefixStackDefinition");
-        this.suffixStackDefinition = Preconditions.checkNotNull(suffixStackDefinition, "suffixStackDefinition");
-    }
-
-    @Nonnull
-    public Contexts getContexts() {
-        return this.contexts;
-    }
-
-    @Nonnull
-    public MetaStackDefinition getPrefixStackDefinition() {
-        return this.prefixStackDefinition;
-    }
-
-    @Nonnull
-    public MetaStackDefinition getSuffixStackDefinition() {
-        return this.suffixStackDefinition;
-    }
-
-    @Override
-    @Nonnull
-    public String toString() {
-        return "MetaContexts(" +
-                "contexts=" + this.getContexts() + ", " +
-                "prefixStackDefinition=" + this.getPrefixStackDefinition() + ", " +
-                "suffixStackDefinition=" + this.getSuffixStackDefinition() +
-                ")";
-    }
-
-    @Override
-    public boolean equals(Object o) {
-        if (o == this) return true;
-        if (!(o instanceof MetaContexts)) return false;
-        final MetaContexts other = (MetaContexts) o;
-        return this.getContexts().equals(other.getContexts()) &&
-                this.getPrefixStackDefinition().equals(other.getPrefixStackDefinition()) &&
-                this.getSuffixStackDefinition().equals(other.getSuffixStackDefinition());
-    }
-
-    @Override
-    public int hashCode() {
-        final int PRIME = 59;
-        int result = 1;
-        result = result * PRIME + this.getContexts().hashCode();
-        result = result * PRIME + this.getPrefixStackDefinition().hashCode();
-        result = result * PRIME + this.getSuffixStackDefinition().hashCode();
-        return result;
-    }
-}

api/src/main/java/me/lucko/luckperms/api/caching/MetaData.java

@@ -1,123 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api.caching;
-
-import com.google.common.collect.ListMultimap;
-
-import me.lucko.luckperms.api.metastacking.MetaStackDefinition;
-
-import java.util.Map;
-import java.util.SortedMap;
-
-import javax.annotation.Nonnull;
-import javax.annotation.Nullable;
-
-/**
- * Holds cached Meta lookup data for a specific set of contexts
- *
- * @since 2.13
- */
-public interface MetaData {
-
-    /**
-     * Gets an immutable copy of the meta this user has.
-     *
-     * <p>A list multimap is used because when inherited values are included, each key can be
-     * mapped to multiple values.</p>
-     *
-     * <p>The first value to be accumulated (and used to represent the key in {@link #getMeta()} is at index 0
-     * in the list. Any additional values are stored in order of accumulation.</p>
-     *
-     * @return an immutable multimap of meta
-     * @since 3.3
-     */
-    @Nonnull
-    ListMultimap<String, String> getMetaMultimap();
-
-    /**
-     * Gets an immutable copy of the meta this user has.
-     *
-     * <p>This map is formed by taking the entries in {@link #getMetaMultimap()}, and mapping each key
-     * to the value at index 0 in the corresponding list.</p>
-     *
-     * @return an immutable map of meta
-     */
-    @Nonnull
-    Map<String, String> getMeta();
-
-    /**
-     * Gets an immutable sorted map of all of the prefixes the user has, whereby the first value is the highest priority
-     * prefix.
-     *
-     * @return a sorted map of prefixes
-     */
-    @Nonnull
-    SortedMap<Integer, String> getPrefixes();
-
-    /**
-     * Gets an immutable sorted map of all of the suffixes the user has, whereby the first value is the highest priority
-     * suffix.
-     *
-     * @return a sorted map of suffixes
-     */
-    @Nonnull
-    SortedMap<Integer, String> getSuffixes();
-
-    /**
-     * Gets the user's highest priority prefix, or null if the user has no prefixes
-     *
-     * @return a prefix string, or null
-     */
-    @Nullable
-    String getPrefix();
-
-    /**
-     * Gets the user's highest priority suffix, or null if the user has no suffixes
-     *
-     * @return a suffix string, or null
-     */
-    @Nullable
-    String getSuffix();
-
-    /**
-     * Gets the definition used for the prefix stack
-     *
-     * @return the definition used for the prefix stack
-     * @since 3.2
-     */
-    @Nonnull
-    MetaStackDefinition getPrefixStackDefinition();
-
-    /**
-     * Gets the definition used for the suffix stack
-     *
-     * @return the definition used for the suffix stack
-     * @since 3.2
-     */
-    @Nonnull
-    MetaStackDefinition getSuffixStackDefinition();
-
-}

api/src/main/java/me/lucko/luckperms/api/caching/UserData.java

@@ -1,185 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api.caching;
-
-import me.lucko.luckperms.api.Contexts;
-
-import java.util.Set;
-
-import javax.annotation.Nonnull;
-
-/**
- * Holds cached permission and meta lookup data for a {@link me.lucko.luckperms.api.User}.
- *
- * <p>Data is only likely to be available for online users. All calls will account for inheritance, as well as any
- * default data provided by the platform. This calls are heavily cached and are therefore fast.</p>
- *
- * <p>For meta, both methods accepting {@link Contexts} and {@link MetaContexts} are provided. The only difference is that
- * the latter allows you to define how the meta stack should be structured internally. Where {@link Contexts} are passed, the
- * values from the configuration are used.</p>
- *
- * @since 2.13
- */
-public interface UserData {
-
-    /**
-     * Gets PermissionData from the cache, given a specified context.
-     *
-     * <p>If the data is not cached, it is calculated. Therefore, this call could be costly.</p>
-     *
-     * @param contexts the contexts to get the permission data in
-     * @return a permission data instance
-     * @throws NullPointerException if contexts is null
-     */
-    @Nonnull
-    PermissionData getPermissionData(@Nonnull Contexts contexts);
-
-    /**
-     * Gets MetaData from the cache, given a specified context.
-     *
-     * <p>If the data is not cached, it is calculated. Therefore, this call could be costly.</p>
-     *
-     * @param contexts the contexts to get the permission data in
-     * @return a meta data instance
-     * @throws NullPointerException if contexts is null
-     * @since 3.2
-     */
-    @Nonnull
-    MetaData getMetaData(@Nonnull MetaContexts contexts);
-
-    /**
-     * Gets MetaData from the cache, given a specified context.
-     *
-     * <p>If the data is not cached, it is calculated. Therefore, this call could be costly.</p>
-     *
-     * @param contexts the contexts to get the permission data in
-     * @return a meta data instance
-     * @throws NullPointerException if contexts is null
-     */
-    @Nonnull
-    MetaData getMetaData(@Nonnull Contexts contexts);
-
-    /**
-     * Calculates permission data, bypassing the cache.
-     *
-     * @param contexts the contexts to get permission data in
-     * @return a permission data instance
-     * @throws NullPointerException if contexts is null
-     */
-    @Nonnull
-    PermissionData calculatePermissions(@Nonnull Contexts contexts);
-
-    /**
-     * Calculates meta data, bypassing the cache.
-     *
-     * @param contexts the contexts to get meta data in
-     * @return a meta data instance
-     * @throws NullPointerException if contexts is null
-     * @since 3.2
-     */
-    @Nonnull
-    MetaData calculateMeta(@Nonnull MetaContexts contexts);
-
-    /**
-     * Calculates meta data, bypassing the cache.
-     *
-     * @param contexts the contexts to get meta data in
-     * @return a meta data instance
-     * @throws NullPointerException if contexts is null
-     */
-    @Nonnull
-    MetaData calculateMeta(@Nonnull Contexts contexts);
-
-    /**
-     * Calculates permission data and stores it in the cache.
-     *
-     * <p>If there is already data cached for the given contexts, and if the resultant output is different,
-     * the cached value is updated.</p>
-     *
-     * @param contexts the contexts to recalculate in.
-     * @throws NullPointerException if contexts is null
-     */
-    void recalculatePermissions(@Nonnull Contexts contexts);
-
-    /**
-     * Calculates meta data and stores it in the cache.
-     *
-     * <p>If there is already data cached for the given contexts, and if the resultant output is different,
-     * the cached value is updated.</p>
-     *
-     * @param contexts the contexts to recalculate in.
-     * @throws NullPointerException if contexts is null
-     * @since 3.2
-     */
-    void recalculateMeta(@Nonnull MetaContexts contexts);
-
-    /**
-     * Calculates meta data and stores it in the cache.
-     *
-     * <p>If there is already data cached for the given contexts, and if the resultant output is different,
-     * the cached value is updated.</p>
-     *
-     * @param contexts the contexts to recalculate in.
-     * @throws NullPointerException if contexts is null
-     */
-    void recalculateMeta(@Nonnull Contexts contexts);
-
-    /**
-     * Calls {@link #recalculatePermissions(Contexts)} for all current loaded contexts
-     */
-    void recalculatePermissions();
-
-    /**
-     * Calls {@link #recalculateMeta(Contexts)} for all current loaded contexts
-     */
-    void recalculateMeta();
-
-    /**
-     * Calls {@link #preCalculate(Contexts)} for the given contexts
-     *
-     * @param contexts a set of contexts
-     * @throws NullPointerException if contexts is null
-     */
-    void preCalculate(@Nonnull Set<Contexts> contexts);
-
-    /**
-     * Ensures that PermissionData and MetaData is cached for a context.
-     *
-     * <p>If the cache does not contain any data for the context, it will be calculated and saved.</p>
-     *
-     * @param contexts the contexts to pre-calculate for
-     * @throws NullPointerException if contexts is null
-     */
-    void preCalculate(@Nonnull Contexts contexts);
-
-    /**
-     * Invalidates all of the underlying Permission calculators.
-     *
-     * <p>Can be called to allow for an update in defaults.</p>
-     */
-    void invalidatePermissionCalculators();
-
-}

api/src/main/java/me/lucko/luckperms/api/context/ContextCalculator.java

@@ -1,49 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api.context;
-
-import javax.annotation.Nonnull;
-
-/**
- * Calculates whether contexts are applicable to {@link T}
- *
- * @param <T> the subject type. Is ALWAYS the player class of the platform.
- * @since 2.13
- */
-public interface ContextCalculator<T> {
-
-    /**
-     * Gives the subject all of the applicable contexts they meet
-     *
-     * @param subject     the subject to add contexts to
-     * @param accumulator a map of contexts to add to
-     * @return the map
-     * @since 2.13
-     */
-    @Nonnull
-    MutableContextSet giveApplicableContext(@Nonnull T subject, @Nonnull MutableContextSet accumulator);
-
-}

api/src/main/java/me/lucko/luckperms/api/context/ContextSet.java

@@ -1,334 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api.context;
-
-import com.google.common.base.Preconditions;
-import com.google.common.collect.Multimap;
-
-import java.util.Map;
-import java.util.Optional;
-import java.util.Set;
-
-import javax.annotation.Nonnull;
-
-/**
- * A set of context pairs.
- *
- * <p>You can think of ContextSets as a wrapped <code>Multimap&lt;String, String&gt;</code>.
- * Each key can be mapped to multiple values.</p>
- *
- * <p>Keys are automatically converted to lowercase when added, and are therefore
- * case-insensitive. Values however are not.</p>
- *
- * <p>Implementations may be either mutable or immutable.</p>
- *
- * @since 2.13
- */
-public interface ContextSet {
-
-    /**
-     * Creates an ImmutableContextSet from a context pair
-     *
-     * @param key   the key
-     * @param value the value
-     * @return a new ImmutableContextSet containing one KV pair
-     * @throws NullPointerException if key or value is null
-     */
-    @Nonnull
-    static ImmutableContextSet singleton(@Nonnull String key, @Nonnull String value) {
-        return ImmutableContextSet.singleton(key, value);
-    }
-
-    /**
-     * Creates an ImmutableContextSet from two context pairs
-     *
-     * @param key1 the first key
-     * @param value1 the first value
-     * @param key2 the second key
-     * @param value2 the second value
-     * @return a new ImmutableContextSet containing the two pairs
-     * @throws NullPointerException if any of the keys or values are null
-     * @since 3.1
-     */
-    @Nonnull
-    static ImmutableContextSet of(@Nonnull String key1, @Nonnull String value1, @Nonnull String key2, @Nonnull String value2) {
-        return ImmutableContextSet.of(key1, value1, key2, value2);
-    }
-
-    /**
-     * Creates an ImmutableContextSet from an existing iterable of Map Entries
-     *
-     * @param iterable the iterable to copy from
-     * @return a new ImmutableContextSet representing the pairs in the iterable
-     * @throws NullPointerException if the iterable is null
-     */
-    @Nonnull
-    static ImmutableContextSet fromEntries(@Nonnull Iterable<? extends Map.Entry<String, String>> iterable) {
-        return ImmutableContextSet.fromEntries(iterable);
-    }
-
-    /**
-     * Creates an ImmutableContextSet from an existing map
-     *
-     * @param map the map to copy from
-     * @return a new ImmutableContextSet representing the pairs from the map
-     * @throws NullPointerException if the map is null
-     */
-    @Nonnull
-    static ImmutableContextSet fromMap(@Nonnull Map<String, String> map) {
-        return ImmutableContextSet.fromMap(map);
-    }
-
-    /**
-     * Creates an ImmutableContextSet from an existing multimap
-     *
-     * @param multimap the multimap to copy from
-     * @return a new ImmutableContextSet representing the pairs in the multimap
-     * @throws NullPointerException if the multimap is null
-     * @since 2.16
-     */
-    @Nonnull
-    static ImmutableContextSet fromMultimap(@Nonnull Multimap<String, String> multimap) {
-        return ImmutableContextSet.fromMultimap(multimap);
-    }
-
-    /**
-     * Creates an new ImmutableContextSet from an existing set.
-     * Only really useful for converting between mutable and immutable types.
-     *
-     * @param contextSet the context set to copy from
-     * @return a new ImmutableContextSet with the same content and the one provided
-     * @throws NullPointerException if contextSet is null
-     */
-    @Nonnull
-    static ImmutableContextSet fromSet(@Nonnull ContextSet contextSet) {
-        return ImmutableContextSet.fromSet(contextSet);
-    }
-
-    /**
-     * Creates a new empty ImmutableContextSet.
-     *
-     * @return a new ImmutableContextSet
-     */
-    @Nonnull
-    static ImmutableContextSet empty() {
-        return ImmutableContextSet.empty();
-    }
-
-    /**
-     * Gets if this set is in an immutable form
-     *
-     * @return true if the set is immutable
-     */
-    boolean isImmutable();
-
-    /**
-     * If the set is mutable, this method will return an immutable copy. Otherwise just returns itself.
-     *
-     * @return an immutable ContextSet
-     */
-    @Nonnull
-    ImmutableContextSet makeImmutable();
-
-    /**
-     * Creates a mutable copy of this set.
-     *
-     * @return a mutable ContextSet
-     * @since 2.16
-     */
-    @Nonnull
-    MutableContextSet mutableCopy();
-
-    /**
-     * Converts this ContextSet to an immutable {@link Set} of {@link Map.Entry}s.
-     *
-     * @return an immutable set
-     */
-    @Nonnull
-    Set<Map.Entry<String, String>> toSet();
-
-    /**
-     * Converts this ContextSet to an immutable {@link Map}
-     *
-     * <b>IMPORTANT: Use of this method may result in data being lost. ContextSets can contain lots of different values for
-     * one key.</b>
-     *
-     * @return an immutable map
-     * @deprecated because the resultant map may not contain all data in the ContextSet
-     */
-    @Nonnull
-    @Deprecated
-    Map<String, String> toMap();
-
-    /**
-     * Converts this ContextSet to an immutable {@link Multimap}
-     *
-     * @return a multimap
-     * @since 2.16
-     */
-    @Nonnull
-    Multimap<String, String> toMultimap();
-
-    /**
-     * Check if the set contains at least one value for the given key.
-     *
-     * @param key the key to check for
-     * @return true if the set contains a value for the key
-     * @throws NullPointerException if the key is null
-     */
-    boolean containsKey(@Nonnull String key);
-
-    /**
-     * Gets a set of all of the values mapped to the given key
-     *
-     * @param key the key to find values for
-     * @return a set of values
-     * @throws NullPointerException if the key is null
-     */
-    @Nonnull
-    Set<String> getValues(@Nonnull String key);
-
-    /**
-     * Returns any value from this set matching the key, if present.
-     *
-     * @param key the key to find values for
-     * @return an optional containing any match
-     * @since 3.1
-     */
-    @Nonnull
-    default Optional<String> getAnyValue(@Nonnull String key) {
-        return getValues(key).stream().findAny();
-    }
-
-    /**
-     * Check if thr set contains a given key mapped to a given value
-     *
-     * @param key   the key to look for
-     * @param value the value to look for (case sensitive)
-     * @return true if the set contains the KV pair
-     * @throws NullPointerException if the key or value is null
-     */
-    boolean has(@Nonnull String key, @Nonnull String value);
-
-    /**
-     * Check if thr set contains a given key mapped to a given value
-     *
-     * @param entry the entry to look for
-     * @return true if the set contains the KV pair
-     * @throws NullPointerException if the key or value is null
-     * @since 3.4
-     */
-    default boolean has(@Nonnull Map.Entry<String, String> entry) {
-        Preconditions.checkNotNull(entry, "entry");
-        return has(entry.getKey(), entry.getValue());
-    }
-
-    /**
-     * Same as {@link #has(String, String)}, except ignores the case of the value.
-     *
-     * @param key   the key to look for
-     * @param value the value to look for
-     * @return true if the set contains the KV pair
-     * @throws NullPointerException if the key or value is null
-     */
-    boolean hasIgnoreCase(@Nonnull String key, @Nonnull String value);
-
-    /**
-     * Same as {@link #has(Map.Entry)}, except ignores the case of the value.
-     *
-     * @param entry the entry to look for
-     * @return true if the set contains the KV pair
-     * @throws NullPointerException if the key or value is null
-     * @since 3.4
-     */
-    default boolean hasIgnoreCase(@Nonnull Map.Entry<String, String> entry) {
-        Preconditions.checkNotNull(entry, "entry");
-        return hasIgnoreCase(entry.getKey(), entry.getValue());
-    }
-
-    /**
-     * Checks to see if all entries in this context set are also included in another set.
-     *
-     * @param other the other set to check
-     * @return true if all entries in this set are also in the other set
-     * @since 3.1
-     */
-    default boolean isSatisfiedBy(@Nonnull ContextSet other) {
-        return isSatisfiedBy(other, true);
-    }
-
-    /**
-     * Checks to see if all entries in this context set are also included in another set.
-     *
-     * @param other the other set to check
-     * @param caseSensitive if the lookup should be case sensitive. see {@link #has(Map.Entry)} and {@link #hasIgnoreCase(Map.Entry)}.
-     * @return true if all entries in this set are also in the other set
-     * @since 3.4
-     */
-    default boolean isSatisfiedBy(@Nonnull ContextSet other, boolean caseSensitive) {
-        Preconditions.checkNotNull(other, "other");
-        if (this.isEmpty()) {
-            // this is empty, so is therefore always satisfied.
-            return true;
-        } else if (other.isEmpty()) {
-            // this set isn't empty, but the other one is
-            return false;
-        } else if (this.size() > other.size()) {
-            // this set has more unique entries than the other set, so there's no way this can be satisfied.
-            return false;
-        } else {
-            // neither are empty, we need to compare the individual entries
-            for (Map.Entry<String, String> pair : toSet()) {
-                if (caseSensitive) {
-                    if (!other.has(pair)) {
-                        return false;
-                    }
-                } else {
-                    if (!other.hasIgnoreCase(pair)) {
-                        return false;
-                    }
-                }
-            }
-
-            return true;
-        }
-    }
-
-    /**
-     * Check if the set is empty
-     *
-     * @return true if the set is empty
-     */
-    boolean isEmpty();
-
-    /**
-     * Gets the number of key-value context pairs in the set
-     *
-     * @return the size of the set
-     */
-    int size();
-
-}

api/src/main/java/me/lucko/luckperms/api/context/ImmutableContextSet.java

@@ -1,274 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api.context;
-
-import com.google.common.collect.ImmutableMap;
-import com.google.common.collect.ImmutableSet;
-import com.google.common.collect.ImmutableSetMultimap;
-import com.google.common.collect.Multimap;
-
-import java.util.Collection;
-import java.util.Map;
-import java.util.Set;
-
-import javax.annotation.Nonnull;
-
-import static com.google.common.base.Preconditions.checkNotNull;
-
-/**
- * An immutable implementation of {@link ContextSet}.
- *
- * <p>On construction, all keys/values are {@link String#intern()}ed, in order to increase
- * comparison speed.</p>
- *
- * @since 2.16
- */
-public final class ImmutableContextSet implements ContextSet {
-    private static final ImmutableContextSet EMPTY = new ImmutableContextSet(ImmutableSetMultimap.of());
-
-    /**
-     * Creates an ImmutableContextSet from a context pair
-     *
-     * @param key   the key
-     * @param value the value
-     * @return a new ImmutableContextSet containing one KV pair
-     * @throws NullPointerException if key or value is null
-     */
-    @Nonnull
-    public static ImmutableContextSet singleton(@Nonnull String key, @Nonnull String value) {
-        return new ImmutableContextSet(ImmutableSetMultimap.of(
-                checkNotNull(key, "key").toLowerCase().intern(),
-                checkNotNull(value, "value").intern()
-        ));
-    }
-
-    /**
-     * Creates an ImmutableContextSet from two context pairs
-     *
-     * @param key1 the first key
-     * @param value1 the first value
-     * @param key2 the second key
-     * @param value2 the second value
-     * @return a new ImmutableContextSet containing the two pairs
-     * @throws NullPointerException if any of the keys or values are null
-     * @since 3.1
-     */
-    @Nonnull
-    public static ImmutableContextSet of(@Nonnull String key1, @Nonnull String value1, @Nonnull String key2, @Nonnull String value2) {
-        return new ImmutableContextSet(ImmutableSetMultimap.of(
-                checkNotNull(key1, "key1").toLowerCase().intern(),
-                checkNotNull(value1, "value1").intern(),
-                checkNotNull(key2, "key2").toLowerCase().intern(),
-                checkNotNull(value2, "value2").intern()
-        ));
-    }
-
-    /**
-     * Creates an ImmutableContextSet from an existing iterable of Map Entries
-     *
-     * @param iterable the iterable to copy from
-     * @return a new ImmutableContextSet representing the pairs in the iterable
-     * @throws NullPointerException if the iterable is null
-     */
-    @Nonnull
-    public static ImmutableContextSet fromEntries(@Nonnull Iterable<? extends Map.Entry<String, String>> iterable) {
-        checkNotNull(iterable, "iterable");
-
-        ImmutableSetMultimap.Builder<String, String> b = ImmutableSetMultimap.builder();
-        for (Map.Entry<String, String> e : iterable) {
-            b.put(checkNotNull(e.getKey()).toLowerCase().intern(), checkNotNull(e.getValue()).intern());
-        }
-
-        return new ImmutableContextSet(b.build());
-    }
-
-    /**
-     * Creates an ImmutableContextSet from an existing map
-     *
-     * @param map the map to copy from
-     * @return a new ImmutableContextSet representing the pairs from the map
-     * @throws NullPointerException if the map is null
-     */
-    @Nonnull
-    public static ImmutableContextSet fromMap(@Nonnull Map<String, String> map) {
-        return fromEntries(checkNotNull(map, "map").entrySet());
-    }
-
-    /**
-     * Creates an ImmutableContextSet from an existing multimap
-     *
-     * @param multimap the multimap to copy from
-     * @return a new ImmutableContextSet representing the pairs in the multimap
-     * @throws NullPointerException if the multimap is null
-     */
-    @Nonnull
-    public static ImmutableContextSet fromMultimap(@Nonnull Multimap<String, String> multimap) {
-        return fromEntries(checkNotNull(multimap, "multimap").entries());
-    }
-
-    /**
-     * Creates a new ImmutableContextSet from an existing set.
-     * Only really useful for converting between mutable and immutable types.
-     *
-     * @param contextSet the context set to copy from
-     * @return a new ImmutableContextSet with the same content and the one provided
-     * @throws NullPointerException if contextSet is null
-     */
-    @Nonnull
-    public static ImmutableContextSet fromSet(@Nonnull ContextSet contextSet) {
-        return checkNotNull(contextSet, "contextSet").makeImmutable();
-    }
-
-    /**
-     * Creates an new empty ContextSet.
-     *
-     * @return a new ContextSet
-     */
-    @Nonnull
-    public static ImmutableContextSet empty() {
-        return EMPTY;
-    }
-
-    private final ImmutableSetMultimap<String, String> map;
-
-    ImmutableContextSet(ImmutableSetMultimap<String, String> contexts) {
-        this.map = contexts;
-    }
-
-    @Override
-    public boolean isImmutable() {
-        return true;
-    }
-
-    @Override
-    @Deprecated // This set is already immutable!
-    @Nonnull
-    public ImmutableContextSet makeImmutable() {
-        return this;
-    }
-
-    @Override
-    @Nonnull
-    public MutableContextSet mutableCopy() {
-        return MutableContextSet.fromSet(this);
-    }
-
-    @Override
-    @Nonnull
-    public Set<Map.Entry<String, String>> toSet() {
-        return map.entries();
-    }
-
-    @Override
-    @Nonnull
-    public Map<String, String> toMap() {
-        ImmutableMap.Builder<String, String> m = ImmutableMap.builder();
-        for (Map.Entry<String, String> e : map.entries()) {
-            m.put(e.getKey(), e.getValue());
-        }
-
-        return m.build();
-    }
-
-    @Override
-    @Nonnull
-    public Multimap<String, String> toMultimap() {
-        return map;
-    }
-
-    @Override
-    @Nonnull
-    public boolean containsKey(@Nonnull String key) {
-        return map.containsKey(checkNotNull(key, "key").toLowerCase().intern());
-    }
-
-    @Override
-    @Nonnull
-    public Set<String> getValues(@Nonnull String key) {
-        Collection<String> values = map.get(checkNotNull(key, "key").toLowerCase().intern());
-        return values != null ? ImmutableSet.copyOf(values) : ImmutableSet.of();
-    }
-
-    @Override
-    @Nonnull
-    public boolean has(@Nonnull String key, @Nonnull String value) {
-        return map.containsEntry(checkNotNull(key, "key").toLowerCase().intern(), checkNotNull(value, "value").intern());
-    }
-
-    @Override
-    @Nonnull
-    public boolean hasIgnoreCase(@Nonnull String key, @Nonnull String value) {
-        value = checkNotNull(value, "value").intern();
-        Collection<String> values = map.get(checkNotNull(key, "key").toLowerCase().intern());
-
-        if (values == null || values.isEmpty()) {
-            return false;
-        }
-
-        for (String val : values) {
-            if (val.equalsIgnoreCase(value)) {
-                return true;
-            }
-        }
-        return false;
-    }
-
-    @Override
-    public boolean isEmpty() {
-        return map.isEmpty();
-    }
-
-    @Override
-    public int size() {
-        return map.size();
-    }
-
-    @Override
-    public boolean equals(Object o) {
-        if (o == this) return true;
-        if (!(o instanceof ContextSet)) return false;
-        final ContextSet other = (ContextSet) o;
-
-        // saves on copying the multimap
-        if (other instanceof MutableContextSet) {
-            return other.equals(this);
-        }
-
-        final Multimap<String, String> thisContexts = this.toMultimap();
-        final Multimap<String, String> otherContexts = other.toMultimap();
-        return thisContexts.equals(otherContexts);
-    }
-
-    @Override
-    public int hashCode() {
-        return map.hashCode();
-    }
-
-    @Override
-    public String toString() {
-        return "ImmutableContextSet(contexts=" + this.map + ")";
-    }
-}

api/src/main/java/me/lucko/luckperms/api/context/MutableContextSet.java

@@ -1,407 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api.context;
-
-import com.google.common.base.Preconditions;
-import com.google.common.collect.HashMultimap;
-import com.google.common.collect.ImmutableMap;
-import com.google.common.collect.ImmutableSet;
-import com.google.common.collect.ImmutableSetMultimap;
-import com.google.common.collect.Multimap;
-import com.google.common.collect.Multimaps;
-import com.google.common.collect.SetMultimap;
-
-import java.util.Collection;
-import java.util.Map;
-import java.util.Set;
-
-import javax.annotation.Nonnull;
-
-import static com.google.common.base.Preconditions.checkNotNull;
-
-/**
- * A mutable implementation of {@link ContextSet}.
- *
- * <p>On construction, all keys/values are {@link String#intern()}ed, in order to increase
- * comparison speed.</p>
- *
- * @since 2.16
- */
-public final class MutableContextSet implements ContextSet {
-
-    /**
-     * Make a singleton MutableContextSet from a context pair
-     *
-     * @param key   the key
-     * @param value the value
-     * @return a new MutableContextSet containing one KV pair
-     * @throws NullPointerException if key or value is null
-     */
-    @Nonnull
-    public static MutableContextSet singleton(@Nonnull String key, @Nonnull String value) {
-        checkNotNull(key, "key");
-        checkNotNull(value, "value");
-        MutableContextSet set = MutableContextSet.create();
-        set.add(key, value);
-        return set;
-    }
-
-    /**
-     * Makes a MutableContextSet from two context pairs
-     *
-     * @param key1 the first key
-     * @param value1 the first value
-     * @param key2 the second key
-     * @param value2 the second value
-     * @return a new MutableContextSet containing the two pairs
-     * @throws NullPointerException if any of the keys or values are null
-     * @since 3.1
-     */
-    @Nonnull
-    public static MutableContextSet of(@Nonnull String key1, @Nonnull String value1, @Nonnull String key2, @Nonnull String value2) {
-        checkNotNull(key1, "key1");
-        checkNotNull(value1, "value1");
-        checkNotNull(key2, "key2");
-        checkNotNull(value2, "value2");
-        MutableContextSet set = MutableContextSet.create();
-        set.add(key1, value1);
-        set.add(key2, value2);
-        return set;
-    }
-
-    /**
-     * Creates a MutableContextSet from an existing iterable of Map Entries
-     *
-     * @param iterable the iterable to copy from
-     * @return a new MutableContextSet representing the pairs in the iterable
-     * @throws NullPointerException if the iterable is null
-     */
-    @Nonnull
-    public static MutableContextSet fromEntries(@Nonnull Iterable<? extends Map.Entry<String, String>> iterable) {
-        checkNotNull(iterable, "iterable");
-        MutableContextSet set = MutableContextSet.create();
-        set.addAll(iterable);
-        return set;
-    }
-
-    /**
-     * Creates a MutableContextSet from an existing map
-     *
-     * @param map the map to copy from
-     * @return a new MutableContextSet representing the pairs from the map
-     * @throws NullPointerException if the map is null
-     */
-    @Nonnull
-    public static MutableContextSet fromMap(@Nonnull Map<String, String> map) {
-        checkNotNull(map, "map");
-        MutableContextSet set = MutableContextSet.create();
-        set.addAll(map);
-        return set;
-    }
-
-    /**
-     * Creates a MutableContextSet from an existing multimap
-     *
-     * @param multimap the multimap to copy from
-     * @return a new MutableContextSet representing the pairs in the multimap
-     * @throws NullPointerException if the multimap is null
-     */
-    @Nonnull
-    public static MutableContextSet fromMultimap(@Nonnull Multimap<String, String> multimap) {
-        checkNotNull(multimap, "multimap");
-        MutableContextSet set = MutableContextSet.create();
-        set.addAll(multimap);
-        return set;
-    }
-
-    /**
-     * Creates a new MutableContextSet from an existing set.
-     * Only really useful for converting between mutable and immutable types.
-     *
-     * @param contextSet the context set to copy from
-     * @return a new MutableContextSet with the same content and the one provided
-     * @throws NullPointerException if contextSet is null
-     */
-    @Nonnull
-    public static MutableContextSet fromSet(@Nonnull ContextSet contextSet) {
-        Preconditions.checkNotNull(contextSet, "contextSet");
-        MutableContextSet set = new MutableContextSet();
-        set.addAll(contextSet.toSet());
-        return set;
-    }
-
-    /**
-     * Creates a new empty MutableContextSet.
-     *
-     * @return a new MutableContextSet
-     */
-    @Nonnull
-    public static MutableContextSet create() {
-        return new MutableContextSet();
-    }
-
-    private final SetMultimap<String, String> map;
-
-    public MutableContextSet() {
-        this.map = Multimaps.synchronizedSetMultimap(HashMultimap.create());
-    }
-
-    private MutableContextSet(MutableContextSet other) {
-        this.map = Multimaps.synchronizedSetMultimap(HashMultimap.create(other.map));
-    }
-
-    @Override
-    public boolean isImmutable() {
-        return false;
-    }
-
-    @Nonnull
-    @Override
-    public ImmutableContextSet makeImmutable() {
-        return new ImmutableContextSet(ImmutableSetMultimap.copyOf(map));
-    }
-
-    @Nonnull
-    @Override
-    public MutableContextSet mutableCopy() {
-        return new MutableContextSet(this);
-    }
-
-    @Nonnull
-    @Override
-    public Set<Map.Entry<String, String>> toSet() {
-        return ImmutableSet.copyOf(map.entries());
-    }
-
-    @Nonnull
-    @Override
-    public Map<String, String> toMap() {
-        ImmutableMap.Builder<String, String> m = ImmutableMap.builder();
-        for (Map.Entry<String, String> e : map.entries()) {
-            m.put(e.getKey(), e.getValue());
-        }
-
-        return m.build();
-    }
-
-    @Nonnull
-    @Override
-    public Multimap<String, String> toMultimap() {
-        return ImmutableSetMultimap.copyOf(map);
-    }
-
-    @Nonnull
-    @Override
-    public boolean containsKey(@Nonnull String key) {
-        return map.containsKey(checkNotNull(key, "key").toLowerCase().intern());
-    }
-
-    @Nonnull
-    @Override
-    public Set<String> getValues(@Nonnull String key) {
-        Collection<String> values = map.get(checkNotNull(key, "key").toLowerCase().intern());
-        return values != null ? ImmutableSet.copyOf(values) : ImmutableSet.of();
-    }
-
-    @Nonnull
-    @Override
-    public boolean has(@Nonnull String key, @Nonnull String value) {
-        return map.containsEntry(checkNotNull(key, "key").toLowerCase().intern(), checkNotNull(value, "value").intern());
-    }
-
-    @Nonnull
-    @Override
-    public boolean hasIgnoreCase(@Nonnull String key, @Nonnull String value) {
-        value = checkNotNull(value, "value").intern();
-        Collection<String> values = map.get(checkNotNull(key, "key").toLowerCase().intern());
-
-        if (values == null || values.isEmpty()) {
-            return false;
-        }
-
-        for (String val : values) {
-            if (val.equalsIgnoreCase(value)) {
-                return true;
-            }
-        }
-        return false;
-    }
-
-    @Override
-    public boolean isEmpty() {
-        return map.isEmpty();
-    }
-
-    @Override
-    public int size() {
-        return map.size();
-    }
-
-    /**
-     * Adds a new key value pair to the set
-     *
-     * @param key   the key to add
-     * @param value the value to add
-     * @throws NullPointerException if the key or value is null
-     */
-    public void add(@Nonnull String key, @Nonnull String value) {
-        map.put(checkNotNull(key, "key").toLowerCase().intern(), checkNotNull(value, "value").intern());
-    }
-
-    /**
-     * Adds a new key value pair to the set
-     *
-     * @param entry the entry to add
-     * @throws NullPointerException if the entry is null
-     */
-    public void add(@Nonnull Map.Entry<String, String> entry) {
-        checkNotNull(entry, "entry");
-        add(entry.getKey(), entry.getValue());
-    }
-
-    /**
-     * Adds an iterable containing contexts to the set
-     *
-     * @param iterable an iterable of key value context pairs
-     * @throws NullPointerException if iterable is null
-     */
-    public void addAll(@Nonnull Iterable<? extends Map.Entry<String, String>> iterable) {
-        for (Map.Entry<String, String> e : checkNotNull(iterable, "iterable")) {
-            add(e);
-        }
-    }
-
-    /**
-     * Adds the entry set of a map to the set
-     *
-     * @param map the map to add from
-     * @throws NullPointerException if the map is null
-     */
-    public void addAll(@Nonnull Map<String, String> map) {
-        addAll(checkNotNull(map, "map").entrySet());
-    }
-
-    /**
-     * Adds the entries of a multimap to the set
-     *
-     * @param multimap the multimap to add from
-     * @throws NullPointerException if the map is null
-     * @since 3.4
-     */
-    public void addAll(@Nonnull Multimap<String, String> multimap) {
-        addAll(checkNotNull(multimap, "multimap").entries());
-    }
-
-    /**
-     * Adds of of the values in another ContextSet to this set
-     *
-     * @param contextSet the set to add from
-     * @throws NullPointerException if the contextSet is null
-     */
-    public void addAll(@Nonnull ContextSet contextSet) {
-        checkNotNull(contextSet, "contextSet");
-        if (contextSet instanceof MutableContextSet) {
-            MutableContextSet other = ((MutableContextSet) contextSet);
-            this.map.putAll(other.map);
-        } else {
-            addAll(contextSet.toMultimap());
-        }
-    }
-
-    /**
-     * Remove a key value pair from this set
-     *
-     * @param key   the key to remove
-     * @param value the value to remove (case sensitive)
-     * @throws NullPointerException if the key or value is null
-     */
-    public void remove(@Nonnull String key, @Nonnull String value) {
-        String k = checkNotNull(key, "key").toLowerCase().intern();
-        String v = checkNotNull(value, "value").intern();
-
-        //noinspection StringEquality
-        map.entries().removeIf(entry -> entry.getKey() == k && entry.getValue() == v);
-    }
-
-    /**
-     * Same as {@link #remove(String, String)}, except ignores the case of the value
-     *
-     * @param key   the key to remove
-     * @param value the value to remove
-     * @throws NullPointerException if the key or value is null
-     */
-    public void removeIgnoreCase(@Nonnull String key, @Nonnull String value) {
-        String k = checkNotNull(key, "key").toLowerCase().intern();
-        String v = checkNotNull(value, "value").intern();
-
-        //noinspection StringEquality
-        map.entries().removeIf(e -> e.getKey() == k && e.getValue().equalsIgnoreCase(v));
-    }
-
-    /**
-     * Removes all pairs with the given key
-     *
-     * @param key the key to remove
-     * @throws NullPointerException if the key is null
-     */
-    public void removeAll(@Nonnull String key) {
-        map.removeAll(checkNotNull(key, "key").toLowerCase());
-    }
-
-    /**
-     * Clears the set
-     */
-    public void clear() {
-        map.clear();
-    }
-
-    @Override
-    public boolean equals(Object o) {
-        if (o == this) return true;
-        if (!(o instanceof ContextSet)) return false;
-        final ContextSet other = (ContextSet) o;
-
-        final Multimap<String, String> otherContexts;
-
-        if (other instanceof MutableContextSet) {
-            otherContexts = ((MutableContextSet) other).map;
-        } else {
-            otherContexts = other.toMultimap();
-        }
-
-        return this.map.equals(otherContexts);
-    }
-
-    @Override
-    public int hashCode() {
-        return map.hashCode();
-    }
-
-    @Override
-    public String toString() {
-        return "MutableContextSet(contexts=" + this.map + ")";
-    }
-}

api/src/main/java/me/lucko/luckperms/api/event/EventBus.java

@@ -1,61 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.api.event;
-
-import java.util.Set;
-import java.util.function.Consumer;
-
-import javax.annotation.Nonnull;
-
-/**
- * The LuckPerms event bus. Used for subscribing (or registering listeners) to events.
- *
- * @since 3.0
- */
-public interface EventBus {
-
-    /**
-     * Subscribe to an event
-     *
-     * @param eventClass the event class
-     * @param handler    the event handler
-     * @param <T>        the event class
-     * @return an event handler instance representing this subscription
-     */
-    @Nonnull
-    <T extends LuckPermsEvent> EventHandler<T> subscribe(@Nonnull Class<T> eventClass, @Nonnull Consumer<T> handler);
-
-    /**
-     * Gets a set of all registered handlers for a given event
-     *
-     * @param eventClass the event to find handlers for
-     * @param <T>        the event class
-     * @return an immutable set of event handlers
-     */
-    @Nonnull
-    <T extends LuckPermsEvent> Set<EventHandler<T>> getHandlers(@Nonnull Class<T> eventClass);
-
-}

api/src/main/java/me/lucko/luckperms/exceptions/ObjectAlreadyHasException.java

@@ -1,40 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.exceptions;
-
-/**
- * Thrown when an object already has something.
- *
- * <p>For example, when:</p>
- * <p></p>
- * <ul>
- *     <li>a permission holding object already has a permission</li>
- *     <li>a permission holding object is already a member of a group</li>
- *     <li>a track already contains a group</li>
- * </ul>
- */
-public class ObjectAlreadyHasException extends MembershipException {
-}

api/src/main/java/me/lucko/luckperms/exceptions/ObjectLacksException.java

@@ -1,40 +0,0 @@
-/*
- * This file is part of LuckPerms, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package me.lucko.luckperms.exceptions;
-
-/**
- * Thrown when an object lacks something.
- *
- * <p>For example, when:</p>
- * <p></p>
- * <ul>
- *     <li>a permission holding object doesn't have a permission</li>
- *     <li>a permission holding object isn't already a member of a group</li>
- *     <li>a track doesn't contain a group</li>
- * </ul>
- */
-public class ObjectLacksException extends MembershipException {
-}

api/src/main/java/net/luckperms/api/LuckPerms.java

@@ -0,0 +1,259 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api;
+
+import net.luckperms.api.actionlog.ActionLogger;
+import net.luckperms.api.context.ContextCalculator;
+import net.luckperms.api.context.ContextManager;
+import net.luckperms.api.event.EventBus;
+import net.luckperms.api.messaging.MessagingService;
+import net.luckperms.api.messenger.MessengerProvider;
+import net.luckperms.api.metastacking.MetaStackDefinition;
+import net.luckperms.api.metastacking.MetaStackElement;
+import net.luckperms.api.metastacking.MetaStackFactory;
+import net.luckperms.api.model.group.Group;
+import net.luckperms.api.model.group.GroupManager;
+import net.luckperms.api.model.user.User;
+import net.luckperms.api.model.user.UserManager;
+import net.luckperms.api.node.NodeBuilderRegistry;
+import net.luckperms.api.node.matcher.NodeMatcherFactory;
+import net.luckperms.api.platform.Platform;
+import net.luckperms.api.platform.PlayerAdapter;
+import net.luckperms.api.platform.PluginMetadata;
+import net.luckperms.api.query.QueryOptionsRegistry;
+import net.luckperms.api.track.Track;
+import net.luckperms.api.track.TrackManager;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.ApiStatus.Internal;
+
+import java.util.Optional;
+import java.util.concurrent.CompletableFuture;
+
+/**
+ * The LuckPerms API.
+ *
+ * <p>The API allows other plugins on the server to read and modify LuckPerms
+ * data, change behaviour of the plugin, listen to certain events, and integrate
+ * LuckPerms into other plugins and systems.</p>
+ *
+ * <p>This interface represents the base of the API package. All functions are
+ * accessed via this interface.</p>
+ *
+ * <p>To start using the API, you need to obtain an instance of this interface.
+ * These are registered by the LuckPerms plugin to the platforms Services
+ * Manager. This is the preferred method for obtaining an instance.</p>
+ *
+ * <p>For ease of use, and for platforms without a Service Manager, an instance
+ * can also be obtained from the static singleton accessor in
+ * {@link LuckPermsProvider}.</p>
+ */
+public interface LuckPerms {
+
+    /**
+     * Gets the name of this server.
+     *
+     * <p>This is defined in the LuckPerms configuration file, and is used for
+     * server specific permission handling.</p>
+     *
+     * <p>The default server name is "global".</p>
+     *
+     * @return the server name
+     */
+    @NonNull String getServerName();
+
+    /**
+     * Gets the {@link UserManager}, responsible for managing
+     * {@link User} instances.
+     *
+     * <p>This manager can be used to retrieve instances of {@link User} by uuid
+     * or name, or query all loaded users.</p>
+     *
+     * @return the user manager
+     */
+    @NonNull UserManager getUserManager();
+
+    /**
+     * Gets the {@link GroupManager}, responsible for managing
+     * {@link Group} instances.
+     *
+     * <p>This manager can be used to retrieve instances of {@link Group} by
+     * name, or query all loaded groups.</p>
+     *
+     * @return the group manager
+     */
+    @NonNull GroupManager getGroupManager();
+
+    /**
+     * Gets the {@link TrackManager}, responsible for managing
+     * {@link Track} instances.
+     *
+     * <p>This manager can be used to retrieve instances of {@link Track} by
+     * name, or query all loaded tracks.</p>
+     *
+     * @return the track manager
+     */
+    @NonNull TrackManager getTrackManager();
+
+    /**
+     * Gets the {@link PlayerAdapter} instance, a utility class for adapting platform Player
+     * instances to {@link User}s.
+     *
+     * <p>The {@code playerClass} parameter must be equal to the class or interface used by the
+     * server platform to represent players.</p>
+     *
+     * <p>Specifically:</p>
+     *
+     * <p></p>
+     * <ul>
+     * <li>{@code org.bukkit.entity.Player}</li>
+     * <li>{@code net.md_5.bungee.api.connection.ProxiedPlayer}</li>
+     * <li>{@code org.spongepowered.api/entity.living.player.Player}</li>
+     * <li>{@code net.minecraft.server.network.ServerPlayerEntity} (Fabric)</li>
+     * <li>{@code cn.nukkit.Player}</li>
+     * <li>{@code com.velocitypowered.api.proxy.Player}</li>
+     * </ul>
+     *
+     * @param playerClass the class used by the platform to represent players
+     * @param <T> the player class type
+     * @return the player adapter
+     * @throws IllegalArgumentException if the player class is not correct
+     * @since 5.1
+     */
+    <T> @NonNull PlayerAdapter<T> getPlayerAdapter(@NonNull Class<T> playerClass);
+
+    /**
+     * Gets the {@link Platform}, which represents the server platform the
+     * plugin is running on.
+     *
+     * @return the platform
+     */
+    @NonNull Platform getPlatform();
+
+    /**
+     * Gets the {@link PluginMetadata}, responsible for providing metadata about
+     * the LuckPerms plugin currently running.
+     *
+     * @return the plugin metadata
+     */
+    @NonNull PluginMetadata getPluginMetadata();
+
+    /**
+     * Gets the {@link EventBus}, used for subscribing to internal LuckPerms
+     * events.
+     *
+     * @return the event bus
+     */
+    @NonNull EventBus getEventBus();
+
+    /**
+     * Gets the {@link MessagingService}, used to dispatch updates throughout a
+     * network of servers running the plugin.
+     *
+     * <p>Not all instances of LuckPerms will have a messaging service setup and
+     * configured.</p>
+     *
+     * @return the messaging service instance, if present.
+     */
+    @NonNull Optional<MessagingService> getMessagingService();
+
+    /**
+     * Gets the {@link ActionLogger}, responsible for saving and broadcasting
+     * defined actions occurring on the platform.
+     *
+     * @return the action logger
+     */
+    @NonNull ActionLogger getActionLogger();
+
+    /**
+     * Gets the {@link ContextManager}, responsible for managing
+     * {@link ContextCalculator}s, and calculating applicable contexts.
+     *
+     * @return the context manager
+     */
+    @NonNull ContextManager getContextManager();
+
+    /**
+     * Gets the {@link MetaStackFactory}.
+     *
+     * <p>The metastack factory provides methods for retrieving
+     * {@link MetaStackElement}s and constructing
+     * {@link MetaStackDefinition}s.</p>
+     *
+     * @return the meta stack factory
+     */
+    @NonNull MetaStackFactory getMetaStackFactory();
+
+    /**
+     * Schedules the execution of an update task, and returns an encapsulation
+     * of the task as a {@link CompletableFuture}.
+     *
+     * <p>The exact actions performed in an update task remains an
+     * implementation detail of the plugin, however, as a minimum, it is
+     * expected to perform a full reload of user, group and track data, and
+     * ensure that any changes are fully applied and propagated.</p>
+     *
+     * @return a future
+     */
+    @NonNull CompletableFuture<Void> runUpdateTask();
+
+    /**
+     * Registers a {@link MessengerProvider} for use by the platform.
+     *
+     * <p>Note that the mere action of registering a provider doesn't
+     * necessarily mean that it will be used.</p>
+     *
+     * @param messengerProvider the messenger provider.
+     */
+    void registerMessengerProvider(@NonNull MessengerProvider messengerProvider);
+
+    /**
+     * Gets the {@link NodeBuilderRegistry}.
+     *
+     * @return the node builder registry
+     */
+    @Internal
+    @NonNull NodeBuilderRegistry getNodeBuilderRegistry();
+
+    /**
+     * Gets the {@link QueryOptionsRegistry}.
+     *
+     * @return the query options registry
+     * @since 5.1
+     */
+    @Internal
+    @NonNull QueryOptionsRegistry getQueryOptionsRegistry();
+
+    /**
+     * Gets the {@link NodeMatcherFactory}.
+     *
+     * @return the node matcher factory
+     * @since 5.1
+     */
+    @Internal
+    @NonNull NodeMatcherFactory getNodeMatcherFactory();
+
+}

api/src/main/java/net/luckperms/api/LuckPermsProvider.java

@@ -0,0 +1,89 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import static org.jetbrains.annotations.ApiStatus.Internal;
+
+/**
+ * Provides static access to the {@link LuckPerms} API.
+ *
+ * <p>Ideally, the ServiceManager for the platform should be used to obtain an
+ * instance, however, this provider can be used if this is not viable.</p>
+ */
+public final class LuckPermsProvider {
+    private static LuckPerms instance = null;
+
+    /**
+     * Gets an instance of the {@link LuckPerms} API,
+     * throwing {@link IllegalStateException} if the API is not loaded yet.
+     *
+     * <p>This method will never return null.</p>
+     *
+     * @return an instance of the LuckPerms API
+     * @throws IllegalStateException if the API is not loaded yet
+     */
+    public static @NonNull LuckPerms get() {
+        LuckPerms instance = LuckPermsProvider.instance;
+        if (instance == null) {
+            throw new NotLoadedException();
+        }
+        return instance;
+    }
+
+    @Internal
+    static void register(LuckPerms instance) {
+        LuckPermsProvider.instance = instance;
+    }
+
+    @Internal
+    static void unregister() {
+        LuckPermsProvider.instance = null;
+    }
+
+    @Internal
+    private LuckPermsProvider() {
+        throw new UnsupportedOperationException("This class cannot be instantiated.");
+    }
+
+    /**
+     * Exception thrown when the API is requested before it has been loaded.
+     */
+    private static final class NotLoadedException extends IllegalStateException {
+        private static final String MESSAGE = "The LuckPerms API isn't loaded yet!\n" +
+                "This could be because:\n" +
+                "  a) the LuckPerms plugin is not installed or it failed to enable\n" +
+                "  b) the plugin in the stacktrace does not declare a dependency on LuckPerms\n" +
+                "  c) the plugin in the stacktrace is retrieving the API before the plugin 'enable' phase\n" +
+                "     (call the #get method in onEnable, not the constructor!)\n";
+
+        NotLoadedException() {
+            super(MESSAGE);
+        }
+    }
+
+}

api/src/main/java/net/luckperms/api/actionlog/Action.java

@@ -0,0 +1,208 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.actionlog;
+
+import net.luckperms.api.LuckPermsProvider;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.checkerframework.checker.nullness.qual.Nullable;
+
+import java.time.Instant;
+import java.util.Optional;
+import java.util.UUID;
+
+/**
+ * Represents a logged action.
+ */
+public interface Action extends Comparable<Action> {
+
+    /**
+     * Gets a {@link Action.Builder}
+     *
+     * @return a new builder
+     */
+    static @NonNull Builder builder() {
+        return LuckPermsProvider.get().getActionLogger().actionBuilder();
+    }
+
+    /**
+     * Gets the time when the action occurred.
+     *
+     * @return the timestamp
+     */
+    @NonNull Instant getTimestamp();
+
+    /**
+     * Gets the source of the action.
+     *
+     * @return the source
+     */
+    @NonNull Source getSource();
+
+    /**
+     * Gets the target of the action.
+     *
+     * @return the target
+     */
+    @NonNull Target getTarget();
+
+    /**
+     * Returns a string describing the action which took place.
+     *
+     * <p>In most instances, this returns a variation of the command string which caused
+     * the change.</p>
+     *
+     * @return the action
+     */
+    @NonNull String getDescription();
+
+    /**
+     * Represents the source of an action.
+     */
+    interface Source {
+
+        /**
+         * Gets the source unique id.
+         *
+         * @return the source unique id
+         */
+        @NonNull UUID getUniqueId();
+
+        /**
+         * Gets the source name.
+         *
+         * @return the source name
+         */
+        @NonNull String getName();
+
+    }
+
+    /**
+     * Represents the target of an action.
+     */
+    interface Target {
+
+        /**
+         * Gets the target unique id.
+         *
+         * @return the target unique id
+         */
+        @NonNull Optional<UUID> getUniqueId();
+
+        /**
+         * Gets the target name.
+         *
+         * @return the target name
+         */
+        @NonNull String getName();
+
+        /**
+         * Gets the target type.
+         *
+         * @return the target type
+         */
+        @NonNull Type getType();
+
+        /**
+         * Represents the type of a {@link Target}.
+         */
+        enum Type {
+            USER, GROUP, TRACK
+        }
+    }
+
+    /**
+     * Builds an {@link Action} instance
+     */
+    interface Builder {
+
+        /**
+         * Sets the timestamp of the entry.
+         *
+         * @param timestamp the timestamp
+         * @return the builder
+         * @see Action#getTimestamp()
+         */
+        @NonNull Builder timestamp(@NonNull Instant timestamp);
+
+        /**
+         * Sets the actor of the entry.
+         *
+         * @param actor the actor
+         * @return the builder
+         */
+        @NonNull Builder source(@NonNull UUID actor);
+
+        /**
+         * Sets the actor name of the entry.
+         *
+         * @param actorName the actor name
+         * @return the builder
+         */
+        @NonNull Builder sourceName(@NonNull String actorName);
+
+        /**
+         * Sets the type of the entry.
+         *
+         * @param type the type
+         * @return the builder
+         */
+        @NonNull Builder targetType(Target.@NonNull Type type);
+
+        /**
+         * Sets the acted object for the entry.
+         *
+         * @param acted the acted object
+         * @return the builder
+         */
+        @NonNull Builder target(@Nullable UUID acted);
+
+        /**
+         * Sets the acted name for the entry.
+         *
+         * @param actedName the acted name
+         * @return the builder
+         */
+        @NonNull Builder targetName(@NonNull String actedName);
+
+        /**
+         * Sets the action of the entry.
+         *
+         * @param action the action
+         * @return the builder
+         */
+        @NonNull Builder description(@NonNull String action);
+
+        /**
+         * Creates a {@link Action} instance from the builder.
+         *
+         * @return a new log entry instance
+         */
+        @NonNull Action build();
+
+    }
+
+}

api/src/main/java/net/luckperms/api/actionlog/ActionLog.java

@@ -0,0 +1,85 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.actionlog;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.SortedSet;
+import java.util.UUID;
+
+/**
+ * Represents the internal LuckPerms log.
+ *
+ * <p>The returned instance provides a copy of the data at the time of retrieval.</p>
+ *
+ * <p>Any changes made to log entries will only apply to this instance of the log.
+ * You can add to the log using the {@link ActionLogger}, and then request an updated copy.</p>
+ *
+ * <p>All methods are thread safe, and return immutable and thread safe collections.</p>
+ */
+public interface ActionLog {
+
+    /**
+     * Gets the {@link Action}s that make up this log.
+     *
+     * @return the content
+     */
+    @NonNull @Unmodifiable SortedSet<Action> getContent();
+
+    /**
+     * Gets the entries in the log performed by the given actor.
+     *
+     * @param actor the uuid of the actor to filter by
+     * @return the content for the given actor
+     */
+    @NonNull @Unmodifiable SortedSet<Action> getContent(@NonNull UUID actor);
+
+    /**
+     * Gets the log content for a given user
+     *
+     * @param uniqueId the uuid to filter by
+     * @return all content in this log where the user = uuid
+     */
+    @NonNull @Unmodifiable SortedSet<Action> getUserHistory(@NonNull UUID uniqueId);
+
+    /**
+     * Gets the log content for a given group
+     *
+     * @param name the name to filter by
+     * @return all content in this log where the group = name
+     */
+    @NonNull @Unmodifiable SortedSet<Action> getGroupHistory(@NonNull String name);
+
+    /**
+     * Gets the log content for a given track
+     *
+     * @param name the name to filter by
+     * @return all content in this log where the track = name
+     */
+    @NonNull @Unmodifiable SortedSet<Action> getTrackHistory(@NonNull String name);
+
+}

api/src/main/java/net/luckperms/api/actionlog/ActionLogger.java

@@ -0,0 +1,90 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.actionlog;
+
+import net.luckperms.api.messaging.MessagingService;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import java.util.concurrent.CompletableFuture;
+
+/**
+ * Represents the object responsible for handling action logging.
+ */
+public interface ActionLogger {
+
+    /**
+     * Returns a new {@link Action.Builder} instance
+     *
+     * @return a new builder
+     */
+    Action.@NonNull Builder actionBuilder();
+
+    /**
+     * Gets a {@link ActionLog} instance from the plugin storage.
+     *
+     * @return a log instance
+     */
+    @NonNull CompletableFuture<ActionLog> getLog();
+
+    /**
+     * Submits a log entry to the plugin to be handled.
+     *
+     * <p>This method submits the log to the storage provider and broadcasts
+     * it.</p>
+     *
+     * <p>It is therefore roughly equivalent to calling
+     * {@link #submitToStorage(Action)} and {@link #broadcastAction(Action)},
+     * however, using this method is preferred to making the calls individually.</p>
+     *
+     * <p>If you want to submit a log entry but don't know which method to pick,
+     * use this one.</p>
+     *
+     * @param entry the entry to submit
+     * @return a future which will complete when the action is done
+     */
+    @NonNull CompletableFuture<Void> submit(@NonNull Action entry);
+
+    /**
+     * Submits a log entry to the plugins storage handler.
+     *
+     * @param entry the entry to submit
+     * @return a future which will complete when the action is done
+     */
+    @NonNull CompletableFuture<Void> submitToStorage(@NonNull Action entry);
+
+    /**
+     * Submits a log entry to the plugins log broadcasting handler.
+     *
+     * <p>If enabled, this method will also dispatch the log entry via the
+     * plugins {@link MessagingService}.</p>
+     *
+     * @param entry the entry to submit
+     * @return a future which will complete when the action is done
+     */
+    @NonNull CompletableFuture<Void> broadcastAction(@NonNull Action entry);
+
+}

api/src/main/java/net/luckperms/api/actionlog/package-info.java

@@ -23,10 +23,7 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.common.managers;
-
-import me.lucko.luckperms.common.model.Group;
-
-public interface GroupManager extends Manager<String, Group> {
-
-}
+/**
+ * {@link net.luckperms.api.actionlog.ActionLog} related functionality.
+ */
+package net.luckperms.api.actionlog;

api/src/main/java/net/luckperms/api/cacheddata/CachedData.java

@@ -0,0 +1,48 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.cacheddata;
+
+import net.luckperms.api.query.QueryOptions;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+/**
+ * Holds cached lookup data for a given set of query options.
+ *
+ * <p>All calls will account for inheritance, as well as any default data
+ * provided by the platform. These calls are heavily cached and are therefore
+ * fast.</p>
+ */
+public interface CachedData {
+
+    /**
+     * Gets the query options this container is holding data for.
+     *
+     * @return the query options this container is caching
+     */
+    @NonNull QueryOptions getQueryOptions();
+
+}

api/src/main/java/net/luckperms/api/cacheddata/CachedDataManager.java

@@ -0,0 +1,248 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.cacheddata;
+
+import net.luckperms.api.context.ContextManager;
+import net.luckperms.api.model.PermissionHolder;
+import net.luckperms.api.model.group.Group;
+import net.luckperms.api.model.user.User;
+import net.luckperms.api.query.QueryOptions;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import java.util.concurrent.CompletableFuture;
+
+/**
+ * Holds cached permission and meta lookup data for a {@link PermissionHolder}.
+ *
+ * <p>All calls will account for inheritance, as well as any default data
+ * provided by the platform. These calls are heavily cached and are therefore
+ * fast.</p>
+ */
+public interface CachedDataManager {
+
+    /**
+     * Gets the manager for {@link CachedPermissionData}.
+     *
+     * @return the permission data manager
+     */
+    @NonNull Container<CachedPermissionData> permissionData();
+
+    /**
+     * Gets the manager for {@link CachedMetaData}.
+     *
+     * @return the meta data manager
+     */
+    @NonNull Container<CachedMetaData> metaData();
+
+    /**
+     * Gets PermissionData from the cache, using the given query options.
+     *
+     * @param queryOptions the query options
+     * @return a permission data instance
+     */
+    @NonNull CachedPermissionData getPermissionData(@NonNull QueryOptions queryOptions);
+
+    /**
+     * Gets MetaData from the cache, using the given query options.
+     *
+     * @param queryOptions the query options
+     * @return a meta data instance
+     */
+    @NonNull CachedMetaData getMetaData(@NonNull QueryOptions queryOptions);
+
+    /**
+     * Gets PermissionData from the cache, using the most appropriate query options
+     * available at the time.
+     *
+     * <p>For {@link User}s, the most appropriate query options will be their
+     * {@link ContextManager#getQueryOptions(User) current active query options} if the
+     * corresponding player is online, and otherwise, will fallback to
+     * {@link ContextManager#getStaticQueryOptions() the current static query options}.</p>
+     *
+     * <p>For {@link Group}s, the most appropriate query options will always be
+     * {@link ContextManager#getStaticQueryOptions() the current static query options}.</p>
+     *
+     * @return a permission data instance
+     * @since 5.1
+     */
+    @NonNull CachedPermissionData getPermissionData();
+
+    /**
+     * Gets MetaData from the cache, using the most appropriate query options
+     * available at the time.
+     *
+     * <p>For {@link User}s, the most appropriate query options will be their
+     * {@link ContextManager#getQueryOptions(User) current active query options} if the
+     * corresponding player is online, and otherwise, will fallback to
+     * {@link ContextManager#getStaticQueryOptions() the current static query options}.</p>
+     *
+     * <p>For {@link Group}s, the most appropriate query options will always be
+     * {@link ContextManager#getStaticQueryOptions() the current static query options}.</p>
+     *
+     * @return a meta data instance
+     * @since 5.1
+     * @see PermissionHolder#getQueryOptions()
+     */
+    @NonNull CachedMetaData getMetaData();
+
+    /**
+     * Invalidates all cached {@link CachedPermissionData} and {@link CachedMetaData}
+     * instances.
+     */
+    void invalidate();
+
+    /**
+     * Invalidates all underlying permission calculators.
+     *
+     * <p>Can be called to allow for an update in defaults.</p>
+     */
+    void invalidatePermissionCalculators();
+
+    /**
+     * Manages a specific type of {@link CachedData cached data} within
+     * a {@link CachedDataManager} instance.
+     *
+     * @param <T> the data type
+     */
+    interface Container<T extends CachedData> {
+
+        /**
+         * Gets {@link T data} from the cache.
+         *
+         * @param queryOptions the query options
+         * @return a data instance
+         * @throws NullPointerException if contexts is null
+         */
+        @NonNull T get(@NonNull QueryOptions queryOptions);
+
+        /**
+         * Calculates {@link T data}, bypassing the cache.
+         *
+         * <p>The result of this operation is calculated each time the method is called.
+         * The result is not added to the internal cache.</p>
+         *
+         * <p>It is therefore highly recommended to use {@link #get(QueryOptions)} instead.</p>
+         *
+         * <p>The use cases of this method are more around constructing one-time
+         * instances of {@link T data}, without adding the result to the cache.</p>
+         *
+         * @param queryOptions the query options
+         * @return a data instance
+         * @throws NullPointerException if contexts is null
+         */
+        @NonNull T calculate(@NonNull QueryOptions queryOptions);
+
+        /**
+         * (Re)calculates data for a given context.
+         *
+         * <p>This method returns immediately in all cases. The (re)calculation is
+         * performed asynchronously and applied to the cache in the background.</p>
+         *
+         * <p>If there was a previous data instance associated with
+         * the given {@link QueryOptions}, then that instance will continue to be returned by
+         * {@link #get(QueryOptions)} until the recalculation is completed.</p>
+         *
+         * <p>If there was no value calculated and cached prior to the call of this
+         * method, then one will be calculated.</p>
+         *
+         * @param queryOptions the query options
+         * @throws NullPointerException if contexts is null
+         */
+        void recalculate(@NonNull QueryOptions queryOptions);
+
+        /**
+         * (Re)loads permission data for a given context.
+         *
+         * <p>Unlike {@link #recalculate(QueryOptions)}, this method immediately
+         * invalidates any previous data values contained within the cache,
+         * and then schedules a task to reload a new data instance to
+         * replace the one which was invalidated.</p>
+         *
+         * <p>The invalidation happens immediately during the execution of this method.
+         * The result of the re-computation encapsulated by the future.</p>
+         *
+         * <p>Subsequent calls to {@link #get(QueryOptions)} will block until
+         * the result of this operation is complete.</p>
+         *
+         * <p>If there was no value calculated and cached prior to the call of this
+         * method, then one will be calculated.</p>
+         *
+         * <p>This method returns a Future so users can optionally choose to wait
+         * until the recalculation has been performed.</p>
+         *
+         * @param queryOptions the query options.
+         * @return a future
+         * @throws NullPointerException if contexts is null
+         */
+        @NonNull CompletableFuture<? extends T> reload(@NonNull QueryOptions queryOptions);
+
+        /**
+         * Recalculates data for all known contexts.
+         *
+         * <p>This method returns immediately. The recalculation is performed
+         * asynchronously and applied to the cache in the background.</p>
+         *
+         * <p>The previous data instances will continue to be returned
+         * by {@link #get(QueryOptions)} until the recalculation is completed.</p>
+         */
+        void recalculate();
+
+        /**
+         * Reloads permission data for all known contexts.
+         *
+         * <p>Unlike {@link #recalculate()}, this method immediately
+         * invalidates all previous data values contained within the cache,
+         * and then schedules a task to reload new data instances to
+         * replace the ones which were invalidated.</p>
+         *
+         * <p>The invalidation happens immediately during the execution of this method.
+         * The result of the re-computation encapsulated by the future.</p>
+         *
+         * <p>Subsequent calls to {@link #get(QueryOptions)} will block until
+         * the result of this operation is complete.</p>
+         *
+         * <p>This method returns a Future so users can optionally choose to wait
+         * until the recalculation has been performed.</p>
+         *
+         * @return a future
+         */
+        @NonNull CompletableFuture<Void> reload();
+
+        /**
+         * Invalidates any cached data instances mapped to the given context.
+         *
+         * @param queryOptions the queryOptions to invalidate for
+         */
+        void invalidate(@NonNull QueryOptions queryOptions);
+
+        /**
+         * Invalidates all cached data instances.
+         */
+        void invalidate();
+    }
+
+}

api/src/main/java/net/luckperms/api/cacheddata/CachedMetaData.java

@@ -0,0 +1,231 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.cacheddata;
+
+import net.luckperms.api.metastacking.MetaStackDefinition;
+import net.luckperms.api.node.types.MetaNode;
+import net.luckperms.api.node.types.PrefixNode;
+import net.luckperms.api.node.types.SuffixNode;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.checkerframework.checker.nullness.qual.Nullable;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.SortedMap;
+import java.util.function.Function;
+
+/**
+ * Holds cached meta lookup data for a specific set of contexts.
+ * 
+ * <p>Meta data refers to {@link PrefixNode prefixes}, {@link SuffixNode suffixes} and
+ * {@link MetaNode meta (options)} held by a permission holder.</p>
+ *
+ * <p>All calls will account for inheritance, as well as any default data
+ * provided by the platform. These calls are heavily cached and are therefore
+ * fast.</p>
+ */
+public interface CachedMetaData extends CachedData {
+
+    /**
+     * Query a meta value for the given {@code key}.
+     * 
+     * <p>This method will always return a {@link Result}, but the
+     * {@link Result#result() inner result} {@link String} will be null if a value
+     * for the given key was not found.</p>
+     *
+     * @param key the key
+     * @return a result containing the value
+     * @since 5.4
+     */
+    @NonNull Result<String, MetaNode> queryMetaValue(@NonNull String key);
+
+    /**
+     * Gets a value for the given meta key.
+     * 
+     * <p>If no such meta value exists for the given key, {@code null} is returned.</p>
+     *
+     * @param key the key
+     * @return the value
+     */
+    default @Nullable String getMetaValue(@NonNull String key) {
+        return queryMetaValue(key).result();
+    }
+
+    /**
+     * Gets a value for the given meta key, and runs it through the given {@code transformer}.
+     *
+     * <p>If no such meta value exists, an {@link Optional#empty() empty optional} is returned.
+     * (the transformer will never be passed a null argument)</p>
+     *
+     * <p>The transformer is allowed to throw {@link IllegalArgumentException} or return null. This
+     * will also result in an {@link Optional#empty() empty optional} being returned.</p>
+     *
+     * <p>For example, to parse and return an integer meta value, use:</p>
+     * <p><blockquote><pre>
+     *     getMetaValue("my-int-val", Integer::parseInt).orElse(0);
+     * </pre></blockquote>
+     *
+     * @param key the key
+     * @param valueTransformer the transformer used to transform the value
+     * @param <T> the type of the transformed result
+     * @return the meta value
+     * @since 5.3
+     */
+    default <T> @NonNull Optional<T> getMetaValue(@NonNull String key, @NonNull Function<String, ? extends T> valueTransformer) {
+        return Optional.ofNullable(getMetaValue(key)).map(value -> {
+            try {
+                return valueTransformer.apply(value);
+            } catch (IllegalArgumentException e) {
+                return null;
+            }
+        });
+    }
+
+    /**
+     * Query for a prefix.
+     * 
+     * <p>This method uses the rules defined by the {@link #getPrefixStackDefinition() prefix stack}
+     * to produce a {@link String} output.</p>
+     * 
+     * <p>Assuming the default configuration is used, this will usually be the value of the
+     * holder's highest priority prefix node.</p>
+     * 
+     * <p>This method will always return a {@link Result}, but the
+     * {@link Result#result() inner result} {@link String} will be null if
+     * a the resultant prefix stack contained no elements.</p>
+     *
+     * @return a result containing the prefix
+     * @since 5.4
+     */
+    @NonNull Result<String, PrefixNode> queryPrefix();
+
+    /**
+     * Gets the prefix.
+     * 
+     * <p>This method uses the rules defined by the {@link #getPrefixStackDefinition() prefix stack}
+     * to produce a {@link String} output.</p>
+     * 
+     * <p>Assuming the default configuration is used, this will usually be the value of the
+     * holder's highest priority prefix node.</p>
+     * 
+     * <p>If the resultant prefix stack contained no elements, {@code null} is returned.</p>
+     *
+     * @return a prefix string, or null
+     */
+    default @Nullable String getPrefix() {
+        return queryPrefix().result();
+    }
+
+    /**
+     * Query for a suffix.
+     *
+     * <p>This method uses the rules defined by the {@link #getSuffixStackDefinition() suffix stack}
+     * to produce a {@link String} output.</p>
+     *
+     * <p>Assuming the default configuration is used, this will usually be the value of the
+     * holder's highest priority suffix node.</p>
+     *
+     * <p>This method will always return a {@link Result}, but the
+     * {@link Result#result() inner result} {@link String} will be null if
+     * a the resultant suffix stack contained no elements.</p>
+     *
+     * @return a result containing the suffix
+     * @since 5.4
+     */
+    @NonNull Result<String, SuffixNode> querySuffix();
+
+    /**
+     * Gets the suffix.
+     *
+     * <p>This method uses the rules defined by the {@link #getSuffixStackDefinition() suffix stack}
+     * to produce a {@link String} output.</p>
+     *
+     * <p>Assuming the default configuration is used, this will usually be the value of the
+     * holder's highest priority suffix node.</p>
+     *
+     * <p>If the resultant suffix stack contained no elements, {@code null} is returned.</p>
+     *
+     * @return a suffix string, or null
+     */
+    default @Nullable String getSuffix() {
+        return querySuffix().result();
+    }
+
+    /**
+     * Gets a map of all accumulated {@link MetaNode meta}.
+     *
+     * <p>Prefer using the {@link #getMetaValue(String)} method for querying values.</p>
+     *
+     * @return a map of meta
+     */
+    @NonNull @Unmodifiable Map<String, List<String>> getMeta();
+
+    /**
+     * Gets a sorted map of all accumulated {@link PrefixNode prefixes}.
+     *
+     * <p>Prefer using the {@link #getPrefix()} method for querying.</p>
+     *
+     * @return a sorted map of prefixes
+     */
+    @NonNull @Unmodifiable SortedMap<Integer, String> getPrefixes();
+
+    /**
+     * Gets a sorted map of all accumulated {@link SuffixNode suffixes}.
+     *
+     * <p>Prefer using the {@link #getSuffix()} method for querying.</p>
+     *
+     * @return a sorted map of suffixes
+     */
+    @NonNull @Unmodifiable SortedMap<Integer, String> getSuffixes();
+
+    /**
+     * Gets the name of the holders primary group.
+     *
+     * <p>Will return {@code null} for Group holder types.</p>
+     *
+     * @return the name of the primary group
+     * @since 5.1
+     */
+    @Nullable String getPrimaryGroup();
+
+    /**
+     * Gets the definition used for the prefix stack.
+     *
+     * @return the definition used for the prefix stack
+     */
+    @NonNull MetaStackDefinition getPrefixStackDefinition();
+
+    /**
+     * Gets the definition used for the suffix stack.
+     *
+     * @return the definition used for the suffix stack
+     */
+    @NonNull MetaStackDefinition getSuffixStackDefinition();
+
+}

api/src/main/java/net/luckperms/api/cacheddata/CachedPermissionData.java

@@ -0,0 +1,86 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.cacheddata;
+
+import net.luckperms.api.node.Node;
+import net.luckperms.api.util.Tristate;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.Map;
+
+/**
+ * Holds cached permission lookup data for a specific set of contexts.
+ *
+ * <p>All calls will account for inheritance, as well as any default data
+ * provided by the platform. These calls are heavily cached and are therefore
+ * fast.</p>
+ */
+public interface CachedPermissionData extends CachedData {
+
+    /**
+     * Performs a permission check for the given {@code permission} node.
+     *
+     * <p>This check is equivalent to the "hasPermission" method call on most platforms.
+     * You can use {@link Tristate#asBoolean()} if you need a truthy result.</p>
+     *
+     * @param permission the permission node
+     * @return a result containing the tristate
+     * @throws NullPointerException if permission is null
+     * @since 5.4
+     */
+    @NonNull Result<Tristate, Node> queryPermission(@NonNull String permission);
+
+    /**
+     * Performs a permission check for the given {@code permission} node.
+     *
+     * <p>This check is equivalent to the "hasPermission" method call on most platforms.
+     * You can use {@link Tristate#asBoolean()} if you need a truthy result.</p>
+     *
+     * @param permission the permission node
+     * @return a tristate result
+     * @throws NullPointerException if permission is null
+     */
+    default @NonNull Tristate checkPermission(@NonNull String permission) {
+        return queryPermission(permission).result();
+    }
+
+    /**
+     * Invalidates the underlying permission calculator cache.
+     *
+     * <p>Can be called to allow for an update in defaults.</p>
+     */
+    void invalidateCache();
+
+    /**
+     * Gets an immutable copy of the permission map backing the permission calculator
+     *
+     * @return an immutable set of permissions
+     */
+    @NonNull @Unmodifiable Map<String, Boolean> getPermissionMap();
+
+}

api/src/main/java/net/luckperms/api/cacheddata/Result.java

@@ -0,0 +1,82 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.cacheddata;
+
+import net.luckperms.api.node.Node;
+
+import org.checkerframework.checker.nullness.qual.Nullable;
+
+/**
+ * Represents the result of a cached data lookup.
+ *
+ * <p>You can find "the holder that has the node that caused this result"
+ * using the following code:</p>
+ * <p></p>
+ * <blockquote>
+ * <pre>
+ * public static {@link net.luckperms.api.model.PermissionHolder.Identifier} holderThatHasTheNodeThatCausedTheResult(Result&lt;?, ?&gt; result) {
+ *     {@link Node} node = result.node();
+ *     if (node == null) {
+ *         return null;
+ *     }
+ *     {@link net.luckperms.api.node.metadata.types.InheritanceOriginMetadata} origin = node.getMetadata(InheritanceOriginMetadata.KEY).orElse(null);
+ *     if (origin == null) {
+ *         return null;
+ *     }
+ *     return origin.getOrigin();
+ * }
+ * </pre>
+ *
+ * <p>Combined with the node itself, this is all the information needed to determine
+ * the root cause of the result.</p>
+ * </blockquote>
+ *
+ * <p>The nullability of {@link #result()} is purposely undefined to allow the
+ * flexibility for methods using {@link Result} to declare it. In general, if the {@code T} type
+ * has a nullable/undefined value, then the return of {@link #result()} will be non-null,
+ * and if not, it will be nullable.</p>
+ *
+ * @param <T> the result type
+ * @param <N> the node type
+ * @since 5.4
+ */
+public interface Result<T, N extends Node> {
+
+    /**
+     * Gets the underlying result.
+     *
+     * @return the underlying result
+     */
+    T result();
+
+    /**
+     * Gets the node that caused the result.
+     *
+     * @return the causing node
+     */
+    @Nullable N node();
+
+}

api/src/main/java/net/luckperms/api/cacheddata/package-info.java

@@ -0,0 +1,30 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Caches permission checks and meta lookups for {@link net.luckperms.api.model.user.User}s and
+ * {@link net.luckperms.api.model.group.Group}s.
+ */
+package net.luckperms.api.cacheddata;

api/src/main/java/net/luckperms/api/context/Context.java

@@ -0,0 +1,101 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.checkerframework.checker.nullness.qual.Nullable;
+
+/**
+ * Represents an individual context pair.
+ *
+ * <p>Context keys and values may not be null or empty. A key/value will be
+ * deemed empty if it's length is zero, or if it consists of only space
+ * characters.</p>
+ *
+ * @see ContextSet
+ */
+public interface Context {
+
+    /**
+     * Tests whether {@code key} is valid.
+     *
+     * <p>Context keys and values may not be null or empty. A key/value will be
+     * deemed empty if it's length is zero, or if it consists of only space
+     * characters.</p>
+     *
+     * <p>An exception is thrown when an invalid key is added to a {@link ContextSet}.</p>
+     *
+     * @param key the key to test
+     * @return true if valid, false otherwise.
+     * @since 5.1
+     */
+    static boolean isValidKey(@Nullable String key) {
+        if (key == null || key.isEmpty()) {
+            return false;
+        }
+
+        // look for a non-whitespace character
+        for (int i = 0, n = key.length(); i < n; i++) {
+            if (key.charAt(i) != ' ') {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Tests whether {@code value} is valid.
+     *
+     * <p>Context keys and values may not be null or empty. A key/value will be
+     * deemed empty if it's length is zero, or if it consists of only space
+     * characters.</p>
+     *
+     * <p>An exception is thrown when an invalid value is added to a {@link ContextSet}.</p>
+     *
+     * @param value the value to test
+     * @return true if valid, false otherwise.
+     * @since 5.1
+     */
+    static boolean isValidValue(@Nullable String value) {
+        return isValidKey(value); // the same for now...
+    }
+
+    /**
+     * Gets the context key.
+     *
+     * @return the key
+     */
+    @NonNull String getKey();
+
+    /**
+     * Gets the context value
+     *
+     * @return the value
+     */
+    @NonNull String getValue();
+
+}

api/src/main/java/net/luckperms/api/context/ContextCalculator.java

@@ -0,0 +1,110 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import java.util.Objects;
+import java.util.function.Function;
+
+/**
+ * Calculates the contexts applicable for a contextual subject.
+ *
+ * <p>Implementations of this interface should satisfy the following
+ * requirements:</p>
+ * <ul>
+ *     <li>Context lookups should be <i>fast</i>: lookup methods are likely to
+ *     be invoked frequently, and should therefore be fast to execute. If
+ *     determining the current contexts involves a particularly time consuming
+ *     lookup (database queries, network requests, etc), then such results
+ *     should be cached ahead of time.</li>
+ *
+ *     <li>Context lookups should be <i>thread-safe</i>: lookups will sometimes
+ *     be performed from "async" threads, and therefore should not access any
+ *     part of the server only safe for access from a sync context. If
+ *     necessary, such results should be determined ahead of time and stored in
+ *     a thread-safe collection for retrieval later.</li>
+ *
+ *     <li>Context lookups should <i>not query active contexts</i>: doing so is
+ *     likely to result in a stack overflow, or thread deadlock. Care should be
+ *     taken to avoid (indirect) calls to the same calculator.</li>
+ * </ul>
+ * <p></p>
+ *
+ * <p>Calculators should be registered using
+ * {@link ContextManager#registerCalculator(ContextCalculator)}.</p>
+ */
+@FunctionalInterface
+public interface ContextCalculator<T> {
+
+    /**
+     * Creates a new {@link ContextCalculator} that provides a single context.
+     *
+     * @param key the key of the context provided by the calculator
+     * @param valueFunction the function used to compute the corresponding value
+     *                      for each query. A context will not be "accumulated"
+     *                      if the value returned is null.
+     * @param <T> the contextual type
+     * @return the resultant calculator
+     */
+    static <T> @NonNull ContextCalculator<T> forSingleContext(@NonNull String key, @NonNull Function<T, String> valueFunction) {
+        Objects.requireNonNull(key, "key");
+        Objects.requireNonNull(valueFunction, "valueFunction");
+        return (target, consumer) -> {
+            String value = valueFunction.apply(target);
+            if (value != null) {
+                consumer.accept(key, value);
+            }
+        };
+    }
+
+    /**
+     * Submits any contexts this calculator determines to be applicable to
+     * the {@code target} contextual subject.
+     *
+     * <p>Care should be taken to ensure implementations of this method meet the
+     * general requirements for {@link ContextCalculator}, defined in the class
+     * doc.</p>
+     *
+     * @param target the target contextual subject for this operation
+     * @param consumer the {@link ContextConsumer} to submit contexts to
+     */
+    void calculate(@NonNull T target, @NonNull ContextConsumer consumer);
+
+    /**
+     * Gets a {@link ContextSet}, containing some/all of the contexts this
+     * calculator could potentially submit.
+     *
+     * <p>The result of this call is primarily intended on providing
+     * suggestions to end users when defining permissions.</p>
+     *
+     * @return a set of potential contexts
+     */
+    default @NonNull ContextSet estimatePotentialContexts() {
+        return ImmutableContextSet.empty();
+    }
+
+}

api/src/main/java/net/luckperms/api/context/ContextConsumer.java

@@ -23,34 +23,42 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.common.processors;
+package net.luckperms.api.context;
 
-import me.lucko.luckperms.api.Tristate;
-
-import java.util.Map;
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 /**
- * A processor within a {@link me.lucko.luckperms.common.calculators.PermissionCalculator}.
+ * Functional interface that accepts context key value pairs.
  */
-public interface PermissionProcessor {
+@FunctionalInterface
+public interface ContextConsumer {
 
     /**
-     * Returns the permission value determined by this calculator.
+     * Accepts a context pair.
      *
-     * @param permission the permission
-     * @return a tristate
+     * @param key the key
+     * @param value the value
      */
-    Tristate hasPermission(String permission);
+    void accept(@NonNull String key, @NonNull String value);
 
     /**
-     * Called each time the permission calculators backing is updated.
+     * Accepts a context pair.
      *
-     * <p>Note that the same map instance is passed to this method on each update,
-     * so, if no processing is needed on the backing map, this can be cached on
-     * the first invocation.</p>
-     *
-     * @param map the map
+     * @param context the context
      */
-    void updateBacking(Map<String, Boolean> map);
+    default void accept(@NonNull Context context) {
+        accept(context.getKey(), context.getValue());
+    }
+
+    /**
+     * Accepts a context set.
+     *
+     * @param contextSet the context set
+     */
+    default void accept(@NonNull ContextSet contextSet) {
+        for (Context entry : contextSet) {
+            accept(entry);
+        }
+    }
 
 }

api/src/main/java/net/luckperms/api/context/ContextManager.java

@@ -0,0 +1,175 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import net.luckperms.api.model.user.User;
+import net.luckperms.api.query.QueryMode;
+import net.luckperms.api.query.QueryOptions;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.ApiStatus.Internal;
+
+import java.util.Optional;
+
+/**
+ * Manages {@link ContextCalculator}s, and calculates applicable contexts for a
+ * given type.
+ *
+ * <p>This interface accepts {@link Object} types as a parameter to avoid having to depend
+ * on specific server implementations. In all cases, the "player" or "subject" type for
+ * the platform must be used.</p>
+ *
+ * <p>Specifically:</p>
+ *
+ * <p></p>
+ * <ul>
+ * <li>{@code org.bukkit.entity.Player}</li>
+ * <li>{@code net.md_5.bungee.api.connection.ProxiedPlayer}</li>
+ * <li>{@code org.spongepowered.api.service.permission.Subject}</li>
+ * <li>{@code net.minecraft.server.network.ServerPlayerEntity} (Fabric)</li>
+ * <li>{@code cn.nukkit.Player}</li>
+ * <li>{@code com.velocitypowered.api.proxy.Player}</li>
+ * </ul>
+ */
+public interface ContextManager {
+
+    /**
+     * Queries the ContextManager for current context values for the subject.
+     *
+     * @param subject the subject
+     * @return the applicable context for the subject
+     */
+    @NonNull ImmutableContextSet getContext(@NonNull Object subject);
+
+    /**
+     * Queries the ContextManager for current context values for the given User.
+     *
+     * <p>This will only return a value if the player corresponding to the
+     * {@link User} is online.</p>
+     *
+     * <p>If you need to obtain a {@link ImmutableContextSet} instance
+     * regardless, you should initially try this method, and then fallback on
+     * {@link #getStaticContext()}.</p>
+     *
+     * @param user the user
+     * @return the applicable context for the subject
+     */
+    @NonNull Optional<ImmutableContextSet> getContext(@NonNull User user);
+
+    /**
+     * Gets the contexts from the static calculators in this manager.
+     *
+     * <p>Static calculators provide the same context for all subjects, and are
+     * marked as such when registered.</p>
+     *
+     * @return the current active static contexts
+     */
+    @NonNull ImmutableContextSet getStaticContext();
+
+    /**
+     * Creates a new {@link QueryOptions.Builder}.
+     *
+     * @param mode the mode
+     * @return a new query options builder
+     */
+    QueryOptions.@NonNull Builder queryOptionsBuilder(@NonNull QueryMode mode);
+
+    /**
+     * Obtains current {@link QueryOptions} for the subject.
+     *
+     * @param subject the subject
+     * @return the query options for the subject
+     */
+    @NonNull QueryOptions getQueryOptions(@NonNull Object subject);
+
+    /**
+     * Obtains current {@link QueryOptions} for the given User.
+     *
+     * <p>This will only return a value if the player corresponding to the
+     * {@link User} is online.</p>
+     *
+     * <p>If you need to obtain a {@link QueryOptions} instance regardless, you should
+     * initially try this method, and then fallback on {@link #getStaticQueryOptions()}.</p>
+     *
+     * @param user the user
+     * @return the query options for the subject
+     */
+    @NonNull Optional<QueryOptions> getQueryOptions(@NonNull User user);
+
+    /**
+     * Gets the static query options, using the registered static context calculators.
+     *
+     * @return the current static query options
+     */
+    @NonNull QueryOptions getStaticQueryOptions();
+
+    /**
+     * Registers a context calculator with the manager.
+     *
+     * @param calculator the calculator
+     */
+    void registerCalculator(@NonNull ContextCalculator<?> calculator);
+
+    /**
+     * Unregisters a context calculator with the manager.
+     *
+     * @param calculator the calculator
+     */
+    void unregisterCalculator(@NonNull ContextCalculator<?> calculator);
+
+    /**
+     * Signal to the {@link ContextManager} that a {@code subject}s
+     * current contexts have changed.
+     *
+     * <p>It is not strictly necessary to make a call to this method every time a context
+     * changes.</p>
+     *
+     * @param subject the subject
+     * @since 5.2
+     */
+    void signalContextUpdate(@NonNull Object subject);
+
+    /**
+     * Gets the {@link ContextSetFactory}, responsible for creating
+     * {@link ContextSet} instances.
+     *
+     * @return the context set factory
+     */
+    @Internal
+    @NonNull ContextSetFactory getContextSetFactory();
+
+    /**
+     * Invalidates the lookup cache for a given subject
+     *
+     * @param subject the subject
+     * @deprecated Use {@link #signalContextUpdate(Object)} instead
+     */
+    @Deprecated
+    default void invalidateCache(@NonNull Object subject) {
+        signalContextUpdate(subject);
+    }
+
+}

api/src/main/java/net/luckperms/api/context/ContextSatisfyMode.java

@@ -0,0 +1,63 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import net.luckperms.api.query.OptionKey;
+
+/**
+ * Mode for determining whether a {@link ContextSet} satisfies another.
+ *
+ * @since 5.2
+ * @see ContextSet#isSatisfiedBy(ContextSet, ContextSatisfyMode)
+ */
+public enum ContextSatisfyMode {
+
+    /**
+     * Mode where a {@link ContextSet} A will be satisfied by another set B, if at least one of the
+     * key-value entries per key in A are also in B.
+     *
+     * <p>For example, given <code>A = {server=survival, world=overworld, world=nether}</code>,
+     * another set {@code X} will satisfy {@code A} if {@code X} contains
+     * <code>server=survival AND (world=overworld OR world=nether)</code>.</p>
+     */
+    AT_LEAST_ONE_VALUE_PER_KEY,
+
+    /**
+     * Mode where a {@link ContextSet} A will be satisfied by another set B, if all key-value
+     * entries in A are also in B.
+     *
+     * <p>For example, given <code>A = {server=survival, world=overworld, world=nether}</code>,
+     * another set {@code X} will satisfy {@code A} if {@code X} contains
+     * <code>server=survival AND world=overworld AND world=nether</code>.</p>
+     */
+    ALL_VALUES_PER_KEY;
+
+    /**
+     * The {@link OptionKey} for {@link ContextSatisfyMode}.
+     */
+    public static final OptionKey<ContextSatisfyMode> KEY = OptionKey.of("contextsatisfymode", ContextSatisfyMode.class);
+
+}

api/src/main/java/net/luckperms/api/context/ContextSet.java

@@ -0,0 +1,271 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.Iterator;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Optional;
+import java.util.Set;
+
+/**
+ * A set of contexts.
+ *
+ * <p>Context in the most basic sense simply means the circumstances where
+ * something will apply.</p>
+ *
+ * <p>A single "context" consists of a key and a value, both strings. The key
+ * describes the type of the context, and the value represents what the key is
+ * set to.</p>
+ *
+ * <p>For example, a context with {@code key=world} and {@code value=world_nether}
+ * describes that a subject is in the "world_nether" world.</p>
+ *
+ * <p>Contexts are exposed to end users and manipulated when managing permissions.
+ * For this reason, context keys should strike a balance between being descriptive
+ * and succinct.</p>
+ *
+ * <p>Context keys and values are case-insensitive, and will be automatically
+ * converted to {@link String#toLowerCase() lowercase} when added to a
+ * context set. Keys and values cannot be null or empty (len=0 or consisting of
+ * only whitespace).</p>
+ *
+ * <p>If a context key is formed of more than one word, the parts should be
+ * separated by the '{@code -}' character. (e.g. "{@code server-type}")</p>
+ *
+ * <p>If a context key is likely to conflict with another plugin, it should be
+ * appropriately namespaced using the name of the plugin providing the context.
+ * The namespace should be at the start of the context key, and separated using
+ * the '{@code :}' character. (e.g. "{@code worldguard:region}" for WorldGuard
+ * regions)</p>
+ *
+ * <p>Contexts can be combined with each other to form so called
+ * "context sets" - simply a collection of context pairs.</p>
+ *
+ * <p>Two default ContextSet implementations are provided.
+ * {@link MutableContextSet} allows the addition and removal of context keys
+ * after construction, and {@link ImmutableContextSet} does not.</p>
+ */
+public interface ContextSet extends Iterable<Context> {
+
+    /**
+     * Gets if this {@link ContextSet} is immutable.
+     *
+     * <p>The state of immutable instances will never change.</p>
+     *
+     * @return true if the set is immutable
+     */
+    boolean isImmutable();
+
+    /**
+     * Returns an immutable representation of this {@link ContextSet}.
+     *
+     * <p>If the set is already immutable, the same object will be returned.
+     * If the set is mutable, an immutable copy will be made.</p>
+     *
+     * @return an immutable representation of this set
+     */
+    @NonNull ImmutableContextSet immutableCopy();
+
+    /**
+     * Creates a mutable copy of this {@link ContextSet}.
+     *
+     * <p>A new copy is returned regardless of the
+     * {@link #isImmutable() mutability} of this set.</p>
+     *
+     * @return a mutable ContextSet
+     */
+    @NonNull MutableContextSet mutableCopy();
+
+    /**
+     * Returns a {@link Set} of {@link Context}s representing the current
+     * state of this {@link ContextSet}.
+     *
+     * <p>The returned set is immutable, and is a copy of the current set.
+     * (will not update live)</p>
+     *
+     * @return an immutable set
+     */
+    @NonNull @Unmodifiable Set<Context> toSet();
+
+    /**
+     * Returns a {@link Map} representing the current state of this
+     * {@link ContextSet}.
+     *
+     * <p>The returned set is immutable, and is a copy of the current set.
+     * (will not update live)</p>
+     *
+     * @return a map
+     */
+    @NonNull @Unmodifiable Map<String, Set<String>> toMap();
+
+    /**
+     * Returns a {@link Map} <b>loosely</b> representing the current state of
+     * this {@link ContextSet}.
+     *
+     * <p>The returned map is immutable, and is a copy of the current set.
+     * (will not update live)</p>
+     *
+     * <p>As a single context key can be mapped to multiple values, this method
+     * may not be a true representation of the set.</p>
+     *
+     * @return an immutable map
+     * @deprecated Deprecated because the returned map may not contain all data in the ContextSet
+     */
+    @Deprecated
+    @NonNull @Unmodifiable Map<String, String> toFlattenedMap();
+
+    /**
+     * Returns an {@link Iterator} over each of the context pairs in this set.
+     *
+     * <p>The returned iterator represents the state of the set at the time of creation. It is not
+     * updated as the set changes.</p>
+     *
+     * <p>The iterator does not support {@link Iterator#remove()} calls.</p>
+     *
+     * @return an iterator
+     */
+    @Override
+    @NonNull @Unmodifiable Iterator<Context> iterator();
+
+    /**
+     * Returns if the {@link ContextSet} contains at least one value for the
+     * given key.
+     *
+     * @param key the key to check for
+     * @return true if the set contains a value for the key
+     * @throws NullPointerException if the key is null
+     */
+    boolean containsKey(@NonNull String key);
+
+    /**
+     * Returns a {@link Set} of the values mapped to the given key.
+     *
+     * <p>The returned set is immutable, and only represents the current state
+     * of the {@link ContextSet}. (will not update live)</p>
+     *
+     * @param key the key to get values for
+     * @return a set of values
+     * @throws NullPointerException if the key is null
+     */
+    @NonNull @Unmodifiable Set<String> getValues(@NonNull String key);
+
+    /**
+     * Returns any value from this {@link ContextSet} matching the key, if present.
+     *
+     * <p>Note that context keys can be mapped to multiple values.
+     * Use {@link #getValues(String)} to retrieve all associated values.</p>
+     *
+     * @param key the key to find values for
+     * @return an optional containing any match
+     */
+    default @NonNull Optional<String> getAnyValue(@NonNull String key) {
+        return getValues(key).stream().findAny();
+    }
+
+    /**
+     * Returns if the {@link ContextSet} contains a given context pairing.
+     *
+     * @param key   the key to look for
+     * @param value the value to look for
+     * @return true if the set contains the context pair
+     * @throws NullPointerException if the key or value is null
+     */
+    boolean contains(@NonNull String key, @NonNull String value);
+
+    /**
+     * Returns if the {@link ContextSet} contains a given context pairing.
+     *
+     * @param entry the entry to look for
+     * @return true if the set contains the context pair
+     * @throws NullPointerException if the key or value is null
+     */
+    default boolean contains(@NonNull Context entry) {
+        Objects.requireNonNull(entry, "entry");
+        return contains(entry.getKey(), entry.getValue());
+    }
+
+    /**
+     * Returns if the {@link ContextSet} contains any of the given context pairings.
+     *
+     * @param key the key to look for
+     * @param values the values to look for
+     * @return true if the set contains any of the pairs
+     * @since 5.2
+     */
+    default boolean containsAny(@NonNull String key, @NonNull Iterable<String> values) {
+        Objects.requireNonNull(key, "key");
+        Objects.requireNonNull(values, "values");
+
+        for (String value : values) {
+            if (contains(key, value)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * Returns if this {@link ContextSet} is "satisfied" by another set.
+     *
+     * <p>{@link ContextSatisfyMode#AT_LEAST_ONE_VALUE_PER_KEY} is the mode used by this method.</p>
+     *
+     * @param other the other set
+     * @return true if this context set is satisfied by the other
+     */
+    default boolean isSatisfiedBy(@NonNull ContextSet other) {
+        return isSatisfiedBy(other, ContextSatisfyMode.AT_LEAST_ONE_VALUE_PER_KEY);
+    }
+
+    /**
+     * Returns if this {@link ContextSet} is "satisfied" by another set, according to the given
+     * {@code mode}.
+     *
+     * @param other the other set
+     * @param mode the mode to use
+     * @return true if this context set is satisfied by the other
+     * @since 5.2
+     */
+    boolean isSatisfiedBy(@NonNull ContextSet other, @NonNull ContextSatisfyMode mode);
+
+    /**
+     * Returns if the {@link ContextSet} is empty.
+     *
+     * @return true if the set is empty
+     */
+    boolean isEmpty();
+
+    /**
+     * Gets the number of context pairs in the {@link ContextSet}.
+     *
+     * @return the size of the set
+     */
+    int size();
+
+}

api/src/main/java/net/luckperms/api/context/ContextSetFactory.java

@@ -0,0 +1,74 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.ApiStatus.Internal;
+
+/**
+ * A factory for creating {@link ContextSet}s.
+ *
+ * <p>Prefer using the static methods on {@link ImmutableContextSet} or {@link MutableContextSet}
+ * instead of this interface.</p>
+ */
+@Internal
+public interface ContextSetFactory {
+
+    /**
+     * Prefer using {@link ImmutableContextSet#builder()}.
+     *
+     * @return a immutable context set builder
+     * @see ImmutableContextSet#builder()
+     */
+    ImmutableContextSet.@NonNull Builder immutableBuilder();
+
+    /**
+     * Prefer using {@link ImmutableContextSet#of(String, String)}.
+     *
+     * @param key the key
+     * @param value the value
+     * @return an immutable context set
+     * @see ImmutableContextSet#of(String, String)
+     */
+    @NonNull ImmutableContextSet immutableOf(@NonNull String key, @NonNull String value);
+
+    /**
+     * Prefer using {@link ImmutableContextSet#empty()}.
+     *
+     * @return an empty immutable context set
+     * @see ImmutableContextSet#empty()
+     */
+    @NonNull ImmutableContextSet immutableEmpty();
+
+    /**
+     * Prefer using {@link MutableContextSet#create()}.
+     *
+     * @return a new mutable context set
+     * @see MutableContextSet#create()
+     */
+    @NonNull MutableContextSet mutable();
+
+}

api/src/main/java/net/luckperms/api/context/DefaultContextKeys.java

@@ -23,47 +23,42 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.common.metastacking;
-
-import me.lucko.luckperms.api.LocalizedNode;
-import me.lucko.luckperms.api.metastacking.MetaStackElement;
-
-import java.util.Map;
-import java.util.Optional;
+package net.luckperms.api.context;
 
 /**
- * Represents a specific entry in a {@link MetaStack}.
- * An entry is basically a live/mutable version of a {@link MetaStackElement}.
+ * Some default context keys used by the plugin.
  */
-public interface MetaStackEntry {
+public final class DefaultContextKeys {
+    private DefaultContextKeys() {
+        throw new AssertionError();
+    }
 
     /**
-     * Gets the stack this entry belongs to.
-     *
-     * @return the parent stack
+     * The context key used to denote the name of the subjects server.
      */
-    MetaStack getParentStack();
+    public static final String SERVER_KEY = "server";
 
     /**
-     * Gets the element this entry was formed form
-     *
-     * @return the forming element
+     * The context key used to denote the name of the subjects world.
      */
-    MetaStackElement getElement();
+    public static final String WORLD_KEY = "world";
 
     /**
-     * Gets the value currently held by this entry.
+     * The context key used to denote the dimension type of the subjects world.
      *
-     * @return the entry
+     * <p>Possible values: overworld, the_nether, the_end</p>
+     *
+     * @since 5.3
      */
-    Optional<Map.Entry<Integer, String>> getCurrentValue();
+    public static final String DIMENSION_TYPE_KEY = "dimension-type";
 
     /**
-     * Accumulates a node to this entry
+     * The context key used to denote the subjects gamemode.
      *
-     * @param node the node to accumulate
-     * @return if the node was accepted
+     * <p>Possible values: survival, creative, adventure, spectator</p>
+     *
+     * @since 5.3
      */
-    boolean accumulateNode(LocalizedNode node);
+    public static final String GAMEMODE_KEY = "gamemode";
 
 }

api/src/main/java/net/luckperms/api/context/ImmutableContextSet.java

@@ -0,0 +1,139 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import net.luckperms.api.LuckPermsProvider;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import java.util.Objects;
+
+/**
+ * An immutable implementation of {@link ContextSet}.
+ */
+public interface ImmutableContextSet extends ContextSet {
+
+    /**
+     * Creates an {@link ImmutableContextSet.Builder}.
+     *
+     * @return a new ImmutableContextSet builder
+     */
+    static @NonNull Builder builder() {
+        return LuckPermsProvider.get().getContextManager().getContextSetFactory().immutableBuilder();
+    }
+
+    /**
+     * Returns an empty {@link ImmutableContextSet}.
+     *
+     * @return an empty ImmutableContextSet
+     */
+    static @NonNull ImmutableContextSet empty() {
+        return LuckPermsProvider.get().getContextManager().getContextSetFactory().immutableEmpty();
+    }
+
+    /**
+     * Creates an {@link ImmutableContextSet} from a context pair.
+     *
+     * @param key   the key
+     * @param value the value
+     * @return a new ImmutableContextSet containing one context pair
+     * @throws NullPointerException if key or value is null
+     */
+    static @NonNull ImmutableContextSet of(@NonNull String key, @NonNull String value) {
+        return LuckPermsProvider.get().getContextManager().getContextSetFactory().immutableOf(key, value);
+    }
+
+    /**
+     * @deprecated This context set is already immutable!
+     */
+    @Override
+    @Deprecated
+    @NonNull ImmutableContextSet immutableCopy();
+
+    /**
+     * A builder for {@link ImmutableContextSet}.
+     */
+    interface Builder {
+
+        /**
+         * Adds a context to the set.
+         *
+         * @param key   the key to add
+         * @param value the value to add
+         * @return the builder
+         * @throws NullPointerException if the key or value is null
+         * @see MutableContextSet#add(String, String)
+         */
+        @NonNull Builder add(@NonNull String key, @NonNull String value);
+
+        /**
+         * Adds a context to the set.
+         *
+         * @param entry the entry to add
+         * @return the builder
+         * @throws NullPointerException if the entry is null
+         * @see MutableContextSet#add(Context)
+         */
+        default @NonNull Builder add(@NonNull Context entry) {
+            Objects.requireNonNull(entry, "entry");
+            add(entry.getKey(), entry.getValue());
+            return this;
+        }
+
+        /**
+         * Adds the contexts contained in the given {@link Iterable} to the set.
+         *
+         * @param iterable an iterable of key value context pairs
+         * @return the builder
+         * @throws NullPointerException if iterable is null
+         * @see MutableContextSet#addAll(Iterable)
+         */
+        default @NonNull Builder addAll(@NonNull Iterable<Context> iterable) {
+            for (Context e : Objects.requireNonNull(iterable, "iterable")) {
+                add(e);
+            }
+            return this;
+        }
+
+        /**
+         * Adds all the contexts in another {@link ContextSet} to the set.
+         *
+         * @param contextSet the set to add from
+         * @return the builder
+         * @throws NullPointerException if the contextSet is null
+         * @see MutableContextSet#addAll(ContextSet)
+         */
+        @NonNull Builder addAll(@NonNull ContextSet contextSet);
+
+        /**
+         * Creates a {@link ImmutableContextSet} from the values previously
+         * added to the builder.
+         *
+         * @return an {@link ImmutableContextSet} from the builder
+         */
+        @NonNull ImmutableContextSet build();
+    }
+}

api/src/main/java/net/luckperms/api/context/MutableContextSet.java

@@ -0,0 +1,126 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import net.luckperms.api.LuckPermsProvider;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import java.util.Objects;
+
+/**
+ * A mutable implementation of {@link ContextSet}.
+ */
+public interface MutableContextSet extends ContextSet {
+
+    /**
+     * Creates a new empty MutableContextSet.
+     *
+     * @return a new MutableContextSet
+     */
+    static @NonNull MutableContextSet create() {
+        return LuckPermsProvider.get().getContextManager().getContextSetFactory().mutable();
+    }
+
+    /**
+     * Creates a {@link MutableContextSet} from a context pair.
+     *
+     * @param key   the key
+     * @param value the value
+     * @return a new MutableContextSet containing one context pair
+     * @throws NullPointerException if key or value is null
+     */
+    static @NonNull MutableContextSet of(@NonNull String key, @NonNull String value) {
+        Objects.requireNonNull(key, "key");
+        Objects.requireNonNull(value, "value");
+        MutableContextSet set = create();
+        set.add(key, value);
+        return set;
+    }
+
+    /**
+     * Adds a context to this set.
+     *
+     * @param key   the key to add
+     * @param value the value to add
+     * @throws NullPointerException if the key or value is null
+     */
+    void add(@NonNull String key, @NonNull String value);
+
+    /**
+     * Adds a context to this set.
+     *
+     * @param entry the entry to add
+     * @throws NullPointerException if the entry is null
+     */
+    default void add(@NonNull Context entry) {
+        Objects.requireNonNull(entry, "entry");
+        add(entry.getKey(), entry.getValue());
+    }
+
+    /**
+     * Adds the contexts contained in the given {@link Iterable} to this set.
+     *
+     * @param iterable an iterable of key value context pairs
+     * @throws NullPointerException if iterable is null
+     */
+    default void addAll(@NonNull Iterable<Context> iterable) {
+        for (Context e : Objects.requireNonNull(iterable, "iterable")) {
+            add(e);
+        }
+    }
+
+    /**
+     * Adds all the contexts in another {@link ContextSet} to this set.
+     *
+     * @param contextSet the set to add from
+     * @throws NullPointerException if the contextSet is null
+     */
+    void addAll(@NonNull ContextSet contextSet);
+
+    /**
+     * Removes a context from this set.
+     *
+     * @param key   the key to remove
+     * @param value the value to remove
+     * @throws NullPointerException if the key or value is null
+     */
+    void remove(@NonNull String key, @NonNull String value);
+
+    /**
+     * Removes all contexts from this set with the given key.
+     *
+     * @param key the key to remove
+     * @throws NullPointerException if the key is null
+     */
+    void removeAll(@NonNull String key);
+
+    /**
+     * Removes all contexts from the set.
+     */
+    void clear();
+
+}

api/src/main/java/net/luckperms/api/context/StaticContextCalculator.java

@@ -0,0 +1,75 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.context;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import java.util.Objects;
+import java.util.function.Supplier;
+
+/**
+ * Extension of {@link ContextCalculator} which provides the same context
+ * regardless of the subject.
+ */
+@FunctionalInterface
+public interface StaticContextCalculator extends ContextCalculator<Object> {
+
+    /**
+     * Creates a new {@link StaticContextCalculator} that provides a single context.
+     *
+     * @param key the key of the context provided by the calculator
+     * @param valueFunction the function used to compute the corresponding value
+     *                      for each query. A context will not be "accumulated"
+     *                      if the value returned is null.
+     * @return the resultant calculator
+     */
+    static StaticContextCalculator forSingleContext(String key, Supplier<String> valueFunction) {
+        Objects.requireNonNull(key, "key");
+        Objects.requireNonNull(valueFunction, "valueFunction");
+        return consumer -> {
+            String value = valueFunction.get();
+            if (value != null) {
+                consumer.accept(key, value);
+            }
+        };
+    }
+
+    /**
+     * Submits any contexts this calculator determines to be applicable.
+     *
+     * <p>Care should be taken to ensure implementations of this method meet the
+     * general requirements for {@link ContextCalculator}, defined in the class
+     * doc.</p>
+     *
+     * @param consumer the {@link ContextConsumer} to submit contexts to
+     */
+    void calculate(@NonNull ContextConsumer consumer);
+
+    @Override
+    default void calculate(@NonNull Object target, @NonNull ContextConsumer consumer) {
+        calculate(consumer);
+    }
+}

api/src/main/java/net/luckperms/api/context/package-info.java

@@ -0,0 +1,30 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Context functionality, including {@link net.luckperms.api.context.ContextSet}s and
+ * {@link net.luckperms.api.context.ContextCalculator}s.
+ */
+package net.luckperms.api.context;

api/src/main/java/net/luckperms/api/event/EventBus.java

@@ -0,0 +1,84 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.Set;
+import java.util.function.Consumer;
+
+/**
+ * The LuckPerms event bus.
+ *
+ * <p>Used to subscribe (or "listen") to LuckPerms events.</p>
+ */
+public interface EventBus {
+
+    /**
+     * Registers a new subscription to the given event.
+     *
+     * <p>The returned {@link EventSubscription} instance encapsulates the subscription state. It has
+     * methods which can be used to terminate the subscription, or view stats about the nature of
+     * the subscription.</p>
+     *
+     * @param eventClass the event class
+     * @param handler    the event handler
+     * @param <T>        the event class
+     * @return an event handler instance representing this subscription
+     */
+    <T extends LuckPermsEvent> @NonNull EventSubscription<T> subscribe(@NonNull Class<T> eventClass, @NonNull Consumer<? super T> handler);
+
+    /**
+     * Registers a new subscription to the given event.
+     *
+     * <p>The returned {@link EventSubscription} instance encapsulates the subscription state. It has
+     * methods which can be used to terminate the subscription, or view stats about the nature of
+     * the subscription.</p>
+     *
+     * <p>Unlike {@link #subscribe(Class, Consumer)}, this method accepts an additional parameter
+     * for {@code plugin}. This object must be a "plugin" instance on the platform, and is used to
+     * automatically {@link EventSubscription#close() unregister} the subscription when the
+     * corresponding plugin is disabled.</p>
+     *
+     * @param <T>        the event class
+     * @param plugin     a plugin instance to bind the subscription to.
+     * @param eventClass the event class
+     * @param handler    the event handler
+     * @return an event handler instance representing this subscription
+     */
+    <T extends LuckPermsEvent> @NonNull EventSubscription<T> subscribe(Object plugin, @NonNull Class<T> eventClass, @NonNull Consumer<? super T> handler);
+
+    /**
+     * Gets a set of all registered handlers for a given event.
+     *
+     * @param eventClass the event to find handlers for
+     * @param <T>        the event class
+     * @return an immutable set of event handlers
+     */
+    <T extends LuckPermsEvent> @NonNull @Unmodifiable Set<EventSubscription<T>> getSubscriptions(@NonNull Class<T> eventClass);
+
+}

api/src/main/java/net/luckperms/api/event/EventSubscription.java

@@ -23,26 +23,25 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event;
+package net.luckperms.api.event;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 import java.util.function.Consumer;
 
-import javax.annotation.Nonnull;
-
 /**
- * Represents a handler for a LuckPerms event
+ * Represents a subscription to a {@link LuckPermsEvent}.
  *
  * @param <T> the event class
  */
-public interface EventHandler<T extends LuckPermsEvent> {
+public interface EventSubscription<T extends LuckPermsEvent> extends AutoCloseable {
 
     /**
      * Gets the class this handler is listening to
      *
      * @return the event class
      */
-    @Nonnull
-    Class<T> getEventClass();
+    @NonNull Class<T> getEventClass();
 
     /**
      * Returns true if this handler is active
@@ -52,25 +51,15 @@ public interface EventHandler<T extends LuckPermsEvent> {
     boolean isActive();
 
     /**
-     * Unregisters this handler from the event bus
-     *
-     * @return true if the handler wasn't already unregistered
+     * Unregisters this handler from the event bus.
      */
-    boolean unregister();
+    @Override
+    void close();
 
     /**
      * Gets the event consumer responsible for handling the event
      *
      * @return the event consumer
      */
-    @Nonnull
-    Consumer<T> getConsumer();
-
-    /**
-     * Gets the number of times this handler has been called
-     *
-     * @return the number of times this handler has been called
-     */
-    int getCallCount();
-
+    @NonNull Consumer<? super T> getHandler();
 }

api/src/main/java/net/luckperms/api/event/LuckPermsEvent.java

@@ -23,16 +23,14 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event;
+package net.luckperms.api.event;
 
-import me.lucko.luckperms.api.LuckPermsApi;
+import net.luckperms.api.LuckPerms;
 
-import javax.annotation.Nonnull;
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 /**
- * The base event interface
- *
- * @since 3.0
+ * A superinterface for all LuckPerms events.
  */
 public interface LuckPermsEvent {
 
@@ -41,7 +39,13 @@ public interface LuckPermsEvent {
      *
      * @return the api instance
      */
-    @Nonnull
-    LuckPermsApi getApi();
+    @NonNull LuckPerms getLuckPerms();
+
+    /**
+     * Gets the type of the event.
+     *
+     * @return the type of the event
+     */
+    @NonNull Class<? extends LuckPermsEvent> getEventType();
 
 }

api/src/main/java/net/luckperms/api/event/cause/CreationCause.java

@@ -23,7 +23,7 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.cause;
+package net.luckperms.api.event.cause;
 
 /**
  * The cause of a group/track creation
@@ -35,6 +35,11 @@ public enum CreationCause {
      */
     COMMAND,
 
+    /**
+     * The creation was caused by the web editor
+     */
+    WEB_EDITOR,
+
     /**
      * The creation was caused by an API call
      */

api/src/main/java/net/luckperms/api/event/cause/DeletionCause.java

@@ -23,7 +23,7 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.cause;
+package net.luckperms.api.event.cause;
 
 /**
  * The cause of a group/track deletion
@@ -35,6 +35,12 @@ public enum DeletionCause {
      */
     COMMAND,
 
+    /**
+     * The deletion was caused by the web editor
+     * @since 5.3
+     */
+    WEB_EDITOR,
+
     /**
      * The deletion was caused by an API call
      */

api/src/main/java/net/luckperms/api/event/cause/package-info.java

@@ -0,0 +1,29 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Event causes.
+ */
+package net.luckperms.api.event.cause;

api/src/main/java/net/luckperms/api/event/context/ContextUpdateEvent.java

@@ -0,0 +1,76 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event.context;
+
+import net.luckperms.api.context.ContextManager;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import java.util.Optional;
+
+/**
+ * Called when a subject's current/active contexts are updated.
+ *
+ * <p>There are no guarantees that this event will be called for every update. It is merely to be
+ * used as a "hint" for plugins which depend on the current active contexts for a player.</p>
+ *
+ * <p>It will always be fired following a call to
+ * {@link ContextManager#signalContextUpdate(Object)}.</p>
+ *
+ * <p>The {@link #getSubject() subject} is always an instance of the platform's subject type. See
+ * {@link ContextManager} for details.</p>
+ *
+ * <p>Unlike most other LuckPerms events, this event is not fired asynchronously. Care should be
+ * taken to ensure listeners are lightweight. Additionally, listeners should ensure they do not
+ * cause further updates to player context, thus possibly causing a stack overflow.</p>
+ *
+ * @since 5.2
+ */
+public interface ContextUpdateEvent extends LuckPermsEvent {
+
+    /**
+     * Gets the subject whose contexts were updated.
+     *
+     * @return the subject
+     */
+    @Param(0)
+    @NonNull Object getSubject();
+
+    /**
+     * Gets the subject whose contexts were updated, casted to a given type.
+     *
+     * @param subjectClass the type to cast to
+     * @param <T> the subject type
+     * @return the casted subject
+     */
+    default <T> @NonNull Optional<T> getSubject(@NonNull Class<T> subjectClass) {
+        Object subject = getSubject();
+        return subjectClass.isInstance(subject) ? Optional.of(subjectClass.cast(subject)) : Optional.empty();
+    }
+
+}

api/src/main/java/net/luckperms/api/event/context/package-info.java

@@ -0,0 +1,29 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Events relating to {@link net.luckperms.api.context.Context}s.
+ */
+package net.luckperms.api.event.context;

api/src/main/java/net/luckperms/api/event/extension/ExtensionLoadEvent.java

@@ -0,0 +1,47 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event.extension;
+
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.extension.Extension;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+/**
+ * Called when an {@link Extension} is loaded.
+ */
+public interface ExtensionLoadEvent extends LuckPermsEvent {
+
+    /**
+     * Gets the extension that was loaded.
+     *
+     * @return the extension
+     */
+    @Param(0)
+    @NonNull Extension getExtension();
+
+}

api/src/main/java/net/luckperms/api/event/extension/package-info.java

@@ -0,0 +1,29 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Events relating to {@link net.luckperms.api.extension.Extension}s.
+ */
+package net.luckperms.api.event.extension;

api/src/main/java/net/luckperms/api/event/group/GroupCacheLoadEvent.java

@@ -0,0 +1,56 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event.group;
+
+import net.luckperms.api.cacheddata.CachedDataManager;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.model.group.Group;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+/**
+ * Called when a groups {@link CachedDataManager} is loaded.
+ */
+public interface GroupCacheLoadEvent extends LuckPermsEvent {
+
+    /**
+     * Gets the group whose data was loaded
+     *
+     * @return the group
+     */
+    @Param(0)
+    @NonNull Group getGroup();
+
+    /**
+     * Gets the data that was loaded
+     *
+     * @return the loaded data
+     */
+    @Param(1)
+    @NonNull CachedDataManager getLoadedData();
+
+}

api/src/main/java/net/luckperms/api/event/group/GroupCreateEvent.java

@@ -23,13 +23,14 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.group;
+package net.luckperms.api.event.group;
 
-import me.lucko.luckperms.api.Group;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
-import me.lucko.luckperms.api.event.cause.CreationCause;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.cause.CreationCause;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.model.group.Group;
 
-import javax.annotation.Nonnull;
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 /**
  * Called when a group is created
@@ -41,15 +42,15 @@ public interface GroupCreateEvent extends LuckPermsEvent {
      *
      * @return the new group
      */
-    @Nonnull
-    Group getGroup();
+    @Param(0)
+    @NonNull Group getGroup();
 
     /**
      * Gets the cause of the creation
      *
      * @return the cause of the creation
      */
-    @Nonnull
-    CreationCause getCause();
+    @Param(1)
+    @NonNull CreationCause getCause();
 
 }

api/src/main/java/net/luckperms/api/event/group/GroupDataRecalculateEvent.java

@@ -0,0 +1,56 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event.group;
+
+import net.luckperms.api.cacheddata.CachedDataManager;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.model.group.Group;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+/**
+ * Called when a groups cached data is refreshed
+ */
+public interface GroupDataRecalculateEvent extends LuckPermsEvent {
+
+    /**
+     * Gets the group whose data was recalculated
+     *
+     * @return the group
+     */
+    @Param(0)
+    @NonNull Group getGroup();
+
+    /**
+     * Gets the data that was recalculated
+     *
+     * @return the data
+     */
+    @Param(1)
+    @NonNull CachedDataManager getData();
+
+}

api/src/main/java/net/luckperms/api/event/group/GroupDeleteEvent.java

@@ -23,16 +23,17 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.group;
+package net.luckperms.api.event.group;
 
-import me.lucko.luckperms.api.Node;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
-import me.lucko.luckperms.api.event.cause.DeletionCause;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.cause.DeletionCause;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.node.Node;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 import java.util.Set;
 
-import javax.annotation.Nonnull;
-
 /**
  * Called when a group is deleted
  */
@@ -43,23 +44,23 @@ public interface GroupDeleteEvent extends LuckPermsEvent {
      *
      * @return the name of the deleted group
      */
-    @Nonnull
-    String getGroupName();
+    @Param(0)
+    @NonNull String getGroupName();
 
     /**
      * Gets an immutable copy of the groups existing data
      *
      * @return a copy of the groups existing data
      */
-    @Nonnull
-    Set<Node> getExistingData();
+    @Param(1)
+    @NonNull Set<Node> getExistingData();
 
     /**
      * Gets the cause of the deletion
      *
      * @return the cause of the deletion
      */
-    @Nonnull
-    DeletionCause getCause();
+    @Param(2)
+    @NonNull DeletionCause getCause();
 
 }

api/src/main/java/net/luckperms/api/event/group/GroupLoadAllEvent.java

@@ -23,9 +23,9 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.group;
+package net.luckperms.api.event.group;
 
-import me.lucko.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.LuckPermsEvent;
 
 /**
  * Called when all groups have been loaded in from storage.

api/src/main/java/net/luckperms/api/event/group/GroupLoadEvent.java

@@ -23,12 +23,13 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.group;
+package net.luckperms.api.event.group;
 
-import me.lucko.luckperms.api.Group;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.model.group.Group;
 
-import javax.annotation.Nonnull;
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 /**
  * Called when a group is loaded into memory from the storage.
@@ -42,7 +43,7 @@ public interface GroupLoadEvent extends LuckPermsEvent {
      *
      * @return the group that was loaded
      */
-    @Nonnull
-    Group getGroup();
+    @Param(0)
+    @NonNull Group getGroup();
 
 }

api/src/main/java/net/luckperms/api/event/group/package-info.java

@@ -0,0 +1,29 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Events relating to {@link net.luckperms.api.model.group.Group}s.
+ */
+package net.luckperms.api.event.group;

api/src/main/java/net/luckperms/api/event/log/LogBroadcastEvent.java

@@ -23,13 +23,14 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.log;
+package net.luckperms.api.event.log;
 
-import me.lucko.luckperms.api.LogEntry;
-import me.lucko.luckperms.api.event.Cancellable;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.actionlog.Action;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.type.Cancellable;
+import net.luckperms.api.event.util.Param;
 
-import javax.annotation.Nonnull;
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 /**
  * Called when a log entry is about to be sent to notifiable players on the platform
@@ -41,32 +42,34 @@ public interface LogBroadcastEvent extends LuckPermsEvent, Cancellable {
      *
      * @return the log entry to be broadcasted
      */
-    @Nonnull
-    LogEntry getEntry();
+    @Param(0)
+    @NonNull Action getEntry();
 
     /**
      * Gets where the log entry originated from.
      *
      * @return the origin of the log
-     * @since 3.3
      */
-    @Nonnull
-    Origin getOrigin();
+    @Param(1)
+    @NonNull Origin getOrigin();
 
     /**
      * Represents where a log entry is from
-     *
-     * @since 3.3
      */
     enum Origin {
 
         /**
-         * Represents a log entry which originated from the current server instance
+         * Marks a log entry which originated from the current server instance
          */
         LOCAL,
 
         /**
-         * Represents a log entry which was sent to this server via the messaging service
+         * Marks a log entry which originated from an API call on the current server instance
+         */
+        LOCAL_API,
+
+        /**
+         * Marks a log entry which was sent to this server via the messaging service
          */
         REMOTE
     }

api/src/main/java/net/luckperms/api/event/log/LogNetworkPublishEvent.java

@@ -23,20 +23,19 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.log;
+package net.luckperms.api.event.log;
 
-import me.lucko.luckperms.api.LogEntry;
-import me.lucko.luckperms.api.event.Cancellable;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.actionlog.Action;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.type.Cancellable;
+import net.luckperms.api.event.util.Param;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 import java.util.UUID;
 
-import javax.annotation.Nonnull;
-
 /**
  * Called when a log is about to be published to the network via the MessagingService
- *
- * @since 3.3
  */
 public interface LogNetworkPublishEvent extends LuckPermsEvent, Cancellable {
 
@@ -45,15 +44,15 @@ public interface LogNetworkPublishEvent extends LuckPermsEvent, Cancellable {
      *
      * @return the id of the log entry being published
      */
-    @Nonnull
-    UUID getLogId();
+    @Param(0)
+    @NonNull UUID getLogId();
 
     /**
      * Gets the log entry to be published
      *
      * @return the log entry to be published
      */
-    @Nonnull
-    LogEntry getEntry();
+    @Param(1)
+    @NonNull Action getEntry();
 
 }

api/src/main/java/net/luckperms/api/event/log/LogNotifyEvent.java

@@ -0,0 +1,91 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event.log;
+
+import net.luckperms.api.actionlog.Action;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.type.Cancellable;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.platform.PlatformEntity;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+/**
+ * Called when a log entry is about to be sent to specific notifiable object on
+ * the platform.
+ *
+ * <p>This event is not called for players without the notify permission,
+ * but is called for objects which are ignoring log notifications (called with
+ * the cancelled flag set to true).</p>
+ */
+public interface LogNotifyEvent extends LuckPermsEvent, Cancellable {
+
+    /**
+     * Gets the log entry to be sent
+     *
+     * @return the log entry to be sent
+     */
+    @Param(0)
+    @NonNull Action getEntry();
+
+    /**
+     * Gets where the log entry originated from.
+     *
+     * @return the origin of the log
+     */
+    @Param(1)
+    @NonNull Origin getOrigin();
+
+    /**
+     * Gets the object to be notified.
+     *
+     * @return the object to notify
+     */
+    @Param(2)
+    @NonNull PlatformEntity getNotifiable();
+
+    /**
+     * Represents where a log entry is from
+     */
+    enum Origin {
+
+        /**
+         * Marks a log entry which originated from the current server instance
+         */
+        LOCAL,
+
+        /**
+         * Marks a log entry which originated from an API call on the current server instance
+         */
+        LOCAL_API,
+
+        /**
+         * Marks a log entry which was sent to this server via the messaging service
+         */
+        REMOTE
+    }
+
+}

api/src/main/java/net/luckperms/api/event/log/LogPublishEvent.java

@@ -23,13 +23,14 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.log;
+package net.luckperms.api.event.log;
 
-import me.lucko.luckperms.api.LogEntry;
-import me.lucko.luckperms.api.event.Cancellable;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.actionlog.Action;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.type.Cancellable;
+import net.luckperms.api.event.util.Param;
 
-import javax.annotation.Nonnull;
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 /**
  * Called when a log is about to be published to the storage file/table
@@ -41,7 +42,7 @@ public interface LogPublishEvent extends LuckPermsEvent, Cancellable {
      *
      * @return the log entry to be published
      */
-    @Nonnull
-    LogEntry getEntry();
+    @Param(0)
+    @NonNull Action getEntry();
 
 }

api/src/main/java/net/luckperms/api/event/log/LogReceiveEvent.java

@@ -23,19 +23,18 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.log;
+package net.luckperms.api.event.log;
 
-import me.lucko.luckperms.api.LogEntry;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.actionlog.Action;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 import java.util.UUID;
 
-import javax.annotation.Nonnull;
-
 /**
  * Called when a log entry is received via the MessagingService
- *
- * @since 3.3
  */
 public interface LogReceiveEvent extends LuckPermsEvent {
 
@@ -44,15 +43,15 @@ public interface LogReceiveEvent extends LuckPermsEvent {
      *
      * @return the id of the log entry being received
      */
-    @Nonnull
-    UUID getLogId();
+    @Param(0)
+    @NonNull UUID getLogId();
 
     /**
      * Gets the log entry being received
      *
      * @return the log entry being received
      */
-    @Nonnull
-    LogEntry getEntry();
+    @Param(1)
+    @NonNull Action getEntry();
 
 }

api/src/main/java/net/luckperms/api/event/log/package-info.java

@@ -0,0 +1,29 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Events relating to the {@link net.luckperms.api.actionlog.ActionLog}.
+ */
+package net.luckperms.api.event.log;

api/src/main/java/net/luckperms/api/event/node/NodeAddEvent.java

@@ -23,25 +23,36 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.common.calculators;
+package net.luckperms.api.event.node;
 
-import com.google.common.collect.MapMaker;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.node.Node;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.Unmodifiable;
 
 import java.util.Collections;
+import java.util.HashSet;
 import java.util.Set;
 
-public abstract class AbstractCalculatorFactory implements CalculatorFactory {
-    private final Set<PermissionCalculator> calculators = Collections.newSetFromMap(new MapMaker().weakKeys().makeMap());
+/**
+ * Called when a node is added to a holder
+ */
+public interface NodeAddEvent extends NodeMutateEvent {
 
-    protected PermissionCalculator registerCalculator(PermissionCalculator calculator) {
-        calculators.add(calculator);
-        return calculator;
-    }
+    /**
+     * Gets the node that was added
+     *
+     * @return the node that was added
+     */
+    @Param(3)
+    @NonNull Node getNode();
 
     @Override
-    public void invalidateAll() {
-        for (PermissionCalculator calculator : calculators) {
-            calculator.invalidateCache();
-        }
+    default @NonNull @Unmodifiable Set<Node> getDataBefore() {
+        // Get data after, then reverse the action
+        Set<Node> nodes = new HashSet<>(this.getDataAfter());
+        nodes.remove(this.getNode());
+        return Collections.unmodifiableSet(nodes);
     }
 }

api/src/main/java/net/luckperms/api/event/node/NodeClearEvent.java

@@ -0,0 +1,59 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event.node;
+
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.node.Node;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Called when a holder has their nodes cleared
+ */
+public interface NodeClearEvent extends NodeMutateEvent {
+
+    /**
+     * Gets the nodes that were cleared
+     *
+     * @return the nodes that were removed
+     * @since 5.3
+     */
+    @Param(3)
+    @NonNull @Unmodifiable Set<Node> getNodes();
+
+    @Override
+    default @NonNull @Unmodifiable Set<Node> getDataBefore() {
+        // Get data after, then reverse the action
+        Set<Node> nodes = new HashSet<>(this.getDataAfter());
+        nodes.addAll(this.getNodes());
+        return Collections.unmodifiableSet(nodes);
+    }
+}

api/src/main/java/net/luckperms/api/event/node/NodeMutateEvent.java

@@ -23,16 +23,21 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.node;
+package net.luckperms.api.event.node;
 
-import me.lucko.luckperms.api.Node;
-import me.lucko.luckperms.api.PermissionHolder;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.model.PermissionHolder;
+import net.luckperms.api.model.data.DataType;
+import net.luckperms.api.model.group.Group;
+import net.luckperms.api.model.user.User;
+import net.luckperms.api.node.Node;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.Unmodifiable;
 
 import java.util.Set;
 
-import javax.annotation.Nonnull;
-
 /**
  * Called when a node is added to/removed from a user/group
  */
@@ -43,41 +48,52 @@ public interface NodeMutateEvent extends LuckPermsEvent {
      *
      * @return the event target
      */
-    @Nonnull
-    PermissionHolder getTarget();
+    @Param(0)
+    @NonNull PermissionHolder getTarget();
+
+    /**
+     * Gets the data type that was mutated.
+     *
+     * @return the data type
+     */
+    @Param(1)
+    @NonNull DataType getDataType();
 
     /**
      * Gets an immutable copy of the holders data before the change
      *
      * @return the data before the change
      */
-    @Nonnull
-    Set<Node> getDataBefore();
+    @NonNull @Unmodifiable Set<Node> getDataBefore();
 
     /**
      * Gets an immutable copy of the holders data after the change
      *
      * @return the data after the change
      */
-    @Nonnull
-    Set<Node> getDataAfter();
+    @Param(2)
+    @NonNull @Unmodifiable Set<Node> getDataAfter();
 
     /**
-     * Gets whether the target of this event is a {@link me.lucko.luckperms.api.User}
+     * Gets whether the target of this event is a {@link User}
      *
      * <p>This is equivalent to checking if getTarget() instanceof User</p>
      *
      * @return if the event is targeting a user
      */
-    boolean isUser();
+    default boolean isUser() {
+        return getTarget() instanceof User;
+    }
 
     /**
-     * Gets whether the target of this event is a {@link me.lucko.luckperms.api.Group}
+     * Gets whether the target of this event is a {@link Group}
      *
      * <p>This is equivalent to checking if getTarget() instanceof Group</p>
      *
      * @return if the event is targeting a group
      */
-    boolean isGroup();
+    default boolean isGroup() {
+        return getTarget() instanceof Group;
+    }
 
 }

api/src/main/java/net/luckperms/api/event/node/NodeRemoveEvent.java

@@ -0,0 +1,59 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event.node;
+
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.node.Node;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Called when a node is removed from a holder
+ */
+public interface NodeRemoveEvent extends NodeMutateEvent {
+
+    /**
+     * Gets the node that was removed
+     *
+     * @return the node that was removed
+     */
+    @Param(3)
+    @NonNull Node getNode();
+
+    @Override
+    default @NonNull @Unmodifiable Set<Node> getDataBefore() {
+        // Get data after, then reverse the action
+        Set<Node> nodes = new HashSet<>(this.getDataAfter());
+        nodes.add(this.getNode());
+        return Collections.unmodifiableSet(nodes);
+    }
+
+}

api/src/main/java/net/luckperms/api/event/node/package-info.java

@@ -0,0 +1,30 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Events relating to changes to a {@link net.luckperms.api.model.user.User} or
+ * {@link net.luckperms.api.model.group.Group}s {@link net.luckperms.api.model.data.NodeMap}.
+ */
+package net.luckperms.api.event.node;

api/src/main/java/net/luckperms/api/event/package-info.java

@@ -0,0 +1,29 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+/**
+ * Main events package.
+ */
+package net.luckperms.api.event;

api/src/main/java/net/luckperms/api/event/player/PlayerDataSaveEvent.java

@@ -23,44 +23,46 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.caching;
+package net.luckperms.api.event.player;
 
-import me.lucko.luckperms.api.Tristate;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.model.PlayerSaveResult;
+import net.luckperms.api.model.user.UserManager;
 
-import java.util.Map;
+import org.checkerframework.checker.nullness.qual.NonNull;
 
-import javax.annotation.Nonnull;
+import java.util.UUID;
 
 /**
- * Holds cached Permission lookup data for a specific set of contexts
+ * Called when player data is saved to the storage.
  *
- * @since 2.13
+ * <p>Data can be saved using {@link UserManager#savePlayerData(UUID, String)}.</p>
  */
-public interface PermissionData {
+public interface PlayerDataSaveEvent extends LuckPermsEvent {
 
     /**
-     * Gets a permission value for the given permission node
+     * Gets the unique ID that was saved.
      *
-     * @param permission the permission node
-     * @return a tristate result
-     * @throws NullPointerException if permission is null
+     * @return the uuid
      */
-    @Nonnull
-    Tristate getPermissionValue(@Nonnull String permission);
+    @Param(0)
+    @NonNull UUID getUniqueId();
 
     /**
-     * Invalidates the underlying permission calculator cache.
+     * Gets the username that was saved.
      *
-     * <p>Can be called to allow for an update in defaults.</p>
+     * @return the username
      */
-    void invalidateCache();
+    @Param(1)
+    @NonNull String getUsername();
 
     /**
-     * Gets an immutable copy of the permission map backing the permission calculator
+     * Gets the result of the operation.
      *
-     * @return an immutable set of permissions
+     * @return the result
      */
-    @Nonnull
-    Map<String, Boolean> getImmutableBacking();
+    @Param(2)
+    @NonNull PlayerSaveResult getResult();
 
 }

api/src/main/java/net/luckperms/api/event/player/PlayerLoginProcessEvent.java

@@ -23,50 +23,71 @@
  *  SOFTWARE.
  */
 
-package me.lucko.luckperms.api.event.user;
+package net.luckperms.api.event.player;
 
-import me.lucko.luckperms.api.User;
-import me.lucko.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.util.Param;
+import net.luckperms.api.model.user.User;
+import net.luckperms.api.util.Result;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.checkerframework.checker.nullness.qual.Nullable;
 
 import java.util.UUID;
 
-import javax.annotation.Nonnull;
-
 /**
- * Called when LuckPerms has finished processing a certain Player's connection.
+ * Called when LuckPerms has finished processing a Player's initial connection.
  *
- * <p>This event will always execute during the platforms async login/auth event.
- * All handlers will be called instantly.</p>
+ * <p>This event will always execute during the platforms async connection
+ * event. The LuckPerms platform listener processing the connection will block
+ * while this event is posted.</p>
  *
- * <p>This, among other things, allows you to wait until permission data is loaded
- * for a User during the BungeeCord 'LoginEvent', as event priorities are ignored
- * by the current implementation.</p>
+ * <p>This, among other things, allows you to wait until permission data is
+ * loaded for a User during the BungeeCord 'LoginEvent', as event priorities are
+ * ignored by the current implementation.</p>
  *
- * @since 3.4
+ * <p>The implementation will make an attempt to ensure this event is called
+ * for all connections, even if the operation to load User data was not
+ * successful. Note that LuckPerms will usually cancel the platform connection
+ * event if data could not be loaded.</p>
  */
-public interface UserLoginProcessEvent extends LuckPermsEvent {
+public interface PlayerLoginProcessEvent extends LuckPermsEvent, Result {
 
     /**
      * Gets the UUID of the connection which was processed
      *
      * @return the uuid of the connection which was processed
      */
-    @Nonnull
-    UUID getUuid();
+    @Param(0)
+    @NonNull UUID getUniqueId();
 
     /**
      * Gets the username of the connection which was processed
      *
      * @return the username of the connection which was processed
      */
-    @Nonnull
-    String getUsername();
+    @Param(1)
+    @NonNull String getUsername();
+
+    /**
+     * Gets if the login was processed successfully.
+     *
+     * @return true if the login was successful
+     */
+    @Override
+    default boolean wasSuccessful() {
+        return getUser() != null;
+    }
 
     /**
      * Gets the resultant User instance which was loaded.
      *
+     * <p>Returns {@code null} if the login was not processed
+     * {@link #wasSuccessful() successfully.}</p>
+     *
      * @return the user instance
      */
-    User getUser();
+    @Param(2)
+    @Nullable User getUser();
 
 }

api/src/main/java/net/luckperms/api/event/player/lookup/UniqueIdDetermineTypeEvent.java

@@ -0,0 +1,102 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.luckperms.api.event.player.lookup;
+
+import net.luckperms.api.event.LuckPermsEvent;
+import net.luckperms.api.event.type.ResultEvent;
+import net.luckperms.api.event.util.Param;
+
+import org.checkerframework.checker.nullness.qual.NonNull;
+
+import java.util.Objects;
+import java.util.UUID;
+
+/**
+ * Called when the platform needs to determine the type of a player's {@link UUID unique id}.
+ *
+ * @since 5.3
+ */
+public interface UniqueIdDetermineTypeEvent extends LuckPermsEvent, ResultEvent<String> {
+
+    /**
+     * The players UUID has been obtained by authenticating with the Mojang session servers.
+     *
+     * <p>Usually indicated by the UUID being {@link UUID#version() version} 4.</p>
+     */
+    String TYPE_AUTHENTICATED = "authenticated";
+
+    /**
+     * The players UUID has not been obtained through authentication, and instead is likely based
+     * on the username they connected with.
+     *
+     * <p>Usually indicated by the UUID being {@link UUID#version() version} 3.</p>
+     */
+    String TYPE_UNAUTHENTICATED = "unauthenticated";
+
+    /**
+     * The players UUID most likely belongs to a NPC (non-player character).
+     *
+     * <p>Usually indicated by the UUID being {@link UUID#version() version} 2.</p>
+     *
+     * @since 5.4
+     */
+    String TYPE_NPC = "npc";
+
+    /**
+     * Unknown UUID type.
+     *
+     * @since 5.4
+     */
+    String TYPE_UNKNOWN = "unknown";
+
+    /**
+     * Gets the {@link UUID unique id} being queried.
+     *
+     * @return the unique id
+     */
+    @Param(0)
+    @NonNull UUID getUniqueId();
+
+    /**
+     * Gets the current result unique id type.
+     *
+     * @return the type
+     */
+    default @NonNull String getType() {
+        return result().get();
+    }
+
+    /**
+     * Sets the result unique id type.
+     *
+     * @param type the type
+     */
+    default void setType(@NonNull String type) {
+        Objects.requireNonNull(type, "type");
+        result().set(type);
+    }
+
+}