[Home](./index.md) > [server](./server.md) > [World](./server.world.md) ## World class Represents an isolated simulation space (a world) on the server. When to use: your primary container for game objects, physics, and players. Use multiple worlds to run separate rooms, arenas, or instances. Do NOT use for: cross-world global state; keep that in your own services or `GameServer`. **Signature:** ```typescript export default class World extends EventRouter implements protocol.Serializable ``` **Extends:** [EventRouter](./server.eventrouter.md) **Implements:** protocol.Serializable ## Remarks Prefer creating worlds via `WorldManager.createWorld` or `WorldManager.getDefaultWorld` so IDs and lifecycle are managed consistently. Initialization: - Call `World.start` to begin ticking (auto-started when created by `WorldManager`). - Use `set*` methods for runtime lighting or skybox changes.

Events

This class is an EventRouter, and instances of it emit events with payloads listed under `WorldEventPayloads`. ## Example ```typescript const world = WorldManager.instance.createWorld({ name: 'My World', skyboxUri: 'skyboxes/partly-cloudy', }); ``` \*\*Category:\*\* Core ## Constructors
Constructor Modifiers Description
[(constructor)(options)](./server.world._constructor_.md) Creates a world instance with the provided options. Use for: direct construction only when you need custom lifecycle control. Do NOT use for: routine world creation; prefer `WorldManager.createWorld`.
## Properties
Property Modifiers Type Description
[ambientLightColor](./server.world.ambientlightcolor.md) `readonly` [RgbColor](./server.rgbcolor.md) The color of the ambient light. \*\*Category:\*\* Core
[ambientLightIntensity](./server.world.ambientlightintensity.md) `readonly` number The intensity of the ambient light. \*\*Category:\*\* Core
[audioManager](./server.world.audiomanager.md) `readonly` [AudioManager](./server.audiomanager.md) The audio manager for this world. \*\*Category:\*\* Core
[blockTypeRegistry](./server.world.blocktyperegistry.md) `readonly` [BlockTypeRegistry](./server.blocktyperegistry.md) The block type registry for this world. \*\*Category:\*\* Core
[chatManager](./server.world.chatmanager.md) `readonly` [ChatManager](./server.chatmanager.md) The chat manager for this world. \*\*Category:\*\* Core
[chunkLattice](./server.world.chunklattice.md) `readonly` [ChunkLattice](./server.chunklattice.md) The chunk lattice for this world. \*\*Category:\*\* Core
[directionalLightColor](./server.world.directionallightcolor.md) `readonly` [RgbColor](./server.rgbcolor.md) The color of the directional light. \*\*Category:\*\* Core
[directionalLightIntensity](./server.world.directionallightintensity.md) `readonly` number The intensity of the directional light. \*\*Category:\*\* Core
[directionalLightPosition](./server.world.directionallightposition.md) `readonly` [Vector3Like](./server.vector3like.md) The position the directional light originates from (relative to the camera). \*\*Category:\*\* Core
[entityManager](./server.world.entitymanager.md) `readonly` [EntityManager](./server.entitymanager.md) The entity manager for this world. \*\*Category:\*\* Core
[fogColor](./server.world.fogcolor.md) `readonly` [RgbColor](./server.rgbcolor.md) \| undefined The fog color, or undefined to use ambient light color. \*\*Category:\*\* Core
[fogFar](./server.world.fogfar.md) `readonly` number The maximum distance from the camera at which fog stops being applied. \*\*Category:\*\* Core
[fogNear](./server.world.fognear.md) `readonly` number The minimum distance from the camera to start applying fog. \*\*Category:\*\* Core
[id](./server.world.id.md) `readonly` number The unique ID of the world. \*\*Category:\*\* Core
[loop](./server.world.loop.md) `readonly` [WorldLoop](./server.worldloop.md) The world loop that drives ticking for this world.
[name](./server.world.name.md) `readonly` string The name of the world. \*\*Category:\*\* Core
[particleEmitterManager](./server.world.particleemittermanager.md) `readonly` [ParticleEmitterManager](./server.particleemittermanager.md) The particle emitter manager for this world. \*\*Category:\*\* Core
[sceneUIManager](./server.world.sceneuimanager.md) `readonly` [SceneUIManager](./server.sceneuimanager.md) The scene UI manager for this world. \*\*Category:\*\* Core
[simulation](./server.world.simulation.md) `readonly` [Simulation](./server.simulation.md) The physics simulation for this world. \*\*Category:\*\* Core
[skyboxIntensity](./server.world.skyboxintensity.md) `readonly` number The intensity of the world's skybox brightness. \*\*Category:\*\* Core
[skyboxUri](./server.world.skyboxuri.md) `readonly` string The URI of the skybox cubemap for this world. \*\*Category:\*\* Core
[tag](./server.world.tag.md) `readonly` string \| undefined An arbitrary identifier tag for your own logic. \*\*Category:\*\* Core
## Methods
Method Modifiers Description
[loadMap(map)](./server.world.loadmap.md) Loads a map into the world, replacing any prior map contents. Use for: initializing or fully resetting a world from serialized map data. Do NOT use for: incremental edits while players are actively interacting with the world.
[setAmbientLightColor(color)](./server.world.setambientlightcolor.md) Sets the color of the world's ambient light.
[setAmbientLightIntensity(intensity)](./server.world.setambientlightintensity.md) Sets the intensity of the world's ambient light.
[setDirectionalLightColor(color)](./server.world.setdirectionallightcolor.md) Sets the color of the world's directional light.
[setDirectionalLightIntensity(intensity)](./server.world.setdirectionallightintensity.md) Sets the intensity of the world's directional light.
[setDirectionalLightPosition(position)](./server.world.setdirectionallightposition.md) Sets the position the world's directional light originates from relative to a player's camera.
[setFogColor(color)](./server.world.setfogcolor.md) Sets the color of the world's fog.
[setFogFar(far)](./server.world.setfogfar.md) Sets the maximum distance from the camera at which fog stops being applied.
[setFogNear(near)](./server.world.setfognear.md) Sets the minimum distance from the camera to start applying fog.
[setSkyboxIntensity(intensity)](./server.world.setskyboxintensity.md) Sets the intensity of the world's skybox brightness.
[setSkyboxUri(skyboxUri)](./server.world.setskyboxuri.md) Sets the cubemap URI of the world's skybox.
[start()](./server.world.start.md) Starts the world loop, which begins ticking physics, entities, and networking. Use for: resuming a previously stopped world. Do NOT use for: standard world creation when using `WorldManager.createWorld` (it auto-starts). \*\*Side effects:\*\* Emits `WorldEvent.START`. \*\*Category:\*\* Core
[stop()](./server.world.stop.md) Stops the world loop, pausing physics, entities, and networking ticks. Use for: pausing a world or preparing for a full map reset. Do NOT use for: disconnecting players; they remain assigned to this world. \*\*Side effects:\*\* Emits `WorldEvent.STOP`. \*\*Category:\*\* Core