Release notes

Here you find the release notes of CrowdSim3D.

Blender CrowdSim3D add-on


Release date: 2019/04/25


  • You can debug your node setup by activating the debugger in the properties panel of the node editor.


Added operations to Select and Deselect all agents and agent factories.


Increased the performance of the populate functionality. Especially noticeable with large crowds. In our roman scene it was around 20 times faster.

State properties

  • [StateOperation] Replaced the text entry field for Set Boolean to be a Check box. The previous implementation did an exact match with ‘true’ or ‘false as this was really unclear we replaced the text field with an check box.

Navigation mesh

  • [Navigation] the result of the navigation mesh incorporates the normal speed setting of the agent. Previous when using the navigation mesh the agent resulted in walking 1m/s. Now we can variate on that.

Look At

  • With the look at node an agent can look at a target.


Release date: 2019/01/18

Overall goal of this release was performance. We did this by

  • converting the main parts to RUST (
  • making use of all available processors during the simulation.
  • optimizing the way how we send simulation data back to blender.

By doing this we achieved enourmous speed-ups. Some of our tests went from half an hour to merely several seconds.

Distribute agents

  • Added an option to offset agents from their location
  • Added an operation to instantiate agents from all selected factories. Select some factories and look for the operations Instantiate Agents From Selection.


  • The height of an agent can be set. This is used during in the Collision node.

Collection Operation Node

  • New node to do set operations on collections of objects. Usefull when working With many factories.
  • Supports union, intersection, difference and symmetric difference operations.

Behavior Node

  • Added option to calculate subframes. We had this option in the Avoid node. In the Avoid node we could’t recalculate the whole simulation. By placing it in the behavior node we can.
  • Added option to Smooth frames. When this value is larger then 0 a post processing step will happen. During this step the result of the simulation is smoothened with the result of the surrounding frames. It is usefull to remove simulation glitches.

Check Attribute Node

  • Added option to test the position of an agent in a grid distribution. You can use this to add different behavior to agents that are on the border of the grid.

Check State Node

  • It was unclear how to check boolean states, eg what value to enter. We replaced this option with a Is True and a Is False check.

Play Action Node

  • Added Linear Ease Blend type.

Intersection Node

  • Added Local space bounding box check.

Limitted Blender 2.80 Support

Blender 2.80 is still under development. This release will have limitted support for Blender 2.80. This means that it could be that Blender 2.80 change its API (what is unlikely). And we need to adapt the add-on by supporting the new API changes.

The CrowdSim3D add-on makes use of Blender 2.80 collections for organizing objects in the scene. It puts agents and generated objects in collections so you can hide them when working with large scenes.

The EEVEE render engine is supported.


Release date: 2018/09/20


  • Option to set the radius of agents. This option is used by the avoid node.

Object Selector

  • The factory input now has an object picker. It used to be a text field.
  • Fixed issue when factory filter was turned on, but no factory was selected. This resulted in selecting all non-agent type of objects, making the system raise an exception when doing populate.

Check Attribute

  • Added option to check the factory of an agent.

Set Attribute Node (new)

  • New node where you can set an internal variable of an agent. Currently it only allows setting a new desired direction and speed of an agent. You can use this together with the advance ground movement node to let agents walk in one direction.


  • Added new avoid algorithms
    • Force based
    • Force based with time to collision

User Preferences

Bug fixes

  • Crash: Avoidance node required a navigation mesh. Without a navigation mesh it crashed
  • Crash: Material variable node where min value is larger than max value
  • Populate Agents populated all populate nodes what was not expected. Now it only populates the populate node where the button was clicked.
  • Added latest version check. The first time the add-on is used it will check with if there are any updated. The check will be performed at most once and it needs the Blender ID authentication add-on to be correctly configured.

0.90 Beta

Release date: 2018/09/10

Check Attribute

  • Added option to test the model and character of the active agent. This makes it possible to add model or character specific logic to the behavior tree.


  • Renamed Object node to Populate node.
  • Populate node can now populate multiple models. Per model a weight can be added for distribution.


  • Renamed the Variance category to Populate.
  • Target property selection was not displayed in the Navigate node.
  • Removed obsolete priority in Action tab.

0.81 Beta

Release date: 2018/09/03


  • Grid distribution is now a blender unit. This ensures a consistency between the distribution modes. Default grid distribution distance is set to 1.1.
  • Quincunx distribution pattern now calculates the distance between the agents better.


  • Every agent now has a Mass. This is used for calculating the impact force in a collision between 2 agents.
  • The object intersection node can now calculate the intersections between an agent and a group of objects. For example to check if 2 agents are colliding. When an intersection has been detected the impact of the collision is calculated.
  • Check attribute: A new node can check internal values of the crowdsim. It can test agent’s speed and collision impact.
  • Removed the dummy Collision Node.
  • Moved the Intersection node to the Collision category.


  • State property nodes did not display the state property selection.


  • Added a failure subtree. This makes it possible to do a if...else... construction with the conditional node. If you load an old file that uses a condition, you need to remove and add the condition again.

0.80 Beta

Release date: 2018/08/27

This is the initial Beta release