TweenFlow Lite [Beta]
TweenFlow provides an interface that allows you to easily create and preview tweens. I started working on this because I felt that tweens only being interactable through code was tedious and time consuming. This plugin allows you to create and preview tweens without needing to go into Play
or Run
mode, or run the code through the Command bar
.
How to Use
- Object Selection
-
Object0
is the object you want to tween. -
Object1
is the object whose properties are used for the tween.Object1
can be aValueBase
(e.g. ,NumberValue
,Color3Value
) object, whereasObject0
cannot. - Select two objects and press the
Select
button. The objects will be assigned based on the order you selected them.
- Switching Objects
- Press the
Switch
icon to swap the order of the selected objects. (Up and down arrows)
- Locking Object Selection
- To select only
Object1
, press theLock
icon, then pressSelect
. - To select only
Object0
, select a single object, then press Select with theLock
icon deselected.
- Inputting Properties
- Type the name of the property you want to tween in the property input field.
- Setting Initial State
- The initial state is the value the objects property returns to when a tween is canceled. By default, it’s the state when play is pressed for the first time. To change this, press
Set Initial State
.
- Generating Tween Code
- Pressing the
Print
icon provides a fully filled-out tween create method in theOutput
once a valid property has been input andObject0
andObject1
have been selected.
- Playback Controls
- The
Play
andPause
buttons function the same as the methods on a tween. - The
Cancel
button stops the tween and returnsObject0
’s property it to its initial state.
- Tween Info Menu
- Input all the TweenInfo as you would using the
Tween.new
constructor.EasingDirection
andEasingStyle
are selectable from drop-down menus.
- Looping Tweens
- To loop a tween indefinitely, input
-1
into the ‘repeat’ field. *This applies to tweens in general not just this plugin.
Known Issues
- Closing the game while a tween is playing may prevent the object from returning to it’s initial state
- Some features lack warnings for missing or incorrect input
- The plugin button may need to be pressed multiple times to open the widget
- Scroll bar popping up when it doesn’t need to
To-Do List / Planned Features
- Revamp Ui
- Enhance playback menu
- Support multi-property tweening
- Tweening an object and it’s descendants to a matching object
- Option to generate scripts instead of printing the tween
- Option to generate tween with different constructors (e.g.,
Color3.new
,Color3.fromHSV
) - Option to directly input property value in addition to using another objects property