Skip to main content

Changelog

Version 1.3.0​

New:

  • Ability to build your own TransitionManager via the ITransitionManager interface — for DI framework integration (e.g. Zenject) or any other project architecture.
  • Addressables support: scenes added to Addressables are marked on the graph with an ADR badge and no longer require a presence in Build Settings.
  • Delete Preview and Enable/Disable Auto-Preview buttons in the node Inspector to manage the preview of a specific scene.
  • New graph methods: IsOneWayOrigin() / IsOneWayDestination(), TryGetSceneDataByAddress() (when Addressables is enabled).
  • Force-refresh affected scenes on graph save setting — force-refreshes ITransitionComponent on affected scenes when the graph is saved.
  • SmartConnection improvements: the position of a new port now depends on the cursor position relative to other ports, plus tooltips while dragging a connection.
  • Support for the newer Unity 6 (6.3–6.7) — the package now works across the full 2023.2.10f1 to 6.7 range.

Changes:

  • WorldGraphContainer no longer owns the graph logic — the runtime graph is extracted into a separate WorldGraph class, accessible via WorldGraphContainer.GetWorldGraph() or ITransitionManager.Graph.
  • TransitionManager transition methods became asynchronous: GoTo / GoFrom / LoadScene → GoToAsync / GoFromAsync / LoadSceneAsync (returning Task); the old synchronous versions are marked [Obsolete], and the ignoreShortcuts parameter was removed from GoFromAsync on the interface.
  • Introduced the IWorldGraph interface — a clean runtime-graph contract; ITransitionManager.Graph is now of type IWorldGraph (implemented by the WorldGraph class).
  • Breaking change: RefreshContext.Manager is marked [Obsolete]. Use RefreshContext.EditorGraph instead — see From 1.2 to 1.3.
  • TransitionManager.OnXxx events became instance properties TransitionManager.Instance.Xxx.
  • The IsShortcutOutput() / IsShortcutInput() extension methods were renamed to IsShortcutDestination() / IsShortcutOrigin(); IsOutput() / IsInput() now require an explicit ITransitionManager.
  • Graph nodes now show the scene name instead of the file path.
  • Scene Inspector WGE overlay: the Validate and Open TM buttons are replaced by a single Project Settings button; the currently active manager type (Default / Custom) is now shown.
  • Some graph Get methods (GetOppositePassageGuid, GetSceneDataByBuildIndex) were replaced by paired TryGet methods with an explicit bool + out. The old overloads are marked [Obsolete] — see Replacing Get methods with TryGet.

Fixes:

  • Fixed a bug where the graph was not updated when the container was saved.
  • Fixed a memory leak related to displaying the scene preview.
  • Fixed a SmartConnection bug that occasionally caused the auto-connection to fail.
  • Correct Undo/Redo behavior for scene preview display and for the disable-auto-capture button.

Version 1.2.0​

New:

  • Scene previews on nodes.
  • Scene Inspector WGE overlay showing information for the current scene.
  • Screenshot Utility WGE overlay for capturing scene previews.
  • Scene-switching buttons in the Toolbar.
  • Asset settings window at Edit > Project Settings > World Graph Editor.
  • Ability to manually configure per-phase transition delays via TransitionContext.
  • Scene validator.
  • Support for user-defined tests in the scene validator.
  • Scene reachability check on the graph.
  • QOL API improvements.

Changes:

  • The Refresh() method on ITransitionComponent now accepts RefreshContext instead of TransitionManager.
  • Refresh() on ITransitionComponent is now called automatically on scene, hierarchy, and graph changes.
  • Support for 2022.3 dropped.

Fixes:

  • To avoid potential ambiguity, port names with leading or trailing whitespace are now considered invalid. For example, "Left", "Left ", and " Left" are treated as the same name.
  • Various minor improvements and internal changes.

Version 1.1.0​

New:

  • RegisterAsyncHandler and UnregisterAsyncHandler now support CancellationToken for cancelling tasks.
  • Added a data-migration path from 1.0 to 1.1+.

Changes:

  • The data storage format in WorldGraphContainer changed.
  • All EditorOnly methods moved from WorldGraphContainer to WorldGraphContainer.EditorData.
  • The Func<Task> overloads of RegisterAsyncHandler / UnregisterAsyncHandler are no longer supported. Func<CancellationToken, Task> is now required.

Fixes:

  • Fixed a bug where calling TransitionManager.LoadScene() spawned the character at (0, 0, 0) instead of DefaultSpawnPoint.
  • Fixed a bug where registered async tasks were not cancelled when exiting Play Mode.

Version 1.0.0​

Initial release.