Nintendo - NES / Famicom (Nestopia UE)¶
Nestopia is a portable and cycle-accurate NES/Famicom emulator written in C++. Nestopia UE (Undead Edition) is a fork of the original source code, with enhancements from members of the emulation community. This includes support for new platforms, and bug fixes in the emulator core.
The Nestopia UE core has been authored by
- Martin Freij
- R. Belmont
- R. Danbrook
The Nestopia UE core is licensed under
A summary of the licenses behind RetroArch and its cores have found here.
Content that can be loaded by the Nestopia UE core have the following file extensions:
RetroArch database(s) that are associated with the Nestopia UE core:
Required or optional firmware files go in the frontend's system directory.
Nestopia UE requires the NstDatabase.xml for general proper emulation. Make sure it's in RetroArch's system directory.
|NstDatabase.xml||Nestopia UE Database file - Required|
|disksys.rom||Family Computer Disk System BIOS - Required for Famicom Disk System emulation||ca30b50f880eb660a320674ed365ef7a|
Frontend-level settings or features that the Nestopia UE core respects.
The Nestopia UE core's internal core name is 'Nestopia'
The Nestopia UE core saves/loads to/from these directories.
Frontend's Save directory
- 'content-name'.srm (Cartridge battery save)
Frontend's State directory
- 'content-name'.state# (State)
Frontend's System directory
- custom.pal (Custom palette file)
Geometry and timing¶
- The Nestopia UE core's core provided FPS is (FPS)
- The Nestopia UE core's core provided sample rate is 44100 Hz
- The Nestopia UE core's core provided aspect ratio is dependent on the 'Preferred aspect ratio' core option.
It is HIGHLY RECOMMENDED you have NstDatabase.xml in RetroArch's system directory, you can get it from https://github.com/0ldsk00l/nestopia
The Nestopia UE core relies on the NstDatabase.xml database file for
- Games that support a custom mapper
- Games that support multitap accessories
- Games that support the Zapper
- ROM Hacks
- Famicom Disk System games
- General proper emulation of games
Many games will have issues if NstDatabase.xml is not present in RetroArch's system directory.
Custom color palettes¶
To use custom color palettes in the Nestopia UE core, the custom color palette file you want to use must be in RetroArch's system directory.
Make sure the custom palette file is named 'custom.pal'
Also, the 'Palette' core option must be set to custom.
Custom color palettes for the NES can be generated with either of these tools.
The Nestopia UE core has the following option(s) that can be tweaked from the core options menu. The default setting is bolded.
Settings with (Restart) means that core has to be closed for the new setting to be applied on next launch.
Blargg NTSC filter [nestopia_blargg_ntsc_filter] (disabled|composite|svideo|rgb|monochrome)
Enable Blargg NTSC filters.
These 'Blargg NTSC filter' core option screenshots have been taken with the 'Palette' core option set to cxa2025as.
Blargg NTSC filter - Off
Blargg NTSC filter - composite
Blargg NTSC filter - svideo
Blargg NTSC filter - rgb
Blargg NTSC filter - monochrome
Palette [nestopia_palette] (cxa2025as|consumer|canonical|alternative|rgb|pal|composite-direct-fbx|pvm-style-d93-fbx|ntsc-hardware-fbx|nes-classic-fbx-fs|raw|custom)
Choose which color palette is going to be used.
These 'Palette' core option screenshots have been taken with the 'Blargg NTSC filter' core option set to Off.
Palette - cxa2025as
Palette - consumer
Palette - canonical
Palette - alternative
Palette - rgb
Palette - pal
Palette - composite-direct-fbx
Palette - pvm-style-d93-fbx
Palette - ntsc-hardware-fbx
Palette - nes-classic-fbx-fs
Palette - raw
Remove 8-sprites-per-scanline hardware limit [nestopia_nospritelimit] (disabled|enabled)
CPU Speed (Overclock) [nestopia_overclock] (1x|2x)
Overclock the emulated CPU.
4 Player Adapter [nestopia_select_adapter] (auto|ntsc|famicom)
Manually select a 4 Player Adapter if needed. Some games will not recognize the adapter correctly through the NstDatabase.xml database, this option should help fix that.
Automatically insert first FDS disk on reset [nestopia_fds_auto_insert] (enabled|disabled)
Mask Overscan (Vertical) [nestopia_overscan_v] (enabled|disabled)
Mask out (vertically) the potentially random glitchy video output that would have been hidden by the bezel around the edge of a standard-definition television screen.
Mask Overscan (Vertical) - On
Mask Overscan (Vertical) - Off
Mask Overscan (Horizontal) [nestopia_overscan_h] (disabled|enabled)
Mask out (horizontally) the potentially random glitchy video output that would have been hidden by the bezel around the edge of a standard-definition television screen.
Mask Overscan (Horizontal) - Off
Mask Overscan (Horizontal) - On
Preferred aspect ratio [nestopia_aspect] (auto|ntsc|pal|4:3)
Choose the preferred aspect ratio. RetroArch's aspect ratio must be set to Core provided in the Video seetings. 'auto' will use the NstDatabase.xml database file for aspect ratio autodetection. If there is no database present it will default to NTSC for 'auto'.
Preferred aspect ratio - ntsc
Preferred aspect ratio - pal
Preferred aspect ratio - 4:3
Game Genie Sound Distortion [nestopia_genie_distortion] (disabled|enabled)
Favored System [nestopia_favored_system] (auto|ntsc|pal|famicom|dendy)
Choose which region the system is from. 'auto' will use the NstDatabase.xml database file for region autodetection. If there is no database present it will default to NTSC for 'auto'.
RAM Power-on State [nestopia_ram_power_state] (0x00|0xFF|random)
Turbo Pulse Speed [nestopia_turbo_pulse] (2|3|4|5|6|7|8|9)
Set the turbo pulse speed for the Turbo B and Turbo A buttons.
The Nestopia UE core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s):
User 1 - 4 device types¶
- None - Doesn't disable input. There's no reason to switch to this.
- RetroPad - Joypad - Stay on this.
- RetroPad w/Analog - Joypad - Same as RetroPad. There's no reason to switch to this.
- Zapper - Lightgun - The Nestopia UE core can emulate Zapper inputs but this is done automatically based off of the NstDatabase.xml Database file and cannot be manually selected a device type.
The Nestopia UE core uses the NstDatabase.xml database file to detect which games have multitap support.
|User 1 Remap descriptors||RetroPad Inputs|
|(FDS) Disk Side Change|
|(FDS) Eject Disk|
|(VSSystem) Coin 1|
|(VSSystem) Coin 2|
|User 2 - 4 Remap descriptors||RetroPad Inputs|
|(FDS) Disk Side Change|
|(FDS) Eject Disk|
|Gun Crosshair||Zapper Crosshair|
|Gun Trigger||Zapper Trigger|
|Gun Aux B||Zapper Light On|
|Skull & Crossbones||Graphical glitches and screen shaking when in 2-player mode. (1)|
- Official Nestopia UE Website
- Official Nestopia UE Github Repository
- Libretro Nestopia UE Core info file
- Libretro Nestopia UE Github Repository
- Report Libretro Nestopia UE Core Issues Here