WowFC - World of Warcraft FC/NES Emulator

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

English | 简体中文

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

1. Place your .nes format ROM files in the WowFC/ROMs/ directory
2. Run WowFC/WowFC_ROM_Converter.exe to convert ROMs to Lua data format
3. Run /reload in-game to load the new ROMs
4. 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

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

1. ROM Copyright: This project does not include any game ROMs. Users must prepare their own legal ROM files.
2. Performance Requirements: The emulator requires computational resources. Recommended for use on better-configured computers.
3. 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.