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
AI (Chat and AI Agent)
AI (Chat and AI Agent)
Agent
Agent
Chat
Chat
More
More
Command palette and shortcuts
Updates
Themes
Themes
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")
Migrate to variants
Migrate to variants
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
Expressions
Expressions
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
Extract Events to a Function
Example of replacing external events by a function
Example of replacing external events by a function
Asynchronous functions
Asynchronous functions
Advanced
Advanced
Asynchronous events
Callback Variables
Core features
Core features
Ads
Ads
AdMob
AdMob
AdMob Reference
Advanced
Advanced
Asynchronous functions
Asynchronous functions
Asynchronous functions Reference
Debugger Tools
Debugger Tools
Debugger Tools Reference
Event functions
Event functions
Event functions Reference
Events and control flow
Events and control flow
Events and control flow Reference
External layouts
External layouts
External layouts Reference
File system
File system
File system Reference
Linked objects
Linked objects
Linked objects Reference
Screenshot
Screenshot
Screenshot Reference
Spine (experimental)
Spine (experimental)
Spine (experimental) Reference
Storage
Storage
Storage Reference
System information
System information
System information Reference
Tile map
Tile map
Tile map Reference
Audio
Audio
Sounds and music
Sounds and music
Sounds and music Reference
Making sound effects using jfxr
Spatial sound
Spatial sound
Spatial sound Reference
Camera
Camera
Layers and cameras
Layers and cameras
Layers and cameras Reference
Game mechanic
Game mechanic
Destroy Outside Screen Behavior
Destroy Outside Screen Behavior
Destroy Outside Screen Behavior Reference
Dialogue Tree
Dialogue Tree
Dialogue Tree Reference
Inventories
Inventories
Inventories Reference
Save State (experimental)
Save State (experimental)
Save State (experimental) Reference
General
General
3D
3D
3D Reference
Conversion
Conversion
Conversion Reference
Flippable objects
Flippable objects
Flippable objects Reference
Mathematical tools
Mathematical tools
Mathematical tools Reference
Objects
Objects
Objects Reference
Objects containing a text
Objects containing a text
Objects containing a text Reference
Objects with animations
Objects with animations
Objects with animations Reference
Objects with effects
Objects with effects
Objects with effects Reference
Objects with opacity
Objects with opacity
Objects with opacity Reference
Panel Sprite (9-patch) Object
Panel Sprite (9-patch) Object
Panel Sprite (9-patch) Object Reference
Resizable objects
Resizable objects
Resizable objects Reference
Scalable objects
Scalable objects
Scalable objects Reference
Scene
Scene
Scene Reference
Shape painter
Shape painter
Shape painter Reference
Sprite
Sprite
Sprite Reference
Text manipulation
Text manipulation
Text manipulation Reference
Tiled Sprite Object
Tiled Sprite Object
Tiled Sprite Object Reference
Timers and time
Timers and time
Timers and time Reference
Variables
Variables
Global variables
Scene variables
Object variables
Instance Variables
Actions and Conditions
Local variables
Local variables
Structures and arrays
Structures and arrays
Input
Input
Device sensors
Device sensors
Device sensors Reference
Keyboard
Keyboard
Keyboard Reference
Mouse and touch
Mouse and touch
Mouse and touch Reference
Movement
Movement
2D Physics Engine
2D Physics Engine
2D Physics Engine Reference
3D physics engine
3D physics engine
3D physics engine Reference
Pathfinding behavior
Pathfinding behavior
Pathfinding behavior Reference
Physics Engine (deprecated)
Physics Engine (deprecated)
Physics Engine (deprecated) Reference
Platform behavior
Platform behavior
Platform behavior Reference
Top-down movement
Top-down movement
Top-down movement Reference
Network
Network
Firebase
Firebase
Analytics
Authentication
Cloud Firestore Database
Firebase Functions
Performance Measuring
Firebase Setup
Firebase Remote Configuration
Realtime Database
Firebase Reference
Firebase Storage
Network
Network
Network Reference
P2P
P2P
P2P Reference
Players
Players
Leaderboards
Leaderboards
Leaderboards Reference
Multiplayer
Multiplayer
Multiplayer Reference
Player Authentication
Player Authentication
Player Authentication Reference
Text
Text
BBCode Text Object
BBCode Text Object
BBCode Text Object Reference
Bitmap Text
Bitmap Text
Bitmap Text Reference
Text object
Text object
Text object Reference
Third-party
Third-party
Facebook Instant Games
Facebook Instant Games
Facebook Instant Games Reference
Shopify
Shopify
Shopify Reference
Steamworks (Steam) (experimental)
Steamworks (Steam) (experimental)
Steamworks (Steam) (experimental) Reference
User interface
User interface
Advanced window management
Advanced window management
Advanced window management Reference
Anchor
Anchor
Anchor Reference
Device vibration
Device vibration
Device vibration Reference
Draggable Behavior
Draggable Behavior
Draggable Behavior Reference
Game window and resolution
Game window and resolution
Game window and resolution Reference
Text entry object
Text entry object
Text entry object Reference
Text Input
Text Input
Text Input Reference
Video
Video
Video Reference
Visual effect
Visual effect
Effects
Effects
Effects Reference
Lights
Lights
Lights Reference
Particle system
Particle system
Particle system Reference
Tweening
Tweening
Tweening Reference
Advanced conditions
Advanced conditions
Trigger once
Trigger once
Collisions
Collisions
Gamepad
Gamepad
Resources loading
Resources loading
Timers and time
Timers and time
The "Wait X seconds" action
Expressions reference
Extended features
Extended features
Install new extensions
Extension tiers
Ads
Ads
Mobile In-App Purchase (experimental)
Mobile In-App Purchase (experimental)
Setup
Playgama Bridge
Playgama Bridge
Details
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 2D objects with the camera
Follow multiple 2D objects with the 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
Fire bullets
Fire bullets
Details
Diagrams
Diagrams
Table of contents
Logic diagram
Health points and damage
Health points and damage
Hexagonal 2D grid
Hexagonal 2D 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
Details
Noise generator
Noise generator
Object spawner 2D area
Object spawner 2D area
Object Stack
Object Stack
RTS-like unit selection
RTS-like unit selection
Rectangular flood fill
Rectangular flood fill
Rectangular 2D grid
Rectangular 2D 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
Android back button
Android 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 car keyboard mapper
3D car keyboard mapper
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
2D Top-Down Physics Car
2D Top-Down 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 (2D)
Stay On Screen (2D)
Stick objects to others
Stick objects to others
Timed Back and Forth Movement
Timed Back and Forth Movement
Top-down movement animator
Top-down movement animator
Make object travel to random positions
Make object travel to random positions
Turret 2D movement
Turret 2D 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)
Multiplayer custom lobbies
Multiplayer custom lobbies
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
Leaderboard dialog
Leaderboard dialog
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 a 2D object into pieces
Slice a 2D object into pieces
3D particle emitter
3D particle emitter
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-like Flip for 2D Sprites
3D-like Flip for 2D Sprites
YSort
YSort
Experimental extensions
Experimental 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
Dungeon generator
Dungeon generator
Extra inventory functions (deprecated)
Extra inventory functions (deprecated)
3D height map
3D height map
Details
Ink Dialog Tree
Ink Dialog Tree
Slot system
Slot system
General
General
Advanced 3D Features
Advanced 3D Features
3D collision
3D collision
Countdown timer (deprecated)
Countdown timer (deprecated)
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
Input
Input
Double key press
Double key press
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
Top-down corner sliding
Top-down corner sliding
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
Scrollbar
Scrollbar
Star Rating
Star Rating
Visual effect
Visual effect
Animation system
Animation system
Character game feel
Character game feel
Dynamic Water
Dynamic Water
Make it rain
Make it rain
Object recolorizer (experimental)
Object recolorizer (experimental)
Reflection
Reflection
3D Sky and sun
3D Sky and sun
Advanced 3D tween
Advanced 3D tween
Create your own extensions
Create your own extensions
Create a new extension
Extension Best Practices
Share your extension
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 on the Asset Store
Sell on the Asset Store
Submit asset packs
Submit asset packs
Manually package the assets
Submit game templates
Submit game templates
Contribute to the documentation
Contribute to the documentation
Report a bug
Report a bug
GDevelop events (game jams, conferences...)
GDevelop Community 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
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
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
Table of contents
Logic diagram
Fire Bullet technical documentation
Tip
Learn how to use the
Fire Bullet
extension.
Logic diagram
Back to top
