🎮 Uncensor Icon

简体中文 | English

Compare and extract different icons between Global and CN World of Warcraft versions to override censored content.

📖 Table of Contents

• 📦 Prebuilt Icons
• 💼 Requirements
• 🚚 Installation
  • Option 1: Download Pre-built Binary
  • Option 2: Build from Source
• 🎯 Quick Start
  • Step 1: Extract Game Icons
  • Step 2: Run the Tool
• ⚙️ Command Options
  • Blacklist Files
• 📝 Example Usage
• 🔧 Building from Source
• 📄 License

📦 Prebuilt Icons

You can download the prebuilt icon pack from NGA.cn

💼 Requirements

• Rust 1.70 or later
• Any OS that supports Rust (Windows, macOS, Linux)
• World of Warcraft (Global and CN versions)

🚚 Installation

Option 1: Download Pre-built Binary

1. Go to the Releases page
2. Download the latest binary for your platform:
   • Windows: uncensor-icon-windows.exe
   • Linux: uncensor-icon-linux
   • macOS: uncensor-icon-macos
3. Place it in a convenient location

Option 2: Build from Source

1. Install Rust from https://rustup.rs/

2. Clone this repository:

   git clone https://github.com/wind-addons/uncensor-icon.git
   cd uncensor-icon

3. Build the project:

   cargo build --release

4. The executable will be in target/release/uncensor-icon.exe

🎯 Quick Start

Step 1: Extract Game Icons

You need to extract the icon files from both WoW versions first:

1. Open Battle.net, go to Game Settings for each WoW version
2. Add -console to "Additional command line arguments"
3. Start each WoW version, go to character selection screen
4. Press ~ to open console, type exportInterfaceFiles art
5. Wait for it to finish (creates BlizzardInterfaceArt\Interface\ICONS folders)

Step 2: Run the Tool

uncensor-icon `
    --global-dir "C:\WoW\Global\_retail_\BlizzardInterfaceArt\Interface\ICONS" `
    --cn-dir "C:\WoW\CN\_retail_\BlizzardInterfaceArt\Interface\ICONS" `
    --output-dir "C:\WoW\CN\_retail_\Interface\ICONS"

⚙️ Command Options

uncensor-icon [OPTIONS]

Required:
  --global-dir <DIR>      Path to Global WoW icons folder
  --cn-dir <DIR>          Path to CN WoW icons folder
  --output-dir <DIR>      Where to copy the different icons

Optional:
  --blacklist <FILES>     Files to skip (default: XP_ICON.BLP,XPBonus_Icon.blp,Garr_CurrencyIcon-Xp.blp)
  --help                  Show help message

Blacklist Files

By default, these files are excluded from comparison as they contain localized text that naturally differs between versions:

• XP_ICON.BLP - Experience bar icons with localized text
• XPBonus_Icon.blp - Bonus experience icons with localized text
• Garr_CurrencyIcon-Xp.blp - Garrison experience icons with localized text

📝 Example Usage

Basic Usage

uncensor-icon `
    --global-dir "C:\Games\WoW\_retail_\BlizzardInterfaceArt\Interface\ICONS" `
    --cn-dir "C:\Games\WoW CN\_retail_\BlizzardInterfaceArt\Interface\ICONS" `
    --output-dir "C:\Games\WoW CN\_retail_\Interface\ICONS"

With Custom Blacklist

uncensor-icon `
    --global-dir "C:\Games\WoW\_retail_\BlizzardInterfaceArt\Interface\ICONS" `
    --cn-dir "C:\Games\WoW CN\_retail_\BlizzardInterfaceArt\Interface\ICONS" `
    --output-dir "C:\Games\WoW CN\_retail_\Interface\ICONS" `
    --blacklist "XP_ICON.BLP,bad_icon.blp,temp.blp,custom_icon.blp"

🔧 Building from Source

1. Install Rust from https://rustup.rs/
2. Clone or download this project
3. Run: cargo build --release
4. The executable will be in target/release/uncensor-icon.exe

📄 License

MIT