From 9a02f780df7232556f0ec8966fb5e2243e7152dc Mon Sep 17 00:00:00 2001
From: stdc105 <1missgirlphobia@gmail.com>
Date: Sun, 5 Apr 2026 01:59:23 -0600
Subject: [PATCH] Add warning for using array pattern with packed arrays

---
 tutorials/scripting/gdscript/gdscript_basics.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tutorials/scripting/gdscript/gdscript_basics.rst b/tutorials/scripting/gdscript/gdscript_basics.rst
index 728ae23104b..d06a8ba3ddc 100644
--- a/tutorials/scripting/gdscript/gdscript_basics.rst
+++ b/tutorials/scripting/gdscript/gdscript_basics.rst
@@ -2005,6 +2005,12 @@ The following pattern types are available:
             [42, ..]:
                 print("Open ended array")
 
+    .. warning::
+
+        Array patterns do not match packed arrays (such as ``PackedStringArray``).
+        Call ``Array(packed_array)`` to convert them into arrays before matching with array patterns.
+
+
 - Dictionary pattern
     Works in the same way as the array pattern. Every key has to be a constant pattern.