[Home](./index.md) > [server](./server.md) > [PlayerEntity](./server.playerentity.md) ## PlayerEntity class Represents an entity controlled by a player in a world. When to use: custom player avatars that respond to player input. Do NOT use for: non-player NPCs; use `Entity` with a controller instead. **Signature:** ```typescript export default class PlayerEntity extends Entity ``` **Extends:** [Entity](./server.entity.md) ## Remarks Player entities extend `Entity`. They expect a controller to be set before spawning. Without a controller, player input cannot be processed. ## Example ```typescript world.onPlayerJoin = player => { const playerEntity = new PlayerEntity({ player, name: 'Player', modelUri: 'models/players/player.gltf', modelAnimations: [ { name: 'idle-lower', loopMode: EntityModelAnimationLoopMode.LOOP, play: true }, { name: 'idle-upper', loopMode: EntityModelAnimationLoopMode.LOOP, play: true }, ], modelScale: 0.5, }); playerEntity.spawn(world, { x: 10, y: 20, z: 15 }); }; ``` \*\*Category:\*\* Entities ## Constructors

Constructor	Modifiers	Description
[(constructor)(options)](./server.playerentity._constructor_.md)		Creates a new PlayerEntity instance.

## Properties

Property	Modifiers	Type	Description
[isTickWithPlayerInputEnabled](./server.playerentity.istickwithplayerinputenabled.md)	`readonly`	boolean	Whether `tickWithPlayerInput()` is called during the entity's tick. \*\*Category:\*\* Entities
[nametagSceneUI](./server.playerentity.nametagsceneui.md)	`readonly`	[SceneUI](./server.sceneui.md)	The SceneUI instance for the player entity's nametag. \*\*Category:\*\* Entities
[player](./server.playerentity.player.md)	`readonly`	[Player](./server.player.md)	The player this entity is assigned to and controlled by. \*\*Category:\*\* Entities

## Methods

Method	Modifiers	Description
[setTickWithPlayerInputEnabled(enabled)](./server.playerentity.settickwithplayerinputenabled.md)		Enables or disables `tickWithPlayerInput()` during the entity's tick. Use for: temporarily disabling player control (cutscenes, menus, stuns).