[Home](./index.md) > [server](./server.md) > [WorldManager](./server.worldmanager.md) ## WorldManager class Manages all worlds in a game server. When to use: creating additional worlds, routing players, or querying the active world set. Do NOT use for: instantiating `World` directly for gameplay; use `WorldManager.createWorld` to ensure IDs and lifecycle are managed consistently. **Signature:** ```typescript export default class WorldManager ``` ## Remarks Access via `WorldManager.instance` — do not construct directly.

Events

This class emits global events with payloads listed under `WorldManagerEventPayloads`. ## Example ```typescript import { WorldManager } from 'hytopia'; const worldManager = WorldManager.instance; const newWorld = worldManager.createWorld({ name: 'My New World', skyboxUri: 'skyboxes/partly-cloudy', }); ``` \*\*Category:\*\* Core ## Properties
Property Modifiers Type Description
[instance](./server.worldmanager.instance.md) `static` `readonly` [WorldManager](./server.worldmanager.md) The global WorldManager instance (singleton). \*\*Category:\*\* Core
## Methods
Method Modifiers Description
[createWorld(options)](./server.worldmanager.createworld.md) Creates and starts a new world with a unique ID. Use for: additional game rooms, arenas, or isolated simulations. Do NOT use for: deferred world creation without starting; this always starts.
[getAllWorlds()](./server.worldmanager.getallworlds.md) Gets all worlds currently managed by the server.
[getDefaultWorld()](./server.worldmanager.getdefaultworld.md) Gets the default world, creating it if it does not exist. Use for: a single-world game or as a safe fallback when routing players. Do NOT use for: creating specialized worlds with unique options.
[getWorld(id)](./server.worldmanager.getworld.md) Gets a world by its ID.
[getWorldsByTag(tag)](./server.worldmanager.getworldsbytag.md) Gets all worlds with a specific tag.
[setDefaultWorld(world)](./server.worldmanager.setdefaultworld.md) Sets the default world players join on connect. Use for: changing the lobby or main world at runtime. Do NOT use for: moving already connected players; use `Player.joinWorld`.