OlaPermissions

Available Events

User Lifecycle Events

• UserFirstLoginEvent: Fired the very first time a unique player joins the server and is inserted into the SQL database.
• UserLoadEvent: Fired when a user's data is successfully loaded from SQL into the high-speed memory cache.
• UserUnloadEvent: Fired when a user disconnects and their data is safely purged from memory to prevent leaks.
• UserUpdateEvent: Fired whenever a user's permissions, groups, prefix, or suffix are modified. This is also fired when a Redis sync causes the user to be re-downloaded from the database.

Group Lifecycle Events

• GroupCreateEvent: Fired explicitly when a new group is created.
• GroupDeleteEvent: Fired when a group is deleted.
• GroupLoadEvent: Fired when a group is loaded from the database.
• GroupUpdateEvent: Fired whenever a group is created, modified, or synced from the database.
• GroupWeightChangeEvent: Fired when a group's weight priority is altered.
• GroupParentAddEvent: Fired when a group adds a parent group to its inheritance tree.
• GroupParentRemoveEvent: Fired when a parent group is removed from inheritance.

Track Lifecycle Events

• TrackCreateEvent: Fired when a new track is created.
• TrackDeleteEvent: Fired when a track is deleted.
• UserPromoteEvent: Fired when a user is promoted along a track.
• UserDemoteEvent: Fired when a user is demoted down a track.

Node & Permission Events

• NodeAddEvent: Fired when a permission node (or group node) is specifically granted to a user or group.
• NodeRemoveEvent: Fired when a permission node (or group node) is revoked.
• NodeExpireEvent: Fired when a temporary permission node naturally expires and is wiped from a user during the async expiration cleanup loop.
• PrimaryGroupCalculateEvent: Fired when the engine resolves the user's primary group (by sorting weights). Allows an addon to override what the "primary" group is.
• UserClearEvent: Fired when ALL permissions or groups are wiped from a user.
• GroupClearEvent: Fired when ALL permissions are wiped from a group.

Context Events

• ServerContextSwitchEvent: Fired when a user switches backend servers on a Velocity network, causing their server-specific permissions to recalculate.
• WorldContextSwitchEvent: Fired when a user changes worlds on a Paper server, causing their world-specific permissions to recalculate.

Prefix & Suffix Events

• UserPrefixChangeEvent: Fired when a user's personal prefix changes.
• UserSuffixChangeEvent: Fired when a user's personal suffix changes.
• GroupPrefixChangeEvent: Fired when a group's prefix changes.
• GroupSuffixChangeEvent: Fired when a group's suffix changes.

Command Events

• OlaCommandPreExecuteEvent: Fired when an admin attempts to run an /ola command, before it processes. Can be cancelled by an addon to block commands.
• OlaCommandPostExecuteEvent: Fired right after a command successfully finishes.

System & Network Events

• NetworkSyncEvent: Fired explicitly when the server receives a Redis sync payload from another proxy.
• MigrationStartEvent: Fired when a LuckPerms migration begins.
• MigrationCompleteEvent: Fired when the migration successfully finishes replacing the database.