Mods don't work

[Duke81]

Following Mods cannot be enabled:
VanillaFixes
Nampower
unitXP

After pressing apply the Play Button is stuck at Update.

Edit:
Some of the Addons don't seem to work either. The updater for Cleaveroidmakros for example is pointing to a page that doesn't exist. It would be cool if you guys could verify which Mods/Addons work and removing the rest from your launcher.

[Skooma]

You can use VanillaFixes.exe to properly start all mods, but you need to make sure the content in dlls.txt is correct.

[Darktifa]

Join discord https://discord.com/channels/1499908924 ... 0607921233
and you ll find a guide

[Duke81]

I don't want to join a discord. Put it on the forums or better yet, put it on the front page: Here is what doesn't work yet, here is how you fix it.

[Darktifa]

I don't want to join a discord. Put it on the forums or better yet, put it on the front page: Here is what doesn't work yet, here is how you fix it.

good luck

[Crimsonclaws]

# STEP 1 : OctoWoW Launcher and base game files

This section guides you through downloading the official launcher and installing the core game files required to play on OctoWoW.

## **1.** Go [**HERE**](https://octowow.st/) and click `Download Launcher`.
This will download the OctoWoW Installer. Run the OctoWoW Installer and check the box "Run OctoLauncher", then click "Finish".

## **2.** In the Launcher, click `Install` Create an `OctoWoW` folder somewhere and point this installation to the newly created folder.

> If the download fails or won't start, please run the launcher as administrator.

## **DO NOT CLICK PLAY.** Close the launcher. We will only ever use the launcher to apply major game updates. You will never launch the game using this launcher until it receives major fixes.


# STEP 2 : Configure Antivirus Exclusions

Before downloading or running the setup tool, you must add your OctoWoW installation folder as an exception in Windows Defender (or your third-party antivirus software).

## **1.** Open `Windows Security` > `Virus & threat protection` .

## **2.**Under `Virus & threat protection settings`, click `Manage settings`.

## **3.** Scroll down to `Exclusions` and click `Add or remove exclusions`.

## **4.**Click `Add an exclusion`, select `Folder`, and target your main OctoWoW directory.

# STEP 3 : Modernization Tool (Mods & tweaks)

This section guides you through downloading and installing various mods and performance tweaks using the Modernization Tool.

> **What is the Modernization Tool?** Imagine you have a cool classic car from 2004 (that's your Vanilla WoW game). It looks great, but it lacks modern features like power steering, Bluetooth, or a modern engine.
> This tool is like a mechanic that automatically upgrades your classic car with modern technology so it runs perfectly on today's computers, without you having to change a single file yourself!

## **1.** Download the **Modernization Tool **[**HERE**](https://github.com/Dusk-92/OctoWoW-Mode ... n_Tool.exe)

> [**HERE BUT DONT DOWNLOAD**](https://github.com/Dusk-92/OctoWoW-Modernization-Tool) is the GitHub link for the source code

> If your antivirus blocks and instantly deletes this tool, we need to tell your computer that these files are safe. So we are going back into Virus settings.
> For Windows 11, this is **Settings**>>**Privacy & Security**>>**Windows Security**>>**Virus & Threat Protection**. Under **Current Threats**, click **"Protection History"**. Now pick which**"threats" **you want to restore so your computer stops instantly deleting the file. Redownload the Modernization tool if needed.

## **2.** Run the tool `as administrator` and click `Browse` to select your OctoWoW installation directory.

## **3.** **Setup & DXVK Tab:** Select your GPU type (Choose AMD if you use an AMD graphics card to prevent crashes). You can also toggle the `Auto-Login` mod here.

> RTX 2060 minimum recommended for Nvidia version. If not use AMD version.

## **4.** **Plugins Tab:** Select which `Recommended Core DLLs` and `optional WeirdUtils` you want to install.

### Recommended Core :

> * **Nampower v4.6.0** | [Mod Source](<https://github.com/Emyrk/nampower>) |[Addon Source](<https://github.com/Emyrk/NampowerSettings>) `[Recommended]`
> * Implements ping compensation. It bypasses a 1.12 client flaw that prevents queuing spell casts until server acknowledgment is received. This enables tighter spell batching and significantly increases cast efficiency for players with network latency.
> * **no1600x1200** | *(Legacy file)*
> * This is an experimental fix for Vanilla 1.12 only showing 1600x1200 resolution instead of widescreen or ultrawidescreen.
> * **PerfBoost** | [Mod Source](<https://github.com/Dusk-92/perf_boost>) | [Addon Source](<https://github.com/Dusk-92/PerfBoostSettings>)
> * A performance optimization DLL for World of Warcraft 1.12.1 that provides advanced render distance controls to improve FPS in crowded areas and in raids. Features - Selective Unit Rendering: Control render distances for different types of units (players, pets, trash mobs, corpses).
> * **SuperWoW v1.5.1** | [Mod Source](<https://github.com/balakethelock/SuperWoW>) | [Addon Source](<https://github.com/balakethelock/SuperAPI>) `[Recommended]`
> * SuperWoW enables a lot of advanced lua features that are not available in the vanilla client. Lots of addons utilize or are greatly enhanced by it. It also doubles the macro character limit - up to 511 characters. And much more!
> * **TransmogFix** | [Source Repository](<https://codeberg.org/MarcelineVQ/WeirdUtils>)
> * Eliminates FPS drops caused by rapid equipment visual updates when transmogged items lose durability.

> * **UnitXP_SP3** | [Mod Source](<https://codeberg.org/konaka/UnitXP_SP3>) |[Addon Source](<https://codeberg.org/konaka/UnitXP_SP3_Addon>) `[Recommended]`
> * Adjust camera, Background notifications, Check line of sight in Lua, Debug interface for in-game Lua, Measure distance in Lua, Various network, TCP, ACK tweaks, Proper nameplates, Screenshot in JPEG file, Better Tab targeting function, And more!
> * **VanillaHelpers** | [Source Repository](<https://github.com/isfir/VanillaHelpers>) `[Recommended]`
> * Vastly expands engine limits. Raises the client memory allocator capacity from 2GB to 4GB to prevent Out-of-Memory crashes. Introduces modern high-resolution texture support (up to 1024x1024), 4x character skins, character morphing, and client file read/write operations. (This mod is required for HD mod to work)
> * **WeirdPerformance** | [Mod Source](<https://codeberg.org/MarcelineVQ/WeirdUtils>)
> - *Function: A lightweight optimization addon that boosts FPS and fixes UI memory leaks for a smoother, stutter-free experience.*

### Optional WeirdUtils :

> * **Big Cursor** | [Mod Source](<https://codeberg.org/MarcelineVQ/WeirdUtils>)
> * Upscales the hardware cursor for improved visibility on modern high-resolution displays (e.g., 1440p / 4K) without losing sharpness
> * **Custom Assets** | [Mod Source](<https://codeberg.org/MarcelineVQ/WeirdUtils>)
> * Allows you to load loose game files directly from the Data/ folder and use custom multi-character patch names without having to repack MPQ archives
> * **Log Sessions** | [Mod Source](<https://codeberg.org/MarcelineVQ/WeirdUtils>)
> * Organizes combat and chat logs into clean, per-character, per-day files automatically upon login
> * **Minimap Icons** | [Mod Source](<https://codeberg.org/MarcelineVQ/WeirdUtils>)
> * Adds TBC/WotLK-style minimap tracking icons for NPCs and game objects, with a combined tracking menu and character-saved preferences
> * **Png Screenshots** | [Mod Source](<https://codeberg.org/MarcelineVQ/WeirdUtils>)
> * Saves screenshots as compressed PNG files instead of the default uncompressed TGA format. Runs on a background thread with no frame drops.
> * **World Markers** | [Mod Source](<https://codeberg.org/MarcelineVQ/WeirdUtils>)
> * Allows party/raid leaders to place up to 5 animated, Cataclysm-style colored world markers for raid positioning and tactical planning

---

## **5.** **Vanilla Tweaks Tab:** Adjust your Field of View (auto-calculated to your screen), render distances, and system limits using the sliders.


> **Important Check:** Make sure to double-check the **"Screen Aspect Ratio"** option! Do not blindly rely on the auto-detection; ensure it matches your monitor's actual resolution to prevent the game from rendering in a wrong or stretched resolution. (Thx <@364292895836078082> )

> * **Always auto-loot**
> * *Function: Automatically loots all items from corpses or containers instantly upon opening.*
> * **Large Address Aware (LAA)** `[Recommended]`
> * *Function: Allows the 32-bit WoW client to use up to 4GB of RAM instead of 2GB, drastically reducing crashes and out-of-memory errors.*
> * **Disable DEP** `[Recommended]`
> * *Function: Disables Data Execution Prevention for the game client, preventing random executable memory crashes and improving compatibility with custom DLL injects.*
> * **Background sounds**
> * *Function: Allows game sounds to continue playing while the game is minimized or in the background.*
> * **Fix Camera Skip Glitch** `[Recommended]`
> * *Function: Fixes a bug where right-clicking and dragging to rotate the camera occasionally snaps your view in a random direction.*


> **Crucial Fix:** Ensure **"Disable DEP (Requires Admin)"** is checked! This automatically disables Data Execution Prevention for the patched client, preventing Windows from instantly crashing the game due to SuperWoW's memory hooks


---

## **6.** Click `Apply Setup & Tweaks`. (Click `Yes` if Windows prompts you for Administrator privileges for the DEP fix).

---

## ** 7.** Launch the Client with the newly generated **`Play Modernized WoW`** shortcut located in your game folder.
**YOU WILL ALWAYS CLICK THIS ICON TO PLAY THE GAME.**


> **IMPORTANT:** Do not launch the game via `WoW.exe` or the OctoWow launcher *(launcher is for updating only)*.

# ━━━━━━━━━━━━━━━━━━━━━━━━━━

[Crimsonclaws]

# PROJECT REFORGED — COMPLETE HD INSTALLATION GUIDE (HD Patches)
This section guides you through upgrading your game with the complete Project Reforged graphics pack, bringing high-definition patches and modern retail assets to your classic client

---
# Access the download links [**HERE**](https://projectreforged.github.io/vanil ... ds/turtle/)

---

## **1.** Dependencies — Install First


These are core files required to optimize the game engine, stabilize performance, and allow the high-definition mods to run smoothly without crashing


* **VanillaHelpers** `[REQUIRED]` `[CORE DEPENDENCY]`
* Required for Project Reforged to function properly. Install it with Modernization Tool https://discord.com/channels/1499908924 ... 5145201694
* **DXVK** `[OPTIONAL]`
* Improves D3D9 stability and ReShade compatibility. Install it with Modernization Tool https://discord.com/channels/1499908924 ... 5145201694
---

## **2. Core Character Models (Essential for Custom Races)**
---
This replaces the old vanilla assets with modern Retail 3D models for players and NPCs. It is mandatory for seeing Turtle WoW's custom content properly (like High Elves or Goblins) instead of broken textures

* **PATCH-A (Player Characters & NPCs)**
* Upgrades characters, NPCs, and adds support for Turtle WoW's custom races (Goblin, High Elf, Naga, etc.).


> *Note: This patch is also the mandatory foundation if you want to use **Patch-L**, **Patch-T**, or **Patch-U**.*

---

## **3.** Core World Modules (The World Combo)
---

These are the main visual overhauls available for your client.

If you want HD world visuals, these three patches are interconnected.
* **PATCH-B** (Buildings) + **PATCH-D** (Doodads) + **PATCH-E** (Environment textures and world visuals, including Fog Pushback integration)

> ➔ **Must be installed ALL THREE TOGETHER, or none at all.**

---

## **4.** Character Texture Choice (Pick ONLY ONE Option)
---

This applies high-resolution skin and gear textures onto the 3D models from Patch-A

* **Option A: Standard HD Upgrade `[Recommended]`**
➔ Install **only** `PATCH-T (Standard Standalone)`.
* **Option B: Ultra HD Upgrade (Heavy)**
➔ Install **both** `PATCH-T (Ultra Base)` **AND** `PATCH-U (Ultra HD Character & Gear)`.

> **Never mix the Standard Standalone file with the Ultra files!**


---

## **5.** A Little Extra for Females (Optional)
---
**PATCH-L** ➔ Strictly requires **PATCH-A** (Player Characters) to function.

**Choose and install ONLY ONE variant:**
* **Regular Version** (by Watchers3D)
* **Less Thicc Version** (by Deezhugs)

---

## **6.** Standalone Patches (Plug & Play)

These patches are completely independent. You can install them or skip them freely—they don't require any other patch to work:

* **PATCH-C** (Creatures and related assets for the classic client.)
* **PATCH-G** (Gear and weapon visuals used by multiple enhancements.)
* **PATCH-I** (Interface visuals and SuperWoW selection circle texture support, tuned for the OctoWoW client.)
* **PATCH-M** (Enhanced maps and loading screens including Turtle WoW's custom zones and continents)
* **PATCH-N** (Darker nights for a more atmospheric experience.)
* **PATCH-P** (Spell visuals and effect enhancements)
* **PATCH-S** (Sound and music enhancements for a richer audio experience.)

---

## **7.** **Required MPQ Renaming**

Before moving the downloaded files into your `OctoWoW/Data` folder, you **MUST shift every patch up by one letter** so they look exactly like this:

> **Why this step is mandatory:**
> The OctoWoW launcher now includes its own `patch-A.mpq` file. If you paste the HD patches directly, your HD patch A will be overwritten, causing all character models to look completely broken.


``` EXACT MPQ RENAMING TABLE:
[Original Downloaded Name] ➔ [WHAT YOU MUST RENAME IT TO]
------------------------------------------------------------
patch-A.mpq ➔ patch-B.mpq
patch-B.mpq ➔ patch-C.mpq
patch-C.mpq ➔ patch-D.mpq
patch-D.mpq ➔ patch-E.mpq
patch-E.mpq ➔ patch-F.mpq
patch-G.mpq ➔ patch-H.mpq
patch-I.mpq ➔ patch-J.mpq
patch-L.mpq ➔ patch-M.mpq
patch-M.mpq ➔ patch-N.mpq
patch-N.mpq ➔ patch-O.mpq
patch-P.mpq ➔ patch-Q.mpq
patch-S.mpq ➔ patch-T.mpq
patch-T.mpq ➔ patch-U.mpq
patch-U.mpq ➔ patch-V.mpq```

---

## **8.** Once renamed, drag and drop all your new `.mpq` files into your `OctoWoW/Data` folder.*


---

## **9.** IMPORTANT REMINDERS

Always launch your game via **`Play Modernized WoW`** located in your OctoWoW folder. **Never use `WoW.exe`.**

---
Join the official Project Reforged Discord to track updates and support their amazing work: https://discord.gg/A7YXdVyVfa

---# ━━━━━━━━━━━━━━━━━━━━━━━━━━

# **Useful Tweaks & Optimization**

---

## Automatically clear WDB every launch (Windows) (Pick ONLY ONE Option) :

Tired of manually deleting your WDB cache folder to avoid glitches? Pick one of these 2 methods to automate or block it completely!

* **Option 1: The "Dummy File" Trick (Ultra Easy)**
* Tricks Windows so the game client can never create a WDB cache folder again.
* Go to your main game directory and delete the `WDB` folder.
* Create a brand new **Text Document** (`.txt`) in that exact spot.
* Rename it simply to `WDB` and **remove the `.txt` extension** at the end. *(Ensure you have "File name extensions" enabled in your Windows explorer settings!)*

* **Option 2: Lock Folder Permissions (Easy)**
* Blocks the game from writing any new data into the folder.
* Open your `WDB` folder and delete everything inside so it is completely empty.
* Go back, right-click the empty `WDB` folder, and select **Properties**.
* Go to the **Security** tab, click **Edit**, and for every group/user listed, check the **Deny** box for **Write** permissions. Click Apply and Save.

# ━━━━━━━━━━━━━━━━━━━━━━━━━━

# TROUBLESHOOTING


**If your game is crashing, please go through the following steps:**

* **Disable all AddOns** and verify if the crashes stop.
* **Enable Vertext Animation Shaders** in your WoW Video settings.
* **Remove all non-supported custom MPQ patches** (like *Darker Nights* or *HD Models*).
> *We do not recommend using unsupported modifications; they can interfere with gameplay and corrupt your client.*
* **Switch your DXVK version.** If your PC doesn't support Vulkan, try the AMD version instead.
* **Check the `Config.wtf` file** in your WTF folder:
* If you see `SoundSoftwareChannels` and `SoundMaxHardwareChannels`, **delete these lines**.
* *(These settings control the max number of sounds played simultaneously like spells, music, etc.)*
* You can use **"Uncapped sounds"** from *SuperWow (SuperAPI addon)* instead, it is much more stable!
* ** If using pfUI:** If your game crashes every time you `/reload` or log back in, it might be a conflict with the `Minimap Icons` module from the Modernization Tool. ** ➔** Go to your AddOn list and disable `[WeirdUtils] Minimap Icons`. This is especially common if you have moved your minimap position using **pfUI**.

---

**Other Known Issues & Fixes:**

* **If you have a flickering mouse cursor:** Disable `Hardware Cursor` in-game via **Options > Miscellaneous**.
* **Double floating healing numbers :** If you see your healing numbers appearing twice on your screen, it is a known issue with SuperWow. You need to apply a small patch to fix the floating heal text. Follow these exact steps:
* Download the patcher tool [HERE](https://github.com/turtlenips/superwow- ... sabler.exe).
* Copy and paste the downloaded `.exe` file into your main **OctoWoW** folder.
* Drag and drop your `SuperWoWhook.dll` file directly onto the `superwow_heal_text_disabler.exe` file.