TransportSurface

For modeling conveyor systems or any kind of freely moving goods (what is called MU in realvirtual.io) on a surface you need to use a Transport Surface.

⚠️ Note: For standard speed-controlled accumulation conveyor systems, you should use the purely physics-based approach with TransportSurface.

However, if this approach becomes unstable or imprecise—especially in position-controlled systems (e.g., driven by PLCs)—consider switching to a guided transport setup:

  • Use GuidedTransport for force-based control.

  • Use KinematicMU for fully position-controlled, kinematic movement without violating physics constraints.

A Transport Surface is always connected to a Drive which is controlling the speed and position. The Transport Surface needs to be placed on the object which is also including the box collider for the surface itself.

If you are seeing instability with drives please check Physic solver settings as well as Stability of TransportSurfacesin Section Physics.

Here is a tutorial about defining your first conveyor:

Advanced Surface

The Advanced Surface option enables enhanced visual representation of the transport surface by automatically generating animated texture effects that are independent of object scaling.

When Advanced Surface is enabled, a child GameObject named Belt is created under the TransportSurface in the hierarchy. This object includes the ConveyorBelt component, which divides the surface into four segments. For each segment, a custom mesh is generated, allowing textures to follow the geometry of the surface—including curves—accurately and seamlessly.

Two different textures are available for use. The example below highlights the visual difference between the default and advanced textures.

💡 The size and placement of the Belt mesh are determined by the dimensions of the BoxCollider attached to the TransportSurface.

Advanced Surface
Advanced Suface

Connecting Drives to Transport Surfaces

To add a Transport Surface you can use the realvirtual.io menu or Add Component on the Gameobject itself. The Transport Surface will be added automatically to the Drive which is next (up in the hierarchy) to the Transport Surface. In some cases, you might need to change it or to add multiple Transport Surfaces to one Drive . You can do this on the Drive itself:

Drives above the TransportSurface Drive - using parent Drives

ParentDrives is only needed if IsKinematic Drives are moving TransportSurfaces in a linear direction or rotational direction, e.g. for turn tables or lifting devices.

Sometimes Unity Physics is very difficult and the solution to master it is a little bit weird. As described in Physics normal movements of a linear or rotational axis are not done based IsKinematic Rigidbodies. The transformation is done based on the Unity hierarchy and the position of Unity’s Transform because this is usually much more stable.

The Transport Surface is different from normal linear or rotational movements of an axis. It is using pure Unity physics functions for transporting the MUs.

This causes one problem. If it is for example necessary to combine a linear or rotational movement with the Transport Surface itself this will cause problems. Unity will not move the Transport Surface Collider as expected.

To prevent this the option ParentDrive is available on the Transport Surface:

This option will automatically decouple the Transport Surface upon simulation start and will make a function as expected possible. During simulation, the Transportsurface will be without a parent in the top level of the hierarchy. You can see an example in the Demo model TurningAndLiftingTransportSurface which can be found under realvirtual.io > Scenes:

When you build up more complex kinematic structures, make sure to always keep the gameobject with the component transport surface parallel to the kinematic structure of the other drive belonging to the surface. An further expample model is MovingTransportSurface which can also be found under realvirtual.io > Scenes. The picture below shows how to define such a structure. The parent drive of the transport surface is the one which is the lowest in the kinematic structure.

If the parent drive of the transport surface is rotating, the pivot points (centre of rotation) of both objects must be in the same position for the movement to be transmitted correctly. If necessary, an empty GameObject must be inserted to achieve this.

Constraints of transported Objects

You can choose if the constraints of objects which enter the transportsurface have to be changed or not. Setting the boolean ChangeConstraintsOnEnter or ChangeConstraintsOnExit to true will give the possibility to that.

© 2025 realvirtual https://realvirtual.io - All rights reserved. No part of this publication may be reproduced, distributed, or transmitted in any form or by any means, including printing, saving, photocopying, recording, or other electronic or mechanical methods, without the prior written permission of the publisher.

Last updated