NES / Famicom (FCEUmm)Link

Contribute to this documentationLink

In order to propose improvements to this document, visit its corresponding source page on github. Changes are proposed using "Pull Requests."

There is a To-Do list for libretro/docs here

You can submit suggestions or issues regarding documentation at the libretro/docs issue tracker or in our forum thread.

BackgroundLink

FCEU "mappers modified" is an unofficial build of FCEU Ultra by CaH4e3, which supports a lot of new mappers including some obscure mappers such as one for unlicensed NES ROM's.

Why use this core?Link

Awaiting description.

How to get and install the FCEUmm core:Link

  • Start up RetroArch. Inside the main menu, go to 'Online Updater'.

  • Just to make sure we have the latest info files, select 'Update Core Info FIles'. Wait until this is done. Then, select 'Core Updater'.

  • Browse through the list and select 'NES / Famicom (FCEUmm)'.

After this has finished downloading, the core should now be ready for use!

How to start (after installation):Link

  • Go back to RetroArch's main menu screen. Select 'Load Content'.

  • Browse to the folder that contains the content you want to run.

  • Select the content that you want to run.

  • If you are asked which core to select, choose 'NES / Famicom (FCEUmm)'.

The content should now start running!

AuthorsLink

  • FCEU Team
  • CaH4e3

See alsoLink

NES/FamicomLink

LicenseLink

A summary of the licenses behind RetroArch and its cores have found here.

The FCEUmm core is licensed under

ExtensionsLink

Content that can be loaded by the FCEUmm core have the following file extensions:

  • .fds
  • .nes
  • .unif
  • .unf

DatabasesLink

RetroArch database(s) that are associated with the FCEUmm core:

BIOSLink

Required or optional firmware files go in RetroArch's system directory.

Filename Description md5sum
disksys.rom Family Computer Disk System BIOS - Required for Famicom Disk System emulation ca30b50f880eb660a320674ed365ef7a
nes.pal Custom NES Palette (Color Palette core option) - Optional

FeaturesLink

RetroArch-level settings or features that the FCEUmm core respects.

Feature Supported
Restart
Screenshots
Saves
States
Rewind
Netplay
Core Options
RetroAchievements
RetroArch Cheats
Native Cheats
Controls
Remapping
Multi-Mouse
Rumble
Sensors
Camera
Location
Subsystem
Softpatching
Disk Control
Username
Language
Crop Overscan

DirectoriesLink

The FCEUmm core's directory name is 'FCEUmm'

The FCEUmm core saves/loads to/from these directories.

RetroArch's Save directory

  • 'content-name'.srm (Cartridge battery save)

RetroArch's State directory

  • 'content-name'.state# (State)

Geometry and timingLink

  • The FCEUmm core's internal FPS is (FPS)
  • The FCEumm core's internal sample rate is (Rate)
  • The FCEUmm core's core provided aspect ratio is dependent on the 'Preferred aspect ratio' core option.

Custom color palettesLink

To use custom color palettes in the FCEUmm core, the 'Color Palette' core option must be set to custom and the custom color palette file you want to use must be in RetroArch's system directory.

Make sure the custom palette file is named 'nes.pal'

Custom color palettes for the NES can be generated with either of these tools.

Core optionsLink

The FCEUmm 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.

  • Region Override (Auto/NTSC/PAL/Dendy)

    Choose which region the system is from.

  • Preferred aspect ratio (8:7 PAR/4:3)

    Choose the preferred aspect ratio. RetroArch's aspect ratio must be set to Core provided in the Video seetings.

Preferred aspect ratio - 8:7 PAR

Preferred aspect ratio - 4:3

  • Color Palette (default/asqrealc/nintendo-vc/rgb/yuv-v3/unsaturated-final/sony-cxa2025as-us/pal/bmf-final2/bmf-final3/smooth-fbx/composite-direct-fbx/pvm-style-d93-fbx/ntsc-hardware-fbx/nes-classic-fbx-fs/nescap/wavebeam/raw/custom)

    Choose which color palette is going to be used. The raw palette can used in combination with the nes-decoder shader to give colors based off on Bisqwit's NES palette generator and applies either an FCC color conversion matrix or specific Sony US matrix.

Attention

These 'Color Palette core option screenshots have been taken with the 'Use NTSC Palette' core option set to Off.

Color Palette - default

Color Palette - asqrealc

Color Palette - nintendo-vc

Color Palette - rgb

Color Palette - yuv-v3

Color Palette - unsaturated-final

Color Palette - sony-cxa2025as-us

Color Palette - pal

Color Palette - bmf-final2

Color Palette - bmf-final3

Color Palette - smooth-fbx

Color Palette - composite-direct-fbx

Color Palette - pvm-style-d93-fbx

Color Palette - ntsc-hardware-fbx

Color Palette - nes-classic-fbx-fs

Color Palette - nescap

Color Palette - wavebeam

Color Palette - raw

  • Use NTSC Palette (Off/On)

    Self-explanatory.

Attention

These 'Use NTSC Palette' core option screenshots have been taken with the 'Color Palette' core option set to default.

Use NTSC Palette - Off

Use NTSC Palette - On

  • Crop Overscan (Horizontal) (Off/On)

    Crop 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.

Crop Overscan (Horiontal) - Off

Crop Overscan (Horizontal) - On

  • Crop Overscan (Vertical) (Off/On)

    Crop 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.

Crop Overscan (Vertical) - On

Crop Overscan (Vertical) - Off

  • No Sprite Limit (Off/On)

    Removes 8-sprites-per-scanline hardware limit.

  • Sound Volume (150/160/170/180/190/200/210/220/230/240/250/0/10/20/30/40/50/60/70/80/90/100/110/120/130/140)

    Self-explanatory.

  • Sound Quality (Low/High/Very High)

    Enables high/higher sound quality for games using expansion audio (MMC5, VRC6, VRC7, Namco, Sunsoft). Use Low for slower devices.

  • Swap Duty Cycles (Off/On)

    Replicates the sound of some famiclones that have duty cycles swapped for square channels. A quick sound comparison is in Contra's sound effect when shooting with normal bullets.

  • Turbo Enable (None/Player 1/Player 2/Both)

    Enable the use of the Turbo B and Turbo A buttons.

  • Turbo Delay (in frames) (3/5/10/15/30/60/1/2)

    The number of frames between consecutive buttton presses when the Turbo B or Turbo A buttons are held down.

  • Zapper Mode (pointer/mouse)

    Pointer allows the Zapper Device Type to be used for touch-devices, but still can be used with regular mouse. Pointer and Mouse mode movement behaves differently with different input driver so user can choose which movement feels natural to them.

  • Show Crosshair (Off/On)

    Show the crosshair for the Zapper device type.

Show Crosshair - On

Show Crosshair - Off

  • Overclocking (Off/2x-Postrender/2x-VBlank)

    Overclocks the NES using PPU method to minimize ingame slowdowns of some games. Contra Force needs VBlank mode (stage 3 slowdowns). Choose which ever minimizes slowdowns without image distortion.

ControllersLink

Device typesLink

The FCEUmm core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s):

User 1 device typesLink

  • None - Input disabled.
  • Auto - Joypad - Based off the loaded game's crc, the core will automatically select a regular controller (NES or Famicom) for User 1.
  • Gamepad - Joypad - Manually selects a regular controller (NES or Famicom) for User 1.
  • Zapper - Mouse - Manually selects a Zapper light gun (NES or Famicom) for User 1.

User 2 device typesLink

  • None - Input disabled.
  • Auto - Joypad - Based off the loaded game's crc, the core will automatically select a regular controller (NES or Famicom) or a Zapper light gun (NES or Famicom) or a Arkanoid Paddle (NES only) for User 2.
  • Gamepad - Joypad - Manually selects a regular controller (NES or Famicom) for User 2.
  • Arkanoid - Mouse - Manually selects a Arkanoid Paddle (NES only) for User 2.
  • Zapper - Mouse - Manually selects a Zapper light gun (NES or Famicom) for User 2.

Other controllersLink

The FCEUmm core will also auto select the following controllers for the Famicom based off the loaded game's crc.

Warning

Please note that these Famicom controllers are completely separate from the device types in the controls menu and cannot be manually selected.

Multitap supportLink

The FCEUmm core supports up to 4 players in multitap games for the NES and Famicom, games with multitap usage are detected by their crc.

Controller tablesLink

Joypad and analog device type tableLink

Warning

In order to use the Turbo A and Turbo B buttons, the 'Turbo Enable' core option must be set to On.

User 1 Remap descriptors for 'Gamepad' device type RetroPad Inputs
B
Turbo B
Select
Start
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
A
Turbo A
(FDS) Disk Side Change
(FDS) Insert/Eject Disk
(VSSystem) Insert Coin
Users 2 - 4 Remap descriptors for 'Gamepad device type' RetroPad Inputs
B
Turbo B
Select
Start
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
A
Turbo A

Mouse device type tableLink

RetroMouse Zapper Arkanoid Oeka Kids Tablet Bandai Hyper Shot Gun
Zapper Crosshair Arkanoid Movement Oeka Kids Tablet Cursor Bandai Hyper Shot Gun Crosshair
Zapper Trigger Arkanoid Fire Oeka Kids Tablet Touch Bandai Hyper Shot Gun Trigger

When the 'Zapper' device type is changed to Mouse mode with the 'Zapper Mode' core option, the inputs will be the exact same.

CompatibilityLink

Game Issue
Skull & Crossbones Graphical glitches and screen shaking when in 2-player mode.