docs.unity3d.com
    Show / Hide Table of Contents

    Interacting with ProBuilder

    ProBuilder User Interface

    ProBuilder provides several ways to interact with its tools and actions:

    (A) The Scene Information

    (B) The ProBuilder menu

    (C) ProBuilder shortcuts

    (D) Editor windows

    (E) The ProBuilder Preferences window

    (F) Transform tools for ProBuilder

    (G) ProBuilder component windows

    (H) The ProBuilder toolbar and the Edit mode toolbar

    (I) Options for ProBuilder actions

    (J) ProBuilder's custom Tool panel

    Scene Information

    Dimensions Overlay

    Scene Information displays information about the Meshes in the scene, and which elements are selected.

    To toggle this on or off, use the Show Scene Info setting in the Preferences.

    Editor windows

    Editor windows

    Editor windows provide features with extended functionality. For example, the UV Editor window (in the example image above) allows you to perform advanced texture manipulations, including texture mapping, UV unwrapping, and tiling.

    To access these windows, use the Probuilder menu, shortcuts, or the tool section of the ProBuilder toolbar.

    Component sections in the Inspector

    Pro Builder Shape, Poly Shape, ProBuilder MeshFilter, and Bezier Shape components

    Most of these component sections appear in the Inspector when you create a Mesh with one of the creation tools:

    • Shape
    • Poly Shape
    • Bezier shape (Experimental)

    When you first activate a creation tool, Unity adds these components to the new GameObject. They expose specific properties defined in the corresponding scripts which help define the topology. After you create the new Mesh, you can re-activate the tool for the same Mesh and change these properties to modify the Mesh's shape.

    Note: When you re-activate one of these tools, you lose any modifications you made to the Mesh through an action or through the Cut tool. For example, imagine you create a new Poly Shape with five points, and then extrude one of the faces. Next, you decide to remove one of the points, so you enter Poly Shape editing mode again. The extrusion disappears as soon as you re-enter Poly Shape editing mode.

    In addition to these creation tool components, every ProBuilder object has a ProBuilder MeshFilter component. It lets you customize lightmap UV parameters for each object. When you ProBuilderize a Mesh that was either exported into Unity or created as a regular primitive Unity Mesh, Unity adds this component to the Mesh.

    Transform tools in ProBuilder

    Translating a Face in ProBuilder

    Most of the time, you interact with ProBuilder with translation, rotation, and scaling tools in much the same way that you interact with Unity. However, ProBuilder uses a combination of Edit modes and special key combinations to interact at a much deeper level with your Meshes.

    For example, you can use the Shift key with the scaling and translation tools in Face mode to create insets and extrusions. This allows you to build complex Meshes easily.

    For an overview of working with ProBuilder, see Creating Meshes, Editing Meshes, and Materials, Shaders, Textures, and UVs.

    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023