Skip to content
GDevelop documentation
Diagrams
GitHub
GDevelop documentation
GDevelop 5
GDevelop documentation
GitHub
GDevelop documentation
GDevelop 5
GDevelop 5
Getting started
Getting started
Interface
Interface
Games
Games dashboard
Games dashboard
Game Analytics
Player Feedback
Leaderboard administration
Leaderboard administration
Marketing
Marketing
Project manager
Project manager
Game icons and thumbnail
Properties of the game
Resources
Scene editor
Scene editor
External layouts
Global Objects
Layer Effects
Layers and cameras
Events editor
Events editor
External Events
Preview
Debugger
Debugger
Profile your game
Profile your game
Profile
Profile
Account Deletion
GDevelop Credits
Ask AI
Ask AI
More
More
Command palette and shortcuts
Updates
Objects
Objects
Sprite
Sprite
Collision mask
Collision mask
Edit points
Edit points
Tiled Sprite
Tiled Sprite
Panel Sprite ("9 patch")
Panel Sprite ("9 patch")
Tilemap
Tilemap
Light
Light
Text
Text
3D Box
3D Box
3D Model
3D Model
BBText
BBText
Bitmap Text
Bitmap Text
Button
Button
Object effects
Object effects
Multitouch joystick
Multitouch joystick
Object groups
Object groups
Particles emitter
Particles emitter
Resource bar
Resource bar
Shape painter
Shape painter
Slider
Slider
Text input
Text input
Toggle switch
Toggle switch
Video
Video
External Tilemap (LDtk/Tiled)
External Tilemap (LDtk/Tiled)
Custom Objects ("Prefabs")
Custom Objects ("Prefabs")
Behaviors
Behaviors
Anchor Behavior
Anchor Behavior
Destroy outside screen behavior
Destroy outside screen behavior
Draggable Object Behavior
Draggable Object Behavior
Pathfinding
Pathfinding
2D Physics Engine
2D Physics Engine
3D Physics Engine
3D Physics Engine
Platform and platformer character behaviors
Platform and platformer character behaviors
Top-Down Movement behavior
Top-Down Movement behavior
Tween behavior
Tween behavior
Physics
Physics
Custom behaviors
Custom behaviors
Events
Events
About Object Picking
About Object Picking
Default Events
Default Events
Group
Group
Link
Link
Repeat
Repeat
While
While
For Each Object
For Each Object
For Each Child Variable
For Each Child Variable
JavaScript Code
JavaScript Code
Javascript in extensions
Javascript in extensions
Custom Functions
Custom Functions
Extract Events to a Function
Example of replacing external events by a function
Advanced
Advanced
Asynchronous events
Callback Variables
All features
All features
Expressions reference
Admob
Admob
AdMob Reference
Advanced
Advanced
Event functions Reference
Advanced conditions
Advanced conditions
Trigger once
Trigger once
Advanced window
Advanced window
Advanced window management Reference
Anchor behavior
Anchor behavior
Anchor Reference
Animatable capability
Animatable capability
Animatable capability Reference
Async
Async
Asynchronous functions Reference
Audio
Audio
Sounds and music Reference
Making sound effects using jfxr
Bbtext
Bbtext
BBCode Text Object Reference
Bitmap text
Bitmap text
Bitmap Text Reference
Camera
Camera
Layers and cameras Reference
Collisions
Collisions
Common conversions
Common conversions
Conversion Reference
Common instructions
Common instructions
Events and control flow Reference
Debugger tools
Debugger tools
Debugger Tools Reference
Destroy outside behavior
Destroy outside behavior
Destroy Outside Screen Behavior Reference
Device sensors
Device sensors
Device sensors Reference
Device vibration
Device vibration
Device vibration Reference
Dialogue tree
Dialogue tree
Dialogue Tree Reference
Draggable behavior
Draggable behavior
Draggable Behavior Reference
Effect capability
Effect capability
Effect capability Reference
Effects
Effects
Effects Reference
Expressions
Expressions
Extensions
Extensions
Linked Objects Tools Extension
Page moved
External layouts
External layouts
External layouts Reference
Facebook instant games
Facebook instant games
Facebook Instant Games Reference
Filesystem
Filesystem
File system Reference
Firebase
Firebase
Analytics
Authentication
Cloud Firestore Database
Firebase Functions
Performance Measuring
Firebase Setup
Firebase Remote Configuration
Realtime Database
Firebase Reference
Firebase Storage
Flippable capability
Flippable capability
Flippable capability Reference
Gamepad
Gamepad
Inventory
Inventory
Inventories Reference
Keyboard
Keyboard
Keyboard Reference
Leaderboards
Leaderboards
Leaderboards Reference
Lighting
Lighting
Lights Reference
Linked objects
Linked objects
Linked objects Reference
Mathematical tools
Mathematical tools
Mathematical tools Reference
Mouse touch
Mouse touch
Mouse and touch Reference
Multiplayer
Multiplayer
Multiplayer Reference
Network
Network
Network Reference
Object
Object
Objects Reference
Opacity capability
Opacity capability
Opacity capability Reference
P2p
P2p
P2P Reference
Panel sprite object
Panel sprite object
Panel Sprite (9-patch) Object Reference
Particle system
Particle system
Particle system Reference
Pathfinding behavior
Pathfinding behavior
Pathfinding behavior Reference
Physics behavior
Physics behavior
Physics Engine (deprecated) Reference
Physics2
Physics2
2D Physics Engine Reference
Physics3d
Physics3d
3D physics engine Reference
Platform behavior
Platform behavior
Platform behavior Reference
Player authentication
Player authentication
Player Authentication Reference
Primitive drawing
Primitive drawing
Shape painter Reference
Resizable capability
Resizable capability
Resizable capability Reference
Resources loading
Resources loading
Scalable capability
Scalable capability
Scalable capability Reference
Scene
Scene
Scene Reference
Scene3d
Scene3d
3D Reference
Screenshot
Screenshot
Screenshot Reference
Shopify
Shopify
Shopify Reference
Spatial sound
Spatial sound
Spatial sound Reference
Spine object
Spine object
Spine (experimental) Reference
Sprite
Sprite
Sprite Reference
Steamworks
Steamworks
Steamworks (Steam) (experimental) Reference
Storage
Storage
Storage Reference
String instructions
String instructions
Text manipulation Reference
System info
System info
System information Reference
Text container capability
Text container capability
Text capability Reference
Text entry object
Text entry object
Text entry object Reference
Text input
Text input
Text Input Reference
Text object
Text object
Text object Reference
Themes
Themes
Tiled sprite object
Tiled sprite object
Tiled Sprite Object Reference
Tilemap
Tilemap
Tile map Reference
Time
Time
Timers and time Reference
Timers and time
Timers and time
The "Wait X seconds" action
Top down movement behavior
Top down movement behavior
Top-down movement Reference
Tween
Tween
Tweening Reference
Variables
Variables
Global variables
Scene variables
Object variables
Instance Variables
Actions and Conditions
Local variables
Local variables
Structures and arrays
Structures and arrays
Video
Video
Video Reference
Window
Window
Game window and resolution Reference
Extensions
Extensions
Install new extensions
Extension tiers
Create your own extensions
Create your own extensions
Create a new extension
Extension Best Practices
Share your extension
Ads
Ads
Mobile In-App Purchase (experimental)
Mobile In-App Purchase (experimental)
Setup
Playgama Bridge
Playgama Bridge
Poki Games SDK
Poki Games SDK
Details
Advanced
Advanced
Base conversion
Base conversion
Color Conversion
Color Conversion
Compressor
Compressor
Pathfinding painter
Pathfinding painter
Extended math support
Extended math support
Frames per second (FPS)
Frames per second (FPS)
Hash
Hash
Object picking tools
Object picking tools
Read pixels
Read pixels
Record
Record
Regular Expressions
Regular Expressions
Sprite Snapshot
Sprite Snapshot
Sprite Sheet Animations
Sprite Sheet Animations
Unique Identifiers
Unique Identifiers
Unicode
Unicode
Audio
Audio
Text-to-Speech
Text-to-Speech
Camera
Camera
Camera impulse
Camera impulse
Camera shake
Camera shake
Camera Zoom
Camera Zoom
Copy camera settings
Copy camera settings
Drag camera with the mouse (or touchscreen)
Drag camera with the mouse (or touchscreen)
Edge scroll camera
Edge scroll camera
First person 3D camera
First person 3D camera
Follow multiple objects with camera
Follow multiple objects with camera
Parallax for Tiled Sprite
Parallax for Tiled Sprite
Room-based camera movement
Room-based camera movement
Smooth Camera
Smooth Camera
Third person camera
Third person camera
Game mechanic
Game mechanic
Checkpoints
Checkpoints
Dungeon generator
Dungeon generator
Fire bullets
Fire bullets
Details
Diagrams
Diagrams
Table of contents
Logic diagram
Health points and damage
Health points and damage
Hexagonal grid
Hexagonal grid
Idle object tracker
Idle object tracker
Simple inventories
Simple inventories
Object "Is On Screen" Detection
Object "Is On Screen" Detection
Linked Objects Tools
Linked Objects Tools
Noise generator
Noise generator
Object spawner area
Object spawner area
Object Stack
Object Stack
RTS-like unit selection
RTS-like unit selection
Rectangular flood fill
Rectangular flood fill
Rectangular grid
Rectangular grid
Values of multiple objects
Values of multiple objects
General
General
Array tools
Array tools
Extended variables support
Extended variables support
Repeat every X seconds
Repeat every X seconds
Input
Input
Back button
Back button
Platformer and top-down remapper
Platformer and top-down remapper
Cursor movement conditions
Cursor movement conditions
Double-click and tap
Double-click and tap
Gamepads (controllers)
Gamepads (controllers)
Konami Code
Konami Code
Cursor object
Cursor object
Mouse Pointer Lock
Mouse Pointer Lock
3D character keyboard mapper
3D character keyboard mapper
Pinching gesture
Pinching gesture
Multitouch joystick and buttons (sprite)
Multitouch joystick and buttons (sprite)
Swipe Gesture
Swipe Gesture
Two choices dialog boxes
Two choices dialog boxes
Movement
Movement
Advanced platformer movements
Advanced platformer movements
Advanced movements for 3D physics characters
Advanced movements for 3D physics characters
Advanced projectile
Advanced projectile
Details
Animated Back and Forth Movement
Animated Back and Forth Movement
Boids movement
Boids movement
Details
Boomerang
Boomerang
Bounce (using forces)
Bounce (using forces)
Explanations
Curved movement
Curved movement
Details
Draggable (for physics objects)
Draggable (for physics objects)
Ellipse movement
Ellipse movement
Explosion force
Explosion force
Face Forward
Face Forward
Homing projectile
Homing projectile
Linear Movement
Linear Movement
Make objects orbit around a center object
Make objects orbit around a center object
Physics car
Physics car
3D physics character animator
3D physics character animator
3D ellipse movement
3D ellipse movement
Pixel perfect movement
Pixel perfect movement
Platformer character animator
Platformer character animator
Platformer trajectory
Platformer trajectory
Rectangular movement
Rectangular movement
Screen wrap
Screen wrap
Speed restrictions
Speed restrictions
Stay On Screen
Stay On Screen
Stick objects to others
Stick objects to others
Timed Back and Forth Movement
Timed Back and Forth Movement
Make object travel to random positions
Make object travel to random positions
Turret movement
Turret movement
Network
Network
Advanced HTTP
Advanced HTTP
Advanced p2p event handling
Advanced p2p event handling
Platforms Validation
Platforms Validation
Internet Connectivity
Internet Connectivity
MQTT Client (advanced)
MQTT Client (advanced)
Webpage URL tools (Web browser)
Webpage URL tools (Web browser)
WebSocket client
WebSocket client
Third-party
Third-party
CrazyGames SDK v3
CrazyGames SDK v3
Details
Discord rich presence (Windows, Mac, Linux)
Discord rich presence (Windows, Mac, Linux)
User interface
User interface
Auto typing animation for text ("typewriter" effect)
Auto typing animation for text ("typewriter" effect)
Button states and effects
Button states and effects
Cancellable draggable object
Cancellable draggable object
Checkbox (for Shape Painter)
Checkbox (for Shape Painter)
Clipboard
Clipboard
Cursor type
Cursor type
Draggable slider (for Shape Painter)
Draggable slider (for Shape Painter)
Emojis
Emojis
Iframe
Iframe
Input Validation
Input Validation
Language
Language
Panel sprite button
Panel sprite button
Resource bar (continuous)
Resource bar (continuous)
Slider
Slider
Player avatar
Player avatar
Pop-up
Pop-up
Animated Score Counter
Animated Score Counter
Share dialog and sharing options
Share dialog and sharing options
Toggle switch
Toggle switch
Star Rating Bar
Star Rating Bar
Resource bar (separated units)
Resource bar (separated units)
Time formatting
Time formatting
Toggle switch (for Shape Painter)
Toggle switch (for Shape Painter)
Visual effect
Visual effect
3D Billboard
3D Billboard
Depth effect
Depth effect
Flash object
Flash object
Flash layer
Flash layer
Flash and transition painter
Flash and transition painter
Marching Squares (experimental)
Marching Squares (experimental)
Details
Slice an object into pieces
Slice an object into pieces
3D particle emitter
3D particle emitter
Object recolorizer (experimental)
Object recolorizer (experimental)
Rolling counter
Rolling counter
Animate Shadow Clones
Animate Shadow Clones
Shake object
Shake object
3D object shake
3D object shake
Shock wave effect
Shock wave effect
Object Masking
Object Masking
Sway
Sway
3D Flip
3D Flip
YSort
YSort
Community extensions
Community extensions
Advanced
Advanced
Crypto Api
Crypto Api
Game properties data
Game properties data
Random Color Generator
Random Color Generator
Rotate a string 13 characters
Rotate a string 13 characters
Audio
Audio
Sounds and music by filename
Sounds and music by filename
Audio Context
Audio Context
Sound volume based on distance
Sound volume based on distance
Camera
Camera
3D camera shake
3D camera shake
Device
Device
GPS
GPS
Voice Recognition API
Voice Recognition API
Game mechanic
Game mechanic
Extra inventory functions
Extra inventory functions
Ink Dialog Tree
Ink Dialog Tree
Secret Code
Secret Code
Slot system
Slot system
General
General
With Three JS
With Three JS
Choose a random value (deprecated)
Choose a random value (deprecated)
3D collision
3D collision
Countdown Timer
Countdown Timer
JSON Resource Loading
JSON Resource Loading
Load images from a URL
Load images from a URL
Maze Generator
Maze Generator
3D model 9-patch
3D model 9-patch
3D raycast
3D raycast
Variables/References
Variables/References
3D sprite
3D sprite
TimeDetector
TimeDetector
Input
Input
CheatCode
CheatCode
Double key press
Double key press
Multitouch joystick and buttons (deprecated)
Multitouch joystick and buttons (deprecated)
Setup
Screen Orientation Checker
Screen Orientation Checker
Selection tools
Selection tools
Movement
Movement
Flip Gravity
Flip Gravity
3D grid jump
3D grid jump
HasLanded
HasLanded
Hedgehog platformer
Hedgehog platformer
Joint connector
Joint connector
3D jump (deprecated)
3D jump (deprecated)
Magnetic Effect
Magnetic Effect
Navigation mesh pathfinding (experimental)
Navigation mesh pathfinding (experimental)
Platform ledge grabber
Platform ledge grabber
Point and Orbit
Point and Orbit
Pushable/Pullable Box
Pushable/Pullable Box
Record Movements
Record Movements
Rectangular Movement (deprecated)
Rectangular Movement (deprecated)
Sine (or ellipsis) Movement (deprecated)
Sine (or ellipsis) Movement (deprecated)
Top-down corner sliding
Top-down corner sliding
Top-down movement animator
Top-down movement animator
Trampoline Platform
Trampoline Platform
Top-down walk
Top-down walk
Network
Network
Update checker
Update checker
Upload Download Text File
Upload Download Text File
Text
Text
3D text
3D text
Third-party
Third-party
GamePix SDK
GamePix SDK
Gamejolt
Gamejolt
Newgrounds API
Newgrounds API
OllamaAI
OllamaAI
Wortal SDK
Wortal SDK
Yandex Games SDK for GDevelop
Yandex Games SDK for GDevelop
User interface
User interface
Align object on the screen
Align object on the screen
ChatBubble
ChatBubble
Clock
Clock
Dialog Box
Dialog Box
Flexbox
Flexbox
Pause when losing focus
Pause when losing focus
Star Rating
Star Rating
Console (commands handler for Text Entry objects)
Console (commands handler for Text Entry objects)
Mobile virtual keyboard for Text Entry
Mobile virtual keyboard for Text Entry
Visual effect
Visual effect
Animation system
Animation system
Character game feel
Character game feel
Dynamic Water
Dynamic Water
Make it rain
Make it rain
Reflection
Reflection
3D Sky and sun
3D Sky and sun
Sprite-based lighting
Sprite-based lighting
Advanced 3D tween
Advanced 3D tween
Create multiple copies of object
Create multiple copies of object
Current game version
Current game version
Draw shock wave effect
Draw shock wave effect
Pushable box
Pushable box
Tween zorder
Tween zorder
Tutorials and Guides
Tutorials and Guides
Basic game making concepts
Basic game making concepts
Basic concepts
Basic concepts
Move objects
Move objects
Rotate objects
Rotate objects
Follow players with cameras
Follow players with cameras
Keep UI on screen
Keep UI on screen
Work with randomness
Work with randomness
Find resources
Find resources
Asteroids
Asteroids
Ship and Movement Controls
Firing Mechanic
Setting Scene
Splitting Asteroids
Screen Wrap
Fail State
End Result
Geometry monster
Geometry monster
Install and setup
Creating the first scene
Introducing main character
Desktop and mobile controls
Adding and moving shapes
Collision detection
Sounds fun
Tracking the score
Adding bombs
More lives
Game over
Main menu
Juice it!
Platformer
Platformer
Create a Playable Character
Create Platforms
Animate the Playable Character
Add Collectible Coins to the Game
Add Enemies to the Game
Make Enemies Kill the Player (and the Player Kill the Enemies)
Add Checkpoints to the Game
Space shooter
Space shooter
2. Move the player
3. Shoot and Health
4. Background and Camera
5. Enemies
6. Enemy Mechanics
7. Meteors
8. Powerups
9. User Interface (UI)
10. Sound Effects & Music
11. Visual Effects
12. Levels
13. Main Menu & The End
Video tutorials
Video tutorials
More guides and How-To
More guides and How-To
Aligning text
Aligning text
Breakout
Breakout
Endless runner
Endless runner
Finite state machine
Finite state machine
How to animate jump fall platformer
How to animate jump fall platformer
How to debug poor performance
How to debug poor performance
How to display big background
How to display big background
How to make behavior
How to make behavior
How to make togglable states with variables
How to make togglable states with variables
How to toggle states using Variables
How to use gdevelop as a team
How to use gdevelop as a team
Leaderboards
Leaderboards
Adding realtime leaderboards to a game
Nilarjun space shooter draft
Nilarjun space shooter draft
Piskel sprite sheets
Piskel sprite sheets
Platform game
Platform game
How to make a platform game - player animations
Follow the player with the camera
Add a background objects
Add a 'Jump through' platform
Add coins and display the number of collected coins
Add enemies to your platformer game
Add checkpoints to your game
Procedural generation
Procedural generation
Implementing Procedural Generation
Understanding Procedural Generation
Reduce size game
Reduce size game
Roadrider
Roadrider
Tank shooter
Tank shooter
Topdown shooter
Topdown shooter
Top Down Shooter - Part 2
Top Down Shooter - Part 3
Top Down Shooter - Part 4
Top Down Shooter - Part 5
Top Down Shooter - Part 6
Using github desktop
Using github desktop
Publishing games
Publishing games
Android
Android
Play store
Play store
Upgrading your app from APK to Android App Bundles
iOS
iOS
App store
App store
Desktop (Windows, macOS, Linux)
Web (gd.games)
Stores and more
Stores and more
Steam
Steam
Amazon App Store
Instant Games on Facebook
Instant Games on Facebook
Monetize your game on Facebook Instant Games platform
CrazyGames
CrazyGames
Poki
Poki
Itch.io
Game Jolt
Microsoft Store
Even more
Even more
Publish your game to crimsongames.io
Publishing your Game to Kongregate
Manual exports
Manual exports
HTML5
Mobile (with Cordova)
Desktop (with Electron)
Marketing your game
Marketing your game
Community
Community
Sell asset packs
Sell asset packs
Submit asset packs
Submit asset packs
Submit examples
Submit examples
Contribute to the documentation
Contribute to the documentation
Report a bug
Report a bug
GDevelop events (game jams, conferences...)
GDevelop FAQ
GDevelop teams
Contribute to GDevelop code
Summer of code
Summer of code
GSoC Contributor Guidance
Google Summer of Code 2020 results
Season of docs
Season of docs
Google Season of Docs 2020 results
Collaboration
Collaboration
Monetization
Monetization
GDevelop for Education
GDevelop for Education
Table of contents
Logic diagram
Fire Bullet technical documentation
Tip
Learn how to use the
Fire Bullet
extension.
Logic diagram
Back to top
