[Home](./index.md) > [server](./server.md) > [PlayerManager](./server.playermanager.md) ## PlayerManager class Manages all connected players in a game server. When to use: accessing online players, reacting to connection lifecycle events, or routing players to worlds. Do NOT use for: constructing or persisting players yourself; players are created automatically on connection. **Signature:** ```typescript export default class PlayerManager ``` ## Remarks Access via `PlayerManager.instance` — do not construct directly.

Events

This class emits global events with payloads listed under `PlayerManagerEventPayloads`. The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `PlayerManager` class. ## Example ```typescript import { PlayerManager } from 'hytopia'; const playerManager = PlayerManager.instance; const connectedPlayers = playerManager.getConnectedPlayers(); ``` \*\*Category:\*\* Players ## Properties
Property Modifiers Type Description
[instance](./server.playermanager.instance.md) `static` `readonly` [PlayerManager](./server.playermanager.md) The global PlayerManager instance (singleton). \*\*Category:\*\* Players
[playerCount](./server.playermanager.playercount.md) `readonly` number The number of players currently connected to the server. \*\*Category:\*\* Players
[worldSelectionHandler?](./server.playermanager.worldselectionhandler.md) (player: [Player](./server.player.md)) => Promise<[World](./server.world.md) \| undefined> _(Optional)_ Optional handler for selecting the world a newly connected player joins. Use for: lobby routing or game mode selection. Do NOT use for: moving players after they have already joined a world; use `Player.joinWorld`.
## Methods
Method Modifiers Description
[getConnectedPlayerByUsername(username)](./server.playermanager.getconnectedplayerbyusername.md) Get a connected player by their username (case-insensitive).
[getConnectedPlayers()](./server.playermanager.getconnectedplayers.md) Get all connected players.
[getConnectedPlayersByWorld(world)](./server.playermanager.getconnectedplayersbyworld.md) Get all connected players in a specific world.