Supported Platforms
This page documents the status of various platforms and renderers supported by Godot.
Table of Contents
Operating Systems
Renderers
Windows
Fully supported. See renderers.
Linux
Fully supported. See renderers.
macOS
Godot and Terrain3D work fine on macOS, however Apple security is overly aggressive when using our release binaries.
Users have reported errors like this:
"libterrain.macos.debug" cannot be opened because the developer cannot be verified. macOS cannot verify that this app is free from malware.
Running the following commands within the downloaded and unzipped directory appears to resolve the issue.
$ xattr -dr com.apple.quarantine addons/terrain_3d/bin/libterrain.macos.debug.framework/libterrain.macos.debug
$ xattr -dr com.apple.quarantine addons/terrain_3d/bin/libterrain.macos.release.framework/libterrain.macos.release
You can also read comments and workarounds from other users.
If bypassing Apple security is not working, or if approaching a release date, macOS users should build from source so you can sign the binaries with your own developer account.
IOS
As of Terrain3D 0.9.1 and Godot 4.2, iOS is reported to work with the following setup:
In Terrain3DMaterial, set max_regions to 64-256 and keep region count under that.
Use textures that Godot imports (converts) such as PNG or TGA, not DDS.
Enable
Project Settings/Rendering/Textures/VRAM Compression/Import ETC2 ASTC.Set
Project Settings/Application/Config/Iconto a valid file (egres://icon.pngor svg).The Terrain3D release includes iOS builds, however they aren’t signed and may not work.
If needed, build the iOS library and make sure the binaries are placed where identified in
terrain.gdextension:
scons platform=ios target=template_debug
scons platform=ios target=template_release
Select
Project/Export, Add the iOS export preset and configure withApp Store Team IDandBundle Identifier, then export.
Once it has been exported, you can open it in XCode, run locally, or on your device.
Further reading:
Android
As of Terrain3D 0.9.1 and Godot 4.2, Android is reported to work. It is still a bit experimental.
In Terrain3DMaterial, set max_regions to 64-256 (128 has the broadest reported coverage) and keep region count under that.
Use textures that Godot imports (converts) such as PNG or TGA, not DDS.
Enable
Project Settings/Rendering/Textures/VRAM Compression/Import ETC2 ASTC.
The release builds include binaries for arm32 and arm64.
Some mobile devices appear to not fully support texture arrays. Or perhaps they need more testing of different texture formats.
Further reading:
Steam Deck
As of Terrain3D v0.9.1 and Godot 4.2, the first generation Steam Deck is reported working, running the demo at 200+ fps.
The user got it working with the following:
Use SteamOS 3.5.7
Install
glibcandlinux-api-headersin addition to the standard Godot dependencies
Further reading:
WebGL
The releases and nightly builds include a web build, but web exports are very experimental. We have had success on some platforms. See the progress and setup instructions in Issue 502.
Supported Renderers
Vulkan
The Forward+ Vulkan renderer is fully supported.
D3D12
The Forward+ Direct3D 12 renderer is fully supported as of Godot 4.6.
Metal
Support for Apple’s Metal for iOS and macOS was merged into Godot 4.4-dev1. We do have Metal users but full Terrain3D support is not clear.
Mobile
The Forward Vulkan Mobile renderer is fully supported.
Compatibility
The OpenGLES 3.0 Compatibility renderer is fully supported since Terrain3D 1.0 and Godot 4.4.