Skip to content

Commit a80f011

Browse files
committed
Merge branch 'master' of github.com:fsstudio-team/ZeroSimROSUnity
2 parents dcf6544 + 354853b commit a80f011

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

README.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -91,19 +91,21 @@ https://youtu.be/VJyvjJUfjv8
9191

9292
* Ubuntu 18.04 or 20.04 (may work on MacOS or Windows but currently untested)
9393
* Unity 2020.x or greater
94+
* Git LFS
9495
* ROS Melodic (ZeroSim provides a pre-built Docker container for ROS functionality https://hub.docker.com/r/zerodog/zerosim_ros_vnc)
9596
* Note: ROS Melodic is our primary supported development environment, but ZeroSim has reportedly been able to run on Noetic and ROS2.
9697

9798
### Setting up a new Unity Project
9899

99100
1. In Unity Hub create a new Unity project using Unity 2020.x or later. ![New Unity Project](Documentation~/images/new_unity_project.png)
100101
2. Add ZeroSim via Unity Packages:
101-
1. Unity Menu `Window -> Package Manager`
102-
2. Select the `+` dropdown:
102+
1. IMPORTANT: Make sure GIT LFS is installed on your system before continuing!
103+
2. Unity Menu `Window -> Package Manager`
104+
3. Select the `+` dropdown:
103105
![Dropdown](Documentation~/images/unity_package_manager.png)
104-
1. Select `Add Package From Git URL...` and enter `git@github.com:fsstudio-team/ZeroSimROSUnity.git`. Note this can take upto a few minutes to update but you should see the following:
106+
4. Select `Add Package From Git URL...` and enter `git@github.com:fsstudio-team/ZeroSimROSUnity.git`. Note this can take upto a few minutes to update but you should see the following:
105107
![ZeroSim Package Installed](Documentation~/images/zerosim_package_installed.png)
106-
1. Import the ZeroSim Samples by selecting the Samples `Import` button in the Package Manager:
108+
5. Import the ZeroSim Samples by selecting the Samples `Import` button in the Package Manager:
107109
![Import ZeroSim Samples](Documentation~/images/import_zerosim_samples.png)
108110
3. **IMPORTANT** the default Unity physics settings do not work well with a lot of simulations. It is very much recommended (required for probably most all simulations) to set the physics settings by opening the Unity menu `Edit -> Project Settings... -> Physics` and set the `Default Solver Iterations` to `30` and the `Default Solver Velocity Iterations` to `60`. ![Unity Physics Settings](Documentation~/images/unity_physics_settings.png)
109111
4. **IMPORTANT** the default Unity fixed timestep setting does not work well with a lot of simulions. It is very much recommended to set the `Fixed Timestep` setting by `Edit -> Project Settings... -> Time` to `0.005` ![Timestep Settings](Documentation~/images/unity_timestep_settings.png)

0 commit comments

Comments
 (0)