/object_scatter_docs

Documentation for Object Scatter, a tool for Unity to organically place objects on your scene.

banner Welcome to Object Scatter Documentaton, a tool for the Unity game engine. The main goal is to provide a simple solution to organically place props on your scene to speed up the level design process.

Notice: This tool works best with Unity 2021+.

Features:

  • Spawns multiple prefabs over a bezier path area
  • Use multiple modifiers to project your prefabs and randomize/offset position, scale and rotation
  • Spread the instances with modifiers for Poisson Disc Sampling, Even Spread or Random placing
  • Includes sample scenes with multiple examples
  • Project the instances on a grid or on top of colliders

image

You can buy Object Scatter on the Asset Store here.

Simple and Straightforward

Object Scatter is easy to use and uses only a couple of scripts to do the work for you. With only a couple of clicks you can place a lot of objects in your scene with collision filtering and using randomization properties. You can easily create pathways using simple gizmos that you can use to compose your scenario.

Also for Artists Only

You don’t know how to program and it’s only using a nice visual scripting plugin to make your game? Don’t worry! You don’t need any programming knowledge to use Object Scatter.

Getting Started

Go to the Samples folder and inside the Scenes folder you can explore the demos available.

image

Inside those scenes there will be one or multiple objects with a scatter script attached to them.

image

You can inspect each one of these scenes and initial scatters to see what are the basics that the tool can do. It spawns objects throughout a path area that you can modify by selecting the scatter object.

image

These areas can be a custom bezier curve, or a primitive like quad and circle.

image

Settings

All of the settings are very self explanatory on each section of the inspector. Here is an inspect on what each one of the sections are:

Setup

Contains some options for baking the mesh, if it should auto update on selection and the mode of execution (runtime or editor or either).

image

Baking

The items you setup in the next section are baked it into one single mesh per material.

image

It generates objects with a baked mesh based on the prefab's material. So make sure the prefab being used here on items has a MeshFilter AND a MeshRenderer at the root of it. For now I'm not supporting baking multiple meshes that are child of the root prefab being added to the items list.

Items

On this section you can control which prefabs are you going to use.

image

Modifiers

Modifiers are the core of the placing. Here you have multiple options to project your prefabs onto the the area.

image

You can make items spreaded evenly, randomly, using Poisson Disc Sampling algorithm, choose to project them into grid, colliders below the scatter path or even a mesh. Some of the modifiers that are currently included are:

  • Even Spreading
  • Poisson Disc Sampling Spreading
  • Random Spreading
  • Project On Colliders
  • Project On Mesh
  • Transform Offset
  • Transform Randomization
  • etc

image

This also means you can create your own modifiers if you know how to code C#.

Exclusions

There is only one list on this section that represents the Object Scatter Paths that are being used as exclusions on your Object Scatter.

image

The Object Scatter has a path for itself, but these childs are simple Object Scatter Path objects that will help you exclude any object intersecting these paths. They are automatically added to the Object Scatter (the parent object) and also removed when deleted/removed. You can also freely manipulate them with the gizmos once you select them.

On some examples these Object Scatter objects have an exclusion path.

image

Scene Editing

You only need a couple of commands to edit a bezier curve.

  • Shift + Left Mouse Click on an existing bezier line to create a new point.
  • Shift + Right Mouse Click on an existing point to remove it.
  • Use the mouse to select/move the points on the bezier curve.

For more info on this check this tutorial.

Check out the wiki

Need more info on how to use the tool? Check out the project wiki.

Also the Quick Setup for Beginners.

If you have any problems you can contact me at contact@elvismd.com.

I hope you can find this asset useful for your level design and can speed up the process of your scene composition. Please don’t forget to leave a review on the Asset Store to support the Object Scatter tool.

Thank you!