> For the complete documentation index, see [llms.txt](https://smartui-docs.pixelperfectstudio.mx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartui-docs.pixelperfectstudio.mx/miscellaneous-addons/parabolic-tween.md).

# Parabolic Tween

Parabolic Tween Behavior

With this plugin, you can easily create and calculate parabolic paths, making it perfect for games that require projectiles, jumps, or curved motion effects.

{% hint style="success" %}
The **ParabolicTween** plugin is capable of the following:

1. **Calculating parabolic trajectories** <mark style="color:green;">**based on initial velocity and angle**</mark>. This can be combined with the Physics behavior to move the object. [#set-parabola-by-velocity](#set-parabola-by-velocity "mention")
2. **Calculating parabolic trajectories** <mark style="color:green;">**based on a 2D destination (X, Y).**</mark> This can also be combined with the Physics behavior to move the object. [#calculate-by-target](#calculate-by-target "mention")
3. **Moving an object along a parabolic trajectory** within a specific period of time by tweening the object. The <mark style="color:green;">**movement is kinematic**</mark>, meaning any physics interactions are ignored. [#tween-parabola](#tween-parabola "mention")
   {% endhint %}

#### Key Features:

* **Parabolic Trajectories**: The Parabolic Tween Addon enables you to build accurate and customizable parabolic paths. You can define a parabola by specifying a point in space, or simulate a projectile’s movement with a set angle and force.
* **Easy to Use**: The plugin is designed to be user-friendly and intuitive. Whether you’re a beginner or an experienced developer, you’ll find it easy to integrate and use in your Construct 3 projects. The simple interface and clear instructions ensure a smooth experience.
* **Real-Time Calculations**: With the “SetParabolaFromVelocity” action, you can calculate and retrieve the exact points of a parabolic trajectory at a specific time, making it ideal for simulating projectiles in games like *Angry Birds* or 2D isometric platformers.
* **Versatile Applications**: The plugin is perfect for a wide range of games, including 2D platformers, sports games (such as American football), and physics-based puzzles. It brings realistic motion to your games with minimal effort.

##

## <img src="https://3242409510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9bZkqK9vYvPkvVDUO4Tp%2Fuploads%2FASPDg5xpY5zJ7WcpnUxZ%2Ficon.svg?alt=media&amp;token=23cd2be0-9c83-4bb7-a525-828bc27e5a91" alt="" data-size="line"> Parabolic Tween

Moves an object along a parabolic trajectory within a timeframe. Provides parabolic shot ACEs to calculate trajectories and integrate them with Construct's physics behavior.&#x20;

<details>

<summary>Download</summary>

<https://store.pixelperfectstudio.mx/product/parabolic-tween-addon-for-construct-3/>

</details>

## Properties

| **Property**    | **Description**                                 |
| --------------- | ----------------------------------------------- |
| `Enabled`       | Enables or disables the behavior.               |
| `Gravity angle` | Gravity angle for all of the object's parabolas |

## Actions

***

### `Calculate by target`

Calculates the initial velocity and angle of the parabola based on a given point in space that must be reached at a specific time.

| **Parameter** | **Description**                          |
| ------------- | ---------------------------------------- |
| `Tag`         | Tag to identify the parabola             |
| `X`           | Target X coordinate                      |
| `Y`           | Target Y coordinate                      |
| `Time`        | Time in seconds to reach the destination |
| `Gravity`     | World gravity                            |

### `Pause all`

Pause all the running tweens

### `Pause tween`

Pauses the specified tweening parabola

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `Resume all`

Resume all the paused and uncompleted tweens

### `Resume tween`

Resumes the specified paused and uncompleted tween

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `Set enabled`

Disable/enable the Parabolic Tween behavior

| **Parameter** | **Description**  |
| ------------- | ---------------- |
| `Enabled`     | Enabled/disabled |

### `Set gravity angle`

Changes the object's gravity angle

| **Parameter** | **Description** |
| ------------- | --------------- |
| `Angle`       | Angle           |

### `Set parabola by velocity`

Constructs a parabolic trajectory prediction based on the initial velocity of the object.

| **Parameter** | **Description**                                      |
| ------------- | ---------------------------------------------------- |
| `Tag`         | Tag to identify the parabola                         |
| `Velocity`    | Initial velocity of the object in pixels per second. |
| `Angle`       | Angle                                                |
| `Gravity`     | World gravity                                        |

### `Stop all`

Stops all the running tweens

### `Stop tween`

Stops the specified tweening parabola

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `Tween parabola`

Tweens a pair of coordinates over a parabola from the current object coordinates to a specified target coordinate.

| **Parameter** | **Description**                                                                                 |
| ------------- | ----------------------------------------------------------------------------------------------- |
| `Tag`         | Tag to identify the parabola                                                                    |
| `X`           | Target X coordinate                                                                             |
| `Y`           | Target Y coordinate                                                                             |
| `Time`        | Time in seconds greater than 0. The higher the time, the more parabolic the trajectory will be. |
| `Gravity`     | World gravity                                                                                   |
| `Set angle`   | Sets the angle of the projectile to follow the trajectory                                       |
| `Destroy`     | Destroys the object when the tweening has finished                                              |

## Conditions

***

### `Is any playing`

Returns true if any tween is running

### `Is enabled`

Returns true if the Parabolic Tween behavior is enabled

### `Is playing`

Returns true if the specified tag is tweening

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `On any finished`

Triggered when any tween has finished

### `On finished`

Triggered for the specified tweening tag when the tween is completed

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

## Expressions

***

### `GetVelocityX`

Returns the initial Velocity-X vector after calling CalculateByTarget action

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `GetVelocityY`

Returns the initial Velocity-Y vector after calling CalculateByTarget action

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `GetXAt`

Returns the X coordinate of the parabola at the given time in seconds. This expression is only valid after calling either actions 'Set Parabola from Velocity' or 'Calculate by target'.

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |
| `Time`        | Time in seconds              |

### `GetYAt`

Returns the Y coordinate of the parabola at the given time in seconds. This expression is only valid after calling either actions 'Set Parabola from Velocity' or 'Calculate by target'.

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |
| `Time`        | Time in seconds              |

### `GetAngle`

Returns the initial angle after calling CalculateByTarget action

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `GetGravityAngle`

Returns the angle of gravity

### `GetProgress`

Returns progress percentage from 0 to 1 of the tween with the specified Tag

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `GetProjectileAngle`

Returns the heading angle of the projectile while tweening over a parabolic trajectory

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `GetProjectileAngleAt`

Returns the heading angle of the projectile for a specific point in time of a parabola after calling 'Set Parabola from Velocity' or 'Calculate by target'

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |
| `Time`        | Time in seconds              |

### `GetTag`

In 'On Any tween finished', returns the finished tag.

### `GetTweenMaxTime`

Returns time set for the specified tweening parabola

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `GetVelocity`

Returns the initial velocity vector after calling CalculateByTarget action

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `GetX`

Returns the X coordinate of a tweening parabola

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

### `GetY`

Returns the Y coordinate of a tweening parabola

| **Parameter** | **Description**              |
| ------------- | ---------------------------- |
| `Tag`         | Tag to identify the parabola |

**(c) Pixel Perfect Studio 2025**