Edit Infobox 3DS Homebrews: Snes9x 3DS (Updated Fork)

Free text:

{{#seo: |title= (Console) - GameBrew |title_mode=append |image=snes9xfork3ds.png |image_alt=Snes9x Fork }} This is a fork of [[SNES9x 3DS]] which includes several new features, like custom border and second screen image for each game. You can also swap your game screen, use the new hotkey options such as Switch to player 2 or Quick Save/Load. The credits for the custom border and bottom image go to [https://github.com/ramzinouri/snes9x_3ds ramzinouri's fork] and [https://github.com/Asdolo/snes9x_3ds_forwarder Asdolo's snes9x forwarder]. == Features == ===Main features=== * Game thumbnails (boxart, title, gameplay) * Border (bezel) and second screen image (cover) for each game * Themes * Improved cheat menu * RetroArch-ish folder structure to keep game collections clean * Swap screen and more hotkey options * Ready to use and cleaned up no-intro sets for cheats, thumbnails, borders and covers ===Snes Core Features=== * Graphic modes 0 * 7. * Frame skipping. * Stretch to full screen / 4:3 ratio * PAL (50fps) / NTSC (60 fps) frame rates. * SDD1 chip (Street Fighter 2 Alpha, Star Ocean) * SFX1/2 chip (Yoshi's Island, but slow on old 3DS) * CX4 chip (Megaman X-2, Megaman X-3) * DSP chips (Super Mario Kart) * SA-1 chip (Super Mario RPG, Kirby Superstar) * Sound emulation (at 32KHz, with echo and gaussian interpolation) ==Installation== '''Homebrew Launcher:''' * Copy snes9x_3ds.3dsx, snes9x_3ds.smdh to sd:/3ds/snes9x_3ds/. * Copy start-screen.png, cover.png and border.png to sd:/snes9x_3ds_data/. * Place your SNES ROMs inside any folder. * Go to your Homebrew Launcher (either via Cubic Ninja, Soundhax or other entry points) and launch the snes9x_3ds emulator. '''CIA Version:''' * Use your favorite CIA installer to install snes9x_3ds.cia into your CFW. You can also use [[FBI 3DS|FBI]] to download from TitleDB. * Place your SNES ROMs inside any folder. * Exit your CIA installer and go to your CFW's home screen to launch the app. ==User guide== === Custom border/bottom screen === Go to sd:/snes9x_3ds_data/&lt;YOUR_GAME_FOLDER&gt;/. If folder is missing, just run the actual game. Folder will be created automatically. Place border.png (exactly 400px x 240px) and cover.png (max 400px x 400px) inside this folder. PNG alpha transparency isn't supported. Although you can adjust cover and border image via opacity settings in options tab. === .CHX Cheat file format === The .CHX is a cheat file format that you can create with any text editor. Each line in the file corresponds to one cheat, and is of the following format: <pre> [Y/N],[CheatCode],[Name]</pre> * [Y/N] represents whether the cheat is enabled. Whenever you enable/disable it in the emulator, the .CHX cheat file will be modified to save your changes. * [CheatCode] must be a Game Genie or a Pro Action Replay code. ** A Game Genie code looks like this: F38B-6DA4. ** A Pro-Action Replay code looks like this: 7E00DC04. * [Name] is a short name that represents this cheat. Since this will appear in the emulator, keep it short (&lt; 30 characters). The .CHX must have the same name as your ROM. This is an example of a .CHX file: Filename: Gradius III (U) [I].CHX Y,F38B-6DA4,Start with 31 lives Y,7E00DC04,Constant Megacrush (enemies die) If you are still lost, refer to a sample Gradius cheat file [https://raw.githubusercontent.com/bubble2k16/snes9x_3ds/master/samples/Gradius%20III%20(U)%20%5B!%7D.chx.txt here]. '''Note:''' You can only have either .CHT or .CHX in your ROM folder for the same ROM. If you have both, only the .CHX file will be effective. === FAQ === '''Q. My Game looks weird/runs slow/has sound issues. What can I do? ''' There are some emulator options, which may improve gaming experience: * Go to Emulator Options tab and change the In-Frame Palette Changes to either one of the 3 options: ** Enabled, Disabled Style 1, Disabled Style 2. ** Color emulation is never perfect because we are using the 3DS GPU for rendering, which doesn't allow us to do what the SNES requires. * Go to Emulator Options Tab and change the SRAM Auto-Save Delay to 10 seconds, 60 seconds, or disable it entirely. Don't worry, the SRAM will be saved again when you open the emulator menu. * Sound issues may be gone after game reset or reload. * Ensure that your ROM file isn't corrupt. Try another revision or region. * Some games are just not running well on this emulator. (see [http://wiki.gbatemp.net/wiki/Snes9x_for_3DS Compatibility List]) '''Q. Why can't I load some games? They are lised as supported on the compatibility list! ''' Ensure that your ROM file is not a zipped file. Currently, the emulator only supports .SFC, .SMC, .FIG formats. '''Q. Can I use my save states generated from Windows versions of Snes9x? ''' You can try using save states from Snes9x v1.43, but sometimes this emulator doesn't recognize them. '''Q. How can I make Snes9x utilize the full speed of the New 3DS? ''' The .3DSX version currently uses the full clock speed of the New 3DS, enabling all your SuperFX, SA-1 games to run faster. '''Q. After closing the lid and re-opening it, the sound synchronization during game emulation is off! ''' Yes, this is a known issue. You can try to tap the bottom to bring up the menu, and then resume your game. The sound should become synchronized again. ''' After pressing the Home button, the emulator music still plays! ''' Try to avoid pressing the Home button or putting the 3DS to sleep. Quit the emulator entirely from the emulator's menu before going to the Home screen. ==Controls== Touchscreen - Menu Up/Down - Choose option A - Confirm X+D-Pad Up/Down - Page Up/Page Down) Left/Right - Change between ROM selection and emulator options You can quit the emulator to your homebrew launcher/your CFW's home screen. ==Screenshots== https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds-01.png https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds-02.png https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds-03.png https://dlhb.gamebrew.org/3dshomebrews/snes9xfork3ds-04.png ==Known issues== * Minor sound emulation errors. * Poor performance in some SFX1/2 games like Doom. * Mosaics. * In-frame palette changes - This is because this emulator uses the 3DS GPU for all graphic rendering. Without in-frame palette changes implemented, a small number of games experience colour issues. == Changelog == '''v1.51.1''' *Bug Fixes: ** Old 3DS, Old 2DS: fix crash on O3DS/O2DS when user opens menu after game has loaded ([https://github.com/matbo87/snes9x_3ds/issues/11 #11]) ([https://github.com/matbo87/snes9x_3ds/commit/71ed471f3f9bfea74f42105ddbbbf3b9e9a94c07 71ed471]) '''v1.51''' *Features: ** Theme option: add Dark mode and RetroArch theme ([https://github.com/matbo87/snes9x_3ds/issues/2 #4]) ([https://github.com/matbo87/snes9x_3ds/commit/d343ca60fb0e380fa9b4239c7ebf346e0ff86e6c d343ca6]). ** File menu: adjust navigation pattern + provide more options in file menu tab ([https://github.com/matbo87/snes9x_3ds/issues/2 #4] [https://github.com/matbo87/snes9x_3ds/commit/d343ca60fb0e380fa9b4239c7ebf346e0ff86e6c d343ca6], [https://github.com/matbo87/snes9x_3ds/commit/ea2cd3fa970f81a4384ebf0c7b014b429d4d7d34 ea2cd3f]) *** Going up a directory by pressing B. *** Option to set a default starting folder. *** Delete game option. *** Random game option. ** Pause screen: show a decent pause screen when menu is open during gameplay ([https://github.com/matbo87/snes9x_3ds/commit/4c9f3ecb333eaf23da85e9199bdbbfa3511312dd 4c9f3ec]) *Bug Fixes: ** O2DS: fix crash on O2DS (and probably O3DS as well) when saving SRAM ([https://github.com/matbo87/snes9x_3ds/issues/2 #2] ([https://github.com/matbo87/snes9x_3ds/commit/02788b17d038e30e612dcbf0719ec45a8fc54a43 02788b1]) *Code Refactoring: ** Menu: reduce redundant code + preserve selected item index per tab ([https://github.com/matbo87/snes9x_3ds/commit/493c1a22b3975c7cb39a55dbd38140e5e3cd2a14 493c1a2], [https://github.com/matbo87/snes9x_3ds/commit/4d6378a507cb77571e4444abb6fbd0df3ff5f555 4d6378a]) ** Dialogs: remove unnecessary animations for a snappier appearance ([https://github.com/matbo87/snes9x_3ds/commit/2bb82c69512a2ef894ee5bb049be13ba567b6e89 2bb82c6]) ** Second screen content: clean up + prevent flickering when info dialog appears/disappears ([https://github.com/matbo87/snes9x_3ds/commit/c1899df01828b9653c3c635695e61d1ce4fbeaee c1899df]) '''v1.50''' *Features: ** Game preview option: boxart, title or gameplay. ** Improved cheat menu: now with available/activated indicator. ** Updated Banner: based on SNES VC banner. ** Menu clean up: *** Reset config(s) option. *** Autosave is now game-specific. *** Show saving dialog instead of freezed menu. *Bug Fixes: ** Cheats: Fix cheats not loaded/saved properly. ** Default button mappings: Fix missing default controls. ** Home menu button: make emulator quit properly when user exits via home menu button. ** Pixel perfect mode: Fix blurry image (mentioned [https://github.com/asdolo/snes9x_3ds_forwarder/pull/1 here]). ** Long game lists: Fix app crash on exit. *Code Refactoring: ** Makefile &amp; app.rsf: use TricksterGuy's [https://github.com/TricksterGuy/3ds-template 3ds-template], update compiler options. ** Image loading/rendering: use stb_image instead of lodepng for faster image decoding, unify image rendering logic. ** Second screen content: improve performance. *Breaking changes: ** Folder structure: All game related files are now in &quot;3ds/snes9x_3ds&quot;, similar to RetroArch folder structure. '''v1.45''' * Buffered file writer for faster config saves (thanks to [https://github.com/willjow/snes9x_3ds willjow]). '''v1.42''' * Fixed screen tearing. * Added option to disable 3D Slider (thanks to ramzinouri). '''v1.41''' * Fixed hotkey for making screenshot. * Fixed quick save/load (no data abort exceptions anymore). * Fixed Errors if cover image is missing. * Updated assets (icon, banner, border, cover). '''v1.40''' * Added Swap Game Screen option. * Added switch controller option like in official Virtual Console (SF2 &quot;Training Mode&quot;, Konami cheat, ...). * Custom second screen image and border for every game (thanks to ramzinouri and Asdolo). * Game Info option for second screen. * Provide more Hotkeys (Quick Save/Load, Swap Controllers). * Disable Analog to Digital Type option which allows you to use circle pad for hotkeys as well. * All game related files like cheats or save states are now in a single folder (folder name = rom name). * Screenshots are now in PNG format (thanks to ramzinouri). * Removed BlargSNES DSP Core, updated dsp-1, added dsp-2 -3 and -4 (thanks to ramzinouri). === bubble2k versions === '''v1.30''' * Improved sound synchronization. * Added BlargSNES DSP Core (experimental) for performance. The original Snes9X DSP core (default) suffers from sound skipping in some games like Aladdin and Gradius 3. You can choose which DSP core to use from the Options menu. The BlargSNES DSP Core sounds similar to the Snes9x Core for most games. Sounds like Final Fantasy 3's the howling wind sound different. * Added support for Tengai Makyou Zero English Patch (for hopefully all future versions). '''v1.21''' * Fixed the ZL/ZR button problem when installing the CIA version. '''v1.20''' * Fixed slider problem in New 3DS (where one of the eyes always sees a black screen). * Added button mappings and rapid fire settings like VirtuaNES / TemperPCE 3DS (thanks to AdmiralCurtiss). * Added button configuration to open emulator menu and fast-forward (thanks to AdmiralCurtiss). Use with care, though. In some games, fast-forwarding can freeze/corrupt your game. * Added a frame rate option to v-sync with the 60Hz 3DS refresh rate (thanks AdmiralCurtiss). * Added an option to auto-save state when exiting and loading when starting a new game. (thanks AdmiralCurtiss). * Added an option to force saving of SRAM, required by Yoshi's Island. (thanks AdmiralCurtiss). * Show 3DS battery level in the bottom right of the menu (thanks ramzinouri). * Increased scrolling speed in menu when holding down the D-pad. * Added memory mapper support for Tengai Makyou Zero English Patch (version 1.0 released 22 Oct 2017). * Supports most original BS Zelda (1-4, Map 2 1-4, Ancient Stone Tablets 1-4), except for the Remix version which still boots into black screen (thanks ramzinouri). * And other text changes (thanks FateForWindows). '''v1.11''' * Fixed crashing bug when loading CHX cheat files. '''v1.10''' * Implemented SA-1 sleep speed-hacks on the following games. These games run faster and some are able to run at 60 fps on the Old 3DS when things on-screen aren't too busy. Super Mario RPG; Kirby’s Dreamland; Jikkyou Oshaberi Parodius; Kirby Super Star; Marvelous; Super Robot Taisen; Panic Bomber World; Dragon Ball Hyper Dimension; SD Gundam Next; Power Rangers Zeo; Daisenryaku Expert 2; Masters New Augusta 3; Bass Fishing; J96 Dream Stadium; Shining Scorpion; Pebble Beach New; PGA European Tour; SD F1 Grand Prix; * Fixed mode 7’s CLIP_10_BIT_SIGNED formula to use the original Snes9x’s formula. This fixes Super Chase HQ’s mode 7 intro. * Imported SPC7110 decompressor chip code from Snes9x 1.52. Now Tengai Makyou Zero (Far East of Eden Zero) can boot after 2 restarts, and in-game graphics appears without problems. * Fixed important bug in cheat engine so that it doesn't not increment the 65816 processor's clock cycles when enabling/disabling cheats. * Fixed the problem of the menu not using the correct font when the emulator first boots up. * Added one more mode when using the 3D slider for a sharper image. * Major refactoring of code. * Fixed SA1 MMC's memory map code by copying it from Snes9x 1.54.2. Now Super Mario World hack VLDC 9 boots. * Fixed Mode 0 rendering bug. The original bug was there since day 1 and with this fix, Lagoon's title screen looks right. '''v1.00''' * Transplanted the full SPC700 + DSP source codes from Snes9x v1.51 into this emulator. As a result, the sound emulation now supports Gaussian Interpolation, and has better accuracy. This fixes some sound problems in Clay Fighter and Mortal Kombat I and II. * Fixed Mode 7 priorities in games that use this: Contra III's stage 1 (at the loss of some color fidelity). Implementing this required the use of some crazy math hacks and hardware tricks to pull this off. * Implemented some experimental speed hacks for Super Mario RPG and Kirby's Dreamland. Runs slightly faster (still not full speed) on Old 3DS. * Implemented hi-res translucency. We get non-flickering emulation of hi-res screens (Secret of Mana, Seiken Densetsu 3, A.S.P. Air Strike Patrol) now as a bonus. As a result, Kirby's Dreamland is now playable. * Invented a new cheat file format .CHX (text file) so that players can add cheats by using any text editor. * Centralized the SNES output screen vertically on the top screen. * Overhauled the user interface to give a more modern look as well as provide additional fonts. * Added more screen stretch options as requested by many users. * Added 3D slider support. Pushing up the 3D slider doesn't create any 3D effect, but may create a better viewing experience. * Removed unnecessary debug messages during start up / shut down of the emulator. * Fixed a bug when the SRAM still saves randomly when it is set to Disabled. * Reduced memory footprint for storing texture position caches. * Made this version buildable with libctru v1.2.0 (thanks to Maki-chan) [Note: Building with devkitARM r46 and libctru v1.2.0 will cause a bug where the emulator cannot utilize the full clock speed of the New 3DS.] '''v0.80''' * Fixed NMI interrupt for specific games such as Cu-On-Pa. This allows Cu-On-Pa to get past the selection screen. * Fixed ROM size calculation for Wonder Project J (English Patch). The game no longer hangs at the menu. * Implemented optimized rendering for offset-per-tile modes. This gives many games a major performance boost. Games such as Strike Gunner STG, Tetris Attack, Kirby's Avalanche, Contra's Stage 1 Boss, Super Mario All-Stars' Super Mario 2 all benefit from this improvement. * Implemented optimized rendering for sprites for modest performance boost. * Used SPC700 core from Snes9x v1.51. * Re-implemented an moderately optimized SA-1 core. Now games like Kirby Super Star, Super Mario RPG can boot. It will NOT run well on the old 3DS currently, but it will run smooth on a new 3DS with full clock speed. '''v0.71''' * Fixed nasty bug that breaks loading of the second ROM, if the first ROM was loaded from a directory path that has spaces in it. * Added feature to allow users to page up/down the options in the menu while holding down X. * Minor optimizations. '''v0.70''' * Fixed sprites priority issues. This fixes sprites problems of Shadowrun, Chrono Trigger, Super Mario All Stars' (and possibly other games too). * The newly implemented rendering engine also provides some modest speed improvements in some games. * Added feature to save the directory of the previously loaded ROM. '''v0.63''' * Fixed bug in DMA when the source address comes from Save RAM. This fixes a number of Super Mario World Hacks so that text is readable on BG layer 3. * Fixed menu key lock issue to improve usability when exiting from menu back into the game. * Fixed DKC tile corruption issue. This probably also fixes most (if not all) tile corruption issues in other games, if you play a game for too long in a single sitting. * Fixed sound problems when auto-saving SRAM. Somehow the hardware or the library doesn't like us stopping and starting the CSND too often. Not too sure what the problem is. * Added an auto-save SRAM option to tell the emulator when to save SRAM (1 second, 10 seconds, 60 seconds, or disable auto-save). Note that regardless of the setting, the emulator will always save any modified SRAM every time you touch the bottom screen to activate the menu. '''v0.62''' * Improved Mode 7 zoomed-in textures. Games like Seiken Densetsu, ActRaiser 1/2 look better when viewing the Mode 7 textures near to the ground. Thanks for Discostew for the motivation. * Improved sound handling to ensure that the left speaker plays at the same volume as the right speaker. * Added option to change in-frame palette handling. There are three options to choose from: ** Enabled. (Slow, accurate, but never as accurate as software) ** Disabled Style 1 (faster, less accurate) ** Disabled Style 2 (faster, less accurate) works a little differently from Style 1 Most games are by default Disabled Style 2. ** Bahamut Lagoon and Front Mission Gun Hazard are by default Disabled Style 1. Wild Guns, Judge Dredd, Batman Forever are by default Enabled. * Fixed Clock Tower to boot properly again. * Fixed Star Fox flickering problem when there are frameskips. * Fixed outside-of-track texture problem with Super Mario Kart’s Bowser Castle stages. * Fixed Final Fantasy V Intro logo cutout problem. * Fixed Donkey Kong Country's tile colour corruption bug. '''v0.61''' * Fixed DSP bug that causes some games like Dragon Ball - Super Budoten 3, Umihara Kawase to mute. * Fixed bug that doesn't stop sound from playing when saving to SRAM. '''v0.6''' * Default sound amplification to 2x … * Reduced GPU freezing problem after loading new ROMs / resetting too many times. * Resynchronise sound when you go into the menu (you can reset the sync this way after waking your 3DS from sleep mode). * Improved sound sample rate to 32 KHz, and added echo and interpolation. The result is overall better sound quality. * Improved sync between SPC700 emulation and the DSP. * Fixed Contra III Mode 7 EXTBG colors again. * Enabled the SPC700 Envelope Height reading. * Fixed Chrono Trigger music not resuming after any battle music or “sealed by mysterious force” music. '''v0.51''' * Implemented pseudo hi-res mode 5 using alternate frame flickering to achieve the pseudo hi-res mode. Games that use this mode include: Secret of Mana, Seiken Densetsu 3, Air Strike Patrol, and a number of others. '''v0.5''' * Implemented major graphic rendering optimizations for color handling, transparency and window effects. Although codes from BlargSNES was not used directly, ideas came from BlargSNES. Some games that use windowing effects should see some / significant performance increase. F-Zero (US / EUR versions) run full speed. Super Mario Kart (EUR) runs full speed. Axelay (US) runs at a playable speed. Breath of Fire 2 battle transition effects are smooth. Super Mario World circular window fade-in/out effects are smooth. etc. * Fixed sprite flickering problems in Yoshi's Island and DKC2. * Fixed 256-color background problems. DKC1/2 and Earthworm Jim 2 intro shows up correctly. * Fixed Mode 7 BG2 problems. Now Super Star Wars - Empire Strikes Back (snowspeeder stage) works correctly. '''v0.42''' * Minor optimisation to GPU drawing. * Increased maximum number of cheats to 200. * Fix the crashing problem if there are too many cheats in the .CHT file. * Fixed the too many sprites on screen problem (fixes Shadowrun freezing). '''v0.41''' * Fixed some transparency issues with Saturday Night Slam Master and Ghost Chaser Densei. * Updated SRAM saving timing. * Minor optimisation for SuperFX emulation. * First implementation of speed hacks (experimental for F-Zero, Axelay, Super Mario Kart, Yoshi’s Island) * Modified some debugging stuff. * Fixed some mode 7 glitches when a mode 7 game (like Super Mario Kart has been running for more than a few minutes). * Implemented palette flickering hack for Front Mission Gun Hazard, Bahamut Lagoon. * Implemented hack for Power Rangers Fighting Edition to prevent graphical glitches * Implemented hack for delayed SRAM (per 1 minute) saving for Star Ocean * Fixed the problem of loading up too many different ROMs once after another, causing the loading to finally fail. * When loading a game without settings, reset the frame rate setting to be based on the game's region. '''v0.4''' * Experimental cheat feature. Requires you to have the .CHT file (May corrupt your save game, use at your own risk). * Added settings to enable turbo buttons (per game). * Added settings to allow user to amplify volume (per game) (beware of sound clipping that results in terrible sounds). * Palette hack for Secret of Mana to ensure that the dialog borders are blue (the bottom status window still behaves oddly due to palette changes). * Transparency fixes: o Legend of Zelda's prologue's dark room o Reported dark tints on several games like Doremi Fantasy, Bomberman, Secret of Mana, Chrono Trigger o Gradient shading on dialog boxes for Chrono Trigger and Final Fantasy III (battles) appear correct. * Fixed window clip problems. * Fixed mode 7 glitches causing mode 7 bugs in Secret of Mana, NHL 94, Magical Quest 3. * Fixed a number of sprite clipping problems o Megaman 7's Dr Wily's spaceship in the intro now pans in from the left correctly o Tales of Phantasia's trainee's sprites (after the intro) now clips correct. * Fixed color inconsistency causing some white sprites to be visible on a white background (eg. in NHL's EA Sports intro screen). * Added speed hack for games that use the WAI instruction (esp Donkey Kong Country 1, 2, 3 should see a good speed increase). * Added hack to avoid hiding sprites even if they exceed the maximum number the real hardware can display. Apparently, this fixes the missing cursor in Final Fantasy III. * And other bugs. '''v0.35''' * Fixed Super Mario Kart grass area texture outside of the track. This fix should work for all cases. * Some minor performance and UI adjustments. '''v0.34''' * Mode 7 minor performance improvements and update to draw Super Mario Kart's grass outside of the racing track. (some it works only under some conditions). * Taking of screenshot now only captures the upper screen. * Option of forcing frame rate to 50 FPS / 60 FPS / or based on the selected ROM's region. * Additional screen scaling option to 320x240. * Fixed the crashing problem when selecting options without any ROM running. * Fixed DKC1 piracy problem. The wrong mask logic was used when writing to SRAM. * Improved the logic to save SRAM to SD card about 1-2 seconds after your game was saved in the emulator. == Credits == * Snes9x team for the fantastic SNES emulator. * StapleButter / DiscostewSM for their work on BlargSNES. Many ideas for optimisations came from them. * Author of SF2D library. Some codes for hardware acceleration evolved from here. * Authors of the Citra 3DS Emulator team. Without them, this project would have been extremely difficult. * Maki-chan for helping with the libctru 1.2.0 conversion. * Fellow forummers on GBATemp for the bug reports and suggestions for improvements. == External links == * GitHub - https://github.com/Xeddius-Network/snes9x_3ds * Github - https://github.com/matbo87/snes9x_3ds * Universal-Team - https://db.universal-team.net/3ds/snes9x-updated-fork