Skip to content

Releases: huchang47/WowFC

v1.1.3

Choose a tag to compare

@github-actions github-actions released this 22 Jun 09:42

WowFC

v1.1.3 (2026-06-22)

Full Changelog Previous Releases

  • chore: bump addon version to 1.1.3
  • feat: 新增多语言本地化支持,实现国际化功能
    • 新增enUS、zhCN、jaJP三种语言的本地化文件
    • 重构所有硬编码中文文本为可本地化的字符串
    • 在TOC中添加本地化文件加载顺序
    • 为各模块添加本地化表引用

v1.1.2

Choose a tag to compare

@github-actions github-actions released this 22 Jun 05:55

WowFC

v1.1.2 (2026-06-22)

Full Changelog Previous Releases

  • build: 新增本地打包脚本并更新版本号至1.1.2
    1. 新增PowerShell本地打包脚本,支持自定义版本和输出目录
    2. 自动读取TOC文件中的版本号作为默认版本
    3. 打包生成完整包和剔除exe文件的精简包
    4. 更新WowFC插件版本为1.1.2
  • refactor: 统一命令大小写与音效声道配置
    1. 统一所有斜杠命令为 /WowFC 标准格式
    2. 将音效声道从 SFX 改为 Master,优化静音体验
    3. 新增窗口隐藏时自动恢复音效与退出操控模式逻辑
    4. 重构暂停/恢复游戏逻辑,复用代码减少重复
  • chore: 移除.pkgmeta中的手动 changelog 配置项
    删除了不再需要的manual-changelog相关配置,清理pkgmeta文件内容
  • chore: 更新gitignore,添加发布版本目录忽略
    修改.gitignore文件,新增对"发布版本/"目录的忽略规则,避免将构建产出的发布目录提交到仓库
  • chore: 更新 .gitignore 匹配规则
    调整忽略文件列表,整理工具目录、ROM文件和缓存文件的忽略规则,移除旧的错误路径并补充新的忽略项

v1.1.1

Choose a tag to compare

@github-actions github-actions released this 20 Jun 22:01

WowFC - World of Warcraft FC/NES Emulator

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

English | 简体中文

Interface
License

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)

Installation

Method 1: GitHub Release (Recommended)

  1. Go to Releases
  2. Download the latest WowFC-vX.X.X.zip
  3. Extract and copy the WowFC folder to your WoW addon directory:
    • Retail: World of Warcraft\_retail_\Interface\AddOns\
    • Classic: World of Warcraft\_classic_\Interface\AddOns\
  4. Restart the game or click the "AddOns" button at the character selection screen

Method 2: CurseForge

Install via CurseForge and let the client manage updates.

Method 3: Git Clone

cd "World of Warcraft\_retail_\Interface\AddOns"
git clone https://github.com/huchang47/WowFC.git WowFC

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

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

  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.