LuckPerms (LuckPerms API (v5.2))

```
public interface LuckPerms
```
The LuckPerms API.
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.

This interface represents the base of the API package. All functions are accessed via this interface.

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.

For ease of use, and for platforms without a Service Manager, an instance can also be obtained from the static singleton accessor in LuckPermsProvider.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`@NonNull ActionLogger`	`getActionLogger()` Gets the `ActionLogger`, responsible for saving and broadcasting defined actions occurring on the platform.
`@NonNull ContextManager`	`getContextManager()` Gets the `ContextManager`, responsible for managing `ContextCalculator`s, and calculating applicable contexts.
`@NonNull EventBus`	`getEventBus()` Gets the `EventBus`, used for subscribing to internal LuckPerms events.
`@NonNull GroupManager`	`getGroupManager()` Gets the `GroupManager`, responsible for managing `Group` instances.
`@NonNull Optional<MessagingService>`	`getMessagingService()` Gets the `MessagingService`, used to dispatch updates throughout a network of servers running the plugin.
`@NonNull MetaStackFactory`	`getMetaStackFactory()` Gets the `MetaStackFactory`.
`@NonNull NodeBuilderRegistry`	`getNodeBuilderRegistry()` Gets the `NodeBuilderRegistry`.
`@NonNull NodeMatcherFactory`	`getNodeMatcherFactory()` Gets the `NodeMatcherFactory`.
`@NonNull Platform`	`getPlatform()` Gets the `Platform`, which represents the server platform the plugin is running on.
`<T> @NonNull PlayerAdapter<T>`	`getPlayerAdapter(@NonNull Class<T> playerClass)` Gets the `PlayerAdapter` instance, a utility class for adapting platform Player instances to `User`s.
`@NonNull PluginMetadata`	`getPluginMetadata()` Gets the `PluginMetadata`, responsible for providing metadata about the LuckPerms plugin currently running.
`@NonNull QueryOptionsRegistry`	`getQueryOptionsRegistry()` Gets the `QueryOptionsRegistry`.
`@NonNull String`	`getServerName()` Gets the name of this server.
`@NonNull TrackManager`	`getTrackManager()` Gets the `TrackManager`, responsible for managing `Track` instances.
`@NonNull UserManager`	`getUserManager()` Gets the `UserManager`, responsible for managing `User` instances.
`void`	`registerMessengerProvider(@NonNull MessengerProvider messengerProvider)` Registers a `MessengerProvider` for use by the platform.
`@NonNull CompletableFuture<Void>`	`runUpdateTask()` Schedules the execution of an update task, and returns an encapsulation of the task as a `CompletableFuture`.

- Method Detail
  - getServerName
```
@NonNull String getServerName()
```
    Gets the name of this server.
    This is defined in the LuckPerms configuration file, and is used for server specific permission handling.
    
    The default server name is "global".
    
    Returns:
    
    the server name
  - getUserManager
```
@NonNull UserManager getUserManager()
```
    Gets the UserManager, responsible for managing User instances.
    This manager can be used to retrieve instances of User by uuid or name, or query all loaded users.
    
    Returns:
    
    the user manager
  - getGroupManager
```
@NonNull GroupManager getGroupManager()
```
    Gets the GroupManager, responsible for managing Group instances.
    This manager can be used to retrieve instances of Group by name, or query all loaded groups.
    
    Returns:
    
    the group manager
  - getTrackManager
```
@NonNull TrackManager getTrackManager()
```
    Gets the TrackManager, responsible for managing Track instances.
    This manager can be used to retrieve instances of Track by name, or query all loaded tracks.
    
    Returns:
    
    the track manager
  - getPlayerAdapter
```
<T> @NonNull PlayerAdapter<T> getPlayerAdapter(@NonNull Class<T> playerClass)
```
    Gets the PlayerAdapter instance, a utility class for adapting platform Player instances to Users.
    The playerClass parameter must be equal to the class or interface used by the server platform to represent players.
    
    Specifically:
    - org.bukkit.entity.Player
    - net.md_5.bungee.api.connection.ProxiedPlayer
    - org.spongepowered.api/entity.living.player.Player
    - cn.nukkit.Player
    - com.velocitypowered.api.proxy.Player
    Type Parameters:
    
    T - the player class type
    
    Parameters:
    
    playerClass - the class used by the platform to represent players
    
    Returns:
    
    the player adapter
    
    Throws:
    
    IllegalArgumentException - if the player class is not correct
    
    Since:
    
    5.1
  - getPlatform
```
@NonNull Platform getPlatform()
```
    Gets the Platform, which represents the server platform the plugin is running on.
    
    Returns:
    
    the platform
  - getPluginMetadata
```
@NonNull PluginMetadata getPluginMetadata()
```
    Gets the PluginMetadata, responsible for providing metadata about the LuckPerms plugin currently running.
    
    Returns:
    
    the plugin metadata
  - getEventBus
```
@NonNull EventBus getEventBus()
```
    Gets the EventBus, used for subscribing to internal LuckPerms events.
    
    Returns:
    
    the event bus
  - getMessagingService
```
@NonNull Optional<MessagingService> getMessagingService()
```
    Gets the MessagingService, used to dispatch updates throughout a network of servers running the plugin.
    Not all instances of LuckPerms will have a messaging service setup and configured.
    
    Returns:
    
    the messaging service instance, if present.
  - getActionLogger
```
@NonNull ActionLogger getActionLogger()
```
    Gets the ActionLogger, responsible for saving and broadcasting defined actions occurring on the platform.
    
    Returns:
    
    the action logger
  - getContextManager
```
@NonNull ContextManager getContextManager()
```
    Gets the ContextManager, responsible for managing ContextCalculators, and calculating applicable contexts.
    
    Returns:
    
    the context manager
  - getNodeBuilderRegistry
```
@NonNull NodeBuilderRegistry getNodeBuilderRegistry()
```
    Gets the NodeBuilderRegistry.
    
    Returns:
    
    the node builder registry
  - getQueryOptionsRegistry
```
@NonNull QueryOptionsRegistry getQueryOptionsRegistry()
```
    Gets the QueryOptionsRegistry.
    
    Returns:
    
    the query options registry
    
    Since:
    
    5.1
  - getMetaStackFactory
```
@NonNull MetaStackFactory getMetaStackFactory()
```
    Gets the MetaStackFactory.
    The metastack factory provides methods for retrieving MetaStackElements and constructing MetaStackDefinitions.
    
    Returns:
    
    the meta stack factory
  - getNodeMatcherFactory
```
@NonNull NodeMatcherFactory getNodeMatcherFactory()
```
    Gets the NodeMatcherFactory.
    
    Returns:
    
    the node matcher factory
    
    Since:
    
    5.1
  - runUpdateTask
```
@NonNull CompletableFuture<Void> runUpdateTask()
```
    Schedules the execution of an update task, and returns an encapsulation of the task as a CompletableFuture.
    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.
    
    Returns:
    
    a future
  - registerMessengerProvider
```
void registerMessengerProvider(@NonNull MessengerProvider messengerProvider)
```
    Registers a MessengerProvider for use by the platform.
    Note that the mere action of registering a provider doesn't necessarily mean that it will be used.
    
    Parameters:
    
    messengerProvider - the messenger provider.

Interface LuckPerms

Method Summary

Method Detail

getServerName

getUserManager

getGroupManager

getTrackManager

getPlayerAdapter

getPlatform

getPluginMetadata

getEventBus

getMessagingService

getActionLogger

getContextManager

getNodeBuilderRegistry

getQueryOptionsRegistry

getMetaStackFactory

getNodeMatcherFactory

runUpdateTask

registerMessengerProvider