See our wiki.
The RoboCup 3d plugin requires Gazebo 6 or higher. Follow the Gazebo installation tutorial for installing Gazebo on your machine.
To install the robocup 3D gazebo package in Ubuntu please use:
#!sh
curl -ssL https://bitbucket.org/osrf/release-tools/raw/default/one-line-installations/robocup3ds.sh | sh
An alternative step by step installation method is detailed below.
If robocup 3D gazebo simulator was installed using the one-liner this instructions are not required.
Clone the repository into a directory in your home folder:
cd ~; hg clone https://bitbucket.org/osrf/robocup3ds
Change directory in the robocup3ds repository:
cd ~/robocup3ds
Create a build directory and go there:
mkdir build
cd build
Configure robocup3ds (choose either method a
or b
below):
a. Release mode: This will generate optimized code, but will not have debug symbols. Use this mode if you don't need to use GDB.
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
b. Debug mode: This will generate code with debug symbols. RoboCup3dS will run slower, but you'll be able to use GDB.
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug ..
The output from cmake
may generate a number of errors and warnings
about missing packages. You must install the missing packages that have errors
and re-run cmake
. Make sure all the build errors are resolved before
continuing (they should be there from the earlier step in which you installed
prerequisites). Warnings alert of optional packages that are missing.
Make note of your install path, which is output from cmake
and should look something like:
-- Install path: /usr
Build robocup3ds:
make -j4
Install robocup3ds:
sudo make install
You can run the tests for the plugins from the same build directory by running:
make test
Code checking is done with cppchecker. Make sure you have it installed:
sudo apt-get install cppcheck
Then to run the check:
First move to the robocup3ds directory:
cd ~/robocup3ds
Then run the checker:
. tools/code_check.sh
Run the simulator to check your installation. A world with a soccer field should appear and there should be no errors printed in the terminal, so we know the plugins are running.
gazebo-robocup3ds --verbose
New features and bug fixes are more than welcome. Please, review the Gazebo guide for code contributions. We follow the same rules here.