Skip to content

Commit 857e57c

Browse files
Site changes [skip-ci]
1 parent 61351a3 commit 857e57c

File tree

149 files changed

+66742
-67347
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

149 files changed

+66742
-67347
lines changed

_data/learnindex.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1749,7 +1749,7 @@
17491749
"en",
17501750
"ru"
17511751
],
1752-
"name": "Avaialble Docker images to run Extender",
1752+
"name": "Available Docker images to run Extender",
17531753
"path": "/manuals/extender-docker-images"
17541754
}
17551755
],
@@ -2093,7 +2093,7 @@
20932093
},
20942094
{
20952095
"author": "Unfolding Gamedev",
2096-
"description": "Do you want to create breathtaking visual effects? Photrealistic or stylized games? You need to dig into how rendering works!",
2096+
"description": "Do you want to create breathtaking visual effects? Photorealistic or stylized games? You need to dig into how rendering works!",
20972097
"embed": "https://www.youtube.com/embed/oLiJTcdBCkM",
20982098
"name": "How graphics works? Render pipeline explained. Example OpenGL + Defold",
20992099
"path": "https://www.youtube.com/watch?v=oLiJTcdBCkM"
@@ -2149,7 +2149,7 @@
21492149
},
21502150
{
21512151
"author": "Tactx Studios",
2152-
"description": "A walkthough is provided on how you can support a user selecting a specific game object and dragging it to a new location within your game.",
2152+
"description": "A walkthrough is provided on how you can support a user selecting a specific game object and dragging it to a new location within your game.",
21532153
"embed": "https://www.youtube.com/embed/83TcgJyv9vk",
21542154
"name": "Defold Drag and Drop",
21552155
"path": "https://www.youtube.com/watch?v=83TcgJyv9vk"

_includes/shared/en/editor-faq.md

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,23 +6,19 @@ A: The editor will use up to 75% of the available memory of the system. On a com
66
A: Yes. The Defold beta editor checks for an update at startup, just like the Defold stable version does.
77

88

9-
#### Q: Why am I getting an error saying "java.awt.AWTError: Assistive Technology not found" when launching the editor?
9+
#### Q: Why am I getting an error saying `java.awt.AWTError: Assistive Technology not found` when launching the editor?
1010
A: This error is related to problems with Java assistive technology such as the [NVDA screen reader](https://www.nvaccess.org/download/). You probably have an `.accessibility.properties` file in your home folder. Remove the file and try launching the editor again. (Note: If you do use any assistive technology and require that file to be present then please reach out to us at [email protected] to discuss alternative solutions).
1111

1212
Discussed [here on the Defold forum](https://forum.defold.com/t/editor-endless-loading-windows-10-1-2-169-solved/65481/3).
1313

1414

15-
#### Q: Why doesn't the editor start or open my project?
16-
A: Check if there are spaces in the path leading up to the Defold application. For instance, if you put the folder *Defold-macosx* containing the macOS version of the editor in your *Applications* folder, then you should be ok. If you rename the folder *Defold macosx* the editor might not start anymore. On Windows, putting Defold under *C:\\Program Files\\* can trigger this problem. This is due to a known bug in the underlying Eclipse framework.
17-
18-
19-
#### Q: Why am I getting an error saying "sun.security.validator.ValidatorException: PKIX path building failed" when launching the editor?
15+
#### Q: Why am I getting an error saying `sun.security.validator.ValidatorException: PKIX path building failed` when launching the editor?
2016
A: This exception occurs when the editor tries to make an https connection but the certificate chain provided by the server cannot be verified.
2117

2218
See [this link](https://github.com/defold/defold/blob/master/editor/README_TROUBLESHOOTING_PKIX.md) for details on this error.
2319

2420

25-
#### Q: Why am I am getting a "java.lang.OutOfMemoryError: Java heap space" when performing certain operations?
21+
#### Q: Why am I am getting a `java.lang.OutOfMemoryError: Java heap space` when performing certain operations?
2622
A: The Defold editor is built using Java and in some cases the default memory configuration of Java might not be sufficient. If this happens you can manually configure the editor to allocate more memory by editing the editor configuration file. The configuration file, named `config`, is located in the `Defold.app/Contents/Resources/` folder on macOS. On Windows it is located next to `Defold.exe` executable and on Linux next to the `Defold` executable. Open the `config` file and add `-Xmx6gb` to the line starting with `vmargs`. Adding `-Xmx6gb` will set the max heap size to 6 gigabytes (the default is usually 4Gb). It should look something like this:
2723

2824
```

_includes/shared/en/html5-faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#### Q: Why does my HTML5-app freeze at the splash screen in Chrome?
22

3-
A: In some cases it is not possible to run a game in the browser locally from the filesystem. Running from the editor serves the game from a local web server. You can, for instance, use SimpleHTTPServer in Python:
3+
A: In some cases it is not possible to run a game in the browser locally from the filesystem. Running from the editor serves the game from a local web server. You can, for instance, use `SimpleHTTPServer` in Python:
44

55
```sh
66
$ python -m SimpleHTTPServer [port]

_includes/shared/en/ios-faq.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,13 @@ A: Make sure that you are using the same bundle identifier in your Defold projec
44
#### Q: How can I check the entitlements of a bundled application?
55
A: From [Inspect the entitlements of a built app](https://developer.apple.com/library/archive/technotes/tn2415/_index.html#//apple_ref/doc/uid/DTS40016427-CH1-APPENTITLEMENTS):
66

7-
> $ codesign -d --ent :- /path/to/the.app
7+
```sh
8+
codesign -d --ent :- /path/to/the.app
9+
```
810

911
#### Q: How can I check the entitlements of a provisioning profile
1012
A: From [Inspecting a profile's entitlements](https://developer.apple.com/library/archive/technotes/tn2415/_index.html#//apple_ref/doc/uid/DTS40016427-CH1-PROFILESENTITLEMENTS):
1113

12-
> $ security cms -D -i /path/to/iOSTeamProfile.mobileprovision
14+
```sh
15+
security cms -D -i /path/to/iOSTeamProfile.mobileprovision
16+
```

_includes/shared/en/linux-faq.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@ $ GTK_CSD=0 ./Defold
2626
```
2727

2828

29-
#### Q: The Defold editor crashes when opening a collection or game object and the crash refers to "com.jogamp.opengl"
29+
#### Q: The Defold editor crashes when opening a collection or game object and the crash refers to `com.jogamp.opengl`
3030

31-
A: On certain distributions (like Ubuntu 18) there is an issue with the version of jogamp/jogl Defold uses vs. the version of [Mesa](https://docs.mesa3d.org/) on the system. You can override which GL version that gets reported when calling `glGetString(GL_VERSION)` by setting the `MESA_GL_VERSION_OVERRIDE` to 2.1 or a larger value but less than or equal to the version of your driver. You can check which is the maximum OpenGL version your driver supports using `glxinfo`:
31+
A: On certain distributions (like Ubuntu 18) there is an issue with the version of `jogamp`/`jogl` Defold uses vs. the version of [Mesa](https://docs.mesa3d.org/) on the system. You can override which GL version that gets reported when calling `glGetString(GL_VERSION)` by setting the `MESA_GL_VERSION_OVERRIDE` to 2.1 or a larger value but less than or equal to the version of your driver. You can check which is the maximum OpenGL version your driver supports using `glxinfo`:
3232

3333
```bash
3434
glxinfo | grep version
@@ -64,7 +64,7 @@ $ MESA_GL_VERSION_OVERRIDE=4.6 ./Defold
6464
```
6565

6666

67-
#### Q: Why am I getting "com.jogamp.opengl.GLException: Graphics configuration failed" when launching Defold?
67+
#### Q: Why am I getting "`com.jogamp.opengl.GLException: Graphics configuration failed`" when launching Defold?
6868

6969
A: On certain distributions (for instance Ubuntu 20.04) there is an issue with the new [Mesa](https://docs.mesa3d.org/) drivers (Iris) when running Defold. You can try using an older driver version when running Defold:
7070

@@ -73,7 +73,7 @@ $ MESA_LOADER_DRIVER_OVERRIDE=i965 ./Defold
7373
```
7474

7575

76-
#### Q: The Defold editor crashes when opening a collection or game object and the crash refers to libffi.so
76+
#### Q: The Defold editor crashes when opening a collection or game object and the crash refers to `libffi.so`
7777

7878
A: The [libffi](https://sourceware.org/libffi/) version of your distribution and the one required by Defold (version 6 or 7) does not match. Make sure `libffi.so.6` or `libffi.so.7` is installed under `/usr/lib/x86_64-linux-gnu`. You can download `libffi.so.7` like this:
7979

@@ -106,15 +106,15 @@ A: Check the console output in the editor. If you get the following message:
106106
dmengine: error while loading shared libraries: libopenal.so.1: cannot open shared object file: No such file or directory
107107
```
108108

109-
Then you need to install *libopenal1*. The package name varies between distributions, and in some cases you might have to install the *openal* and *openal-dev* or *openal-devel* packages.
109+
Then you need to install *`libopenal1`*. The package name varies between distributions, and in some cases you might have to install the *`openal`* and *`openal-dev`* or *`openal-devel`* packages.
110110

111111
```bash
112112
$ apt-get install libopenal-dev
113113
```
114114

115115
#### Q: Why does the top menu close before I can select something?
116116

117-
A: This is likely caused by the window manager used (for instance Qtile or i3). This is a [known issue in JavaFX](https://bugs.openjdk.org/browse/JDK-8251240?focusedCommentId=14362084&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-14362084) and it can either be solved by setting the `GDK_DISPLAY` environment variable to 1:¨
117+
A: This is likely caused by the window manager used (for instance `Qtile` or i3). This is a [known issue in JavaFX](https://bugs.openjdk.org/browse/JDK-8251240?focusedCommentId=14362084&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-14362084) and it can either be solved by setting the `GDK_DISPLAY` environment variable to 1:¨
118118

119119
```bash
120120
$ GDK_DISPLAY=1 ./Defold

_includes/shared/en/windows-faq.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22

33
A: This error can happen on [computers using AMD Radeon GPUs](https://github.com/defold/editor2-issues/issues/2723). Make sure to update your graphics drivers.
44

5-
#### Q: Why am I getting 'com.sun.jna.Native.open.class java.lang.Error: Access is denied' when opening an atlas or a scene view?
5+
#### Q: Why am I getting `com.sun.jna.Native.open.class java.lang.Error: Access is denied` when opening an atlas or a scene view?
66

77
A: Try running Defold as administrator. Right-click on the Defold executable and select "Run as Administrator".
88

99
#### Q: Why is my game not rendering properly on Windows using an Intel UHD integrated GPU (but my HTML5 build works)?
1010

11-
A: Make sure to update your driver to a version higher than or equal to 27.20.100.8280. Check with the [Intel Driver Support Asistant](https://www.intel.com/content/www/us/en/search.html?ws=text#t=Downloads&layout=table&cf:Downloads=%5B%7B%22actualLabel%22%3A%22Graphics%22%2C%22displayLabel%22%3A%22Graphics%22%7D%2C%7B%22actualLabel%22%3A%22Intel%C2%AE%20UHD%20Graphics%20Family%22%2C%22displayLabel%22%3A%22Intel%C2%AE%20UHD%20Graphics%20Family%22%7D%2C%7B%22actualLabel%22%3A%22Intel%C2%AE%20UHD%20Graphics%20630%22%2C%22displayLabel%22%3A%22Intel%C2%AE%20UHD%20Graphics%20630%22%7D%5D). Additional information can be found in [this forum post](https://forum.defold.com/t/sprite-game-object-is-not-rendering/69198/35?u=britzl).
11+
A: Make sure to update your driver to a version higher than or equal to 27.20.100.8280. Check with the [Intel Driver Support Assistant](https://www.intel.com/content/www/us/en/search.html?ws=text#t=Downloads&layout=table&cf:Downloads=%5B%7B%22actualLabel%22%3A%22Graphics%22%2C%22displayLabel%22%3A%22Graphics%22%7D%2C%7B%22actualLabel%22%3A%22Intel%C2%AE%20UHD%20Graphics%20Family%22%2C%22displayLabel%22%3A%22Intel%C2%AE%20UHD%20Graphics%20Family%22%7D%2C%7B%22actualLabel%22%3A%22Intel%C2%AE%20UHD%20Graphics%20630%22%2C%22displayLabel%22%3A%22Intel%C2%AE%20UHD%20Graphics%20630%22%7D%5D). Additional information can be found in [this forum post](https://forum.defold.com/t/sprite-game-object-is-not-rendering/69198/35?u=britzl).
1212

13-
#### Q: The Defold editor is crashing and the log shows AWTError: Assistive Technology not found
13+
#### Q: The Defold editor is crashing and the log shows `AWTError: Assistive Technology not found`
1414

1515
If the editor crashes with a log mentioning `Caused by: java.awt.AWTError: Assistive Technology not found: com.sun.java.accessibility.AccessBridge` then follow these steps:
1616

@@ -23,5 +23,5 @@ assistive_technologies=com.sun.java.accessibility.AccessBridge
2323
screen_magnifier_present=true
2424
```
2525

26-
* Add a hashmark (`#``) in front of theses lines
26+
* Add a hash mark (`#``) in front of theses lines
2727
* Save your changes to the file and restart Defold

_includes/shared/es/editor-faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ A: El editor utilizará el 75% de tu memoria disponible en el sistema. Una compu
66
A: Sí. El editor beta de Defold verifica por una actualización al inicio, tal como la versión estable de Defold.
77

88

9-
#### Q: ¿Por qué obtengo un error diciendo "java.awt.AWTError: Assistive Technology not found" cuando lanzo el editor?
9+
#### Q: ¿Por qué obtengo un error diciendo `java.awt.AWTError: Assistive Technology not found` cuando lanzo el editor?
1010
A: Este error está relacionado a problemas con Java assistive technology como el [NVDA screen reader](https://www.nvaccess.org/download/). Probablemente tienes un archivo `.accessibility.properties` en tu carpeta home. Remueve el archivo y trata de lanzar el editor de nuevo. (Nota: Si utilizas cualquier tecnología de asistencia y requieres que el archivo esté presente entonces por favor escríbenos a [email protected] para discutir soluciones alternativas).
1111

1212
Se ha discutido [aquí en el foro de Defold](https://forum.defold.com/t/editor-endless-loading-windows-10-1-2-169-solved/65481/3).

_includes/shared/es/ios-faq.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,13 @@ A: Asegúrate de que utilizas el mismo identificador de bundle en tu proyecto De
44
#### Q: ¿cómo puedo verificar los derechos de una aplicación empaquetada??
55
A: Desde [Inspect the entitlements of a built app](https://developer.apple.com/library/archive/technotes/tn2415/_index.html#//apple_ref/doc/uid/DTS40016427-CH1-APPENTITLEMENTS):
66

7-
> $ codesign -d --ent :- /path/to/the.app
7+
```sh
8+
codesign -d --ent :- /path/to/the.app
9+
```
810

911
#### Q: ¿Cómo puedo verificar los derechos de un perfil provisional?
1012
A: Desde [Inspecting a profile's entitlements](https://developer.apple.com/library/archive/technotes/tn2415/_index.html#//apple_ref/doc/uid/DTS40016427-CH1-PROFILESENTITLEMENTS):
1113

12-
> $ security cms -D -i /path/to/iOSTeamProfile.mobileprovision
14+
```sh
15+
security cms -D -i /path/to/iOSTeamProfile.mobileprovision
16+
```

_includes/shared/fr/editor-faq.md

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,23 +6,19 @@ A: The editor will use up to 75% of the available memory of the system. On a com
66
A: Yes. The Defold beta editor checks for an update at startup, just like the Defold stable version does.
77

88

9-
#### Q: Why am I getting an error saying "java.awt.AWTError: Assistive Technology not found" when launching the editor?
9+
#### Q: Why am I getting an error saying `java.awt.AWTError: Assistive Technology not found` when launching the editor?
1010
A: This error is related to problems with Java assistive technology such as the [NVDA screen reader](https://www.nvaccess.org/download/). You probably have an `.accessibility.properties` file in your home folder. Remove the file and try launching the editor again. (Note: If you do use any assistive technology and require that file to be present then please reach out to us at [email protected] to discuss alternative solutions).
1111

1212
Discussed [here on the Defold forum](https://forum.defold.com/t/editor-endless-loading-windows-10-1-2-169-solved/65481/3).
1313

1414

15-
#### Q: Why doesn't the editor start or open my project?
16-
A: Check if there are spaces in the path leading up to the Defold application. For instance, if you put the folder *Defold-macosx* containing the macOS version of the editor in your *Applications* folder, then you should be ok. If you rename the folder *Defold macosx* the editor might not start anymore. On Windows, putting Defold under *C:\\Program Files\\* can trigger this problem. This is due to a known bug in the underlying Eclipse framework.
17-
18-
19-
#### Q: Why am I getting an error saying "sun.security.validator.ValidatorException: PKIX path building failed" when launching the editor?
15+
#### Q: Why am I getting an error saying `sun.security.validator.ValidatorException: PKIX path building failed` when launching the editor?
2016
A: This exception occurs when the editor tries to make an https connection but the certificate chain provided by the server cannot be verified.
2117

2218
See [this link](https://github.com/defold/defold/blob/master/editor/README_TROUBLESHOOTING_PKIX.md) for details on this error.
2319

2420

25-
#### Q: Why am I am getting a "java.lang.OutOfMemoryError: Java heap space" when performing certain operations?
21+
#### Q: Why am I am getting a `java.lang.OutOfMemoryError: Java heap space` when performing certain operations?
2622
A: The Defold editor is built using Java and in some cases the default memory configuration of Java might not be sufficient. If this happens you can manually configure the editor to allocate more memory by editing the editor configuration file. The configuration file, named `config`, is located in the `Defold.app/Contents/Resources/` folder on macOS. On Windows it is located next to `Defold.exe` executable and on Linux next to the `Defold` executable. Open the `config` file and add `-Xmx6gb` to the line starting with `vmargs`. Adding `-Xmx6gb` will set the max heap size to 6 gigabytes (the default is usually 4Gb). It should look something like this:
2723

2824
```

_includes/shared/fr/html5-faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#### Q: Why does my HTML5-app freeze at the splash screen in Chrome?
22

3-
A: In some cases it is not possible to run a game in the browser locally from the filesystem. Running from the editor serves the game from a local web server. You can, for instance, use SimpleHTTPServer in Python:
3+
A: In some cases it is not possible to run a game in the browser locally from the filesystem. Running from the editor serves the game from a local web server. You can, for instance, use `SimpleHTTPServer` in Python:
44

55
```sh
66
$ python -m SimpleHTTPServer [port]

0 commit comments

Comments
 (0)