FuncGodot 2024.3.1

2024.3.1 Hot Fix

• Solid Entity Origin Type Bounds calculations now correctly retrieve the bounding box dimensions. See #66 for more information. This could be considered a breaking change if you adapted your workflow to this particular bug.

New to FuncGodot 2024.3:

• New Entity property auto_apply_to_matching_node_properties : Automatically applies entity class properties to matching properties in the generated node. This feature comes from @greenfox1505!
• New Solid Entity feature Mesh Metadata: a group of properties that tell FuncGodot to add a "func_godot_mesh_data"] Dictionary to the metadata of the generated node upon build. This data is parallelized, so that each element of the array is ordered to reference the same face in the mesh.
  • add_textures_metadata
  • add_vertex_metadata
  • add_face_position_metadata
  • add_face_normal_metadata
  • add_collision_shape_face_range_metadata

Short list but the mesh metadata is a long requested major feature. The main purpose behind it is to allow devs to get the texture on a particular face of the map geometry, to allow for surface based effects like footsteps based on the ground texture or bullet decals based on the wall or ceiling, etc...

Godot separates Meshes and Collision, for a wide number of reasons. This makes it a complex undertaking trying to solve for the texture a character may be standing on or any other similar game mechanics. The new Mesh Metadata feature is our way of bridging that gap. You can read the discussion we had over it here. A number of us discussed it and came up with general designs and requirements for the feature but the brunt of the work and final implementation comes from @the-argus!

The feature is off by default and must be enabled in your own custom or duplicated entities. If wanting to use this feature on one of the default entities, be sure to copy the definitions outside the addons folder, as any changes will be overwritten with every update to the plugin. Be sure to read the Manual to understand how it works!

Speaking of The Manual, it's been updated to not only include the new features but also for slight improvements to readability. Linking to individual pages should also work properly now.

Lastly, we'll finally be getting FuncGodot on AssetLib. We want to thank you for your patience on this. Stay tuned for a brief announcement on this!

And yes, Phong is still broken. Working on that.

Looking forward to all of your surface shenanigans experiments and showcases!
@RhapsodyInGeek