> For the complete documentation index, see [llms.txt](https://sonity.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sonity.gitbook.io/docs/sonity/changelog.md).

# Changelog

The timeline of changes in Sonity

#### 1.2.0.1 - Unity 6.5 Serializable and bugfixes (2026 September)

Unity Upgrade: Support for Unity 6.5 and newer, with Serializable and NonSerializeable attributes.\
Fix: Fixed so that SoundEventInstance is reset properly regarding cooldown when re-using instances.\
Fix: Stop with SoundEvent/SoundTrigger/SoundPicker doesn't give warnings if SoundManager is null.\
Fix: Text color of the Statistics didnt look correct in dark mode.\
Fix: Moved some settings around and fixed tooltips.\
Fix: Fixed some auditor code warnings.

#### **1.2.0 - Force2D, Optimizations & Statistics Upgrade (2026 July)**

Please remove the whole Sonity folder before upgrading.\
After upgrading you need to run "Tools/Sonity 🔊/Legacy/Sonity 1.2.0 Assets Upgrade: Reserialize All Sonity assets for new GUIDs" to save the new GUIDs and cached names.\
New Feature: Force2D is now added as a SoundParameter and Modifier, enabling you to make any 3D sound into a 2D sound.\
New Feature: SoundEvent preview drawer for easily previewing SoundEvents in the editor (created by Dangledorf <3).\
New Feature: SoundManager Statistics now remade with better overview, better filtering and a more compact layout.\
New Feature: SoundManager Debug All setting locally per computer with EditorPrefs and a "Force Debug" setting for e.g. example & debug scenes.\
New Feature: Added Select SoundManager and Editor Tools Menu for all assets (Select SoundManager default shortcut Shift+M)\
New Feature: Added new tools: Select all Sonity assets and Reserialize all Sonity assets.\
Optimization: Added SoundManager setting "PlayOneShot Optimize" which will use PlayOneShot() instead of Play() when possible for increased performance.\
Optimization: Added SoundManager setting "Voice Effect Disable" for low-end platforms (scripting define symbol "SONITY\_DISABLE\_VOICE\_EFFECTS").\
Optimization: Optimized SoundManager with higher performance iteration and lookups.\
Optimization: Using cached names for scriptable objects.\
Optimization: SoundEventInstance remove MonoBehaviour dependency and less Transform updates for Voices.\
Optimization: Now allowing for manual update of the SoundManager Update with SoundManager.Instance.ManualUpdate() (scripting define symbol "SONITY\_ENABLE\_SOUNDMANAGER\_MANUAL\_UPDATE")\
Optimization: Optimized generally with less array resizes, creating less garbage and increasing performance.\
Removed: SoundEvent & SoundContainer specific reference finders, use the new Reference Finder instead.\
Fix: Fixed bug where SoundPolyGroups wouldn't properly lower polyphony in runtime.\
Fix: Fixed bug where SoundEvent timeline values didn't save.\
Fix: Fixed bug where SoundTimeScale did not reset properly on domain reload.\
Fix: Added info for "Tools/Sonity 🔊/Legacy" of which version each upgrade is referring to.\
Fix: Added Asset Postprocessor which initializes Sonity scriptable objects.\
Fix: SteamAudio SoundContainer settings are now saved even if SteamAudio is disabled.\
Fix: Fixed so that when AudioListener and AudioListenerDistance is null, it will return max distance.\
Fix: Fixed SoundManager.Instance null warning on Start() which was erroneous.\
Fix: Fixed minor editor bugs in EditorDebugDrawInGame/SceneView.\
Fix: Fixed so RuntimeInitializeOnLoadMethod is used consistently everywhere.

#### **1.1.2.1 - Unity 6.5 GetEntityId Support Hotfix (2026 July)**

Hotfix: Bugfix GetInstanceID replaced with GetEntityId from base objects.

#### **1.1.2 - Unity 6.5 GetEntityId Support (2026 June)**

Please remove the whole Sonity folder before upgrading.\
Unity Upgrade: Support for Unity 6.5 and newer, where GetInstanceID is replaced with GetEntityId.\
Unity Upgrade: Support for Unity 6.4 and newer, where FindObjectsByType FindObjectsSortMode is deprecated.\
Tools Upgrade: Editor Tool Reference Finder: Cached search!, live editing, and a lot of quality of life fixes.\
New Feature: Global SoundTag in SoundManager now supports multiple values (legacy support with "Tools/Sonity 🔊/Legacy/Add Scripting Define Symbol for Legacy Functions Global SoundTag").\
New Feature: SoundDataGroup expanded with support for SoundEvents, SoundContainers and AudioClips.\
New Feature: Added object name fixer at "Tools/Sonity 🔊/Fix Object Names".\
New Feature: Added GetMaxDistance() for SoundEvents.\
New Feature: Added GetAddressableAudioMixerHasLoaded() and ActionAddressableAudioMixerLoaded;\
New Feature: Editor Tool Select Same Type can now select multiple types.\
Examples: Added example scenes for Steam Audio and PlayMaker.\
Examples: Added an example of SoundParameter using Update Mode Continuous.\
Examples: Fixed material compability with automatic replacement between BRP, URP, HDRP and SRP.\
Fix: Fixed AudioListenerDistance bug.\
Fix: Fixed GetContainsLoop() bug.\
Fix: Set AssetGUID and initialize SoundEvent timeline when creating assets.\
Fix: Improved the pseudo random AudioClip selection function.\
Fix: Implemented FixedTime timescale which was missing.\
Fix: Replaced Sonity EditorPath with System.IO.Path.\
Fix: Simplified the example scripts input system code.\
Fix: Added fix for "invalid seek position" which happened sometimes in Unity 2021.\
Fix: Combined Add Component menu items into one folder.

#### **1.1.1 - 2D/3D Info & Fixes (2025 September)**

Please remove the whole Sonity folder before upgrading.\
New Feature: Added 3D/2D sound info for the [SoundContainer](/docs/soundcontainer.md) and [SoundEvents](/docs/soundevent.md) for better overview.\
New Feature: Added [SoundContainer Distance Scale](broken://pages/ZqxKQf6T7jI3LUAnAyOR#settings) info and batch replace when multiple objects are selected.\
New Feature: Added [SoundContainer preset](/docs/soundcontainer.md#presets) "UI" and and fixed so all Presets set Reverb Zone Mix.\
Legacy: [Support for renamed music & 2D functions](/docs/sonity/legacy-support.md) with "Tools/Sonity 🔊/Legacy/Add Scripting Define Symbol for Legacy Functions Music and 2D"\
Fix: If materials are pink, select all "ExampleMaterial" and upgrade to URP with Edit -> Rendering -> Materials -> Convert Selected Built-in Materials to URP.\
Fix: Fixed so [Log SoundEvents Owner](/docs/soundmanager.md#log-soundevents) will show the proper owner when Polyphony Mode Limited Globally is used.\
Fix: Fixed bug where steam audio sources werent force-updated, which made occlussion not work.\
Fix: Fixed [SoundEvent](/docs/soundevent.md) mute, solo and disable color transparency.\
Fix: [SoundPreset](/docs/soundpreset.md) when creating assets added SetDirty.\
Fix: Editor Sound Preview AudioListener fixed HideFlags.\
Fix: Added nullchecks to [SoundManager](/docs/soundmanager.md) Log and changed the default values.\
Fix: Changed so all asmdefs use GUIDs.\
Documentation: Added info about legacy support in documentation.

#### **1.1.0 - Steam Audio & PlayMaker Integration (2025 June)**

Please remove the whole Sonity folder before upgrading.\
Rename: Renamed Play2D() to UIPlay() and PlayMusic() to MusicPlay() with the same pattern for all all other Music & 2D/UI functions.\
New Feature: Added integration for [Steam Audio](/docs/integrations/steam-audio-integration.md), enabling features like occlussion, reflection and propagation.\
New Feature: Added integration for [PlayMaker](/docs/integrations/playmaker-integration.md), adding actions to implement sounds using visual scripting.\
New Feature: Added [async startup](/docs/soundmanager.md#docs-internal-guid-dcaf7a58-7fff-9584-39bc-aabab3d35a26), enabling quicker load times when using the addressable AudioMixer.\
New Feature: Added Example scene for [AudioListenerDistance Override](/docs/soundmanager.md#audiolistenerdistance-component).\
Fix: Renamed "Adressable" to "Addressable" for eg SONITY\_ENABLE\_ADDRESSABLE\_AUDIOMIXER.\
Fix: Fixed bug where Music/UI Stop, Pause, Unpause wouldn't work if Limited Globally polyphony was used.\
Fix: Fixed bug where WebGL build could give the error "An invalid seek position was passed to this function".\
Fix: Fixed so when [SoundContainers](/docs/soundcontainer.md) are added, removed or changed in the [SoundEvent](/docs/soundevent.md) at runtime it will update live in the editor.\
Fix: Fixed bug where StopEverything, StopAllAtOwner, StopAtPosition might give an error.\
Fix: Fixed bug where virtualized loops random start position wouldn't be randomized.\
Fix: Fixed bug where volume increase settings mismatch would make the sound preview not work properly.\
Fix: Fixed bug where play on [Trigger On Stop](/docs/soundevent.md#trigger-on-stop) in combination with StopAllAtOwner might cause errors.\
Fix: Fixed bug where SoundEventCopy would copy the wrong volumeRatio value.\
Fix: Fixed so Enable Volume Increase volume is set on awake.\
Fix: Fixed so [SoundTrigger](/docs/soundtrigger.md) initialises when it is triggered.\
Fix: Polished the [TemplateSoundVolumeManager](https://sonity.gitbook.io/docs/sonity/pages/x5ioYp59iaMMelgNSm6F#templatesoundvolumemanager.cs).\
Fix: Fixed the [SoundPreset](/docs/soundpreset.md) default settings.\
Fix: Fixed bug where GetAngleToAudioListener would throw warnings.\
Fix: Fixed so that the AudioListener is reset in edit mode when previewing sounds.\
Fix: Changed so GetLastPlayedClipLength returns Mathf.Infinity when its null (returning 0 caused problems when TriggerOnTail and delay was combined).

#### **1.0.6 - The Big Volume & Debug Update (2024 November)**

Bug Note: Sonity 1.0.6 users have reported problems with overriding the Start Postion, this is can be fixed by upgrading to Sonity 1.1.0 or later.\
Please remove the whole Sonity folder before upgrading because scripts were moved.\
Support: Added support for Unity 6 (velocity replaced with linearVelocity).\
New Feature: [Added support to increase the volume](/docs/soundmanager.md#settings) of [SoundEvents](/docs/soundevent.md) and [SoundContainers](/docs/soundcontainer.md) by +24 dB each and [SoundVolumeGroups](/docs/soundvolumegroup.md) by +12 dB.\
New Feature: Added [SoundEvent Base Volume & Polyphony settings](/docs/soundevent.md#base) (convert old to new with "Tools/Sonity 🔊/Convert SoundEvent Modifier Volume and Polyphony to Base").\
New Feature: Added [SoundVolumeGroup](/docs/soundvolumegroup.md) objects for linked [SoundEvent](/docs/soundevent.md) volume control.\
New Feature: Added [SoundManager Debug Log SoundEvents to console](/docs/soundmanager.md#log-soundevents).\
New Feature: Added [debug settings per SoundEvent](/docs/soundevent.md#debug) for e.g. hiding or changing color of debug drawing and logging.\
New Feature: Added [new editor tools "Selection History", "Reference Finder" and "Select Same Type"](/docs/soundmanager/editor-tools.md).\
New Feature: Added [SoundContainer setting "HRTF Spatialize"](/docs/soundcontainer.md#advanced-settings) for external spatializer plugin support.\
New Feature: Added fields for the [AudioListener and the AudioListenerDistance for easy debugging](/docs/soundmanager.md#debug).\
New Feature: Added support for having the [AudioMixer as an addressable asset in the SoundManager](/docs/soundmanager.md#docs-internal-guid-dcaf7a58-7fff-9584-39bc-aabab3d35a26).\
New Feature: Added "Note" fields for all scripable objects.\
New Feature: Added addressable support for scriptable object asset comparison by adding custom GUIDs to all scriptable objects.\
New Feature: Added SoundEvent.GetContainsLoop().\
New Feature: Added SoundEvent.GetLastPlayedAudioSource().\
New Feature: Added [SoundManager Debug Draw SoundEvents](/docs/soundmanager.md#draw-soundevents) added "Hide Closer Than" in game view setting.\
Documentation: Added links in the documentation changelog.\
Fix: Removed AudioMixerGroup from the [SoundContainer](/docs/soundcontainer.md). Convert with: "Tools/Sonity 🔊/Legacy/Apply SoundContainer AudioMixerGroup to [SoundEvent](/docs/soundevent.md) if None".\
Fix: Fixed so preview uses Global Volume.\
Fix: Fixed bug where [SoundPreset](/docs/soundpreset.md) [SoundEvent](/docs/soundevent.md) creation would return null [SoundTag](/docs/soundtag.md).\
Fix: Removed ducking limiter from AudioMixer example because it sometimes seemed to make audio silent when lots of things were playing.\
Fix: Better find AudioListener & AudioListenerDistance where disabled objects doesnt count.\
Fix: Fixed problem where sound would be stopped when RunInBackground is disabled and not restart when Unity regains focus.\
Fix: Removed debug of missing [SoundManager](/docs/soundmanager.md) when application is quitting.\
Fix: Added checks and info that the [SoundPicker](/docs/soundpicker.md) is not nestable in an array or custom class because it is built upon CustomPropertyDrawer.\
Fix: Cleaned up [SoundMix](/docs/soundmix.md) functions.\
Fix: Fixed the icons for the scriptable object with new higher resolution versions and better import settings.\
Fix: Replaced deprecated FindObjectOfType and FindObjectsOfType with newer versions when supported.\
Fix: Fixed example scenes Unity downgrade bug where BoxCollider sizes were set to size 2.\
Documentation: Fixed info about [SoundMix](/docs/soundmix.md) and AudioMixerGroup.\
Change: Made Advanced subcategory for Settings in [SoundContainers](/docs/soundcontainer.md), [SoundEvents](/docs/soundevent.md) and the [SoundManager](/docs/soundmanager.md).\
Change: Removed the create [SoundPolyGroup](/docs/soundpolygroup.md) for SE shortcuts.\
Change: Fixed the default [SoundManager](/docs/soundmanager.md) Instance Statistics settings.\
Change: Increased the [SoundContainer](/docs/soundcontainer.md) "ReverbZoneMix Distance Increase" from 0.1 to 0.5.

#### **1.0.5.1 - Fixes (2024 May)**

Fix: Fixed bug where AudioListener wasn't checked if it was disabled properly.\
Fix: Fixed bug where SoundPreset copied [SoundEvent](/docs/soundevent.md) modifiers and [SoundEvent](/docs/soundevent.md) [SoundTag](/docs/soundtag.md) settings by reference instead of by value.

#### **1.0.5 - SoundPhysics Update (2023 December)**

New Tutorial: [SoundPhysics & Intensity Tutorial](https://youtu.be/ehnwL678N4E)\
New Feature: Support for addressables (deleting [SoundEvents](/docs/soundevent.md) in runtime).\
New Feature: [SoundPhysics](/docs/soundphysics.md) is expanded with support for Is Trigger and exit sounds.\
New Feature: New [SoundPhysicsConditions](/docs/soundphysics.md) object for advanced reusable conditions and terrain layer support.\
New Feature: Added a [SoundPreset](/docs/soundpreset.md) object enabling custom presets for [SoundEvents](/docs/soundevent.md) and [SoundContainers](/docs/soundcontainer.md).\
New Feature: Added Pause/Unpause functions e.g. Pause/Unpause AllAtOwner, Everywhere, Everything, 2D, All2D, Music, AllMusic.\
New Feature: Added [SoundManager](/docs/soundmanager.md) functions and settings Global Pause and Global Volume.\
New Feature: Added [SoundManager](/docs/soundmanager.md) setting for Sound Time Scale and default is changed from RealtimeSinceStartup to UnscaledTime.\
New Feature: Added [SoundEvent](/docs/soundevent.md) settings Ignore Local Pause and Ignore Global Pause.\
New Feature: Added GetMusic and Get2D functions like e.g. GetMusicSoundEventState().\
New Feature: Better UnityEvent support by adding [SoundEvent](/docs/soundevent.md) functions with less parameters like StopAllowFadeOut and StopImmediate etc.\
Deprication: [SoundPhysics](/docs/soundphysics.md) is reworked with arrays of SoundEvents, automatic conversion system is added in the editor.\
Deprication: [SoundPhysics](/docs/soundphysics.md) is reworked to use object references so old tags must be remade.\
Documentation how to: Added How To - Optimize AudioClip Settings.\
Documentation how to: Added How To - Rename A Lot of Assets.\
Documentation how to: Added How To - Debug Sounds and Performance.\
Documentation: Documented [SoundTrigger](/docs/soundtrigger.md) and [SoundPicker](/docs/soundpicker.md) functions.\
Documentation: Updated info on AudioMixerGroup performance tips.\
Documentation: Added video tutorial links.\
Change: SoundPhysics is split for performance reasons into SoundPhysics, SoundPhysics2D, SoundPhysicsNoFriction, SoundPhysics2DNoFriciton.\
Change: Renamed [SoundTrigger](/docs/soundtrigger.md) enum StopNoFadeOut to StopImmediate.\
Change: Renamed StopAllAt2D() to StopAll2D().\
Change: Renamed tools and create assets to "Sonity 🔊".\
Change: Renamed GetLastPlayedClipTime() to GetLastPlayedClipTimeSeconds.\
Addition: Added GetLastPlayedClipTimeRatio().\
Addition: Added SoundTrigger Actions: Pause, Pause Forced, Unpause.\
Addition: Added SoundEventState.Paused.\
Addition: Added [SoundPhysics](/docs/soundphysics.md) example scenes including friction, exit, Trigger On etc.\
Addition: Added Intensity Scale Add and Scale Multiplier and Scale Max to 1 button.\
Addition: Added Intensity Debug Zoom for easier visual debugging.\
Addition: Added Tools "Set Selected Assets as Dirty (Force Reserialize for Resave)".\
Addition: Expanded Example\_AudioMixerWithLimiter with AMB, MUS, SFX, UI, VO.\
Fix: [SoundContainer](/docs/soundcontainer.md) distance scale is hidden when distance is disabled.\
Fix: Increased the contrast of the [SoundEvent](/docs/soundevent.md) and [SoundContainer](/docs/soundcontainer.md) icons.\
Fix: Fixed so automatic crossfades work with sound names ending with "loop".\
Fix: Fixed [SoundParameterIntensity](/docs/soundparameter/soundparameterintensity.md) continuous threshold stopping sounds and restarting loops.\
Fix: Fixed problem where [SoundPhysics](/docs/soundphysics.md) friction didnt work as expected.\
Fix: Fixed bug where [SoundParameters](/docs/soundparameter.md) weren't nullchecked.\
Fix: Fixed so [SoundContainer](/docs/soundcontainer.md) volume can be increased when multiple objects are selected and volume is at -0 dB.\
Fix: Optimized [SoundEvent](/docs/soundevent.md) recorded intensity drawing.\
Fix: Replaced all ToLower with ToLowerInvariant for greater language support.\
Fix: Fixed bug with create assets filename extension.\
Fix: Fixed nullcheck in [SoundPicker](/docs/soundpicker.md) for SoundManager.Instance.\
Legacy support: Fixed Unity 2018 compability by fixing: asmdef to non guid mode, SubsystemRegistration, GetContact.impulse, editor enum and header names.

#### **1.0.4 - Free Trial Release (2023 June)**

New Feature: Free trial version released.\
Fix: Fixed bug where audio positions were based on the previous frame.\
Fix: Fixed bug where disabled [SoundEvents](/docs/soundevent.md) played in builds.\
Fix: Fixed scripts for free trial version.

#### **1.0.3 - Support for Disabling Domain Reloading (2023 June)**

New Feature: Support for disabling domain reloading in the “enter play mode options”.\
New Feature: [Override Listener Distance with the AudioListenerDistance component](/docs/soundmanager.md).\
Fix: Parented all Sonity scene objects created in runtime under the [SoundManager](/docs/soundmanager.md).\
Fix: Improved documentation on how to bind shortcuts.\
Fix: Fixed SoundTriggerCustomEditor example code.\
Fix: Fixed preview TriggerOnTail tail length 0 bug.

#### **1.0.2.1 - Hotfix (2023 May)**

Hotfix: Fixed error in SoundContainer settings editor.

#### **1.0.2 - Mixed Fixes (2023 May)**

New Feature: [Pass Parameter setting in the SoundEvent](/docs/soundevent.md#settings) for passing [SoundParameters](/docs/soundparameter.md) to sub [SoundEvents](/docs/soundevent.md).\
New Feature: Added GetSpectrumData() to get the spectrum data from AudioSources.\
Support: Added support for using multiple disabled AudioListeners.\
Support: Added support for [SoundTrigger](/docs/soundtrigger.md) Custom Override and added examples in the documentation.\
Support: Fixed support in examples and the timeline for the new Input System Package.\
Fix: Fixed bug where [SoundEvents](/docs/soundevent.md) with global polyphony couldn't be stopped.\
Fix: Fixed nullcheck in [SoundPicker](/docs/soundpicker.md) for SoundManager.Instance.\
Fix: The [SoundManager](/docs/soundmanager.md) and sub objects are now moved to Vector3.zero at start.\
Fix: [SoundPhysics](/docs/soundphysics.md) removed collider requirement warning.\
Fix: Preparing code for trial .dll version.\
Fix: Fixed Find Assets OrderBy bug.\
Example: Added example scene showcasing [SoundPicker](/docs/soundpicker.md).\
Documentation: Added tips and info about "Unity Native Audio Support" in documentation.\
Documentation: [SoundPhysics](/docs/soundphysics.md) added info about rigidbody requirements.\
Documentation: Updated asmdef info in documentation.\
Documentation: Fixed documentation [SoundParameter](/docs/soundparameter.md) incorrect example code.\
Documentation: Fixed DontDestroyOnLoad tooltip.\
Documentation: Fixed [Modifier](/docs/modifiers.md) tooltips.\
Documentation: Fixed [SoundParameterIntensity](/docs/soundparameter/soundparameterintensity.md) summary.\
Documentation: Fixed Play2D summary.

#### **1.0.1 - Gun Tutorial (2022 November)**

New Feature: [Automatic asset creator](/docs/sonity/create-assets-from-selection.md) finds common denominator name.\
New Feature: [SoundContainer](/docs/soundcontainer.md) presets added set automatic looping and automatic crossfades.\
Example: Added new examples used in the new gun tutorials.\
Documentation: Updated documentation.\
Documentation: Minor spelling corrections of tooltips and documentation.\
Change: Changed so timeline zooms when holding down control and scrolling with mousewheel.\
Change: Changed so [SoundEvent](/docs/soundevent.md) [SoundTag](/docs/soundtag.md) always use modifiers.\
Change: Trigger On Tail default length changed to 0.\
Change: Trigger On Tail added warning if length is less than shortest AudioClip.\
Fix: Fixed bug with serialized cache bools.\
Fix: Fixed bug with [SoundTag](/docs/soundtag.md) position.\
Fix: Fixed bug with preview [SoundEvent](/docs/soundevent.md) distance scale.\
Fix: Fixed so debug logs only print in developent builds and the editor.\
Fix: Fixed nullcheck for camera in "Draw SoundEvents in Game View".\
Fix: [SoundEvent](/docs/soundevent.md) and [SoundManager](/docs/soundmanager.md) GetMaxLength removed forceUpdate.\
Fix: All helpboxes now respect GUI Warnings setting.\
Fix: Optimized [SoundManager](/docs/soundmanager.md) update.\
Fix: Cleared SoundEventInstanceDictionaryValue.cs\
Fix: Changed template scripts to useDontDestroyOnLoad to public.

#### **1.0.0 - First Release (2022 October)**

Release.