Experimental Features¶
Massive Swarm System sometimes ships experimental features: capabilities that work today but whose shape, defaults, or existence may change in future updates.
What "experimental" means¶
Experimental feature contract
- Parameters, defaults, and behavior may change in patch updates without notice.
- The feature is not covered by the support promise.
- The feature may be removed entirely if it does not pan out.
- Existing scenes that use the feature may need re-tuning after an update.
If you are building production content, prefer stable features. Experimental features are useful for prototyping, profiling, and giving feedback that shapes the final design.
What ships experimental today¶
Three settings carry the marker, all in SwarmSettings. All three are off in a new Swarm Settings asset:
| Setting | Where | What it does |
|---|---|---|
| Congestion Reroute (the toggle on the foldout header) | Advanced → Surface Flow Field Navigation → Congestion Reroute | Rebakes the flow field so crowded corridors cost more, pushing later agents onto alternative routes. See Congestion reroute. |
| Assume Flat Ground Outside Field | Advanced → Surface Flow Field Navigation → Surface Grounding | Skips physics ground probes for agents outside the baked field by assuming flat ground at the field's lowest walkable cell height. See Swarm Settings. |
| Allow Agent Colliders As Ground | Advanced → Grounding | Lets agents stand on other agents, so a crowd can stack or climb. Not validated at high counts, which is why it is marked. See Swarm Settings. |
How they look in the inspector¶
An experimental setting carries a small orange Experimental pill, with the reason it is marked printed in small italics next to it. The pill adds no warning HelpBox and locks nothing: it is a label. A field under it can still be greyed for its usual reason, such as the Congestion Reroute fields while the header toggle is off.
Where the pill lands depends on the scope:
- A single setting: its own row directly above the field. Assume Flat Ground Outside Field and Allow Agent Colliders As Ground are the shipped examples.
- A whole section: the top of the section body, visible once you expand it. Congestion Reroute is the shipped example.
Nothing is disabled or hidden because of the pill. All three are off by default. The one shipped exception is the Pyramid demo, whose settings asset turns Assume Flat Ground Outside Field on, so a scene built from a copy of that asset inherits it.
How they look in the manual¶
The callout sits with the feature, near the top of the section that documents it:
Experimental
This feature is experimental. Parameters and behavior may change in future updates.
When a single field on an otherwise stable page is experimental, its own entry says so, rather than a callout over the whole group. Where enabling it in the wrong place breaks something, a warning follows the entry.
Giving feedback¶
If an experimental feature is close to what you need but has rough edges, tell us. Feedback is what decides whether one graduates to stable, gets reshaped, or is dropped. Discord is the fastest route; support@creativespore.com works too. Both are on the Help & Support page.