From 49b36b3ff182fff42128d36779be74dd40bca3a9 Mon Sep 17 00:00:00 2001
From: Erick Sanchez <7268597+nalancer08@users.noreply.github.com>
Date: Mon, 26 Oct 2026 13:01:25 -0600
Subject: [PATCH] Explain native game builds and document Xbox and PlayStation
 controller support

---
 README-es.md | 18 +++++++++++++++++-
 README.md    | 18 +++++++++++++++++-
 2 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/README-es.md b/README-es.md
index 1c9ddc1..dd5f6d6 100644
--- a/README-es.md
+++ b/README-es.md
@@ -2,7 +2,7 @@
 
 [English](README.md) · **Español**
 
-**Tus propios juegos, preparados para iPhone, iPad o Mac.**
+**Ejecuta tus propios juegos compatibles de Nintendo Switch de forma nativa en Mac, iPhone y iPad, con gráficos Metal, controles físicos y controles táctiles editables.**
 
 ## Empieza aquí
 
@@ -198,6 +198,22 @@ Esta base requiere iOS/iPadOS 26 o posterior, iPhone con A17 Pro o posterior o i
 </tr>
 </table>
 
+## Controles Xbox, PS5 y PS4
+
+Los juegos preparados usan GameController de Apple en **Mac, iPhone y iPad**:
+
+- **Xbox:** Xbox Wireless Controller con Bluetooth (modelo 1708), Series X/S y Elite Series 2.
+- **PS5:** DualSense y DualSense Edge.
+- **PS4:** DualShock 4.
+
+Conecta el control desde **Bluetooth del dispositivo** y abre tu juego. No necesitas instalar drivers ni activar opciones en la herramienta. Se mapean sticks, cruceta, botones, gatillos, botones superiores, clics de sticks y menús. En iPhone/iPad los controles táctiles se ocultan al conectar uno físico.
+
+Los botones siguen las **posiciones de Nintendo**, no las letras impresas en Xbox: A de Switch = B de Xbox / círculo de PlayStation; B = A / cruz; X = Y / triángulo; Y = X / cuadrado.
+
+Se admite la entrada estándar del control; no se mapean gatillos adaptativos de DualSense, movimiento del mando ni gestos del panel táctil. La vibración depende de lo que expongan el control y el sistema. En Mac puede haber varios jugadores locales si el juego lo permite; en iPhone/iPad los controles se combinan como jugador 1.
+
+Guías de Apple para [conectar Xbox](https://support.apple.com/en-us/111101) y [conectar PlayStation](https://support.apple.com/en-us/111100). Revisamos el código y las pruebas automáticas; no hemos probado físicamente estos modelos en este checkout.
+
 ## Controles a tu gusto
 
 En el juego pulsa **Edit controls**. Mueve los botones, ajusta tamaño y opacidad y pulsa **Save**. **Cancel** descarta y **Reset control / Reset all** restaura. Cada juego guarda su acomodo 2D y 3D. El juego sigue corriendo mientras editas. El selector de idioma de la app de Mac no traduce este editor dentro del juego.
diff --git a/README.md b/README.md
index 3f35ec1..edd8f5a 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 **English** · [Español](README-es.md)
 
-**Your own games, prepared for iPhone, iPad or Mac.**
+**Run your own supported Nintendo Switch games natively on Mac, iPhone and iPad — with Metal graphics, physical controllers and editable touch controls.**
 
 ## Start here
 
@@ -196,6 +196,22 @@ This base requires iOS/iPadOS 26 or later, an iPhone with A17 Pro or later, or a
 </tr>
 </table>
 
+## Xbox, PS5 and PS4 controllers
+
+The game apps use Apple's GameController framework on **Mac, iPhone and iPad**:
+
+- **Xbox:** Bluetooth-capable Xbox Wireless Controller (model 1708), Series X/S and Elite Series 2.
+- **PS5:** DualSense and DualSense Edge.
+- **PS4:** DualShock 4.
+
+Pair your controller in the device's **Bluetooth settings**, then open the prepared game. No extra driver or launcher setting is needed. Sticks, D-pad, face buttons, shoulders, triggers, stick clicks and menu buttons are mapped automatically. On iPhone/iPad, touch controls hide while a physical controller is connected.
+
+Face buttons follow **Nintendo positions**, rather than the letters printed on an Xbox controller: Switch A = Xbox B / PlayStation Circle; Switch B = Xbox A / Cross; Switch X = Xbox Y / Triangle; Switch Y = Xbox X / Square.
+
+Standard gamepad input is supported; DualSense adaptive triggers, controller motion and touchpad gestures are not mapped. Rumble depends on the features exposed by the controller and OS. Mac supports separate local players when the game allows it; iPhone/iPad merge controllers into player 1.
+
+See Apple's [Xbox pairing guide](https://support.apple.com/en-us/111101) and [PlayStation pairing guide](https://support.apple.com/en-us/111100). This support was checked in the input code and automated tests; these specific physical models have not been tested in this checkout.
+
 ## Make the controls your own
 
 Inside the game, tap **Edit controls**. Move buttons, adjust their size and opacity, then tap **Save**. **Cancel** discards edits; **Reset control / Reset all** restores defaults. Each game keeps separate 2D and 3D layouts. The game continues running while you edit. The desktop language selector does not translate this in-game editor.