Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

UnpackAllInstancesOfPrefab(GameObject, PrefabUnpackMode, InteractionMode)

Unpacks all instances of a given Prefab Asset root GameObject in all open scenes so that all instances are replaced with the contents of the Prefab Asset while retaining all override values.
Read time 1 minuteLast updated 12 days ago

Definition

  • Type: Method
  • Namespace: UnityEditor
  • Assembly: UnityEditor.CoreModule
public static void UnpackAllInstancesOfPrefab(GameObject prefabRoot, PrefabUnpackMode unpackMode, InteractionMode action)

Parameters

prefabRoot

GameObject
The root GameObject of a Prefab Asset used to find all Prefab instances in open scenes that should be unpacked.

unpackMode

PrefabUnpackMode
Whether to unpack the outermost root or unpack completely.

action

InteractionMode
The interaction mode to use for this action.

Remarks

The Prefab instances will not be unpacked in closed scenes. This function uses PrefabUtility.FindAllInstancesOfPrefab to determine which instances to unpack and calls PrefabUtility.UnpackPrefabInstance for each instance.
Unpacking throws an ArgumentException if the given object is not the root GameObject of a Prefab Asset.

Examples

using UnityEditor;using UnityEngine;public class Example{    public static void UnpackAllInstancesOfPrefab(string prefabPath)    {        var prefabAssetRoot = AssetDatabase.LoadMainAssetAtPath(prefabPath) as GameObject;        if (prefabAssetRoot != null)        {            PrefabUtility.UnpackAllInstancesOfPrefab(prefabAssetRoot, PrefabUnpackMode.OutermostRoot, InteractionMode.UserAction);        }    }}