Animated Counter Behavior

A Construct 3 behavior designed to seamlessly animate both Text and Sprite Font objects, transitioning them smoothly from one number to the next.

Current Features

• Seamless animation between numerical values
• Support for both Text and Sprite Font objects
• Customizable update interval
• Configurable step size for increments/decrements
• Optional BBCode template for formatted display
• Real-time value updates
• SDK v2

Properties

Property Name	Description	Type
Initial Number	The initial number	float
Update Interval	Update interval in milliseconds, how often the counter will update	float
Step Size	how much to increment/decrement by each update tick	float
Use BBCode Template	If true, the BBCode template will be used to format the number	check
BBCode Template	The template for the BBCode, %v will be replaced with the counter value	text

---

Actions

Action	Description	Params
Set BBCode Template	Set the BBCode template to format the number	Template (string)
Set Step Size	Set the step size of the counter, the amount to increment or decrement by each tick	Step Size (number)
Set Counter Update Interval	Set the update interval of the counter, how often the counter will update in milliseconds	Milliseconds (number)
Set Use BBCode Template	Set if the BBCode template should be used to format the number	Use (boolean)
Add	Add value to the counter	Value (number)
Set Target	Set the target value of the counter, this will start the animation	Target (number)
Set Value	Set the initial value of the counter, instantly	Value (number)
Set Value and Target	Set the initial value of the counter and the target value	Value (number) Target (number)
Subtract	Subtract value from the counter	Value (number)
Force Stop	Force stop the counter, set value to target
Stop	Stop the counter

---

Conditions

Condition	Description	Params
Is Animating	Check if the counter is animating
Is Decreasing	Check if the counter is decreasing
Is Increasing	Check if the counter is increasing
On Animation End	Triggered when the counter stops animating
On Animation Start	Triggered when the counter starts animating

---

Expressions

Expression	Description	Return Type	Params
StepSize	Get the step size of the counter	number
UpdateInterval	Get the counter update interval	number
CurrentValue	Get the current value of the counter	number
Diff	Get the difference between the current and target value	number
TargetValue	Get the target value of the counter	number

Links

• Source Code
• Issues & Feature Request