docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Icon Merge

    Toolbox Rule Engine
    Merge all input GameObjects into a single object. By merging, you will lose additional components such as Metadata.

    Parameters

    Parameter Type Description
    type MergeMode Merge All: Merge all objects from the initial model as a single object. To merge each selected object recursively with all of its child objects, select Keep Parent.
    Merge By Material: Merge all objects that are from the initial model and that share the same material.
    Merge Final Level: Merge the last hierarchy level below the input objects.
    Merge By Hierarchy level: Merge the specified hierarchy levels below the input objects. The selected GameObjects must be placed at the same hierarchy level.
    Merge By Name: Merge all input objects that share the same name.
    Merge By Regions: Merge input GameObjects within the same area
    hierarchyLevel Int32
    keepParent Boolean Will merge each GameObjects with all of its own children.
    mergeByRegionsStrategy (Merge By) MergeByRegionsStrategy Number: specify the number of output GameObject (or the number of regions of output GameObject)
    Size: specify the diagonal size of the output regions
    numberOfRegions Int32 Specify the number of output GameObject (or the number of regions of output GameObject)
    sizeOfRegions Single Specify the diagonal size of the output regions (in Unity unit)
    mergeStrategy MergeStrategy Choose whether to merge GameObjects into one GameObject or merge GameObjects by materials (one GameObject per material)

    Additional Information

    Caution

    During merge, additional components such as metadata are lost.

    Merge by Regions

    Identifies regions in the model and merges them based on one of these criteria:

    • The number of regions
    • The size of each chunk
    You can then merge each region into one GameObject, or merge child object regions by materials.
    Image

    See also:

    • Bake Materials
    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)