Files
DucielandClaude Opus 5.5 adb1179da5 ducielperf phase 1: C++ rewrite of WeirdUtils' World Markers, Interact, Clickthrough and Transmog Fix
Ports four WeirdUtils modules (public domain, Zig) to C++ built with clang
via `zig c++`, with MinHook 1.3.4 for detours. WeirdUtils needs a patched
Zig compiler: stock Zig 0.16.0 miscompiles x86 __fastcall, which the WoW
1.12.1 client uses for its Lua API and many hooked functions.

Core:
- Lua protection bypass, Lua function registration on login/reload, and
  the WeirdUtils version table + GetWeirdUtilsVersion (AutoMarker needs it).
- In-memory file serving (addon files, M2 models, BLP textures embedded
  with .incbin) and embedded addon registration.
- WeirdUtils-compatible per-module mutexes, so leftover worldmarkers.dll /
  transmogfix.dll / weirdutils.dll skip the modules this DLL provides.
- Single SceneEnd hook shared by Interact and Transmog Fix.

Lua C functions are __fastcall(L): verified at 0x6F61A6 where the Lua VM
calls them with L in ECX only.

Verified offline: loads in a harness that maps WoW.exe at 0x400000, all
18 hooks and both byte patches applied, old companion DLLs step aside.
Not yet tested in game.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 23:14:07 +01:00

95 lines
4.4 KiB
Markdown

# MinHook
[![License](https://img.shields.io/badge/License-BSD%202--Clause-orange.svg)](https://opensource.org/licenses/BSD-2-Clause)
The Minimalistic x86/x64 API Hooking Library for Windows
http://www.codeproject.com/KB/winsdk/LibMinHook.aspx
### Version history
- **v1.3.4 - 28 Mar 2025**
* Improved error handling for enumerating and suspending threads.
* Visual Studio VS2022 support.
* CMake support.
* Fixed compilation with Clang.
* Fixed compilation as C++ code.
- **v1.3.3 - 8 Jan 2017**
* Added a helper function ```MH_CreateHookApiEx```. (Thanks to asm256)
* Support Visual Studio 2017 RC.
- **v1.3.2.1 - 9 Nov 2015** (Nuget package only)
* Fixed an insufficient support for Visual Studio 2015.
- **v1.3.2 - 1 Nov 2015**
* Support Visual Studio 2015.
* Support MinGW.
- **v1.3.2-beta3 - 21 Jul 2015** (Nuget package only)
* Support MinGW. (Experimental)
- **v1.3.2-beta2 - 18 May 2015**
* Fixed some subtle bugs. (Thanks to RaMMicHaeL)
* Added a helper function ```MH_StatusToString```. (Thanks to Jan Klass)
- **v1.3.2-beta - 12 May 2015**
* Fixed a possible thread deadlock in x64 mode. (Thanks to Aleh Kazakevich)
* Reduced the footprint a little more.
* Support Visual Studio 2015 RC. (Experimental)
- **v1.3.1.1 - 7 Apr 2015** (Nuget package only)
* Support for WDK8.0 and 8.1.
- **v1.3.1 - 19 Mar 2015**
* No major changes from v1.3.1-beta.
- **v1.3.1-beta - 11 Mar 2015**
* Added a helper function ```MH_CreateHookApi```. (Thanks to uniskz).
* Fixed a false memory leak reported by some tools.
* Fixed a degradated compatibility issue.
- **v1.3 - 13 Sep 2014**
* No major changes from v1.3-beta3.
- **v1.3-beta3 - 31 Jul 2014**
* Fixed some small bugs.
* Improved the memory management.
- **v1.3-beta2 - 21 Jul 2014**
* Changed the parameters to Windows-friendly types. (void* to LPVOID)
* Fixed some small bugs.
* Reorganized the source files.
* Reduced the footprint a little more.
- **v1.3-beta - 17 Jul 2014**
* Rewrote in plain C to reduce the footprint and memory usage. (suggested by Andrey Unis)
* Simplified the overall code base to make it more readable and maintainable.
* Changed the license from 3-clause to 2-clause BSD License.
- **v1.2 - 28 Sep 2013**
* Removed boost dependency ([jarredholman](https://github.com/jarredholman/minhook)).
* Fixed a small bug in the GetRelativeBranchDestination function ([pillbug99](http://www.codeproject.com/Messages/4058892/Small-Bug-Found.aspx)).
* Added the ```MH_RemoveHook``` function, which removes a hook created with the ```MH_CreateHook``` function.
* Added the following functions to enable or disable multiple hooks in one go: ```MH_QueueEnableHook```, ```MH_QueueDisableHook```, ```MH_ApplyQueued```. This is the preferred way of handling multiple hooks as every call to `MH_EnableHook` or `MH_DisableHook` suspends and resumes all threads.
* Made the functions ```MH_EnableHook``` and ```MH_DisableHook``` enable/disable all created hooks when the ```MH_ALL_HOOKS``` parameter is passed. This, too, is an efficient way of handling multiple hooks.
* If the target function is too small to be patched with a jump, MinHook tries to place the jump above the function. If that fails as well, the ```MH_CreateHook``` function returns ```MH_ERROR_UNSUPPORTED_FUNCTION```. This fixes an issue of hooking the LoadLibraryExW function on Windows 7 x64 ([reported by Obble](http://www.codeproject.com/Messages/4578613/Re-Bug-LoadLibraryExW-hook-fails-on-windows-2008-r.aspx)).
- **v1.1 - 26 Nov 2009**
* Changed the interface to create a hook and a trampoline function in one go to prevent the detour function from being called before the trampoline function is created. ([reported by xliqz](http://www.codeproject.com/Messages/3280374/Unsafe.aspx))
* Shortened the function names from ```MinHook_*``` to ```MH_*``` to make them handier.
- **v1.0 - 22 Nov 2009**
* Initial release.
### Building MinHook - Using vcpkg
You can download and install MinHook using the [vcpkg](https://github.com/Microsoft/vcpkg) dependency manager:
git clone https://github.com/microsoft/vcpkg
.\vcpkg\bootstrap-vcpkg.bat
.\vcpkg\vcpkg integrate install
.\vcpkg\vcpkg install minhook
The MinHook port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.