Cómo usar nxnative
Usar nxnative consiste en tres cosas: crear una app a partir de tu propio juego en un Mac, instalarla en tu iPhone o iPad y jugar. Este es el proceso oficial, en orden. Se da por hecho que ya tienes los archivos y las claves de tu propio juego; este sitio no explica cómo obtenerlos.
Paso 1: instala nxnative y sus herramientas (una vez)
En un Mac con macOS 26.6 o posterior, Xcode 27.1 y Homebrew (usa Python 3.12 o posterior):
xcodebuild -downloadComponent MetalToolchain
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd glslang
brew install --cask dotnet-sdk
python3 -m pip install lz4 capstone fonttools "backports.zstd; python_version < '3.14'"Paso 2: pon un juego en una carpeta
Una carpeta por juego, con el juego base y su actualización y DLC si los tienes. También funcionan los archivos comprimidos NSZ y XCZ; el script los convierte una vez. Se empaqueta la versión más reciente que haya en la carpeta.
Paso 3: ejecuta el script
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keysEl IPA aparece en la misma carpeta. Opciones útiles: -o fija la ruta de salida, --app-name el nombre de la app, --language el idioma del juego, --show-fps muestra la frecuencia de imagen y --platform mac-app crea una app para Mac. Ejecútalo con -h para ver la lista completa. La primera compilación tarda de 30 a 60 minutos; las siguientes reutilizan los pasos cuyas entradas no han cambiado, así que guarda el pequeño archivo .idx que el script deja junto al IPA.
Paso 4: instala el IPA
Instálalo con tu herramienta de sideload: AltStore, Sideloadly, LiveContainer o similar. Fírmalo con la capacidad Increased Memory Limit si tu herramienta lo permite, para que iOS no cierre los juegos más grandes. La app recibe el nombre, el icono y la versión del juego. Con una cuenta de desarrollador de Apple puedes usar --prepare-xcode e instalar desde Xcode.
Para un juego grande, --romfs separate deja los archivos del juego fuera del IPA e imprime un comando que los copia al teléfono una sola vez, así el IPA es pequeño y las recompilaciones son rápidas. También ayuda cuando un IPA es demasiado grande para que iOS lo descomprima.
Paso 5: juega
- Pantalla de ajustes. Antes de que empiece el juego, una pantalla con desplazamiento agrupada en Juego, Controles y Rendimiento ofrece lo que admite el juego: frecuencia de imagen, escala de renderizado, modo sobremesa o portátil, escalado, idioma, contador de FPS y vibración, con un botón para volver a los ajustes con los que se probó el juego. Pulsa Play. Qué hace cada uno: ajustes de nxnative explicados (en inglés).
- Controles táctiles. Cambia entre los diseños 2D y 3D en la parte superior. En 3D, desliza en el tercio derecho de la pantalla para mover la cámara. Un mando conectado oculta los controles táctiles.
- Vibración. Usa la respuesta háptica del iPhone o un mando compatible, con sus propios ajustes de activación e intensidad.
- Movimiento. Un mando con giroscopio (DualSense, DualShock 4) controla los movimientos del juego; con un mando sin giroscopio se usa el del propio iPhone. Empaqueta con
--no-motionsi el movimiento falla. - Partidas guardadas y registros están en la app Archivos, bajo el nombre de la app. Si algo falla, el proyecto pide el archivo
log.txt. - En un Mac, la app del juego muestra sus ajustes en una ventana antes de empezar. Su registro está en
~/Library/Logs/nxnative/.
Opción más fácil: NX2Apple
NX2Apple es una app comunitaria para Mac que crea tus juegos para iPhone, iPad o Mac sin línea de comandos, guarda los juegos de Mac en una biblioteca y los abre con sus ajustes. También empaqueta los archivos del juego de forma más compacta para un IPA más ligero. Es un proyecto aparte.
¿Necesitas un mando?
No es obligatorio: cada app trae controles táctiles 2D y 3D. Un mando conectado oculta los controles táctiles y conserva todos los botones. En iPhone 15 Pro y posteriores (USB-C), un mando que se acopla al teléfono, como el GameSir G8 Plus MFi (USB-C, con certificación de Apple según GameSir), es lo más cómodo. Sin giroscopio propio, el juego usa el giroscopio del iPhone. Para Mac o para controles de movimiento con el mando en la mano, sirven DualSense o DualShock 4. Más detalles en la guía de mandos (en inglés).
Preguntas sobre el uso
¿Cuánto tarda la compilación?
La primera compilación tarda de 30 a 60 minutos. Las siguientes reutilizan cada paso cuyas entradas no han cambiado: tras una actualización que solo cambia el host, alrededor de un minuto. Para eso, guarda el pequeño archivo .idx junto al IPA.
¿Puedo cambiar el idioma del juego?
Sí. Elige uno al empaquetar con --language (por ejemplo -l es o -l Spanish); tiene que ser un idioma que el juego incluya. También puedes cambiarlo en la pantalla de ajustes sin volver a compilar.
¿Dónde están mis partidas guardadas?
En la app Archivos, bajo el nombre de la app, en save/. Algunas herramientas de sideload dan una carpeta de datos nueva a una app reinstalada; copia save/ y pso_user.tsv para conservar tu progreso.
¿Por qué da tirones la primera vez?
La app compila los gráficos la primera vez que aparece una escena nueva y los recuerda para el siguiente arranque. Los tirones breves en las primeras visitas son normales.
¿Puedo jugar en un Mac?
Sí. Empaqueta con --platform mac-app para obtener una app de Mac que abres desde el Finder (Apple silicon).
Los detalles para desarrolladores están en la guía de desarrollo oficial (en inglés). Consulta también la lista de juegos (en inglés).