Skip to content

Latest commit

 

History

History
81 lines (66 loc) · 3.2 KB

README.md

File metadata and controls

81 lines (66 loc) · 3.2 KB

Multi Scene Tools

MultiSceneToolsIcon

Features

  • Scene Collection ScriptableObjects

    • Tracks which scenes are used together in runtime.
    • Double Click to load collection.
    • Set which scene is the active scene in the collection. (gets set automatically)
    • Track and add collection scenes to build settings.
    • (Coming) Tracks cross scene references.
  • Hierarchy Style

    • Icon and tooltip on scenes that belong to a scene collection
    • User defined scene collection color.
    • Checkmark on the target active scene for the collection
    • Icons for displaying which collection scenes are in the build settings
  • Multi Scene Management Window

    • Display currently loaded scene collection
    • Load scene collections
    • Load scenes additively
    • Unload scenes
    • Save and override loaded scene collection
    • Create scene collections from loaded scenes
    • Create new scenes and load it additively
    • Add all open scenes to build settings
    • See the current settings set in the config scriptable object
  • Multi Scene Loader

    • Load scene collections with this static class
    • OnSceneCollectionLoaded & OnSceneCollectionLoadDebug<SceneCollection, collectionLoadMode> events triggered on successful loading
    • Loading modes
      • Additive
        • Loads all scenes in a collection additively
      • Replace
        • Unloads all scenes other than the boot scene, then loads all scenes additively.
      • DifferenceReplace
        • Unloads all scenes the collections do not share, then load the missing scenes.
      • DifferenceAdditive
        • Load all scenes in the collection that is not already loaded
      • Subtractive [experimental] (not implemented for async)
        • unload all matching scenes
    • Async loading methods
      • preload scenes and activate when ready
      • defer unloading scenes and trigger unloading when ready
      • returns an AsyncCollection
        • track progression of the async operations
        • trigger activation of scenes
        • trigger unloading of scenes
    • (coming) Scene Node view, Connect scenes together with nodes to visualize adjacent scenes and automate when scenes should be loaded.
  • Multi Scene Tools Config

    • See and set current singleton instance
    • See and set current loaded scene collection
    • Toggle for allowing cross scene referencing (Cross scene referencing is not implemented)
    • Toggle for logging scene collection loading
    • Target path for boot scene or manager scene
    • Target path for loading scene collections

Examples

  • Scene Transitioner
    • Waits for the transition animation to finish before loading the next scene collection.
    • Tracks the in and out transition state

Setup

Author

License

  • Apache License 2.0 License. Refer to the LICENSE file