DOTween is compatible with Unity versions 2022 to 5.6.7.
Works with:
Win, Mac, Linux, Unity WebPlayer, WebGL, iOS, Android,
Windows Phone, UWP (only via IL2CPP starting from v1.2.055), PS Vita (PSM), PlayStation, Xbox, Nintendo Switch + more (didn't test additional platforms but it should work everywhere except with the discontinued Flash export)
For bug reports, suggestions etc please check out the support section.
NOTE: on UWP you must disable safe mode (it's a Unity issue and they're working on it). Consider that this means you'll have to take care yourself of killing tweens when their target becomes NULL.
Also, starting from DOTween v1.2.055, UWP is supported only via IL2CPP (safe mode works correctly with IL2CPP).
NOTE: on iOS safe mode works only if stripping level is set to Strip Assemblies or Script Call Optimization is set to Slow and Safe, while on Windows 10 WSA it won't work if Master Configuration and .NET are selected.
Download DOTween v1.2.765
(February 4, 2024)
IMPORTANT: if you're upgrading from a pre-Modules version follow these instructions.
DOTWEEN PRO OWNERS: if you have a Pro version older than 1.0.041 do not upgrade DOTween from here, but first upgrade your Pro version from the Asset Store.
The mighty dudebxl also created DOTween actions for PlayMaker. You can grab them here.
Also, the mighty Doozy made a pro package.
IMPORTANT: if you're upgrading from a pre-Modules version follow these instructions.
After importing a new DOTween update, you have to setup DOTween in order to activate/deactivate Modules.
To setup DOTween, open the DOTween Utility Panel from the Tools menu, then select "Setup DOTween..." from the panel that appears.
Done method now returns the tween so it can be chained correctlySequence.JoinCallback methodDone chainable methodEditorPreview throwing errors in some Unity versionsDOVirtual.Vector2 methodtween.isLoopingBackwards propertyWorldAxisAdd or LocalAxisAddDORotate on Y axis not working correctly in some cases (bug introduced in v1.2.690)DORotate with RotateMode.Fast not taking the shortest route in case of negative valuesIndexOutOfRangeException when killing a tween inside its OnComplete callback when the tween had already been killedEvaluateAndApply methodDOTween.unscaledTimeScale property, to allow changing the global TimeScale only of unscaled tweensDOTween.TotalTweensById method, which returns total number of tweens with a given IDTotalActiveTweeners and TotalActiveSequences methodsSetSpeedBased or infinite-loop tween to a SequenceVector3 overload to DOVirtual.EasedValuerandomnessMode parameter to Shake tweens, which allows for either full (previous behaviour) or harmonic shakesOnWaypointChange not being called correctly in some casesTweenParams and SetAs not setting intId and stringId correctlyDORotate on single axis creating a wobbling animation in some casesGameObject (instead of a Transform is set as a target for path tweensDOTween.TotalActiveTweens() methodtransform.DODynamicLookAt method (same as DOLookAt but also updates the lookAt point every frame: useful when your transform is moving)DOTween.Sequence(target) overload that accepts a target (same as chaining a SetTarget to it)tween.SetInverted method that completely inverts the tween animation while keeping the play direction as forwardstatic DOCurve class, that allows to get curve points and data without creating a tweenFrom(immediate, relative) that allows to prevent the tween to setting the From value immediately (as by default behaviour)RectTransform.DOShapeCircle which allows to animate a UI on a circle around the given centertween.ManualUpdate methodDOTween.Kill overload with more optionsLookAt not working correctly if inside a non-uniformly scaled parenttween.Complete() from inside another tween's callbackDOJump/DOLocalJump OnStart not being called when using Goto without ever playing the tweenDOLocalJump not working correctly after another DOLocalJump inside a SequenceChangeStart/EndValue now accepts Color32 for Color tweensIndexOutOfRange exception when quitting the apptween.IsActive() now returns FALSE also if the tween is NULLAsync Await methodsSetDelay overload for Sequences that sets the delay as a one-time occurrence instead of using PrependIntervalisRelative parameter in From(value) overloadRigidbody2D.DOPath/DOLocalPathSetLookAt overload that allows to keep the Z rotation stableOnStepComplete being called multiple times if more steps were completed in the same frame but the callbacks killed the tweenDOTween.Goto/Complete not working correctly on speed-based tweens that weren't initializedtimeScaleIndependent tweens calculating erroneous time if run immediately at startupDOTween Utility Panel, to get more information in case of errorsRestart() preventing a Sequence from restarting if changeDelayTo was set, plus better intellisenseSetLinkIndexOutOfRange error, possibly foreverIndexOutOfRange and Object Not Cleaned errors introduced in version 1.2.270 and laterASMDEF usage in DOTween Utility PanelDOTween Utility Panel not showing all elements on Unity 2019.3betaExperimental Play Mode Optionssafe mode captured some errorsnested Tweens in a Sequence not being paused in the same exact frame if the Sequence is paused during a callbackDOGradientColor shortcuts not setting the target correctlyLog Priority being assigned before DOTween's Utility Panel's preferences are loaded in some casesDOText with a NULL stringPlayBackwards then immediately PlayForward would rewind a tween if it was completeDOTween.onWillLog method to intercept DOTween's logsASMDEF creation not working correctly with latest Unity versions (if you had them active, please remove them using DOTween Utility Panel and then recreate them)DOTweenUpgradeManager not being recognized and correctly deleted if outside of DOTween's parent folderAdd/remove ASMDEF button to DOTween Utility PanelFrom overload that allows to set a start value directlyPathType.CubicBezier that allows to create bezier path types via code (not available in DOTween Pro visual editor)TweenerCore generic ChangeStart/End/Values method that doesn't create any allocationsDORotateQuaternion not always choosing the shortest pathOnWaypointChange being called multiple times when restarting a loop set to Restartwarning CS0219 on DOTweenModuleUtils.PreserverSetLink chainable method when creating a tween, which can be used to link a tween to a gameObject and play/restart/pause/kill it when the gameObject active state changesIndexOutOfRangeException introduced in v1.2.060, which happened in some cases when a nested tween's target became NULL (or a callback threw an error) while the tween was runningPropertyIDDOTween.TweensById wasn't working correctly with string and int idsplaymodeStateChanged usage in Unity 2017.1DOTweenSettings being reset when Library is rebuiltIndexOutOfRange exception (and in case report it)reset parameter to DOTweenEditorPreview.StopDOTweenComponent to a sceneplayModeStateChanged API in Unity 2017 and laterKillAll exclusion array not working correctlyDOGradientColor didn't use eventual custom material property correctlyWaitFor coroutines overloads that return a CustomYieldInstructionRectTransform.DOAnchoredPos3DX/Y/Z shortcutsPlayerValidation errors during DOTween setupDOJump/DOJumpAnchorPos not working correctly in some casesmyTween.ElapsedPercentage returning NaN if the tween was never playedLogBehaviour to defaultfillableList optional parameter to methods that return a list, so it can be recycledDOBlendablePunchRotation by Steve StreetingSetId overload that accepts/uses int values directly and loops faster over themDOJump not working correctly with .NET 4.6tween.intId value being 0 (instead of -999) by defaultIndexOutOfRange exceptionUpdatType.ManualUpdate and DOTween.ManualUpdate methodSetLookAt with DOPath caused the target to end at the wrong positiononStart/Complete/etc) are now public, so you can add multiple callbacks to the same eventDOShake/Punch returning NaN values if the duration was 0 (now they warn you and don't create any tween)Tween.DOTimeScale shortcutRestart methods, that allows to change tween's delayTextMesh Pro (if you have DOTween Pro)IndexOutOfRange error when a Kill was called from within another KillDOBlendableRotate/LocalRotateBy considering values as absolute instead of relativeIPlugOptionsalsoCheckIfPlaying optional parameter to DOTween.IsTweening methodmaxSmoothUnscaledTime setting in DOTween's preferencesDOPath Rigidbody extension, but beware, it doesn't work with UWP because of a Unity bugGetCustomPlugin, which generated minimal allocations when creating a tweenpath.wpLengths is now publicOnWaypointChange callbackIndexOutOfRangeException happening under rare conditionsRectTransform.DOPivot/X/Y shortcutsfadeOut parameter to Shake tweensPlayForward/PlayBackwards overloads that accept a target or an IDuint tweens not working correctlyIndexOutOfRangeException happening in rare occasions when tweens capacity had not been manually setDOTween.KillAll from inside an OnComplete callbackDOTween Inspector > Added Play/Pause All buttonsScrollRect.DOHorizontal/VerticalNormalizedPos + DONormalizedPos shortcutsRectTransform.DoAnchorMin/Max shortcutsOnPlay being called before eventual delays are complete (only after first run)OnWaypointChange being called only once even if the tween went through multiple waypoints since the last updateFlash ease not being fluid when moving slowlyOnComplete not being called for last nested tween in case of very short SequencesDOTween Inspector > Added buttons to show more data about playing/paused tweensSpeedBased not calculating the correct time with rich-text string tweensFlash, InFlash, OutFlash, InOutFlash eases for flashing effectsFlash, InFlash, OutFlash, InOutFlash easesTransform.DORotateQuaternion/DOLocalRotateQuaternion shortcutsSequence.Join now considers also Interval insertion timedouble values erroneously accepting float end valuesRectTransform.DOAnchorPosX/Y shortcutsdouble valuesSequence.Join now considers also the time insertion of callbacksMaterial/SpriteRenderer/Image.DOGradientColor shortcutsDOJump not working correctly with Rigidbody2DDOTween.KillAll overload which accepts a list of ids and targets to exclude from the operationMaterial operation shortcutsOnPlay not being called when a tween restartswithCallbacks optional parameter to Complete and DOComplete methodsSequence.Join not working correctly in latest releaseSetRelative now works with Sequences too (sets all nested tweens as relative)tween.Loops() methodDOJump so it now works with SetDelay and OnUpdate callbacksDOJump not ending correctly in case of single loopsDOJump not working with SetRelativeLoopType.Incremental not working with pathsSmoothRewind/SmoothRewindAll/DOSmoothRewind control methodssmoothDeltaTime instead of deltaTime in DOTween Utility PanelmyTween.PathGetDrawPoints method, which returns a series of points useful to draw the path at runtimemyTween.ElapsedDirectionalPercentageDOJump now can change the final Y too, and adds a new jumpPower parameterTransform/Rigidbody/2D DOJump shortcutCamera shortcutsRectTransform.DOPunchAnchorPos shortcutMaterial.DOTiling/DOOffset shortcutsIndexOutOfRangeException issueChangeStart/End/Values#tween.PathGetPoint methodDOTween.TweensById and DOTween.TweensByTarget optional parameter which allows to return only playing tweens with the given filterTween.IsInitialized() methodRectTransform.DOShakeAnchorPos shortcutChangeEndValue throwing errors when called inside an OnUpdate callbackSetDelay not working correctly with named parametersOrientToPath not working correctly in case of local pathsTweensById not working correctly with DOTween Pro idsDOBlendableColor and DOBlendableFadeBy shortcuts to most elements that support color tweensMaterial.DOFade overload which accepts a property string parameterSetRelative not working correctly with some DORotate modesDOTween's Settings (using DOTween Utility Panel)DOScale shortcut now can also accept a float instead of a Vector3, to scale stuff uniformlyDOTween.Play/Restart(target, id) overload, to play/restart a tween only if both the given target and the given id correspondEaseFactory.StopMotion by Andrei StanescuDORewind/DORestart shorctuts working on all tweens instead than only on the ones started from the targetSequence Callbacks at 0 time not being fired after the first loop cycle (if using LoopType.Restart)myText.DOText and generic string tweens SetOptions have a new API, to implement the new rich text and scrambling optionslong and ulong tween supportIsTweening returning true if called inside the OnComplete callback of the same targetDOBlendableRotateBy, DOBlendableLocalRotateBy and DOBlendableScaleBy shortcutssequence.Complete(true) not completing nested tweenspath orientation not ending correctly with Linear open pathstween.GotoWaypoint throwing an error if called immediately after path creationDOBlendableMoveBy and DOBlendableLocalMoveBy shortcutsAudioMixer.DOSetFloat shortcut (Unity 5)IndexOutOfRange exception which could happen in rare occasionsRewind/Restart/Goto)DOTween.TweensById/Target/etc returning an error in some casesText.DOText shortcutDOVirtual.DelayedCall now returns a Tween so it can eventually be stored and paused/killed/etcSequences with LoopType.Restart not being rewinded correctly between each loop stepOnWaypointChange is now fired even at the very first weaypointImage.DOFillAmountDOVirtual.DelayedCallPathMode.Ignore, which will ignore any LookAt option you might passWaitForRewind coroutinemyTween.fullPosition get/set propertyDOVirtual.Float static methodDOVirtual.EasedValue static methodOnComplete now work with empty Sequences tooPreferences Tab, which allows to set DOTween's default valuesDOTween.defaultTimeScaleIndependent static propertymyTween.IsComplete() propertyDOTween.TweensById and DOTween.TweensByTarget static propertymyTarget.DOComplete methodDOTween.Kill()) have been renamed to DOTween.KillAll/RewindAll/EtcAll, in order to fix a bug when calling some of them. You will be warned (with an error log) inside Unity editor if you have to change your code accordinglymyTween.ForceInit()myTween.PathLength()DOTween.Kill(myTarget) and other similar static methods being interpreted as DOTween.Kill(true) because of Unity's implicit conversion of UnityEngine.Object types to booleanDOTween.defaultEaseType to Ease.OutQuad (was erroneously set to Ease.InOutQuadUpdateType.Fixed (though it's not recommended)UpdateType.Default to UpdateType.Normal (to avoid confusion when using the new DOTween.defaultUpdateType option)UpdateType.Fixed option, to make tweens update during FixedUpdateDOTween.defaultUpdateTypeUpdateTypes together could cause issues when killing/autokilling tweensClear then immediately creating new tweens could generate duplicate DOTween objects (and double or more each tween's speed)Clear and starting a new tween at the same timeLayoutElement.DOFlexible/Preferred/MinSize shortcutsGotoWaypoint method and OnWaypointChange callback for path tweensElastic ease not always bouncing in the correct directionDOAnchor and DOAnchor3D shortcuts renamed to DOAnchorPos and DOAnchorPos3DDOTween.TotPlayingTweens renamed to DOTween.TotalPlayingTweensLineRenderer.DOColor shortcutTrailRenderer.DOResize/DOTime shortcutsSlider.DOValue shortcutmyTarget.DOKill(complete) not behaving correctlyonComplete/onUpdate/onEtc properties are now internal so they won't be mistaken for OnComplete/OnUpdate/OnEtcTweenParms has been renamed to TweenParamsSetOptions that allows to choose which characters to use for scramblingSetAs not working on WebPlayercomplete parameter to Kill methodsGraphic.DOColor/DOFade shortcutsRectTransform shortcutsOutline.DOColor/DOFade shortcutsOnPause callbackDOTween.PlayingTweens and DOTween.PausedTweens static methodsText.DOFade/DOColor shortcutstransform/rigidbody.DORotate now has an additional option RotateMode which allows to choose if you want a regular, a beyond 360, an "add to world-axis" or an "add to local axis" rotationEase, which will be applied to the whole SequenceRigidbody2D shortcutsaudioSource.DOFade/DOPitch shortcutstransform/rigidbody.DOLocaAxisRotate removed and replaced by an additional RotateMode option in DORotateDOLookAt for rigidbodiesLoopType.IncrementalDOLookAt not working correctly with Sequences in some casesmaterial.DOFloat/DOVector shortcutsShake methods that allows to choose how much to shake on each axisDOTween Setup menu item inside Tools menu (so it can share it with other plugins)Sequence.Join methodtransform.DOPath) added to basic DOTween version (still very alpha)SetOptions and SetLookAt settings for path tweens (still very alpha)DOTween Setup menu item to setup additional shortcuts if the current Unity version is high enoughlight.DOShadowStrengthDOLookAt not working correctly with axis constraintsaxisConstraint parameter to DOLookAt methodsImage.DOColor/DOFade shortcutsCanvasGroup.DOFade shortcutDOTween46 DLL with specific Unity 4.6 (new UI) shortcutsDOTween.Validate method to manually parse all tweens and remove the ones who have become invalid (usually because their target became null)Sequence callbacks not firing correctlyWaitFor coroutinesFrom versions of shortcuts and generic tween methods have been replaced by a simple From(bool isRelative) that can be chained to Tweeners, and that will immediately set the target to the "From" starting positionChangeStart/End/Values methods not working with AOT/iOSSetDelay not being used correctly inside SequencesGoto/Restart/Rewind unless the Sequence had been played onceUpdateType.Late, which uses Unity's LateUpdateDOTween.TotPlayingTweens methodDocumentation and Check Updates buttons in DOTween InspectorUpdateType.Independent removed: it is now an additional option when using SetUpdate (so that both Default and Late updates can be independent)logBehaviour is now set to LogBehaviour.ErrorsOnly by defaulttrasform/rigidbody.DOLookFromtrasform/rigidbody.DORotateTowards is now called trasform/rigidbody.DOLookAttrasform/rigidbody.DORotateTowardsmaterial.DOColor/From overload that allows to tween named color propertiesDelay() method, to get a tween's delayAxisConstraint option for Vector4 tweensDOLocalAxisRotate not working since the rotation logic was changedspriteRenderer.DOColor/DOFade (Unity 4.3 or later)LoopType.Incremental now works with every tween plugin, arrays includedTweenParms object, just as an extra utility class you can use to store settings for multiple tweenscamera.DOColor, light.DOColor and light.DOIntensity shortcutsDORotate) now take the shortest route to reach the given rotation and don't rotate more than 360° unless you choose otherwise (see the new optional useShortest360Route parameter in the various DORotate methods)Punch/Shake vibrato parameter is now an intPunch/Shake not working with some vibrato valuesReset and SetAs not implementing the latest additionsOnPlay and OnRewind callbackstransform.DOShakePosition/Rotation/Scale shortcutsignoreZAxis parameter to DOTween.Shaketransform.DOPunchPosition/Rotation/Scale shortcutscamera.DOShakeRotation shortcutDOTween.Punch and DOTween.ShakeDOTween.To method that allows to tween a virtual valueSetOptions chaining (with snapping parameter) for DOTween.ToArray methodInit by chaining SetCapacity to itDOTween.logBehaviour is set to Verbose, otherwise nothing at all)Clear not resetting everything correctlyGoto not working with tweens that had infinite loopscamera.DOShakePosition shortcutDOTween.ToArray method (tweens through an array of Vector3 end values)DOMove/DOLocalMove/etcDOTween.ToAxis/FromAxisSetRecyclable setting to tweensDOLocalAxisRotateOnKill callbackDOTween.Init, by changing DOTween.defaultRecyclable, or by setting it for each single tween via SetRecyclableDOTween.Init now contains 3 parameters, with the first one being the new recycleAllByDefaultDOLocalAxisRotate shortcutSetLoops generating errors with WebPlayer platformOnUpdate not being reset correctlyChangeEndValue, ChangeStartValue and ChangeValues now return a Tweener instead than voidLoopType.IncrementalDOTween.ClearCachedTweens methodDOTween.IsTweening now returns a bool instead of an intDOTween.IsTweening(id)SetEaseDOTween.defaultEaseOvershootOrAmplitude and DOTween.defaultEasePeriodYou can find DOTween's open source code on GitHub (moved there on March 18 2015 from scratch: all previous history is lost - here lies the old Google Code repo)
Want a DOTween logo to slap somewhere? Thanks, that's very nice of you!
A lot of work went into DOTween and a lot more is to come. If you use it, like it, and want to support it, press this button to read more
Support DOTween
