docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Output hierarchy reference

    Find the GameObject hierarchy and components the importer generates.

    The imported root GameObject mirrors the URDF joint tree. Each link's transform carries an ArticulationBody whose joint type maps from the URDF:

    URDF joint type ArticulationBody joint type
    revolute, continuous RevoluteJoint
    prismatic PrismaticJoint
    Any other type FixedJoint

    Joint limits populate the body's xDrive, and the <inertial> tag provides the inertial mass (links without one get a near-zero mass with gravity disabled).

    Under each link, the importer creates:

    Child GameObject Description
    visual MeshFilter and MeshRenderer components for primitives or meshes, using materials created from the URDF <material> definitions.
    collision Primitive colliders, direct convex mesh colliders, or VHACD hull* children.
    Sensor GameObject Created if the link declared a <sensor> element.

    The importer adds generated meshes, materials, and textures to the imported asset, so the whole robot is self-contained.

    Note

    This importer is separate from the optional external com.unity.robotics.urdf-importer package. Simulation Pro only compiles some visualization features (RobotVisualization, joint-state and trajectory visualizers) when that external package is present, behind the URDF_IMPORTER define. Those features rely on its UrdfRobot and UrdfJoint components and are unrelated to the importer described here.

    Additional resources

    • Import a URDF file
    • URDF sensor reference
    • URDF Importer inspector reference
    • Visualize and debug
    In This Article
    Back to top
    Copyright © 2026 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)