OlaVault

OlaVault Events

OlaVault replaces legacy polling timers with a rich ecosystem of 15 highly-specialized Bukkit events. Developers can use standard @EventHandler annotations to listen to these events.

API Lifecycle Events

• ProviderReadyEvent: Fired when a new API provider (Economy, Permissions, or Chat) is successfully registered, cached, and ready for use. Listen to this event to safely hook your plugin after startup.

Economy Events

• EconomyTransactionEvent: Fired when an economy transaction (deposit, withdraw, or set) completes. Contains the player's UUID, currency identifier, transaction type, amount, and the new balance.
• EconomyAccountCreateEvent: Fired when a new economy account is generated for a player (e.g., first join).
• EconomyAccountDeleteEvent: Fired when an admin completely wipes or purges a player's economy data.
• EconomyCurrencyRegisterEvent: Fired when a multi-currency provider dynamically creates a new valid currency for trading mid-game.

Player Permission & Chat Events

• PlayerPrimaryGroupChangeEvent: Fired when a player's primary permission group changes.
• PlayerGroupChangeEvent: Fired when a player is added to or removed from a specific group.
• PlayerPermissionChangeEvent: Fired when a specific permission node is granted or revoked for a player.
• PlayerMetaChangeEvent: Fired when a player's prefix, suffix, or custom metadata (via getMetaKey()) changes.

Group Permission & Chat Events

• GroupCreateEvent: Fired when a new permission group is created by the permissions provider.
• GroupDeleteEvent: Fired when an existing permission group is deleted.
• GroupRenameEvent: Fired when a permission group's name/ID is changed.
• GroupInheritanceChangeEvent: Fired when a group's inheritance (parent groups) changes.
• GroupPermissionChangeEvent: Fired when a permission node is granted or revoked for an entire group.
• GroupMetaChangeEvent: Fired when a group's prefix, suffix, or custom metadata (via getMetaKey()) changes.