PX4-gazebo-models is a collection of simulation models and worlds for use with Gazebo and PX4 autopilot software.
The repository addresses the need to provide realistic 3D models and environment configurations for testing PX4 flight control systems in simulation. It maintains a curated set of models and worlds that are synchronized with the Gazebo Fuel repository at app.gazebosim.org/PX4. The project includes a simulation-gazebo script that automates the process of downloading models and worlds from the repository and launching them in Gazebo, configured to work alongside a running PX4 instance.
Developers should adopt this tool if they are working with PX4 autopilot and need a straightforward way to set up realistic simulation environments. It suits projects that require testing drone or aircraft behavior in Gazebo without manually managing model dependencies. The tool is particularly valuable for those who want to use community-maintained models rather than creating custom ones from scratch. The simulation-gazebo script provides flexibility through command-line arguments that allow users to specify custom worlds, configure network settings via Gazebo partitions and IP addresses, point to alternative model sources, and run in headless mode for containerized or server-only deployments.
The project maintains active engagement with its simulation infrastructure, supporting multiple configuration options for different deployment scenarios including interactive mode for custom model paths, local file directory or HTTP-based model sources, and the ability to overwrite existing model data. It provides both standard graphical simulation and headless operation suitable for continuous integration environments and macOS systems. The tool includes a dry-run mode for testing purposes, allowing developers to validate configurations without launching the full Gazebo simulator.
