editor.worldpartition

World Partition grid and cell management

← API Reference

editor.worldpartition.getInfo

Returns world partition status, streaming info, and world bounds.

No parameters.

Returns:

Name Type Description
is_enabledboolWhether world partition is enabled
is_initializedboolWhether world partition is initialized
is_streaming_enabledboolWhether streaming is enabled
num_streaming_sourcesnumberNumber of streaming sources
is_streaming_completedboolWhether all streaming is complete
world_bounds_xnumberWorld bounds X extent
world_bounds_ynumberWorld bounds Y extent
world_bounds_znumberWorld bounds Z extent

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getInfo" }

editor.worldpartition.isStreamingCompleted

Checks if all world partition streaming is complete.

No parameters.

Returns:

Name Type Description
is_completedboolWhether streaming is complete
has_world_partitionboolWhether world partition exists

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.isStreamingCompleted" }

editor.worldpartition.getStreamingSources

Returns all active streaming sources with locations and priorities.

No parameters.

Returns:

Name Type Description
sourcesarrayEach: {source_name, location, priority, target_state}
countnumberNumber of sources

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getStreamingSources" }

editor.worldpartition.getLevelInstances

Returns all level instances in the world with their asset paths and runtime behaviors.

No parameters.

Returns:

Name Type Description
level_instancesarrayEach: {actor_name, actor_class, level_asset_path, runtime_behavior, is_loaded}
countnumberNumber of level instances

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getLevelInstances" }

editor.worldpartition.getHLODLayers

Returns HLOD actors in the world.

No parameters.

Returns:

Name Type Description
hlod_actorsarrayEach: {actor_name, actor_class, path, x, y, z}
countnumberNumber of HLOD actors
has_world_partitionboolWhether WP is enabled

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getHLODLayers" }

editor.worldpartition.getWorldSettings

Returns world partition-related world settings.

No parameters.

Returns:

Name Type Description
has_world_partitionboolWP enabled
has_world_compositionboolWorld Composition enabled
world_namestringWorld name
map_namestringMap name
is_initializedboolWP initialized (if WP enabled)
is_streaming_enabledboolStreaming enabled (if WP)
bounds_size_x, bounds_size_y, bounds_size_znumberRuntime bounds (if WP)
enable_world_bounds_checksboolBounds checks enabled
kill_znumberKill Z height

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getWorldSettings" }

editor.worldpartition.getActorGridInfo

Returns grid placement and spatial info for a specific actor.

Parameters:

Name Type Required Description
actorstringYesActor label or name

Returns:

Name Type Description
actor_namestringActor label
actor_classstringClass name
x, y, znumberActor location
bounds_x, bounds_y, bounds_znumberBounding box size
folder_pathstringOutliner folder
is_spatially_loadedboolWhether spatially loaded

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getActorGridInfo", "params": { "actor": "BP_Enemy_0" } }

editor.worldpartition.getContentBundles

Returns content bundle actors in the world.

No parameters.

Returns:

Name Type Description
content_bundlesarrayEach: {actor_name, actor_class, path}
countnumberNumber of content bundles

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getContentBundles" }

editor.worldpartition.getRegions

Returns volume/region actors with their bounds.

No parameters.

Returns:

Name Type Description
regionsarrayEach: {actor_name, actor_class, origin_x, origin_y, origin_z, extent_x, extent_y, extent_z}
countnumberNumber of regions

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getRegions" }

editor.worldpartition.getActorsByRegion

Returns all actors within a spatial bounding box.

Parameters:

Name Type Required Description
minobjectYes{x, y, z} -- minimum bounds
maxobjectYes{x, y, z} -- maximum bounds

Returns:

Name Type Description
actorsarrayEach: {label, class, x, y, z}
countnumberNumber of actors in region

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.worldpartition.getActorsByRegion", "params": { "min": {"x": -5000, "y": -5000, "z": -1000}, "max": {"x": 5000, "y": 5000, "z": 5000} } }