Skip to content

user

Player Events

Player Health Update

  • Description: Player health/food updated
  • Parameters:
  • health: float - Current health
  • food: int - Food level
  • saturation: float - Food saturation
  • Usage:
    Python
    @client.event
    async def on_player_health_update(health: float, food: int, saturation: float) -> None:
        ...
    

Player Experience Set

  • Description: Player XP updated
  • Parameters:
  • level: int - Current level
  • total_xp: int - Total experience
  • progress: float - Progress to next level (0.0-1.0)
  • Usage:
    Python
    @client.event
    async def on_player_experience_set(level: int, total_xp: int, progress: float) -> None:
        ...
    

Held Slot Change

  • Description: Hotbar slot changed
  • Parameters:
  • slot: int - New selected slot (0-8)
  • Usage:
    Python
    @client.event
    async def on_held_slot_change(slot: int) -> None:
        ...
    

Player Position And Look

  • Description: Player position/orientation updated
  • Parameters:
  • position: Vector3D - New position
  • rotation: Rotation - New rotation
  • Usage:
    Python
    @client.event
    async def on_player_position_and_look(position: Vector3D, rotation: Rotation) -> None:
        ...
    

Player Abilities Change

  • Description: Player abilities changed
  • Usage:
    Python
    @client.event
    async def on_player_abilities_change() -> None:
        ...
    

Player Combat

Player Death

  • Description: Player died
  • Parameters:
  • player: Player - The player who died
  • message: Message - Death message
  • Usage:
    Python
    @client.event
    async def on_player_death(player: Player, message: Message) -> None:
        ...
    

Player Killed

  • Description: Player killed by entity
  • Parameters:
  • player: Player - The killed player
  • killer: Entity - The killer entity
  • message: Message - Kill message
  • Usage:
    Python
    @client.event
    async def on_player_killed(player: Player, killer: Entity, message: Message) -> None:
        ...
    

Use Bed

  • Description: Player used bed
  • Parameters:
  • entity: Entity - The player entity
  • position: Vector3D - Bed position
  • Usage:
    Python
    @client.event
    async def on_use_bed(entity: Entity, position: Vector3D) -> None:
        ...