Add script cache to demo project, and docs

Author: TokisanGames

.gitignore

@@ -13,9 +13,10 @@ _patches/
 # Docs
 doc/_build
 
-# Godot-specific ignores
+# Godot-specific ignores (Include script cache. See godot issue #75388)
 /project/.import/
-/project/.godot/
+/project/.godot/*
+!/project/.godot/global_script_class_cache.cfg
 export.cfg
 export_presets.cfg
 

Terrain3D.vcxproj

@@ -180,6 +180,7 @@
     <None Include="doc\conf.py" />
     <None Include="doc\docs\double_precision.md" />
     <None Include="doc\docs\games.md" />
+    <None Include="doc\docs\misc.md" />
     <None Include="doc\docs\mobile_web.md" />
     <None Include="doc\docs\nightly_builds.md" />
     <None Include="doc\docs\press.md" />

Terrain3D.vcxproj.filters

@@ -190,6 +190,9 @@
     <None Include="doc\docs\storage_format.md">
       <Filter>2. Docs</Filter>
     </None>
+    <None Include="doc\docs\misc.md">
+      <Filter>2. Docs</Filter>
+    </None>
   </ItemGroup>
   <ItemGroup>
     <Text Include=".readthedocs.yaml">

doc/docs/misc.md

@@ -0,0 +1,30 @@
+Miscelaneous Features
+=======================
+
+This page collects various features that haven't been fully detailed or made their way into specific pages yet.
+
+
+## Terrain3DObjects
+
+This node allows you to snap objects to the terrain when sculpting or moving.
+
+Objects that are children of this node will maintain the same vertical offset relative to the terrain as they are moved laterally. 
+
+For example you can place a sphere on the ground, move it laterally where a hill exists, and it will snap up to the ground. Or you can lower the ground and the sphere will drop with the ground changes. 
+
+You can then adjust the vertical position of the sphere so it is half embedded in the ground, then repeat either of the above and the sphere will snap with the same vertical offset, half embedded in the ground.
+
+To use it:
+* Add a new node
+* Find Terrain3DObjects
+* Add nodes as children of this node
+
+
+
+## Minimal Shader
+
+You'll find a shader that provides just the minimum needed to allow the terrain to work in `extras/minimum.gdshader`.
+
+It includes no texturing. 
+
+Load this shader into the override shader slot and enable it. Customize as you see fit.

doc/index.rst

@@ -102,6 +102,7 @@ Geometry clipmap mesh code created by `Mike J. Savage <https://mikejsavage.co.uk
 
    docs/double_precision
    docs/integrating
+   docs/misc
    docs/mobile_web
    docs/navigation
    docs/occlusion_culling

project/.godot/global_script_class_cache.cfg

@@ -0,0 +1,7 @@
+list=Array[Dictionary]([{
+"base": &"Node3D",
+"class": &"Terrain3DObjects",
+"icon": "",
+"language": &"GDScript",
+"path": "res://addons/terrain_3d/utils/terrain_3d_objects.gd"
+}])

project/project.godot

@@ -12,7 +12,7 @@ config_version=5
 
 config/name="Terrain3D"
 run/main_scene="res://demo/Demo.tscn"
-config/features=PackedStringArray("4.1")
+config/features=PackedStringArray("4.2")
 config/icon="res://icon.svg"
 
 [display]