Skip to content

Quick start: a rig in 5 minutes

You need a scene with a ground mesh (a GameObject with a MeshFilter and a renderer) and, ideally, a directional light.

The fast way

Window > Fable > Setup > Add rig does steps 1 and 2 in one click. Then carry on from step 3.

  1. Create the rig. Add an empty GameObject, for example Fable. Click Add Component and add Fable System.
  2. Turn on modules. In the rig inspector, open the Config tab. Under ACTIVE MODULES, switch on Wind, Skybox, Clouds and Grass. Each switch creates a child GameObject (Wind, Skybox, Clouds, Grass) and assigns the package's default preset, material and shaders.
  3. Skybox uses the scene's sun (RenderSettings.sun, else the first directional light). If there is none, it creates a Directional Light under the Skybox object.
  4. Give the grass something to grow on. Open the Grass tab. Under SETUP > Patch > Surfaces, add an entry and drag your ground's MeshFilter into it. The grass builds straight away.
  5. The mesh must be readable: enable Read/Write in its model import settings.
  6. If the mesh has several materials, a Material Slot dropdown appears. Pick the slot grass should grow on, or All slots.
  7. Place the clouds. Cloud shadows cover a square (600 m by default) centred on the Clouds object. Move that object to the middle of your level, at ground height.
  8. Make the presets your own before you tune anything: click Copy beside each tab's preset. See Presets are shared assets.
  9. Add interaction. Put a Grass Interactor component on your player, or on anything that should push grass aside.
  10. Press Play.

Keep the Wind module on whenever you use grass. Blades face around the wind direction, and that facing is baked when the grass builds, so grass without a Wind module stands still.

Use one rig per scene. The Wind and Skybox modules write scene-wide state (global shader values, the skybox, ambient light and fog), so two rigs would fight over it.