[Home](./index.md) > [server](./server.md) > [Player](./server.player.md) ## Player class A connected player in the game. When to use: interacting with a connected player's state, UI, and world membership. Do NOT use for: constructing players or representing offline users. **Signature:** ```typescript export default class Player extends EventRouter implements protocol.Serializable ``` **Extends:** [EventRouter](./server.eventrouter.md) **Implements:** protocol.Serializable ## Remarks Players are created automatically on connection by `PlayerManager`.

Events

This class is an EventRouter, and instances of it emit events with payloads listed under `PlayerEventPayloads`. \*\*Category:\*\* Players The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `Player` class. ## Properties

Property	Modifiers	Type	Description
[camera](./server.player.camera.md)	`readonly`	[PlayerCamera](./server.playercamera.md)	The camera for the player. \\Category:\\ Players
[cosmetics](./server.player.cosmetics.md)	`readonly`	Promise<[PlayerCosmetics](./server.playercosmetics.md) \\| void>	The cosmetics for the player.
[id](./server.player.id.md)	`readonly`	string	The unique HYTOPIA UUID for the player. \\Category:\\ Players
[input](./server.player.input.md)	`readonly`	[PlayerInput](./server.playerinput.md)	The current `PlayerInput` of the player. \\Category:\\ Players
[isInteractEnabled](./server.player.isinteractenabled.md)	`readonly`	boolean	Whether player click/tap input triggers interactions.
[maxInteractDistance](./server.player.maxinteractdistance.md)	`readonly`	number	The maximum distance a player can interact with entities or blocks.
[profilePictureUrl](./server.player.profilepictureurl.md)	`readonly`	string \\| undefined	The profile picture URL for the player. \\Category:\\ Players
[ui](./server.player.ui.md)	`readonly`	[PlayerUI](./server.playerui.md)	The UI for the player. \\Category:\\ Players
[username](./server.player.username.md)	`readonly`	string	The unique HYTOPIA username for the player. \\Category:\\ Players
[world](./server.player.world.md)	`readonly`	[World](./server.world.md) \\| undefined	The current `World` the player is in, or undefined if not yet joined. \\Category:\\ Players

## Methods

Method	Modifiers	Description
[disconnect()](./server.player.disconnect.md)		Disconnects the player from the game server. Use for: kicking a player or enforcing a logout. Do NOT use for: switching worlds; use `Player.joinWorld` instead. \\Side effects:\\ Emits `PlayerEvent.LEFT_WORLD` if the player is in a world and closes the connection. \\Category:\\ Players
[getPersistedData()](./server.player.getpersisteddata.md)		Gets the persisted data for the player, if available. Use for: reading saved progress after the player connects.
[joinWorld(world)](./server.player.joinworld.md)		Assigns the player to a world. Use for: initial placement or moving a player between worlds. Do NOT use for: respawning or teleporting within the same world.
[resetInputs()](./server.player.resetinputs.md)		Resets all cached input keys for the player. Use for: clearing stuck input states (e.g., after disconnect or pause). \\Side effects:\\ Clears the current `PlayerInput` state. \\Category:\\ Players
[scheduleNotification(type, scheduledFor)](./server.player.schedulenotification.md)		Schedules a notification for the player at a future time. Use for: re-engagement or timed reminders. Do NOT use for: immediate in-game messaging; use chat or UI instead.
[setInteractEnabled(enabled)](./server.player.setinteractenabled.md)		Enables or disables interaction clicks/taps for this player. Use for: cutscenes, menus, or temporary input blocking.
[setMaxInteractDistance(distance)](./server.player.setmaxinteractdistance.md)		Sets the maximum distance a player can interact with entities or blocks.
[setPersistedData(data)](./server.player.setpersisteddata.md)		Merges data into the player's persisted data cache. Use for: saving progress, inventory, or other player-specific state. Do NOT use for: large binary data or per-tick updates.
[unscheduleNotification(notificationId)](./server.player.unschedulenotification.md)		Unschedules a scheduled notification for the player.