SurfaceAnalyzer 2.1 3D Tools 4.2 Community

Submitted by user BWolf; MIT; 2026-05-13

A Godot 4.2+ plugin for identifying surface materials on complex 3D meshes via raycast.

Designed to work alongside a detailed "ConcavePolygonShape3D" for precise material detection.

Features

- Returns the actually rendered material "get_active_material"
- Returns the overridden material from MeshInstance3D "get_surface_override_material"
- Works with multi-surface meshes

Custom node hierarchies may require manual adjustments.

Caching behavior: Triangle counts are cached per Mesh resource. If you check another mesh during execution, the cache will remove the old data.

Memory: The cache stores only the last accessed mesh to minimize memory usage. Switching between many different meshes will repeatedly rebuild the cache.

Performance: First access to a new mesh triggers [method Mesh.surface_get_arrays], which copies geometry data from GPU to CPU. This may cause a spike. Subsequent raycasts on the same mesh are fast.

Requirements

- Godot 4.2 or newer
- The detailed collision shape must be generated from the visual mesh
- Jolt Physics: If using Jolt, enable "physics/jolt_physics_3d/queries/enable_ray_cast_face_index" (requires godot-jolt 0.14.0 or newer)