instanceRoot | The GameObject to save as a Prefab and make into a Prefab instance. |
assetPath | The path to save the Prefab at. |
action | The interaction mode to use for this action. |
success | The result of the save action, either successful or unsuccessful. Use this together with the console log to get more insight into the save process. |
Use this function to create a Prefab Asset at the given path from the given GameObject including any children in the Scene and at the same time make the given GameObject into an instance of the new Prefab.
In case some of the children are Prefab instances they will automatically become nested inside the new Prefab.
The input object has to be a plain GameObject or the outermost root of a Prefab Instance.
If the input object is a Prefab instance root the resulting Prefab will be a Variant Prefab. Should you in this case actually want to create a new uniqueue Prefab you need to unpack the instance first.
See Also: SaveAsPrefabAsset, UnpackPrefabInstance.