From be020ef7714b8cbb51070299033bf6e0a70f989b Mon Sep 17 00:00:00 2001
From: vaner-org <angadmishra@outlook.com>
Date: Wed, 10 Sep 2025 07:10:18 +0530
Subject: [PATCH] Clarifies limitations of get_debug_mesh

---
 doc/classes/Shape3D.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/classes/Shape3D.xml b/doc/classes/Shape3D.xml
index b82620139a50..177be8f32f25 100644
--- a/doc/classes/Shape3D.xml
+++ b/doc/classes/Shape3D.xml
@@ -15,6 +15,7 @@
 			<return type="ArrayMesh" />
 			<description>
 				Returns the [ArrayMesh] used to draw the debug collision for this [Shape3D].
+				[b]Note:[/b] This generates a debug line mesh intended for visual debugging purposes only. It has no surface data accessible via [MeshDataTool], and cannot be used with [SurfaceTool] to create triangle meshes as they use different array layouts. To extract actual collision mesh data, use [method ConcavePolygonShape3D.get_faces] for trimesh collision shapes.
 			</description>
 		</method>
 	</methods>