Skip to content

PlayerPermissionChangeEvent

Package: com.hypixel.hytale.server.core.event.events.permissions Implements: IEvent<Void> Cancellable: No

Abstract base event for all player-level permission changes. Provides the playerUuid field shared by all player permission events. Has four inner classes covering the four types of player permission changes: direct permission grants/revocations and group membership additions/removals.

FieldTypeAccessorMutableNullable
playerUuidUUIDgetPlayerUuid()NoNo
  • playerUuid — The UUID of the player whose permissions changed.

PlayerPermissionChangeEvent.PermissionsAdded

Section titled “PlayerPermissionChangeEvent.PermissionsAdded”

Dispatched when direct permissions are granted to a player.

FieldTypeAccessorMutableNullable
playerUuidUUIDgetPlayerUuid()NoNo
addedPermissionsSet<String>getAddedPermissions()NoNo
  • addedPermissions — The set of permission strings that were granted. Returned as an unmodifiable set.

Fired by: PermissionsModule.addUserPermission() (line 94) via eventBus dispatch.

PlayerPermissionChangeEvent.PermissionsRemoved

Section titled “PlayerPermissionChangeEvent.PermissionsRemoved”

Dispatched when direct permissions are revoked from a player.

FieldTypeAccessorMutableNullable
playerUuidUUIDgetPlayerUuid()NoNo
removedPermissionsSet<String>getRemovedPermissions()NoNo
  • removedPermissions — The set of permission strings that were revoked. Returned as an unmodifiable set.

Fired by: PermissionsModule.removeUserPermission() (line 102) via eventBus dispatch.

Dispatched when a player is added to a permission group (from the permission-change perspective).

FieldTypeAccessorMutableNullable
playerUuidUUIDgetPlayerUuid()NoNo
groupNameStringgetGroupName()NoNo

Dispatched when a player is removed from a permission group (from the permission-change perspective).

FieldTypeAccessorMutableNullable
playerUuidUUIDgetPlayerUuid()NoNo
groupNameStringgetGroupName()NoNo
// Listen for direct permissions being added to a player
getEventRegistry().register(PlayerPermissionChangeEvent.PermissionsAdded.class, event -> {
UUID playerUuid = event.getPlayerUuid();
Set<String> added = event.getAddedPermissions();
// Handle new player permissions
});
// Listen for direct permissions being removed from a player
getEventRegistry().register(PlayerPermissionChangeEvent.PermissionsRemoved.class, event -> {
UUID playerUuid = event.getPlayerUuid();
Set<String> removed = event.getRemovedPermissions();
// Handle revoked player permissions
});
  • PlayerGroupEvent — Extends this class. The Added and Removed inner classes are the primary dispatch targets for group membership changes.
  • GroupPermissionChangeEvent — Fired when a group’s own permissions change.
PlayerPermissionChangeEvent
+-- GroupAdded
+-- GroupRemoved
+-- PermissionsAdded
+-- PermissionsRemoved
+-- PlayerGroupEvent (subclass)
+-- Added
+-- Removed