es/Dynamic Xtreme Quick Start

English

Português

Español

日本語

Esta guía explica cómo realizar una instalación básica de Dynamic Xtreme en Windows o Linux.

Si es la primera vez que utilizas la herramienta, sigue los pasos en el orden indicado. No es necesario conocer el funcionamiento interno del sistema para completar la instalación.

Requisitos

Dynamic Xtreme requiere el runtime de .NET 8. Descarga e instala la versión correspondiente a tu sistema operativo desde el sitio oficial de Microsoft:

.NET 8 Runtime

La herramienta es compatible con Windows y Linux. Solo necesitas el runtime de .NET; no es necesario instalar el SDK completo.

Puedes descargar Dynamic Xtreme desde SNEStorage: SNEStorage - Dynamic Xtreme

Preparar los recursos

Antes de ejecutar Dynamic Xtreme, añade a tu proyecto todos los recursos que deseas instalar.

Recursos para PIXI y UberASMTool

Los recursos actuales normalmente incluyen su archivo *.asm o *.json junto con los archivos que necesitan. Copia el paquete completo sin cambiar su estructura de carpetas.

En PIXI, utiliza la carpeta correspondiente al tipo de sprite:

• sprites para sprites normales.
• cluster para cluster sprites.
• extended para extended sprites.
• Para otros tipos, utiliza la carpeta indicada por el recurso.

En UberASMTool, utiliza la carpeta correspondiente al tipo de código:

• level para códigos de nivel.
• overworld para códigos del overworld.
• gamemode para códigos de game mode.
• Para otros tipos, utiliza la carpeta indicada por el recurso.

Después de copiar el recurso, añádelo al archivo de lista de PIXI o UberASMTool como lo harías normalmente.

Los recursos preparados para Dynamic Xtreme ya contienen las declaraciones necesarias en su archivo ASM principal. Mantén juntos el ASM, el JSON y las carpetas incluidas con el recurso para no romper sus rutas relativas.

Carpetas tradicionales

Algunos recursos utilizan las carpetas tradicionales de Dynamic Xtreme. En ese caso, sigue esta organización:

Estas carpetas se encuentran junto al ejecutable de Dynamic Xtreme: dxt.exe en Windows o dxt en Linux.

Tipo de archivo	Carpeta
*.dynamicinfo	DynamicInfos
*.drawinfo	DrawInfos
*.paleffect	PaletteEffects
Gráficos, paletas y otros archivos relacionados	DynamicResources

Utiliza siempre el método indicado por el recurso. No muevas a las carpetas tradicionales los archivos de un sprite o código UberASM moderno, salvo que sus instrucciones lo soliciten.

Instalación completa

Ejecutar la herramienta

Dynamic Xtreme debe ejecutarse desde su propia carpeta.

• En Windows, haz doble clic en dxt.exe.
• En Linux, abre una terminal en la carpeta de Dynamic Xtreme y ejecuta:

./dxt

La herramienta mostrará una serie de preguntas para configurar la instalación.

Configurar las rutas

Las rutas y las funcionalidades seleccionadas quedan guardadas en Settings/Settings.json, dentro de la carpeta de Dynamic Xtreme. La herramienta utiliza ese archivo para recuperar la configuración en las siguientes instalaciones.

Puedes escribir cada ruta o arrastrar el archivo correspondiente a la terminal. Después, presiona Enter para continuar.

Si dejas una respuesta vacía y presionas Enter, Dynamic Xtreme utilizará el valor guardado en Settings/Settings.json. Si todavía no existe un valor guardado y la ruta es opcional, esa integración se omitirá.

Las rutas se solicitan en el siguiente orden:

1. ROM de entrada

   Selecciona la ROM de Super Mario World que deseas modificar.

1. ROM de salida

   Indica la ruta de la ROM que tendrá el resultado de la instalación.

1. Ejecutable de PIXI

   Selecciona el ejecutable de PIXI. Esta ruta permite integrar las

   rutinas y definiciones de Dynamic Xtreme con PIXI.

1. Ejecutable de UberASMTool

   Selecciona el ejecutable de UberASMTool si tu proyecto utiliza

   códigos de UberASM.

1. Ejecutable de GPS

   Selecciona el ejecutable de GPS si tu proyecto utiliza bloques

   personalizados.

1. Lista de PIXI

   Selecciona el archivo de lista donde registraste los sprites que

   utilizará tu proyecto.

1. Lista de UberASMTool

   Selecciona el archivo de lista donde registraste los códigos

   UberASM que utilizará tu proyecto.

Las rutas de PIXI, UberASMTool, GPS y sus listas son opcionales. Si no utilizas alguna de estas herramientas y no existe una ruta guardada, puedes dejar la respuesta vacía.

Para dejar de utilizar una integración que ya tiene rutas guardadas, edita Settings/Settings.json y deja sus valores como cadenas vacías (""):

• PIXI: PixiPath y PixiListPath.
• UberASMTool: UberasmToolPath y UberasmListPath.
• GPS: GPSPath.

No elimines los campos ni reemplaces todo el archivo. En las siguientes preguntas podrás dejar esas rutas vacías sin recuperar la integración anterior.

Seleccionar las funciones

Después de configurar las rutas, Dynamic Xtreme preguntará qué funciones deseas instalar.

Puedes responder Y para habilitar una función o N para deshabilitarla.

Si presionas Enter sin escribir nada, se conservará el valor guardado en Settings/Settings.json. Durante la primera instalación se utilizará el valor predeterminado de la función.

En una instalación habitual se pueden habilitar las funciones que no muestran advertencias. Si aparece una advertencia en rojo, léela con atención y comprueba su compatibilidad con tu proyecto antes de habilitar esa función.

Consulta Funcionalidades para saber qué hace cada opción y Compatibilidad para revisar los posibles conflictos con otros recursos y los espacios de RAM utilizados.

Ejemplo de instalación típica con PIXI y UberASMTool

Este ejemplo utiliza PIXI y UberASMTool con las opciones predeterminadas. Las rutas son ficticias y corresponden a Windows; sustitúyelas por las de tu proyecto. En Linux, indica las rutas de sus ejecutables correspondientes.

Pregunta	Ejemplo de respuesta
ROM de entrada	C:\MiHack\MiHack.smc
ROM de salida	C:\MiHack\MiHack_DX.smc
Ejecutable de PIXI	C:\MiHack\PIXI\pixi.exe
Ejecutable de UberASMTool	C:\MiHack\UberASMTool\UberASMTool.exe
Ejecutable de GPS	Dejar vacío si no se utiliza y no hay una ruta guardada.
Lista de PIXI	C:\MiHack\PIXI\list.txt
Lista de UberASMTool	C:\MiHack\UberASMTool\list.txt

Para las funcionalidades, utiliza estos valores:

Funcionalidad	Activada	Respuesta
GraphicsChange	Sí	Y
PalettesChange	Sí	Y
DynamicPoses	Sí	Y
DrawingSystem	Sí	Y
PalettesEffects	Sí	Y
Free7E2000	Sí	Y
ControllerOptimization	Sí	Y
FixedColorOptimization	Sí	Y
KevinLMVRAMOptimization	No	N
StatusBarOptimization	No	N
PlayerFeatures	No	N
YoshiFeatures	No	N

En ROMs con SA-1, Free7E2000 se desactiva automáticamente.

Enter conserva el valor guardado si ya utilizaste la herramienta. Para reproducir esta configuración, responde Y o N según la tabla; los valores predeterminados solo se utilizan cuando no hay una selección anterior.

Instalación mediante línea de comandos

Después de completar una instalación interactiva, Dynamic Xtreme guarda las rutas y funciones seleccionadas en Settings/Settings.json.

Puedes reutilizar esa configuración para realizar instalaciones posteriores sin responder nuevamente todas las preguntas.

En Windows, abre una terminal en la carpeta de Dynamic Xtreme y ejecuta:

.\dxt.exe -use-settings

En Linux, ejecuta:

./dxt -use-settings

Si alguna ruta guardada ya no es válida, Dynamic Xtreme volverá al modo interactivo para solicitar la configuración.

Las opciones disponibles son:

Opción	Alias	Descripción
-use-settings	-us	Utiliza las rutas y funciones guardadas sin mostrar nuevamente las preguntas.
-verbose	-v	Muestra información más detallada durante la instalación.
-help		Muestra la ayuda y la lista de opciones disponibles.
-version		Muestra la versión instalada de Dynamic Xtreme.

Las opciones pueden combinarse. Por ejemplo, para utilizar la configuración guardada y mostrar información detallada:

Windows:

.\dxt.exe -use-settings -verbose

Linux:

./dxt -use-settings -verbose

Para cambiar las rutas o las funciones seleccionadas, ejecuta Dynamic Xtreme sin -use-settings y completa nuevamente las preguntas.

Finalizar la instalación

Tanto la instalación interactiva como la instalación mediante línea de comandos producen el mismo resultado.

El resultado de la instalación queda guardado en log.txt, junto al ejecutable de Dynamic Xtreme. Este archivo contiene todos los detalles de la instalación.

Dynamic Xtreme prepara la integración con PIXI, UberASMTool y GPS, pero no ejecuta estas herramientas. Después de instalar Dynamic Xtreme, vuelve a ejecutar las herramientas externas que utilice tu proyecto sobre la ROM de salida.

Cuándo reinstalar:

• Si cambias gráficos, paletas o archivos *.dynamicinfo, *.drawinfo o *.paleffect, reinstala Dynamic Xtreme y después las herramientas que utilicen esos recursos.
• Si añades, eliminas o modificas los includes de recursos ;#incdyn, ;#incdri o ;#incpale dentro del ASM, también debes reinstalar Dynamic Xtreme y después las herramientas que utilicen esos recursos.
• Si solo modificas el código *.asm, sin cambiar esos includes, no necesitas reinstalar Dynamic Xtreme. Basta con volver a insertar el código con la herramienta correspondiente.

Cuando sea necesario reinstalar Dynamic Xtreme, el orden correcto es:

1. Ejecutar Dynamic Xtreme para regenerar e instalar sus recursos.
2. Volver a ejecutar PIXI, UberASMTool, GPS y cualquier otra

   herramienta que utilice datos generados por Dynamic Xtreme.

Este orden es necesario porque las direcciones y los identificadores de los recursos pueden cambiar cada vez que se ejecuta Dynamic Xtreme.