Player

Player

Python

Player(
    entity_id: int,
    uuid: str,
    position: Vector3D[float],
    rotation: Rotation,
    metadata: Dict[int, Any],
    tablist: Dict[str, tab.PlayerInfo],
)

Bases: Living

Player entity extending Living.

ATTRIBUTE	DESCRIPTION
ENTITY_TYPE	The Minecraft entity type identifier for players. TYPE: ClassVar[str]
BOUNDING	The bounding box dimensions (width/depth, height) of the player. TYPE: ClassVar[Tuple[float, float]]

info property

Python

info: Optional[tab.PlayerInfo]

Get additional player information from the server's tab list.

RETURNS	DESCRIPTION
Optional[tab.TabPlayer]	The player's tab list entry if they are currently online and visible in the tab list, None otherwise.

additional_hearts property

Python

additional_hearts: float

Additional hearts.

RETURNS	DESCRIPTION
float	The number of additional hearts the player has.

score property

Python

score: int

Player score.

RETURNS	DESCRIPTION
int	The player's current score.

displayed_skin_parts property

Python

displayed_skin_parts: int

Displayed skin parts bit mask.

RETURNS	DESCRIPTION
int	Bit mask representing which skin parts are displayed.

main_hand property

Python

main_hand: int

Main hand preference.

RETURNS	DESCRIPTION
int	The main hand preference (0=left, 1=right).

left_shoulder_entity property

Python

left_shoulder_entity: Optional[Any]

Left shoulder entity NBT data.

RETURNS	DESCRIPTION
Optional[Any]	NBT data of the entity on the left shoulder, or None if empty.

right_shoulder_entity property

Python

right_shoulder_entity: Optional[Any]

Right shoulder entity NBT data.

RETURNS	DESCRIPTION
Optional[Any]	NBT data of the entity on the right shoulder, or None if empty.

cape_enabled property

Python

cape_enabled: bool

Whether cape is enabled (bit 0).

RETURNS	DESCRIPTION
bool	True if the cape is enabled, False otherwise.

jacket_enabled property

Python

jacket_enabled: bool

Whether jacket is enabled (bit 1).

RETURNS	DESCRIPTION
bool	True if the jacket is enabled, False otherwise.

left_sleeve_enabled property

Python

left_sleeve_enabled: bool

Whether left sleeve is enabled (bit 2).

RETURNS	DESCRIPTION
bool	True if the left sleeve is enabled, False otherwise.

right_sleeve_enabled property

Python

right_sleeve_enabled: bool

Whether right sleeve is enabled (bit 3).

RETURNS	DESCRIPTION
bool	True if the right sleeve is enabled, False otherwise.

left_pants_leg_enabled property

Python

left_pants_leg_enabled: bool

Whether left pants leg is enabled (bit 4).

RETURNS	DESCRIPTION
bool	True if the left pants leg is enabled, False otherwise.

right_pants_leg_enabled property

Python

right_pants_leg_enabled: bool

Whether right pants leg is enabled (bit 5).

RETURNS	DESCRIPTION
bool	True if the right pants leg is enabled, False otherwise.

hat_enabled property

Python

hat_enabled: bool

Whether hat is enabled (bit 6).

RETURNS	DESCRIPTION
bool	True if the hat is enabled, False otherwise.

is_left_handed property

Python

is_left_handed: bool

Whether player is left-handed (main hand = 0).

RETURNS	DESCRIPTION
bool	True if the player is left-handed, False otherwise.

is_right_handed property

Python

is_right_handed: bool

Whether player is right-handed (main hand = 1).

RETURNS	DESCRIPTION
bool	True if the player is right-handed, False otherwise.

has_left_shoulder_parrot property

Python

has_left_shoulder_parrot: bool

Whether player has a parrot on left shoulder.

RETURNS	DESCRIPTION
bool	True if there's an entity on the left shoulder, False otherwise.

has_right_shoulder_parrot property

Python

has_right_shoulder_parrot: bool

Whether player has a parrot on right shoulder.

RETURNS	DESCRIPTION
bool	True if there's an entity on the right shoulder, False otherwise.

air property

Python

air: int

Remaining air ticks.

RETURNS	DESCRIPTION
int	Number of air ticks remaining before drowning

custom_name property

Python

custom_name: Optional[str]

Custom name text component or None.

RETURNS	DESCRIPTION
Optional[str]	Custom display name for the entity, or None if not set

is_custom_name_visible property

Python

is_custom_name_visible: bool

Whether custom name is visible above entity.

RETURNS	DESCRIPTION
bool	True if custom name should be displayed above the entity

is_silent property

Python

is_silent: bool

Whether entity makes sounds.

RETURNS	DESCRIPTION
bool	True if entity is silent and won't produce sounds

no_gravity property

Python

no_gravity: bool

Whether entity is affected by gravity.

RETURNS	DESCRIPTION
bool	True if entity ignores gravity effects

max_health property

Python

max_health: float

Maximum health attribute value.

RETURNS	DESCRIPTION
float	Maximum health points for this entity

movement_speed property

Python

movement_speed: float

Movement speed attribute value.

RETURNS	DESCRIPTION
float	Movement speed multiplier for this entity

armor property

Python

armor: float

Armor attribute value.

RETURNS	DESCRIPTION
float	Armor points providing damage reduction

attack_speed property

Python

attack_speed: float

Attack speed attribute value.

RETURNS	DESCRIPTION
float	Attack speed multiplier for this entity

on_fire property

Python

on_fire: bool

Whether entity is on fire (bit 0).

RETURNS	DESCRIPTION
bool	True if entity is currently on fire

crouched property

Python

crouched: bool

Whether entity is crouching (bit 1).

RETURNS	DESCRIPTION
bool	True if entity is in crouching state

sprinting property

Python

sprinting: bool

Whether entity is sprinting (bit 3).

RETURNS	DESCRIPTION
bool	True if entity is currently sprinting

invisible property

Python

invisible: bool

Whether entity is invisible (bit 5).

RETURNS	DESCRIPTION
bool	True if entity has invisibility effect active

glowing property

Python

glowing: bool

Whether entity is glowing (bit 6).

RETURNS	DESCRIPTION
bool	True if entity has glowing outline effect

flying_with_elytra property

Python

flying_with_elytra: bool

Whether entity is flying with elytra (bit 7).

RETURNS	DESCRIPTION
bool	True if entity is gliding with elytra wings

equipment property

Python

equipment: Dict[int, gui.Slot]

Get all equipment slots.

RETURNS	DESCRIPTION
Dict[int, gui.Slot]	Dictionary mapping slot IDs to their equipment slots.

has_equipment property

Python

has_equipment: bool

Check if the entity has any equipment.

RETURNS	DESCRIPTION
bool	True if entity has equipment, False otherwise.

hand_states property

Python

hand_states: int

Hand state bit mask.

RETURNS	DESCRIPTION
int	Bit mask containing hand usage states

health property

Python

health: float

Current health value.

RETURNS	DESCRIPTION
float	Current health points remaining

potion_effect_color property

Python

potion_effect_color: int

Potion effect particle color.

RETURNS	DESCRIPTION
int	RGB color value for potion effect particles

is_potion_effect_ambient property

Python

is_potion_effect_ambient: bool

Whether potion effect is ambient.

RETURNS	DESCRIPTION
bool	True if potion effect particles are ambient (less visible)

arrows_in_entity property

Python

arrows_in_entity: int

Number of arrows stuck in entity.

RETURNS	DESCRIPTION
int	Count of arrows visually stuck in the entity

is_hand_active property

Python

is_hand_active: bool

Whether hand is active (using item).

RETURNS	DESCRIPTION
bool	True if entity is currently using an item with their hand

active_hand property

Python

active_hand: int

Which hand is active (0=main, 1=off).

RETURNS	DESCRIPTION
int	Hand index: 0 for main hand, 1 for off-hand

update_metadata

Python

update_metadata(metadata: Dict[int, Any]) -> None

Update entity metadata from metadata packet.

PARAMETER	DESCRIPTION
metadata	New metadata values indexed by metadata ID TYPE: Dict[int, Any]

update_properties

Python

update_properties(
    properties: Dict[str, Dict[str, Any]],
) -> None

Update entity attributes from properties packet.

PARAMETER	DESCRIPTION
properties	Attribute properties containing base values and modifiers TYPE: Dict[str, Dict[str, Any]]

get_attribute

Python

get_attribute(key: str, default: float = 0.0) -> float

Get final attribute value.

PARAMETER	DESCRIPTION
key	Attribute key name TYPE: str
default	Default value if attribute not found. TYPE: float DEFAULT: 0.0

RETURNS	DESCRIPTION
float	Final attribute value after applying modifiers

get_metadata_value

Python

get_metadata_value(index: int, default: Any = None) -> Any

Get metadata value by index with default fallback.

PARAMETER	DESCRIPTION
index	Metadata index to retrieve TYPE: int
default	Default value if metadata not found. TYPE: Any DEFAULT: None

RETURNS	DESCRIPTION
Any	Metadata value at the specified index, or default if not found

set_equipment

Python

set_equipment(slot: gui.Slot) -> None

Set equipment in the specified slot.

RETURNS	DESCRIPTION
None