Release notes from Terrain3D

v0.9.3a-beta

2024-11-03T10:43:27Z

No content.

Terrain3D v0.9.3a-beta (Updated)

2024-11-04T17:31:30Z

Cover art by FR3NKD

Terrain3D v0.9.3a-beta Release

This update has over 200 commits including:

Performance improvements to the Instancer by @Xtarsia
Support for the Compatibility Renderer by @Xtarsia
Separate storage files per region by @SlashScreen
Adjustable region sizes by @Dekker3D
Terrain sizes as small as 64 x 64m up to 65.5 x 65.5km by @Xtarsia
Slope painting tool setting by @Ryan-000
Many performance and quality improvements by @Xtarsia

Be sure to familiarize yourself with the updated keyboard shortcuts. e.g. You must use CTRL for removal.

Games Made With Terrain3D

Check out other Games Made With Terrain3D. If you're using Terrain3D in your game, let me know so I can add it.

Breaking Changes & Known Issues

Data is now stored in a directory instead of a single storage file. See the upgrade instructions to convert your data.
There have been many API changes in this release.
Thumbnail generation of the mesh assets in the asset dock is a bit wonky. Click Meshes or hover to regenerate.

Download

Requirements

Supports Godot 4.2.2-4.3, 4.3 is recommended.
Supports Windows, Linux, macOS(read more) and experimental mobile platforms. See all platforms and renderers.

Get Terrain3D in the AssetLib tab within Godot.
Or, download terrain3d_0.9.3a-beta.zip under Assets below.
Follow the Installation & Upgrade instructions.

Full Changelog

This release has over 200 commits!
Full Changelog: v0.9.2-beta...v0.9.3a-beta

Updated 11/3: v0.9.3a includes a few fixes for the compatibility renderer, spray tool, Terrain3DObjects undo, and reduces default MMI visibility range to 64m.

Thanks to all our contributors including our new ones: @Ryan-000, @Dekker3D, @Malidos, @scottdavis, @jesus-g20

Terrain3D v0.9.2-beta

2024-11-03T11:18:47Z

v0.9.2-beta Release

This massive update includes long desired features like a foliage instancer, paintable rotation and scale, fixes for artifacts, and countless other improvements.

Download terrain3d_0.9.2-beta.zip under Assets below and follow the Installation & Upgrade instructions.

Games Made With Terrain3D

Check out other Games Made With Terrain3D. If you're using Terrain3D in your game, let me know so I can add it.

Compatibility

Supports Godot 4.2.2-4.3.
D3D12 and Compatibility renderers are currently unsupported.
Includes binaries for Windows, Linux, macOS and experimental mobile platforms.
macOS/iOS are unsigned universal builds. You may need to jump through Apple security hoops to use them. If you have problems, your best bet is to build from source.

Breaking Changes & Known Issues

Thumbnail generation of the mesh assets in the asset dock is a bit wonky. Click Meshes or hover to regenerate.
Internally, we restructured the classes so the major sub classes (eg Terrain3DStorage) has a link back to the Terrain3D instance in PR #371. This revealed a garbage collection bug (design choice) in Godot for C# users.
The texture list from 0.9.0/1 should automatically upgrade to the new asset list. Open a scene, the console reports it detected the old version and asks you to save right away to upgrade. If you have multiple scenes sharing the same asset list, open and save to upgrade the first one. All of the other scenes will be broken, but you just need to quick load the asset list and save.

Notable Updates

Added a foliage instancer. Hold CTRL to remove. #340 and #402
Detiling in the Texture Asset is now usable by @Xtarsia in 46a36bd
Fixed the long standing artifact on region boundaries #185 by @Xtarsia in #353
Paintable UV rotation & scale by @Xtarsia in #365
Terrain3DObjects allows MeshInstance3Ds to track terrain sculpting changes by @tcoxon in #325
The Asset Dock is now movable and can be in any sidebar or down at the bottom of the screen. Settings are saved. #338

API

Exposed control map conversion utilities to GDScript in 4943cfb
get_texture_id() now reports autoshader values by @Xtarsia in #376
get_height() and get_normal() now interpolate between vertices in e889b71 and c0797ad

New Contributors

Thanks to all our contributors including some new ones: @Xtarsia, @FishOfTheNorthStar, @jeffercize, @az-raven

Full Changelog - Updated: July 8th

This is a huge release with ~~118~~ 131 commits! The download has been updated to include a few additional changes that aren't worth another release.
Full change log:
v0.9.1-beta...25601a0

Terrain3D v0.9.1-beta

2024-04-30T05:19:41Z

v0.9.1-beta Release

Download the compiled binary package found under Assets below. Ignore the files labeled Source code.

This version comes with full API docs, improved mobile support, improved mouse cursor, an awesome slope sculpting tool, vertex spacing for higher and lower poly worlds, and more.

Compatibility

Supports Godot 4.1 and 4.2. 4.3 may work but is not supported until it is stable.
Includes binaries for Windows, Linux, macOS and experimental platforms Android 32/64, iOS for cross-platform exports.
macOS/iOS are unsigned universal builds. macOS work on both M1/Arm and Intel x64. You may need to jump through Apple security hoops to use them. If you have problems, your best bet is to build from source.

Breaking Changes

v0.8 deprecated classes have been removed. To seamlessly update from <=0.8.3 first load in 0.8.4 or 0.9.0 and save, then upgrade to this or future versions.
Possible custom shader breaks, definite improvements in base shader

Notable Changes

Slope sculpting tool by @tcoxon in #297
Relaxed texture requirements, moving responsibility for texture compatibility to developer. Also enables android and ios support. by @lfxu in #295
iOS Support by @directedchaossoftware in #219
Vertex spacing (mesh density) by @lfxu in #296 and @TokisanGames in #323
Add channel packer tool by @epitaque in #259
Improved mouse cursor, support all 4 viewports inc half resolution and orthogonal by @TokisanGames in #313
Improved rotation anti-tiling by @outobugi in #317
Full documentation for the API.
An example minimal custom shader was added to the extras directory. This provides mesh functionality without any texturing or advanced features like holes.
Added maps_edited signal to Terrain3DStorage by @tcoxon in #305 and #274
Brush size can now be manually entered larger than 200
and countless fixes and improvements

New Contributors

Thanks to all our contributors including some new ones: @lfxu, @directedchaossoftware, @epitaque.

Full Changelog: v0.9.0-beta...v0.9.1-beta

Terrain3D v0.9.0-beta

2023-12-18T15:04:57Z

v0.9.0 beta release

Notes

Supports Godot 4.1.3+ and 4.2.0+
Includes binaries for Windows, Linux, macOS and experimental Android for cross-platform exports.
macOS builds are unsigned universal builds that work on both M1/Arm and Intel x64 if you jump through Apple security hoops. If you have problems, your best bet is to build from source.
This is the last release for 0.8 deprecated classes. They'll be removed in 0.9.1. The upgrade path from <0.8.4 is to first load 0.8.4 or 0.9.0, save, then upgrade to 0.9.1+.

Breaking changes

The shader has been dramatically refactored. Redo your custom shader changes. Discarding external vertices is now included.

New Features

Navigation Baker by @tcoxon and @SlashScreen in #267
Holes that work with collision by @TokisanGames
Auto shader w/ dual scaling, macro variation, edge noise, removed specular by @TokisanGames
Improved world background noise by @TokisanGames
Toggleable nearest/linear texture filtering by @jacobcoughenour in #265
Terrain3DStorage::get_normal() function by @lw64 in #246
Command line debug switch --terain3d-debug by @lw64 in #247
Moved documentation from github wiki to readthedocs.

Notable Fixes

#233: All regions can now be loaded by @rds1983 in #250
#186: Exporter's filename validations by @rds1983 in #255

And countless more improvements. Full Changelog: v0.8.4-alpha_gd4.1.3...v0.9.0-beta

Terrain3D v0.8.4-alpha_gd4.1.3

2023-12-01T06:13:00Z

v0.8.4 alpha release for Godot 4.1.3

Notes

For Godot 4.2, use the nightly build from 4d844c4, which fixes some error spam. Must be logged in to github to download.
Includes binaries for Windows, Linux, and macOS for cross-platform exports.
macOS builds are unsigned universal builds that work on both M1/Arm and Intel x64 if you jump through Apple security hoops. If you have problems, your best bet is to build from source.

Breaking changes

Major shader changes. If you have a custom shader, reapply your changes to our 0.8.4 shader.
Terrain3DStorage.save_16-bit renamed to save_16_bit
Probably some other functions and variables not listed here

Major Changes

Occlusion Culling added by @tcoxon
Dramatically improved texturing tools. Use this painting technique for optimal results.
Major class restructure, separating the material into a separate resource that can be saved to disk.
Custom uniforms are dynamically exposed for custom shaders
Control map converted to a bitfield, allowing for many more features to be added in the future like holes and foliage
Support for doubles added by @SlashScreen. See #30
Exposed extra_cull_margin
A lot more documentation

Other New Contributors

@svencan made their first contribution improving installation instructions in #212

Full Changelog: v0.8.3-alpha_gd4.1.1...v0.8.4-alpha_gd4.1.3

Terrain3D v0.8.3-alpha_gd4.1.1

2023-09-12T13:00:27Z

v0.8.3 alpha release for Godot 4.1.1

Notes

The release now includes binaries for Windows, Linux, and macOS so cross-platform exports will work.
macOS builds are unsigned universal builds and should work on both M1/Arm and Intel x64.

Breaking Changes

The terrain is now aligned to the origin. Your objects need to move (512, 0, 512). See #195 for reasoning and easy instructions.

Other Changes

Increased speed by 20% by removing derivatives from the shader
Surfaces are now called Textures and now stored in a separate, savable TextureList resource for sharing between scenes. v0.8.3 automatically extracts textures from the storage resource to this new resource. It's just text data, so saving as tres is best. See [#188]
raw file extension is now accepted as synonymous with r16 for import/export
Configured build scripts. Github now builds the releases for all systems
Added class name to debug logger
Countless other fixes

Full Changelog: v0.8.2-alpha_gd4.1.1...v0.8.3-alpha_gd4.1.1

Terrain3D v0.8.2-alpha_gd4.1.1

2023-08-31T09:13:37Z

v0.8.2 alpha release for Godot 4.1.1

Notes

Windows binaries require the latest Microsoft Visual C++ Redistributable.
macos universal is newer, built by github
osx_x64 build is community provided.

Breaking changes

Moved plugin.cfg. You may need to reenable the plugin
Changed texture uv scale from vec3 to float
Renamed collision_layers -> collision_layer to match Godot

Additions

Surfaces now have names and can be reordered
Add false color debug shaders
Change importer to allow importing and exporting files from anywhere on the file system
Print image size to console when exporting images

Bug fixes

Fix #143 Data exporter unable to rewrite existing file
Fix #147 Crash importing null textures
Fix #111 RID error spam
Fix #151 Gaps between collision shapes. Collision edges now read from adjacent maps
Fix Connection to camera lost when game changes active camera
Fix #169 terrain normals
Fix get_region_offset() gdscript API

Developers

Shaders are now separate glsl files instead of embedded in C++
Shaders have an inclusion system to allow snippets to be inserted into the main shader

Full Changelog: v0.8.1-alpha_gd4.1.1...v0.8.2-alpha_gd4.1.1

Terrain3D v0.8.1-alpha_gd4.1.1

2023-08-23T10:07:55Z

v0.8.1 Alpha release for Godot 4.1.1
Linux & Windows include both debug & release libraries.

Updates:

Fix smoothing over regions causing an artifact
Fix Raycasting returning null. Now returns terrain3d object
Expose cast_shadows and render layers
Fixes for building OSX & Linux
Extras: Fix project_on_terrain3d for HungryProton's newest version of Scatter
Demo: Fix F8 not quitting on export
Internal: Restructure update code

Edit: I forgot to add the demo to the packages. It has been added.
7/24 Edit: I also forgot to add the project file so the demo will run. Files updated.

Terrain3D v0.8-alpha_gd4.1

2023-08-23T10:08:06Z

v0.8 Alpha release for Godot 4.1. Debug builds. OSX is community provided.