From fae3068c257fc5628b557c2a0560a189335259de Mon Sep 17 00:00:00 2001 From: strotlog <49286967+strotlog@users.noreply.github.com> Date: Thu, 31 Mar 2022 15:09:13 -0700 Subject: [PATCH] Documentation: Add RetroArch emu to SNES games (#365) * Documentation: Add RetroArch emu to SNES games * Documentation: fix screenshot alt text --- .../A Link to the Past/multiworld_en.md | 18 +++++++++++++++- .../A Link to the Past/multiworld_es.md | 20 ++++++++++++++++-- .../assets/tutorial/SMZ3/multiworld_en.md | 17 +++++++++++++++ .../Secret of Evermore/multiworld_en.md | 16 ++++++++++++++ .../tutorial/Super Metroid/multiworld_en.md | 16 ++++++++++++++ .../retroarch-network-commands-en.png | Bin 0 -> 31292 bytes 6 files changed, 84 insertions(+), 3 deletions(-) create mode 100755 WebHostLib/static/assets/tutorial/retroarch-network-commands-en.png diff --git a/WebHostLib/static/assets/tutorial/A Link to the Past/multiworld_en.md b/WebHostLib/static/assets/tutorial/A Link to the Past/multiworld_en.md index 22896cdafa..d9b2625e0a 100644 --- a/WebHostLib/static/assets/tutorial/A Link to the Past/multiworld_en.md +++ b/WebHostLib/static/assets/tutorial/A Link to the Past/multiworld_en.md @@ -10,7 +10,8 @@ - Hardware or software capable of loading and playing SNES ROM files - An emulator capable of connecting to SNI ([snes9x rr](https://github.com/gocha/snes9x-rr/releases), - [BizHawk](http://tasvideos.org/BizHawk.html)) + [BizHawk](http://tasvideos.org/BizHawk.html), or + [RetroArch](https://retroarch.com?page=platforms) 1.10.1 or newer). Or, - An SD2SNES, [FXPak Pro](https://krikzz.com/store/home/54-fxpak-pro.html), or other compatible hardware - Your Japanese v1.0 ROM file, probably named `Zelda no Densetsu - Kamigami no Triforce (Japan).sfc` @@ -102,6 +103,21 @@ first time launching, you may be prompted to allow it to communicate through the - SNIClient users should look in their Archipelago folder for `/SNI/lua/x64` or `/SNI/lua/x86` depending on if the emulator is 64-bit or 32-bit. +##### RetroArch 1.10.1 or newer + +You only have to do these steps once. + +1. Enter the RetroArch main menu screen. +2. Go to Settings --> User Interface. Set "Show Advanced Settings" to ON. +3. Go to Settings --> Network. Set "Network Commands" to ON. (It is found below Request Device 16.) Leave the default + Network Command Port at 55355. +![Screenshot of Network Commands setting](/static/assets/tutorial/retroarch-network-commands-en.png) +4. Go to Main Menu --> Online Updater --> Core Downloader. Scroll down and select "Nintendo - SNES / SFC (bsnes-mercury + Performance)". + +When loading a ROM, be sure to select a **bsnes-mercury** core. These are the only cores that allow external tools to +read ROM data. + #### With hardware This guide assumes you have downloaded the correct firmware for your device. If you have not done so already, please do diff --git a/WebHostLib/static/assets/tutorial/A Link to the Past/multiworld_es.md b/WebHostLib/static/assets/tutorial/A Link to the Past/multiworld_es.md index e01306a63e..c016236872 100644 --- a/WebHostLib/static/assets/tutorial/A Link to the Past/multiworld_es.md +++ b/WebHostLib/static/assets/tutorial/A Link to the Past/multiworld_es.md @@ -13,7 +13,8 @@ - Hardware o software capaz de cargar y ejecutar archivos de ROM de SNES - Un emulador capaz de ejecutar scripts Lua ([snes9x Multitroid](https://drive.google.com/drive/folders/1_ej-pwWtCAHYXIrvs5Hro16A1s9Hi3Jz), - [BizHawk](http://tasvideos.org/BizHawk.html)) + [BizHawk](http://tasvideos.org/BizHawk.html), o + [RetroArch](https://retroarch.com?page=platforms) 1.10.1 o más nuevo). O, - Un flashcart SD2SNES, [FXPak Pro](https://krikzz.com/store/home/54-fxpak-pro.html), o otro hardware compatible - Tu archivo ROM japones v1.0, probablemente se llame `Zelda no Densetsu - Kamigami no Triforce (Japan).sfc` @@ -135,6 +136,21 @@ ejecutas, puedes ser que el firewall de Windows te pregunte si le permites la co 7. Observa que se ha asignado un nombre al dispositivo, y el cliente muestra "SNES Device: Connected", con el mismo nombre en la esquina superior izquierda. +##### RetroArch 1.10.1 o más nuevo + +Sólo hay que segiur estos pasos una vez. + +1. Comienza en la pantalla del menú principal de RetroArch. +2. Ve a Ajustes --> Interfaz de usario. Configura "Mostrar ajustes avanzados" en ON. +3. Ve a Ajustes --> Red. Configura "Comandos de red" en ON. (Se encuentra bajo Request Device 16.) Deja en 55355 (el + default) el Puerto de comandos de red. +![Captura de pantalla del ajuste Comandos de red](/static/assets/tutorial/retroarch-network-commands-en.png) +4. Ve a Menú principal --> Actualizador en línea --> Descargador de núcleos. Desplázate y selecciona "Nintendo - SNES / + SFC (bsnes-mercury Performance)". + +Cuando cargas un ROM, asegúrate de seleccionar un núcleo **bsnes-mercury**. Estos son los sólos núcleos que permiten +que herramientas externas lean datos del ROM. + #### Con Hardware Esta guía asume que ya has descargado el firmware correcto para tu dispositivo. Si no lo has hecho ya, hazlo ahora. Los @@ -203,4 +219,4 @@ El programa recomentdado actualmente es: 4. Si quieres que las llaves y los objetos de mazmorra tambien sean marcados, activa la caja con nombre **Race Illegal Tracking** 5. Haz click en el boton **Start Autotracking** -6. Cierra la ventana AutoTracker, ya que deja de ser necesaria \ No newline at end of file +6. Cierra la ventana AutoTracker, ya que deja de ser necesaria diff --git a/WebHostLib/static/assets/tutorial/SMZ3/multiworld_en.md b/WebHostLib/static/assets/tutorial/SMZ3/multiworld_en.md index 5424ceb95c..3ac439629a 100644 --- a/WebHostLib/static/assets/tutorial/SMZ3/multiworld_en.md +++ b/WebHostLib/static/assets/tutorial/SMZ3/multiworld_en.md @@ -11,6 +11,8 @@ - snes9x Multitroid from: [snes9x Multitroid Download](https://drive.google.com/drive/folders/1_ej-pwWtCAHYXIrvs5Hro16A1s9Hi3Jz), - BizHawk from: [BizHawk Website](http://tasvideos.org/BizHawk.html) + - RetroArch 1.10.3 or newer from: [RetroArch BuildBot Website](https://buildbot.libretro.com/) - nightly builds + are required until 1.10.3 is released. Or, - An SD2SNES, FXPak Pro ([FXPak Pro Store Page](https://krikzz.com/store/home/54-fxpak-pro.html)), or other compatible hardware - Your legally obtained Super Metroid ROM file, probably named `Super Metroid (Japan, USA).sfc` and @@ -103,6 +105,21 @@ first time launching, you may be prompted to allow it to communicate through the - SNIClient users should look in their Archipelago folder for `/SNI/lua/x64` or `/SNI/lua/x86` depending on if the emulator is 64-bit or 32-bit. Please note the most recent versions of BizHawk are 64-bit only. +##### RetroArch 1.10.3 or newer + +You only have to do these steps once. Note, RetroArch 1.9.x will not work as it is older than 1.10.3. + +1. Enter the RetroArch main menu screen. +2. Go to Settings --> User Interface. Set "Show Advanced Settings" to ON. +3. Go to Settings --> Network. Set "Network Commands" to ON. (It is found below Request Device 16.) Leave the default + Network Command Port at 55355. +![Screenshot of Network Commands setting](/static/assets/tutorial/retroarch-network-commands-en.png) +4. Go to Main Menu --> Online Updater --> Core Downloader. Scroll down and select "Nintendo - SNES / SFC (bsnes-mercury + Performance)". + +When loading a ROM, be sure to select a **bsnes-mercury** core. These are the only cores that allow external tools to +read ROM data. + #### With hardware This guide assumes you have downloaded the correct firmware for your device. If you have not done so already, please do diff --git a/WebHostLib/static/assets/tutorial/Secret of Evermore/multiworld_en.md b/WebHostLib/static/assets/tutorial/Secret of Evermore/multiworld_en.md index 03a395eaee..fa07eb8bbc 100644 --- a/WebHostLib/static/assets/tutorial/Secret of Evermore/multiworld_en.md +++ b/WebHostLib/static/assets/tutorial/Secret of Evermore/multiworld_en.md @@ -9,6 +9,7 @@ - snes9x-rr from: [snes9x-rr Releases Page](https://github.com/gocha/snes9x-rr/releases) - BizHawk from: [BizHawk Website](http://tasvideos.org/BizHawk.html) - bsnes-plus-nwa from: [bsnes-plus GitHub](https://github.com/black-sliver/bsnes-plus) + - RetroArch from: [RetroArch Website](https://retroarch.com?page=platforms). Or, - Or SD2SNES, FXPak Pro ([FXPak Pro Store Page](https://krikzz.com/store/home/54-fxpak-pro.html)), or other compatible hardware. - Your legally obtained Secret of Evermore US ROM file, probably named `Secret of Evermore (USA).sfc` @@ -92,6 +93,21 @@ you may be prompted to allow it to communicate through the Windows Firewall. This should automatically connect to SNI. If this is its first time launching, you may be prompted to allow it to communicate through the Windows Firewall. +##### RetroArch + +You only have to do these steps once. + +1. Enter the RetroArch main menu screen. +2. Go to Settings --> User Interface. Set "Show Advanced Settings" to ON. +3. Go to Settings --> Network. Set "Network Commands" to ON. (It is found below Request Device 16.) Leave the default + Network Command Port at 55355. +![Screenshot of Network Commands setting](/static/assets/tutorial/retroarch-network-commands-en.png) +4. Go to Main Menu --> Online Updater --> Core Downloader. Scroll down and select "Nintendo - SNES / SFC (bsnes-mercury + Performance)". + +When loading a ROM, be sure to select a **bsnes-mercury** core. These are the only cores that allow external tools to +read ROM data. + #### With hardware This guide assumes you have downloaded the correct firmware for your device. If you have not done so already, please do diff --git a/WebHostLib/static/assets/tutorial/Super Metroid/multiworld_en.md b/WebHostLib/static/assets/tutorial/Super Metroid/multiworld_en.md index 4a3e5821ef..a24411deca 100644 --- a/WebHostLib/static/assets/tutorial/Super Metroid/multiworld_en.md +++ b/WebHostLib/static/assets/tutorial/Super Metroid/multiworld_en.md @@ -12,6 +12,7 @@ - snes9x Multitroid from: [snes9x Multitroid Download](https://drive.google.com/drive/folders/1_ej-pwWtCAHYXIrvs5Hro16A1s9Hi3Jz), - BizHawk from: [BizHawk Website](http://tasvideos.org/BizHawk.html) + - RetroArch 1.10.1 or newer from: [RetroArch Website](https://retroarch.com?page=platforms). Or, - An SD2SNES, FXPak Pro ([FXPak Pro Store Page](https://krikzz.com/store/home/54-fxpak-pro.html)), or other compatible hardware - Your legally obtained Super Metroid ROM file, probably named `Super Metroid (Japan, USA).sfc` @@ -107,6 +108,21 @@ first time launching, you may be prompted to allow it to communicate through the - SNIClient users should look in their Archipelago folder for `/SNI/lua/x64` or `/SNI/lua/x86` depending on if the emulator is 64-bit or 32-bit. Please note the most recent versions of BizHawk are 64-bit only. +##### RetroArch 1.10.1 or newer + +You only have to do these steps once. Note, RetroArch 1.9.x will not work as it is older than 1.10.1. + +1. Enter the RetroArch main menu screen. +2. Go to Settings --> User Interface. Set "Show Advanced Settings" to ON. +3. Go to Settings --> Network. Set "Network Commands" to ON. (It is found below Request Device 16.) Leave the default + Network Command Port at 55355. +![Screenshot of Network Commands setting](/static/assets/tutorial/retroarch-network-commands-en.png) +4. Go to Main Menu --> Online Updater --> Core Downloader. Scroll down and select "Nintendo - SNES / SFC (bsnes-mercury + Performance)". + +When loading a ROM, be sure to select a **bsnes-mercury** core. These are the only cores that allow external tools to +read ROM data. + #### With hardware This guide assumes you have downloaded the correct firmware for your device. If you have not done so already, please do diff --git a/WebHostLib/static/assets/tutorial/retroarch-network-commands-en.png b/WebHostLib/static/assets/tutorial/retroarch-network-commands-en.png new file mode 100755 index 0000000000000000000000000000000000000000..fd97dfa097cdf762fddf074a0d716737bd659edf GIT binary patch literal 31292 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 literal 0 HcmV?d00001