Pumpkin-Docs/docs/en/plugin-dev/python/events.md

Events

Events allow your plugin to respond to actions occurring on the server, such as players joining or messages being sent.

Registering an Event

You can register an event handler in the on_load method of your plugin using self.register_event.

def on_load(self, ctx: context.Context) -> None:
    self.register_event(ctx, event.EventType.PLAYER_JOIN_EVENT, self.on_player_join)

Event Handlers

An event handler is a method that receives the server instance and the event data. It should return the (possibly modified) event data.

def on_player_join(self, srv: server.Server, evt: event.PlayerJoinEventData) -> event.PlayerJoinEventData:
    print(f"Player {evt.player.get_name()} joined!")
    return evt

Event Types

The event.EventType enum contains all available events. Some common events include:

• PLAYER_JOIN_EVENT
• PLAYER_QUIT_EVENT
• PLAYER_CHAT_EVENT