nxnative-easy/README-es.md

nxnative Easy

English · Español

Prepara tus juegos para iPhone desde una app de Mac. Sin comandos para el uso diario.

Qué aporta esta versión

Partimos de seedds/nxnative: el motor, los perfiles y la compatibilidad son trabajo del proyecto original. nxnative Easy añade:

• App para Mac: elegir juego, avance, cancelación y acceso a IPA, datos y Sideloadly.
• Controles editables en iPhone: posición, tamaño y opacidad, guardados por juego y layout.
• IPA ligera automática: los datos romfs van aparte; se conservan salidas y cachés válidas.
• Llaves del usuario: debes seleccionar la carpeta de tus propias prod.keys. No incluimos, descargamos ni distribuimos llaves o juegos.
• Preparación local: sin cuenta Apple, sin certificados de empresa y sin servicio que reciba tus archivos.

Entregamos código, una interfaz de preparación y herramientas de compilación. El resultado es una IPA sin firmar; tú la firmas e instalas con Sideloadly. No ofrecemos juegos, llaves, firma de Apple ni compatibilidad garantizada con cualquier juego.

Idioma

La app inicia en English. Cambia a Español con el selector de la esquina superior; la elección se guarda en este Mac. Cambia el idioma de la interfaz, no el del juego. Los detalles técnicos se muestran en su idioma original.

Abre la app y elige tu juego

1. Abre nxnative.app.
2. Elige la Carpeta del juego, selecciona tu Carpeta de llaves una vez y pulsa Preparar juego.

La app prepara las herramientas, compila y deja lista la IPA ligera. Verás el avance en la ventana. Al terminar aparecen los dos pasos para instalar. Enviar a Sideloadly abre allí la IPA preparada; si Sideloadly no está instalado, el botón ofrece descargarlo.

En nuestro Mac: la app está disponible como nxnative.app en Descargas. Recuerda tu última carpeta y permite volver a mostrar la IPA ya preparada.

En otro Mac: después de descargar este repositorio privado, abre scripts/Abrir-interfaz.command con doble clic. Crea y abre la app local. La primera vez necesitas Xcode completo y Homebrew instalados; si hacen falta tus llaves, te pedirá elegir la carpeta donde guardas tu propio prod.keys. Mantén cada juego fuera del repositorio, en una carpeta con su base y actualizaciones.

Cómo se compila la app de Mac

El acceso de apertura usa el compilador Swift de tu Xcode. La firma de la app es ad hoc, local y sin cuenta, certificado ni equipo Apple (TeamIdentifier no asignado). No usa cuentas de empresa. Sólo al instalar la IPA de iPhone con Sideloadly introduces tu cuenta personal, dentro de Sideloadly.

Los símbolos de la interfaz son genéricos del sistema; no se usan imágenes ni logotipos de los juegos en la app. La galería de documentación de abajo procede de upstream y está separada de la interfaz.

Instalar: Sideloadly + Finder

1. Con la IPA lista, conecta tu iPhone y pulsa Enviar a Sideloadly. La app abre allí el archivo preparado.
2. Dentro de Sideloadly pulsa Start con tu cuenta Apple personal. Si hace falta buscar el archivo manualmente, usa Mostrar IPA.
3. La primera vez, pulsa Mostrar datos del juego y copia la carpeta romfs completa por Finder → iPhone → Archivos → tu juego.

Para actualizar, usa la misma cuenta y el mismo bundle ID efectivo de Sideloadly. Instala encima; no desinstales la app, para conservar tus partidas. Si los datos del juego no cambiaron, puedes reutilizar el romfs existente. La app instala las herramientas de compilación que falten después de tener Xcode y Homebrew, pero no firma ni instala el juego en el iPhone. Esos pasos los hace Sideloadly. La app los explica cuando la IPA está lista.

Juegos incluidos

El carrusel muestra los perfiles de esta copia; no proporciona ni descarga juegos. Debes añadir tus propios archivos del juego. Pulsa Ver todos arriba a la derecha para consultar la lista completa de soporte. Busca por nombre, versión o Title ID; cada resultado enlaza a su ficha. El catálogo vuelve a leer los perfiles locales cada vez que lo abres.

Las pruebas propias cubren compilación y empaquetado en Mac, no una verificación automática de juego en iPhone. Los perfiles y reportes de juego proceden de upstream; revisa la ficha de tu juego antes de prepararlo. Un perfil no garantiza que cualquier versión funcione en cualquier iPhone.

Esta base requiere iOS/iPadOS 26 o posterior, iPhone con A17 Pro o posterior o iPad con M1 o posterior. Los datos de los juegos y las llaves los aportas tú.

Mario Kart 8 Deluxe ~11.9 GB · no Mii heads	Mario vs. Donkey Kong ~1.6 GB	Paper Mario: The Thousand-Year Door ~5 GB · 60 fps with 1.0.1
Super Mario 3D World + Bowser's Fury ~3 GB	Super Mario Bros. Wonder ~4 GB	Super Mario Galaxy ~3 GB
Super Mario Galaxy 2 ~3 GB	Super Mario Odyssey ~6 GB	The Legend of Zelda: Breath of the Wild ~16 GB · 60 fps with 1.9.0
The Legend of Zelda: Link's Awakening ~6 GB	The Legend of Zelda: Tears of the Kingdom ~17 GB · 60 fps with 1.4.3	13 Sentinels: Aegis Rim ~5 GB
Absolum ~2 GB	Ace Attorney Investigations Collection ~7 GB	Advance Wars 1+2: Re-Boot Camp ~7.1 GB
AI: THE SOMNIUM FILES ~8.3 GB	AI: THE SOMNIUM FILES - nirvanA Initiative ~11.6 GB	Animal Crossing: New Horizons ~10.5 GB
ANIMAL WELL ~54 MB	ASTRAL CHAIN ~9.7 GB · 60 fps target with 1.0.1	Balatro ~82 MB · played by touch
BALL x PIT ~1.1 GB	Bayonetta ~8.8 GB	Bayonetta 2 ~12.5 GB
Bayonetta 3 ~14.2 GB	Big Brain Academy: Brain vs. Brain ~0.8 GB	Brain Memory Training Academy ~0.1 GB
Captain Toad: Treasure Tracker ~2 GB	Catherine: Full Body ~14 GB	Celeste ~0.9 GB
Cuphead ~5 GB	DARK SOULS: REMASTERED ~4 GB · 60 fps with 1.0.3	Digimon Story Cyber Sleuth: Complete Edition ~5 GB
DRAGON QUEST VII Reimagined ~5.9 GB	DRAGON QUEST XI S: Echoes of an Elusive Age – Definitive Edition ~15 GB · 60 fps with 1.0.4	FINAL FANTASY RESONANCE ~10 GB · 60 fps with 1.0.1
FINAL FANTASY TACTICS - The Ivalice Chronicles ~11 GB	Fire Emblem Engage ~15 GB · 60 fps with 2.0.0	Fire Emblem: Three Houses ~13 GB · 60 fps with 1.2.0
Ghost Trick: Phantom Detective ~3 GB	The Great Ace Attorney Chronicles ~4 GB	Hades ~4 GB
Hades II ~4 GB	Hollow Knight: Silksong ~6.4 GB	Hyrule Warriors: Age of Calamity ~15 GB · 60 fps with 1.3.0
Luigi's Mansion 3 ~7.5 GB · 60 fps with 1.4.0	Metroid Dread ~5 GB	Monster Hunter Rise ~22 GB · 60 fps with 16.0.2
Monster Train 2 ~1.6 GB · 60 fps with 1.1.1	Octopath Traveler 0 ~4 GB · 60 fps with 1.0.5	Octopath Traveler II ~5.9 GB · 60 fps with 1.1.1
Patrick's Parabox ~0.2 GB	Persona 5 Royal ~14.9 GB	Pikmin 4 ~10.8 GB
Pokémon Brilliant Diamond ~4.6 GB · 60 fps with 1.3.0	Pokémon Legends: Z-A ~6 GB	Pokémon Sword ~12.4 GB
Pokémon Shield ~12.4 GB	Portal ~2.6 GB	Raging Loop ~0.9 GB
Rhythm Heaven Groove ~3 GB	ROMANCE OF THE THREE KINGDOMS 8 REMAKE ~16.8 GB · controller only	Stardew Valley ~0.6 GB
STEINS;GATE RE:BOOT ~6 GB	Super Smash Bros. Ultimate ~17.5 GB · offline	Taiko Risshiden V DX ~3.3 GB · Japanese · played by touch
Unicorn Overlord ~4 GB	NieR:Automata The End of YoRHa Edition ~10.9 GB · 60 fps with 1.0.3	The Legend of Zelda: Echoes of Wisdom ~7.8 GB

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.

Guías, comandos y detalles técnicos

• Guía de comandos e instalación detallada.
• Automatización y solución de problemas.
• Revisión de los PR de upstream.
• README anterior y créditos completos.

Basado en seedds/nxnative, con nuestro editor de controles y automatización. Conservamos la licencia MIT y los créditos originales. Nuestros cambios pertenecen a la cuenta de GitHub nalancer08; los commits históricos de upstream conservan su autoría.