Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions automated_updates_data.json
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,10 @@
{
"date": "2026-07-07",
"summary": "Improved keyboard docs: added 'Key just pressed' (held vs one-frame) and 'Any key released' conditions, control-remapping note, and a reference list of valid key names"
},
{
"date": "2026-08-12",
"summary": "Improved filesystem docs (added User's Home folder, game executable file, and path-parsing expressions; fixed duplicate 'Delete a file' heading and typo) and screenshot docs (desktop-only note and auto .png extension)"
}
]
}
15 changes: 13 additions & 2 deletions docs/gdevelop5/all-features/filesystem/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ This condition checks if the given file or directory exists on the file system.
This action creates a new folder at the given file path.
== Parameters ==
** Directory: ** The absolute file path to the directory which should be created.
It is advised to use the expressions for special folders (see below), to keep you game platform independent.
It is advised to use the expressions for special folders (see below), to keep your game platform independent.

** (Optional) Result variable: ** Variable to store the result. It can either hold the value 'ok': the task was successful or 'error': an error occurred.

Expand Down Expand Up @@ -184,7 +184,7 @@ It is advised to use the expressions for special folders (see below) to keep you

---

#### Delete a file
#### Delete a file (async)
This action deletes the file at the given file path __asynchronously__.
== Parameters ==
** File path: ** The path on the file system where the file is located.
Expand All @@ -204,6 +204,7 @@ This expression returns the operating system independent path to the _Documents_
This is the standard folder for storing documents.
#### This games executable folder
This expression returns the operating system independent path to the folder where your game is being executed from.
There is also a separate "Game executable file" expression that returns the full path to the executable file itself (including its name), which is useful when you need the executable's exact location rather than the containing folder.
#### Pictures folder
This expression returns the operating system independent path to the _Pictures_ folder of the user that runs your game.
This is the standard folder for storing images.
Expand All @@ -213,10 +214,20 @@ This folder is used for temporary files that your operating system can delete at
#### Userdata folder
This expression returns the operating system independent path to the _UserData_ folder of the user that runs your game.
This folder is used for storing application settings.
#### User's Home folder
This expression returns the operating system independent path to the _Home_ folder of the user that runs your game (for example `C:\Users\Name` on Windows or `/home/name` on Linux).
#### Path delimiter
This expression returns the operating system independent path delimiter character. ("\" on Windows and "/" on Linux and macOS).
Use this expression to build cross-platform file paths that can be accessed on all supported operating systems.

### Reading parts of a path

A few expressions help you extract parts of an existing path without manipulating strings yourself:

- **Get directory name from a path**: returns the directories portion of the path, without the ending file name.
- **Get file name from a path**: returns the name of the file, including its extension.
- **Get the extension from a file path**: returns the file extension including the period (for example `.txt`).

## Example
In order to save a screenshot to the _Pictures_ directory you could write:

Expand Down
8 changes: 6 additions & 2 deletions docs/gdevelop5/all-features/screenshot/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,17 @@ Note: As of GDevelop 5.0.0-beta92 the screenshot action is no longer an extensio

Use this action to save a screenshot of everything which is currently drawn on the game window into a *png* file.

!!! note

This works only on games exported for Windows, Linux and macOS. Screenshots are not supported in web games or mobile games.

##### Parameters:

**Save path**: The file path where the screenshot should be saved.

The save path needs to be an absolute path on the file system (Like "C:\MyFolder\MyScreenshot.png" on Windows)'
The save path needs to be an absolute path on the file system (Like "C:\MyFolder\MyScreenshot.png" on Windows).

Relative paths are not supported.
Relative paths are not supported. If the path does not already end with `.png`, the extension is added automatically.

!!! note

Expand Down