WowFC - World of Warcraft FC/NES Emulator

A World of Warcraft addon that runs FC/NES games inside the game.

English | 简体中文

Screenshot

Features

Run FC/NES games inside World of Warcraft
Support for multiple mappers (Mapper 0, 1, 2, 3, 4)
Customizable key bindings
Frame skip optimization for different performance environments
Turbo (rapid fire) support
Debug mode
Optional scanline-accurate rendering
Sound on/off toggle
Performance boost mode (uncaps WoW frame limit while running)

Usage

Basic Controls

Type /fc or /wowfc to open/close the emulator window
Press ESC to exit control mode
Window is draggable to adjust position

Loading Games

Place your .nes format ROM files in the WowFC/ROMs/ directory
Run WowFC/WowFC_ROM_Converter.exe to convert ROMs to Lua data format
Run /reload in-game to load the new ROMs
Click the "Load ROM" button in the addon interface to select and load a game

Note: ROM files may have copyright issues. Please do not commit ROM files to the repository.

Key Binding

Click the "Key Binding" button in the interface to customize keyboard mappings for FC controller buttons.

Commands

Command	Description
`/fc`	Open/close emulator window
`/fc skip <1-10\|auto>`	Set frame skip (for performance tuning)
`/fc scanline <on\|off>`	Toggle scanline-accurate rendering
`/fc sound <on\|off>`	Toggle sound output
`/fc boost`	Toggle performance boost mode
`/fc prof`	Show performance profile data
`/fc profreset`	Reset performance profile data
`/fc debug`	Show debug information
`/fc bench [frames] [rounds]`	Run renderer benchmark (default 60 frames × 3 rounds)
`/fc help`	Show help message

Project Structure

WowFC/
├── Core/           # Emulator core
│   ├── CPU.lua     # 6502 CPU emulation
│   ├── PPU.lua     # Picture Processing Unit
│   ├── ROM.lua     # ROM loader
│   ├── FC.lua      # Main emulator logic
│   └── Mappers/    # Various mapper implementations
├── Utils/          # Utility modules
├── Sound/          # Sound sample assets
├── ROMs/           # ROM directory (README only in repo)
├── UltraRenderer.lua  # Renderer
├── Keybinding.lua  # Key binding
├── WowFC.lua       # Addon main entry
└── WowFC.toc       # Addon manifest

Technical Notes

This project is based on:

World of Warcraft Lua API for UI rendering
Pure Lua implementation of 6502 CPU and PPU emulation

Important Notes

ROM Copyright: This project does not include any game ROMs. Users must prepare their own legal ROM files.
Performance Requirements: The emulator requires computational resources. Recommended for use on better-configured computers.
Compatibility: Currently supports World of Warcraft 12.0+.

Known Limitations

Performance: Frame skip may be required on lower-end systems to maintain playable speed

License

This project is open-sourced under the MIT License.

Acknowledgments

Thanks to the WoW addon development community

Authors

[黑科研]胡涂 / [黑科研]童

Disclaimer: This addon is for educational and communication purposes only. It is not affiliated with Blizzard Entertainment.