Practical engineering guide
What you can build with Webots and where problems start
Webots provides a visual robot simulator with editable worlds, sensor models and controllers in languages including Python and C++. Its robot controller processes are separate from a production motor-control stack; ROS 2 integration runs through the supported webots_ros2 driver.
A first test you can reproduce
- 01.Launch a bundled sample world and inspect its robot's node and controller assignments.
- 02.Change one motor target and check the simulation's BasicTimeStep and device update periods.
- 03.If you need ROS 2, install the webots_ros2 packages matching your distro and start an official example before building a custom URDF bridge.
- 04.Export sensor output and compare controller rate and frame orientation with the hardware design.
Questions that come up during real implementation
Why does the robot model load but the Python controller never move a joint?
Confirm the Robot node references the correct controller and the motor device names in code match the world file. The controller must call robot.step(...) in its loop. Check torque/velocity limits and whether position or velocity control is active on the device.
Does Webots work with ROS 2 without custom wrappers?
The webots_ros2 driver offers supported examples and integration, but a custom robot still needs device mapping and messages for its own sensors and actuators. Verify the release matching your ROS distro; old webots_ros documentation targets ROS 1.
Why do repeated tests have different outcomes?
Fix world parameters and random seeds, log the simulation step, sensor rate and controller inputs, and avoid tying motion logic to host wall-clock timing. Graphics performance does not tell you whether each controller step used the intended simulated time.
Checks before using it on a robot
- Inspect collisions and joint orientation in a one-axis test first.
- Compare the same sensor frame through Webots and ROS 2 for timestamps and coordinate axes.
Official technical reference
https://cyberbotics.com/doc/guide/indexCompatibility and installation
- Developer
- Cyberbotics
- License
- Open source
- Operating systems
- Linux, Windows, macOS
- ROS support
- ROS 2
- Languages
- C, C++, Python, Java, MATLAB
- Installation method
- Official installer, package manager or source build