Installation & Upgrades
Requirements
Supports Godot 4.2+.
Supports Windows, Linux, and macOS. Other platforms are pending.
Running the demo
Download the latest binary release and extract the files, or build the plugin from source.
Run Godot, using the console executable so you can see error messages.
In the project manager, import the demo project and open it. Allow Godot to restart.
In
Project Settings / Plugins
, ensure that Terrain3D is enabled.Select
Project / Reload Current Project
to restart once more.If the demo scene doesn’t open automatically, open
demo/Demo.tscn
. You should see a terrain. Run the scene.
If it isn’t working for you, watch the tutorial videos and read Troubleshooting and Getting Help.
Installing Terrain3D in your project
Download the latest binary release and extract the files, or build the plugin from source.
Copy
addons/terrain_3d
to your project folder asaddons/terrain_3d
.Run Godot, using the console executable so you can see error messages. Restart when it prompts.
In
Project Settings / Plugins
, ensure that Terrain3D is enabled.Select
Project / Reload Current Project
to restart once more.Create or open a 3D scene and add a new Terrain3D node.
Select Terrain3D in the Scene panel. In the Inspector, click the down arrow to the right of the
storage
resource and save it as a binary.res
file. The other resources can be left as is or saved as text.tres
. These external files can be shared with other scenes.Click Next to learn how to properly set up your textures, or skip to import data.
If it isn’t working for you, watch the tutorial videos and read Troubleshooting and Getting Help.
Upgrading Terrain3D
To update Terrain3D:
Close Godot.
Remove
addons/terrain_3d
from your project folder.Copy
addons/terrain_3d
from the new release download or from your build directory into your project folder.
Don’t just copy the new folder over the old, as this won’t remove any files that we may have intentionally removed.
Upgrade Path
While later versions of Terrain3D can generally open previous versions, not all data will be loaded unless the supported upgrade path is followed. We occasionally deprecate or rename classes and provide upgrade paths to convert data for a limited time. Open up your files and resave them in a supported upgrade version before moving on to later versions.
Starting Version |
Supported Upgrade |
---|---|
0.8.4 - 0.9.0 |
Current |
0.8.0 - 0.8.3 |
0.8.4 - 0.9.0 |