[Home](./index.md) > [server](./server.md) > [PlayerCamera](./server.playercamera.md) ## PlayerCamera class The camera for a Player. When to use: controlling a player's view, mode, and camera offsets. Do NOT use for: moving the player or entities; use entity movement APIs. **Signature:** ```typescript export default class PlayerCamera extends EventRouter implements protocol.Serializable ``` **Extends:** [EventRouter](./server.eventrouter.md) **Implements:** protocol.Serializable ## Remarks Access via `Player.camera`. Most operations require the player to be in a world.

Events

This class is an EventRouter, and instances of it emit events with payloads listed under `PlayerCameraEventPayloads`. The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `PlayerCamera` class. ## Example ```typescript // Camera follows player, continuously looks at enemy player.camera.setAttachedToEntity(playerEntity); player.camera.setTargetEntity(enemyEntity); // Camera at fixed position, continuously looks at player player.camera.setAttachedToPosition({ x: 0, y: 10, z: 0 }); player.camera.setTargetEntity(playerEntity); // Stop targeting, restore manual camera control player.camera.setTargetEntity(undefined); ``` \*\*Category:\*\* Players ## Properties

Property	Modifiers	Type	Description
[attachedToEntity](./server.playercamera.attachedtoentity.md)	`readonly`	[Entity](./server.entity.md) \\| undefined	The entity the camera is attached to. \\Category:\\ Players
[attachedToPosition](./server.playercamera.attachedtoposition.md)	`readonly`	[Vector3Like](./server.vector3like.md) \\| undefined	The position the camera is attached to. \\Category:\\ Players
[collidesWithBlocks](./server.playercamera.collideswithblocks.md)	`readonly`	boolean	Whether the camera collides with blocks instead of clipping through them. \\Category:\\ Players
[facingDirection](./server.playercamera.facingdirection.md)	`readonly`	[Vector3Like](./server.vector3like.md)	The facing direction vector of the camera based on its current orientation. \\Category:\\ Players
[facingQuaternion](./server.playercamera.facingquaternion.md)	`readonly`	[QuaternionLike](./server.quaternionlike.md)	The quaternion representing the camera's facing direction. \\Category:\\ Players
[filmOffset](./server.playercamera.filmoffset.md)	`readonly`	number	The film offset of the camera.
[forwardOffset](./server.playercamera.forwardoffset.md)	`readonly`	number	The forward offset of the camera (first-person mode only).
[fov](./server.playercamera.fov.md)	`readonly`	number	The field of view of the camera. \\Category:\\ Players
[mode](./server.playercamera.mode.md)	`readonly`	[PlayerCameraMode](./server.playercameramode.md)	The mode of the camera. \\Category:\\ Players
[modelHiddenNodes](./server.playercamera.modelhiddennodes.md)	`readonly`	Set<string>	Model nodes that will not be rendered for this player.
[modelShownNodes](./server.playercamera.modelshownnodes.md)	`readonly`	Set<string>	Model nodes that will be rendered for this player, overriding hidden nodes.
[offset](./server.playercamera.offset.md)	`readonly`	[Vector3Like](./server.vector3like.md)	The relative offset of the camera from its attachment target. \\Category:\\ Players
[orientation](./server.playercamera.orientation.md)	`readonly`	[PlayerCameraOrientation](./server.playercameraorientation.md)	The current orientation of the camera.
[player](./server.playercamera.player.md)	`readonly`	[Player](./server.player.md)	The player that the camera belongs to. \\Category:\\ Players
[shoulderAngle](./server.playercamera.shoulderangle.md)	`readonly`	number	The shoulder angle of the camera in degrees. \\Category:\\ Players
[targetEntity](./server.playercamera.targetentity.md)	`readonly`	[Entity](./server.entity.md) \\| undefined	The entity the camera continuously rotates to face. \\Category:\\ Players
[targetPosition](./server.playercamera.targetposition.md)	`readonly`	[Vector3Like](./server.vector3like.md) \\| undefined	The position the camera continuously rotates to face. \\Category:\\ Players
[viewModelHiddenNodes](./server.playercamera.viewmodelhiddennodes.md)	`readonly`	Set<string>	Node substrings to hide on the view model (or attached entity's model). \\Category:\\ Players
[viewModelPitchesWithCamera](./server.playercamera.viewmodelpitcheswithcamera.md)	`readonly`	boolean	Whether the view model pitches up/down with the camera orientation. \\Category:\\ Players
[viewModelShownNodes](./server.playercamera.viewmodelshownnodes.md)	`readonly`	Set<string>	Node substrings to show on the view model (or attached entity's model). \\Category:\\ Players
[viewModelUri](./server.playercamera.viewmodeluri.md)	`readonly`	string \\| undefined	The URI of the view model.
[viewModelYawsWithCamera](./server.playercamera.viewmodelyawswithcamera.md)	`readonly`	boolean	Whether the view model yaws left/right with the camera orientation. \\Category:\\ Players
[zoom](./server.playercamera.zoom.md)	`readonly`	number	The zoom of the camera. \\Category:\\ Players

## Methods

Method	Modifiers	Description
[faceEntity(entity)](./server.playercamera.faceentity.md)		Makes the camera look at an entity once. Use for: one-off focus moments (e.g., cutscene beats). Do NOT use for: continuous tracking; use `PlayerCamera.setTrackedEntity`.
[facePosition(position)](./server.playercamera.faceposition.md)		Makes the camera look at a position once. Use for: one-off focus moments (e.g., points of interest). Do NOT use for: continuous tracking; use `PlayerCamera.setTrackedPosition`.
[reset()](./server.playercamera.reset.md)		Resets the camera state on the server. Use for: clearing camera state on disconnect or reconnect.
[setAttachedToEntity(entity)](./server.playercamera.setattachedtoentity.md)		Attaches the camera to an entity. Use for: third-person follow cameras or entity-bound views. Do NOT use for: tracking an entity without attachment; use `PlayerCamera.setTrackedEntity`.
[setAttachedToPosition(position)](./server.playercamera.setattachedtoposition.md)		Attaches the camera to a world position. Use for: fixed cameras or cinematic shots. Do NOT use for: tracking a moving target; use `PlayerCamera.setTrackedPosition`.
[setCollidesWithBlocks(collidesWithBlocks)](./server.playercamera.setcollideswithblocks.md)		Sets whether the camera collides with blocks instead of clipping through them.
[setFilmOffset(filmOffset)](./server.playercamera.setfilmoffset.md)		Sets the film offset of the camera. A positive value shifts the camera right, a negative value shifts it left.
[setForwardOffset(forwardOffset)](./server.playercamera.setforwardoffset.md)		Sets the forward offset of the camera (first-person mode only).
[setFov(fov)](./server.playercamera.setfov.md)		Sets the field of view of the camera.
[setMode(mode)](./server.playercamera.setmode.md)		Sets the mode of the camera.
[setOffset(offset)](./server.playercamera.setoffset.md)		Sets the relative offset of the camera from its attachment target.
[setShoulderAngle(shoulderAngle)](./server.playercamera.setshoulderangle.md)		Sets the shoulder angle of the camera in degrees (third-person mode only).
[setTargetEntity(entity)](./server.playercamera.settargetentity.md)		Sets the entity the camera will continuously look at. Use for: keeping the camera focused on a moving entity.
[setTargetPosition(position)](./server.playercamera.settargetposition.md)		Sets the position the camera will continuously look at. Use for: fixed focal points in the scene.
[setViewModel(viewModelUri)](./server.playercamera.setviewmodel.md)		Sets a view model for first-person rendering.
[setViewModelHiddenNodes(viewModelHiddenNodes)](./server.playercamera.setviewmodelhiddennodes.md)		Hides nodes on the view model (or attached entity's model if no view model is set).
[setViewModelPitchesWithCamera(viewModelPitchesWithCamera)](./server.playercamera.setviewmodelpitcheswithcamera.md)		Sets whether the view model pitches up/down with the camera orientation.
[setViewModelShownNodes(viewModelShownNodes)](./server.playercamera.setviewmodelshownnodes.md)		Shows nodes on the view model (or attached entity's model if no view model is set), overriding hidden nodes.
[setViewModelYawsWithCamera(viewModelYawsWithCamera)](./server.playercamera.setviewmodelyawswithcamera.md)		Sets whether the view model yaws left/right with the camera orientation.
[setZoom(zoom)](./server.playercamera.setzoom.md)		Sets the zoom of the camera.