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 off until you turn them on:
| Setting | Where | What it does |
|---|---|---|
| Enable Surface Flow Congestion Reroute | Advanced → Surface Flow → 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 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. No warning HelpBox, no greyed-out field: it is a label, not a lock.
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, and all three ship off, so you will only ever be running one because you switched it on.
How they look in the manual¶
The callout sits with the feature, directly under the heading 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, it gets an inline (experimental) tag in its own entry and a warning right after it describing what goes wrong if you enable it in the wrong place, rather than a callout over the whole group.
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.