From 33530407660306e804bb0edadfda3dc4ccb1b592 Mon Sep 17 00:00:00 2001
From: Nintorch <92302738+Nintorch@users.noreply.github.com>
Date: Thu, 26 Feb 2026 12:22:32 +0500
Subject: [PATCH] Clarify `Input.get_connected_joypads()` order

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

diff --git a/doc/classes/Input.xml b/doc/classes/Input.xml
index 805576f170..f5da5fa55d 100644
--- a/doc/classes/Input.xml
+++ b/doc/classes/Input.xml
@@ -85,6 +85,7 @@
 			<return type="int[]" />
 			<description>
 				Returns an [Array] containing the device IDs of all currently connected joypads.
+				[b]Note:[/b] The order of connected joypads can not be guaranteed to be the same after a project and/or the editor is restarted, because Godot doesn't save the order of joypad connections. Joypads are registered in the order they are discovered by Godot.
 			</description>
 		</method>
 		<method name="get_current_cursor_shape" qualifiers="const">