Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


MoveGameObjectsToScene

Move multiple GameObjects, represented by a NativeArray of instance IDs, from their current Scene to a new Scene.
Read time 1 minuteLast updated 9 days ago

Definition

MoveGameObjectsToScene(NativeArray<int>, Scene)

Move multiple GameObjects, represented by a NativeArray of instance IDs, from their current Scene to a new Scene.
Warning
Removed. Please use MoveGameObjectsToScene(NativeArray\<EntityId\>, Scene scene) with the EntityId parameter type instead.
public static void MoveGameObjectsToScene(NativeArray<int> instanceIDs, Scene scene)

Parameters

instanceIDs

GameObjects by instance ID to move.

scene

Scene to move into.

Remarks

You can only move root GameObjects from one Scene to another. This means the GameObject to move must not be a child of any other GameObject in its Scene. This only works on GameObjects being moved to a Scene that is already loaded (additive). If you want to load single Scenes, make sure to use DontDestroyOnLoad on the GameObject you would like to move to a new Scene, otherwise Unity deletes it when it loads a new Scene.

MoveGameObjectsToScene(NativeArray<EntityId>, Scene)

Move multiple GameObjects, represented by a NativeArray of instance IDs, from their current Scene to a new Scene.
public static void MoveGameObjectsToScene(NativeArray<EntityId> entityIds, Scene scene)

Parameters


scene

Scene to move into.

Remarks

You can only move root GameObjects from one Scene to another. This means the GameObject to move must not be a child of any other GameObject in its Scene. This only works on GameObjects being moved to a Scene that is already loaded (additive). If you want to load single Scenes, make sure to use DontDestroyOnLoad on the GameObject you would like to move to a new Scene, otherwise Unity deletes it when it loads a new Scene.