Multitouch joystick and buttons (sprite)

Joysticks or buttons for touchscreens.

Authors and contributors to this experimental extension: VictrisGames, MelonDev, xellix, D8H.

Multitouch joysticks are objects showing a joystick on the screen, useful for mobile. They work like a physical gamepad:

4 or 8 directions
Analogus pads
Player selection
Automatic "mapper" behaviors for 2D and 3D movement behaviors (platformer characters, top-down movement, 3D character etc...). Add one of these to the object with the movement behavior (i.e: the player most of the time) and the behavior will then be controlled automatically by the virtual joystick (it works by reading the multitouch joystick state and simulating controls). No need for additional events to make it work once the behaviors are set up.

There are ready-to-use joysticks in the asset-store multitouch joysticks pack.

Conditions

New touch on a screen side
Check if a new touch has started on the right or left side of the screen.

See parameters

Parameter 1 (👾 Object): Multitouch joystick
Parameter 2 (🔤 String): Screen side (one of: "Left", "Right")

Technical note: parameters 0, 3 are internal parameters handled by GDevelop.

Multitouch controller button just pressed
Check if a button was just pressed on a multitouch controller.

See parameters

Parameter 1 (🔢 Number): Multitouch controller identifier (1, 2, 3, 4...)
Parameter 2 (string): Button name

Technical note: parameters 0, 3 are internal parameters handled by GDevelop.

Multitouch controller button pressed
Check if a button is pressed on a multitouch controller.

See parameters

Parameter 1 (🔢 Number): Multitouch controller identifier (1, 2, 3, 4...)
Parameter 2 (string): Button name

Technical note: parameters 0, 3 are internal parameters handled by GDevelop.

Multitouch controller button released
Check if a button is released on a multitouch controller.

See parameters

Parameter 1 (🔢 Number): Multitouch controller identifier (1, 2, 3, 4...)
Parameter 2 (string): Button name

Technical note: parameters 0, 3 are internal parameters handled by GDevelop.

Joystick pushed in a direction (4-way)
Check if joystick is pushed in a given direction.

See parameters

Parameter 1 (🔢 Number): Multitouch controller identifier (1, 2, 3, 4...)
Parameter 2 (🔤 String): Joystick name (one of: "Primary", "Secondary")
Parameter 3 (🔤 String): Direction (one of: "Up", "Down", "Left", "Right")

Technical note: parameters 0, 4 are internal parameters handled by GDevelop.

Joystick pushed in a direction (8-way)
Check if joystick is pushed in a given direction.

See parameters

Parameter 1 (🔢 Number): Multitouch controller identifier (1, 2, 3, 4...)
Parameter 2 (🔤 String): Joystick name (one of: "Primary", "Secondary")
Parameter 3 (🔤 String): Direction (one of: "Up", "Down", "Left", "Right", "UpLeft", "UpRight", "DownLeft", "DownRight")

Technical note: parameters 0, 4 are internal parameters handled by GDevelop.

Stick force
Compare the force of multitouch contoller stick (from 0 to 1).

See parameters

Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Value to compare
Parameter 3 (🔢 Number): Multitouch controller identifier (1, 2, 3, 4...)
Parameter 4 (🔤 String): Stick name (one of: "Primary", "Secondary")

Technical note: parameters 0, 5 are internal parameters handled by GDevelop.

Expressions

Expression	Description
`SpriteMultitouchJoystick::StickAngle(number, string)`	Return the angle the multitouch controller stick is pointing towards (Range: -180 to 180).
	🔢 Number	Multitouch controller identifier (1, 2, 3, 4...)
	🔤 String	Joystick name
`SpriteMultitouchJoystick::StickForce(number, string)`	Return the force of multitouch contoller stick (from 0 to 1).
	🔢 Number	Multitouch controller identifier (1, 2, 3, 4...)
	🔤 String	Stick name
`SpriteMultitouchJoystick::StickForceX(number, string)`	Return the multitouch contoller stick force on X axis (from -1 at the left to 1 at the right).
	🔢 Number	Multitouch controller identifier (1, 2, 3, 4...)
	🔤 String	Joystick name
`SpriteMultitouchJoystick::StickForceY(number, string)`	Return the multitouch contoller stick force on Y axis (from -1 at the top to 1 at the bottom).
	🔢 Number	Multitouch controller identifier (1, 2, 3, 4...)
	🔤 String	Joystick name

Multitouch Joystick

Joystick for touchscreens.

Object actions

De/activate control
De/activate control of the joystick.

See parameters

Parameter 0: 👾 Object
Parameter 1 (❓ Yes or No): Activate

Technical note: parameter 2 are internal parameters handled by GDevelop.

Multitouch controller identifier
Change the multitouch controller identifier (1, 2, 3, 4...).

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Operator
Parameter 2 (🔢 Number): Value

Technical note: parameter 3 are internal parameters handled by GDevelop.

Dead zone radius
Change the dead zone radius of the joystick (range: 0 to 1). The deadzone is an area for which movement on sticks won't be taken into account (instead, the stick will be considered as not moved).

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Operator
Parameter 2 (🔢 Number): Value

Technical note: parameter 3 are internal parameters handled by GDevelop.

Joystick name
Change the joystick name of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Operator
Parameter 2 (string): Value

Technical note: parameter 3 are internal parameters handled by GDevelop.

Show and start pressing
Show the joystick until it is released.

See parameters

Parameter 0: 👾 Object

Technical note: parameter 1 are internal parameters handled by GDevelop.

Object conditions

Multitouch controller identifier
Compare the multitouch controller identifier (1, 2, 3, 4...).

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Value to compare

Technical note: parameter 3 are internal parameters handled by GDevelop.

Dead zone radius
Compare the dead zone radius of the joystick (range: 0 to 1). The deadzone is an area for which movement on sticks won't be taken into account (instead, the stick will be considered as not moved).

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Value to compare

Technical note: parameter 3 are internal parameters handled by GDevelop.

Joystick pushed in a direction (4-way movement)
Check if joystick is pushed in a given direction.

See parameters

Parameter 0: 👾 Object
Parameter 1 (🔤 String): Direction (one of: "Up", "Down", "Left", "Right")

Technical note: parameter 2 are internal parameters handled by GDevelop.

Joystick pushed in a direction (8-way movement)
Check if joystick is pushed in a given direction.

See parameters

Parameter 0: 👾 Object
Parameter 1 (🔤 String): Direction (one of: "Up", "Down", "Left", "Right", "UpLeft", "UpRight", "DownLeft", "DownRight")

Technical note: parameter 2 are internal parameters handled by GDevelop.

Stick pressed
Check if a stick is pressed.

See parameters

Parameter 0: 👾 Object

Technical note: parameter 1 are internal parameters handled by GDevelop.

Joystick name
Compare the joystick name of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Relational operator
Parameter 2 (string): Value to compare

Technical note: parameter 3 are internal parameters handled by GDevelop.

Stick force
Compare the strick force (from 0 to 1).

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Value to compare

Technical note: parameter 3 are internal parameters handled by GDevelop.

Stick X force
Compare the stick force on X axis (from -1 at the left to 1 at the right).

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Value to compare

Technical note: parameter 3 are internal parameters handled by GDevelop.

Stick Y force
Compare the stick force on Y axis (from -1 at the top to 1 at the bottom).

See parameters

Parameter 0: 👾 Object
Parameter 1: 🟰 Relational operator
Parameter 2 (🔢 Number): Value to compare

Technical note: parameter 3 are internal parameters handled by GDevelop.

Object expressions

Expression	Description
`Object.ControllerIdentifier()`	Return the multitouch controller identifier (1, 2, 3, 4...).
`Object.DeadZoneRadius()`	Return the dead zone radius of the joystick (range: 0 to 1). The deadzone is an area for which movement on sticks won't be taken into account (instead, the stick will be considered as not moved).
`Object.JoystickIdentifier()`	Return the joystick name of the object.
`Object.StickAngle()`	Return the angle the stick is pointing towards (from -180 to 180).
`Object.StickForce()`	Return the strick force (from 0 to 1).
`Object.StickForceX()`	Return the stick force on X axis (from -1 at the left to 1 at the right).
`Object.StickForceY()`	Return the stick force on Y axis (from -1 at the top to 1 at the bottom).

First person camera multitouch controller mapper

Control camera rotations with a multitouch controller.

Behavior actions

Horizontal rotation acceleration
Change the horizontal rotation acceleration of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Horizontal rotation deceleration
Change the horizontal rotation deceleration of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Maximum horizontal rotation speed
Change the maximum horizontal rotation speed of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Z position offset
Change the z position offset of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Maximum vertical camera angle
Change the maximum vertical camera angle of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Minimum vertical camera angle
Change the minimum vertical camera angle of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Vertical rotation acceleration
Change the vertical rotation acceleration of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Vertical rotation deceleration
Change the vertical rotation deceleration of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Maximum vertical rotation speed
Change the maximum vertical rotation speed of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Operator
Parameter 3 (🔢 Number): Value

Technical note: parameter 4 are internal parameters handled by GDevelop.

Behavior conditions

Horizontal rotation acceleration
Compare the horizontal rotation acceleration of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Horizontal rotation deceleration
Compare the horizontal rotation deceleration of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Maximum horizontal rotation speed
Compare the maximum horizontal rotation speed of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Z position offset
Compare the z position offset of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Maximum vertical camera angle
Compare the maximum vertical camera angle of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Minimum vertical camera angle
Compare the minimum vertical camera angle of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Vertical rotation acceleration
Compare the vertical rotation acceleration of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Vertical rotation deceleration
Compare the vertical rotation deceleration of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Maximum vertical rotation speed
Compare the maximum vertical rotation speed of the object.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior
Parameter 2: 🟰 Relational operator
Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 4 are internal parameters handled by GDevelop.

Behavior expressions

Expression	Description
`Object.FirstPersonMultitouchMapper::HorizontalRotationAcceleration()`	Return the horizontal rotation acceleration of the object.
`Object.FirstPersonMultitouchMapper::HorizontalRotationDeceleration()`	Return the horizontal rotation deceleration of the object.
`Object.FirstPersonMultitouchMapper::HorizontalRotationSpeedMax()`	Return the maximum horizontal rotation speed of the object.
`Object.FirstPersonMultitouchMapper::OffsetZ()`	Return the z position offset of the object.
`Object.FirstPersonMultitouchMapper::VerticalAngleMax()`	Return the maximum vertical camera angle of the object.
`Object.FirstPersonMultitouchMapper::VerticalAngleMin()`	Return the minimum vertical camera angle of the object.
`Object.FirstPersonMultitouchMapper::VerticalRotationAcceleration()`	Return the vertical rotation acceleration of the object.
`Object.FirstPersonMultitouchMapper::VerticalRotationDeceleration()`	Return the vertical rotation deceleration of the object.
`Object.FirstPersonMultitouchMapper::VerticalRotationSpeedMax()`	Return the maximum vertical rotation speed of the object.

Multitouch button

Detect presses made on a touchscreen on the object so it acts like a button and automatically trigger the button having the same identifier for the mapper behaviors.

Behavior conditions

Button just pressed
Check if the button was just pressed.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior

Technical note: parameter 2 are internal parameters handled by GDevelop.

Button pressed
Check if the button is pressed.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior

Technical note: parameter 2 are internal parameters handled by GDevelop.

Button released
Check if the button is released.

See parameters

Parameter 0: 👾 Object
Parameter 1: 🧩 Behavior

Technical note: parameter 2 are internal parameters handled by GDevelop.