com.unity.behavior 1.0.10
Source docsNotes: processedReleased May 22, 2025
Unity Compatibility
Minimum Unity: 6000.0 (16f1)
Package Dependencies
- com.unity.burst (1.7.2)
- com.unity.collections (2.1.4)
- com.unity.dt.app-ui (2.0.0-pre.16)
- com.unity.modules.ai (1.0.0)
- com.unity.modules.animation (1.0.0)
- com.unity.modules.audio (1.0.0)
- com.unity.modules.particlesystem (1.0.0)
- com.unity.modules.unitywebrequest (1.0.0)
- com.unity.nuget.newtonsoft-json (3.2.1)
✨ Features
- Blackboard variable UI elements expanded/collapsed state is now preserved across domain reloads for the duration of an Editor session.
- Added Queue mode for StartOnEvent node that preserves and processes messages sequentially. It can be used to preserve messages when multiple events are received in a single frame. (BEHAVB-290)
- Added `Allow Disabled Agent Debugging` to project settings > Behavior > Asset Settings.
- Graph debug now displays an "(Outdated)" tag on agents whose instance graph differs from the current version of the source graph.
📈 Improvements
- As part of the Muse product sunset, the generative AI features have been disabled.
- Updated the serialization sample so that now we save to a file and load from it between sessions.
- Blackboard asset variable are now readonly when viewed from the graph editor blackboard view. This change was made to clarify that default values should be changed from the source blackboard asset.
- `Patrol`, `NavigateToTarget` and `NavigateToLocation` action nodes now set animator speed based on agent velocity, even when not using NavMeshAgent component.
- Sticky notes now support rich text.
🔧 Bug Fixes
- Fixed a runtime serialization issues with monobehaviors in the sample.
- Fixed a variety of runtime serialization issues where inheritance between assemblies was causing issues. Lots of additional tests were added to ensure the fixes.
- Fixed graph asset with static subgraph reference loosing their SubgraphsInfo metadata when opening editor.
- Fixed performance issues when moving nodes around in the graph.
- Improved undo-redo handling of BlackboardVariable for Create, Detele, Rename and SetValue commands when blackboard editor is open.
- Improved blackboard view refresh mechanism.
- Fixed undo-redo not rebuilding the asset runtime data when needed.
- Fixed undo-redo inconsistent behaviors in both GraphEditor and BlackboardEditor.
- Fixed inconsistent undo-redo of BlackboardVariable SetValue command when a blackboard editor is open.
- Fixed undoing a delete operation on a `Conditional Branch` node failing to restore the True and False node.
- Fixes `BehaviorGraphAgent.SetVariableValue` not working when trying to assign value to a variable from a linked blackboard asset when the agent is not initialized.
- Fixed Behavior Graph not rebuilding runtime graph when edited during Play Mode. (BEHAVB-310)
- Fixed graph debugging nodes status not showing the correct status after editing a graph during Play Mode.
- Fixed graph debugging not tagging disabled agent as "(Disabled)" in the agent picker window.
- Fixed an issue in PatrolAction where the agent would incorrectly mark waypoints as reached during path calculation, causing it to skip waypoints when wait times were used. (Credit to @viento20340)
- Fixed navigation nodes not reverting NavMeshAgent speed to its original value when node's `OnEnd` was called.
- Fixed navigation nodes overriding default NavMeshAgent stopping distance post runtime deserialization.
- Fixed order of the Blackboard variable list in the Inspector window becomes unsynchronized when the list order is changed in the Behaviour Graph window's Blackboard. (BEHAVB-288)
⚠️ Known Issues
- `RunSubgraph (Static)` node doesn't refresh properly when the referenced subgraph asset is deleted.
- In regard to runtime serialization, `RunSubgraph (Dynamic)` is not yet fully supported and should not be use with runtime serialization. `RunSubgraph (Static)` is supported and can be use with runtime serialization.
- In regards to runtime serialization, shared variables will not restore their previously saved state after deserializing.
- Blackboard items re-ordering is now undo-able but some inconsistencies remains when redo-ing.
- When editing graphs in Play Mode, changes to shared blackboard variables will be reflected at runtime. However, agent-specific values will revert when exiting Play Mode. This can cause agent shared blackboard variables to become out of sync with source shared blackboard variables. Workarounds: To re-sync all shared variable instances, edit the
