Compare commits

...

33 Commits

Author SHA1 Message Date
MarcelineVQ 6f2789fd1c Update README and API header for v0.7.0
Adds World Markers section (new module shipping in 0.7.0). Updates the
Performance section with Lua runtime optimizations (allocator, GC,
string interning, pattern prefilter). Fixes Log Sessions documentation
to reflect per-day rollover. Adds worldmarkers, clickthrough, and
weirdperformance to the DLL auto-discovery list in weirdutils_api.h.
2026-04-11 14:15:42 -07:00
MarcelineVQ d71ab9d4fd update issue template 2026-03-28 01:59:07 +01:00
MarcelineVQ eb21c08706 update issue template 2026-03-28 01:59:04 +01:00
MarcelineVQ 95704a412d update issue template 2026-03-28 01:59:01 +01:00
MarcelineVQ a3d5b47910 fix: simplify bug report template with markdown headers 2026-03-27 23:56:44 +01:00
MarcelineVQ 58f2f788b1 fix: consolidate bug report into single textarea with upload 2026-03-27 23:54:30 +01:00
MarcelineVQ 434a4f1129 fix: remove render attribute, let textarea auto-size 2026-03-27 23:51:35 +01:00
MarcelineVQ 11e954857b fix: disable upload on description field via render attribute 2026-03-27 23:11:19 +01:00
MarcelineVQ 49d9a43235 fix: merge description and steps into single field with prefilled sections 2026-03-27 23:09:30 +01:00
MarcelineVQ 4a4ae22a2d fix: remove duplicate DLL upload section from bug report template 2026-03-27 23:06:12 +01:00
MarcelineVQ ad4e44dc55 fix: bug report template - add upload prompts, resize fields 2026-03-27 22:59:22 +01:00
MarcelineVQ 6c216ddf28 Bug report: remove placeholder text from upload fields 2026-03-27 22:51:57 +01:00
MarcelineVQ 12465cfd58 Add bug_report.yml 2026-03-27 22:41:56 +01:00
MarcelineVQ 6d216e8201 Add config.yml 2026-03-27 22:41:54 +01:00
MarcelineVQ 44d56ebe1b Remove config.yaml 2026-03-27 22:41:53 +01:00
MarcelineVQ ad2dd20ca1 Add other.yml 2026-03-27 22:41:50 +01:00
MarcelineVQ f266852fa5 Remove other.yaml 2026-03-27 22:41:49 +01:00
MarcelineVQ caac25cb73 Rename bug_report.yaml to .yml 2026-03-27 22:41:46 +01:00
MarcelineVQ baf0a7997d Bug report: clean textarea fields for file attachments 2026-03-27 22:33:48 +01:00
MarcelineVQ 9b1f7c2600 Bug report: separate file upload fields for crash log and DLLs 2026-03-27 22:32:05 +01:00
MarcelineVQ e674a1634d Disable blank issue template 2026-03-27 22:30:05 +01:00
MarcelineVQ d1dc5ec31d Add feature request / question template 2026-03-27 22:26:05 +01:00
MarcelineVQ 30c827647c Update bug report: file attachments section 2026-03-27 22:26:04 +01:00
MarcelineVQ b49a633456 Update bug report template: defaults, file attachments 2026-03-27 22:22:52 +01:00
MarcelineVQ ae5caa0098 Add bug report issue template 2026-03-27 22:19:53 +01:00
MarcelineVQ b8facd60e9 Update clickthrough description for cascade raycast 2026-03-25 01:53:04 -07:00
MarcelineVQ 1b19fde999 Update README for v0.6.0 2026-03-24 19:06:39 -07:00
MarcelineVQ 83d97ab1db Update clickthrough description for PvP filtering 2026-03-09 23:21:49 -07:00
MarcelineVQ c62eb2c560 Update README for v0.5.0 2026-03-09 22:40:00 -07:00
MarcelineVQ a283ffe2b6 Rename pngscreenshot to pngscreenshots 2026-03-08 19:36:44 -07:00
MarcelineVQ 4af5180c4d Add weirdutils_api.h to repo 2026-03-08 17:53:18 -07:00
MarcelineVQ 2d4bb10c6e Update README for v0.4.0 2026-03-08 15:53:34 -07:00
MarcelineVQ 7a7b564c51 Update README for v0.3.0 2026-03-06 13:42:37 -08:00
5 changed files with 335 additions and 7 deletions
+41
View File
@@ -0,0 +1,41 @@
name: Bug Report
about: Report a crash, error, or unexpected behavior
labels:
- bug
body:
- type: dropdown
id: launcher
attributes:
label: Launcher
options:
- WoW.exe (direct)
- VanillaFixes.exe
- Other
default: 0
validations:
required: true
- type: dropdown
id: platform
attributes:
label: Platform
options:
- Windows
- Linux (Wine)
- macOS (Wine/CrossOver)
default: 0
validations:
required: true
- type: textarea
id: description
attributes:
label: Bug Report
description: Attach your WeirdUtils DLL(s) and crash log (.txt from Errors/ folder) by dragging them into this box.
value: |
## What happened?
## Steps to reproduce:
## Other DLLs loaded (nampower, SuperWoW, UnitXP, etc.):
validations:
required: true
+2
View File
@@ -0,0 +1,2 @@
blank_issues_enabled: false
contact_links: []
+10
View File
@@ -0,0 +1,10 @@
name: Feature Request / Question
about: Suggest a feature or ask a question
body:
- type: textarea
id: description
attributes:
label: Description
description: What would you like to see, or what question do you have?
validations:
required: true
+202 -7
View File
@@ -1,6 +1,6 @@
# WeirdUtils
This package provides many pre-built DLLs for enhancing the vanilla WoW gameplay experience, aimed in particular at ease of use and accessibility but also bug fixes.
This package provides many pre-built DLLs for enhancing the vanilla 1.12 client WoW gameplay experience, aimed in particular at ease of use and accessibility but also bug fixes.
You may get all features by installing `weirdutils.dll`, or choose any selection of features via individual DLLs.
On Turtle WoW, place your chosen DLLs next to your `WoW.exe` and add them to your `dlls.txt`. For other versions you will need some sort of DLL loader.
@@ -9,6 +9,45 @@ On Turtle WoW, place your chosen DLLs next to your `WoW.exe` and add them to you
## Features
### World Markers
Place up to 5 animated colored markers (Cataclysm style) at any position in the world, useful for raid positioning, pull planning, or route marking. Requires party/raid leader or raid assist.
- `/worldmarker 1` through `/worldmarker 5` (or `/wm 1`) -- place a marker where your cursor is pointing
- `/worldmarker 1 target` -- place a marker on a unit (player, target, mouseover, etc.)
- `/clearworldmarker` (or `/cwm`) -- remove all markers
- `/clearworldmarker 2` -- remove a specific marker
Keybindings for placing each marker and clearing all markers are available in the Key Bindings menu.
Markers automatically sync with group members who also have WeirdUtils installed. When a leader/assist places or clears a marker, all group members see it. Markers persist across zone transitions and respawn when you return to the area.
Lua API for addon developers:
- `WorldMarker(index)` -- place marker at cursor (returns x,y,z,areaId on success, nil if no permission, -1 on failure)
- `WorldMarker(index, "unit")` -- place marker at a unit's position
- `WorldMarker(index, x, y, z)` -- place marker at world coordinates
- `ClearWorldMarker(index)` / `ClearWorldMarker()` -- remove one or all markers (returns 1 on success, nil if no permission)
- `GetWorldMarker(index)` -- returns x,y,z,areaId for an active marker, nil if empty
- `CanSetWorldMarker()` -- returns 1 if the local player is party/raid leader or raid assist, nil otherwise
**DLL:** `worldmarkers.dll`
---
### PNG Screenshots
Saves screenshots as compressed PNG files instead of the default uncompressed TGA format. Runs on a background thread with no frame drops.
Controlled via the `screenshotQuality` CVar (saved to config.wtf):
- `/script SetCVar("screenshotQuality", "6")` -- set compression level (1 = fast, 9 = smallest, default 6)
- `/script SetCVar("screenshotQuality", "0")` -- disable PNG, use original TGA format
**DLL:** `pngscreenshots.dll`
---
### Transmog Fix
Eliminates FPS drops caused by rapid equipment visual updates when transmogged items lose durability. No configuration needed, install and forget.
@@ -23,7 +62,7 @@ Enables loading loose game asset files (models, textures, etc.) from the `Data/`
Also allows multi-character patch archive names (e.g. `patch-12.mpq`, `patch-jimbo.mpq`).
Patch archives are sorted case-insensitively by filename last in the sort gets highest priority, and all patches override the base archives.
Patch archives are sorted case-insensitively by filename - last in the sort gets highest priority, and all patches override the base archives.
No configuration needed, install and forget.
@@ -31,18 +70,51 @@ No configuration needed, install and forget.
---
### Utility Minimap Trackings
Adds TBC/WotLK-style minimap tracking icons for NPC types, game objects, and quest givers.
Replaces the native tracking dropdown with a combined menu showing both spell tracking and NPC category tracking.
Can be disabled from the normal AddOn menu. Preferences saved per-character.
- Click the minimap tracking icon to open the dropdown
- Check/uncheck NPC categories to toggle their minimap icons
- Spell tracking (Hunter tracking, Find Herbs, etc.) remains available alongside NPC tracking
- "Hide in Cities" toggle suppresses NPC icons in capital cities
Tracks various npc types and useful objects like Oranges and Brainwasher and Mailbox.
**DLL:** `minimapicons.dll`
---
### Clickthrough
Smart cursor targeting that prioritizes useful interactions. Instead of always selecting the nearest object under the cursor, the module finds the most useful target along the ray in priority order.
- Lootable corpses first, then interactable game objects/portals, then interactable NPCs, then normal selection
- Dead non-lootable corpses can still be selected when nothing more useful is behind them
- Disabled inside battlegrounds to prevent targeting objectives through enemy players
Can replace SuperWoW's `Clickthrough()` toggle with always-on smart targeting that doesn't require a manual toggle and preserves the ability to select dead bodies when needed. Disable corpse-clickthrough in SuperAPI if you want this.
No configuration needed, install and forget.
**DLL:** `clickthrough.dll`
---
### Log Sessions
Organizes the combat, raw combat, and chat logs into per-character directories with timestamped filenames:
Organizes the combat, raw combat, and chat logs into per-character, per-day files:
```
Logs\<Realm>\<Character>\WoWChatLog_YYYYMMDD_HHMMSS.txt
Logs\<Realm>\<Character>\WoWCombatLog_YYYYMMDD_HHMMSS.txt
Logs\<Realm>\<Character>\WoWRawCombatLog_YYYYMMDD_HHMMSS.txt (superwow only)
Logs\<Realm>\<Character>\WoWChatLog_YYYY_MM_DD.txt
Logs\<Realm>\<Character>\WoWCombatLog_YYYY_MM_DD.txt
Logs\<Realm>\<Character>\WoWRawCombatLog_YYYY_MM_DD.txt (superwow only)
```
Every character login begins with a marker line (`COMBATLOG_SESSION` or `CHAT_SESSION`) identifying the character and realm.
If a log file for the same character was written to within the last 60 minutes, the same logfile will be used instead of creating a new one.
If today's log file for that character already exists, it is appended to instead of creating a new one, so a day of play stays in one file even across multiple logins or `/reload`s.
Lua API for addon developers:
@@ -63,6 +135,40 @@ Fixes duplicate floating heal numbers caused by SuperWoW 1.5. Only relevant if y
---
### Big Cursor
Upscales the hardware cursor for improved visibility without losing sharpness. Supports fractional scales from 1.0 (off) to 4.0.
- `/script SetCursorScale(1.2)` -- set cursor scale (default 1.2x)
- `/script SetCursorScale(1)` -- disable (use original 32x32 cursor)
This value is saved to the `cursorScale` CVar in tenths: `/script SetCVar("cursorScale", "15")` for 1.5x.
Lua API for addon developers:
- `SetCursorScale(n)` -- set scale factor (1.0-4.0), takes effect on next cursor change
- `GetCursorScale()` -- returns current scale factor
**DLL:** `bigcursor.dll`
---
### Performance
Engine-level optimizations that reduce CPU time on math, rendering helpers, file lookups, and data decompression.
- **SIMD Math** -- replaces 20+ internal math functions with SSE/AVX equivalents covering skeletal animation, particle rendering, frustum culling, collision detection, text glyph caching, and float-to-integer conversion
- **Data Decompression** -- swaps the game's 2004-era zlib with a modern library (2.2x faster). Loading screen times reduced by at least 13%
- **MPQ File Cache** -- caches archive file lookups so repeat file opens skip the archive chain walk. Saving 50-160ms every 15 seconds during heavy gameplay
- **Timer Calibration** -- recalibrates the client's RDTSC against the OS high-resolution counter for accurate animation timing, and raises the OS timer resolution to 0.5ms. Ported from [VanillaFixes](https://github.com/hannesmann/vanillafixes)
- **Lua Runtime** -- custom slab allocator (O(1) free/realloc), incremental/generational GC (turns the ~1s stop-the-world freeze into ~9ms chunks), faster string interning (~40% on `luaS_newlstr`), and a literal prefilter on `string.find`/`gfind`/`gsub` that kills the O(n²) backtracking addon combat log parsers inflict on every chat message
Most noticeable in cities, raids, during zone transitions, and in addon-heavy setups.
**DLL:** `weirdperformance.dll`
---
## Why No Source Code?
This project is distributed as pre-built DLLs only. The source code is not and will not be made publicly available.
@@ -70,3 +176,92 @@ This project is distributed as pre-built DLLs only. The source code is not and w
These DLLs work by hooking deeply into the game client's internals: memory layout, function addresses, rendering pipeline, input handling, and more.
While every feature here is built for legitimate quality-of-life use, the underlying techniques touch on too many core mechanisms that are trivially abusable.
Publishing the source would be handing a candy store to bad actors: the same hooks and patterns used to render a raid marker or fix a crash can be repurposed for cheats, exploits, and in particular automation with minimal effort.
---
## Developer Notes
### Runtime Module Control API
WeirdUtils exports three functions for querying and disabling modules at runtime in case other devs find their dll's in conflict.
#### Exported Functions
| Function | Signature | Description |
|---|---|---|
| `WeirdUtils_IsModuleActive` | `int __cdecl (const char *name)` | Returns 1 if the module is compiled in and currently hooked, 0 otherwise |
| `WeirdUtils_DisableModule` | `int __cdecl (const char *name)` | Unhooks the named module. Returns 1 if found, 0 otherwise |
| `WeirdUtils_DisableAll` | `int __cdecl (void)` | Unhooks all modules and core hooks. Returns count of modules disabled |
Module names are case-insensitive and match the released dll names:
`customassets`, `logsessions`, `transmogfix`, `minimapicons`, `healtextfix`, `bigcursor`, `worldmarkers`, `pngscreenshots`, `clickthrough`, `weirdperformance`
There is no re-enable API.
#### C/C++ Header
A header-only `include/weirdutils_api.h` is provided that handles DLL discovery and runtime resolution automatically. No .lib file needed:
```c
#include "weirdutils_api.h"
// Returns 0 if WeirdUtils isn't loaded - safe to call unconditionally
if (WeirdUtils_IsModuleActive("transmogfix"))
WeirdUtils_DisableModule("transmogfix");
```
The header tries all known DLL names (`weirdutils.dll`, `worldmarkers.dll`, etc.) via `GetModuleHandleA`, so it works regardless of which DLL variant is loaded.
#### Raw GetProcAddress
If you prefer not to use the header:
```c
HMODULE hMod = GetModuleHandleA("weirdutils.dll");
if (hMod) {
typedef int (__cdecl *IsActiveFn)(const char *);
IsActiveFn isActive = (IsActiveFn)GetProcAddress(hMod, "WeirdUtils_IsModuleActive");
if (isActive && isActive("transmogfix")) {
typedef int (__cdecl *DisableFn)(const char *);
DisableFn disable = (DisableFn)GetProcAddress(hMod, "WeirdUtils_DisableModule");
if (disable) disable("transmogfix");
}
}
```
### Version Query API
WeirdUtils registers a Lua global table and query function for addon developers to detect which modules are loaded and their versions. Available from the login screen onward.
#### `GetWeirdUtilsVersion()`
Returns the `WeirdUtils` table containing all enabled modules and their version strings:
```lua
local modules = GetWeirdUtilsVersion()
for name, version in pairs(modules) do
print(name .. " v" .. version) -- e.g. "dpslog v1.0"
end
```
#### `GetWeirdUtilsVersion("modulename")`
Returns the version string for a specific module, or `nil` if not loaded:
```lua
if GetWeirdUtilsVersion("dpslog") then
-- DPSLog is available, register for COMBAT_LOG_EVENT_UNFILTERED
end
local ver = GetWeirdUtilsVersion("minimapicons") -- "1.0" or nil
```
The `WeirdUtils` table is additive -- if multiple independent DLLs are loaded (e.g. `dpslog.dll` and `minimapicons.dll` separately), each adds its own modules to the shared table.
---
### Module Mutexes
Each module also holds a named mutex while active: `Local\WeirdUtils_<name>_<PID>` (e.g. `Local\WeirdUtils_framecrash_12345`). The exception is transmogfix, which uses `Local\TransmogCoalesceHook_<PID>` for legacy reasons.
If you see the mutex, the module is loaded - and can use the Runtime Module Control API to disable it. If you don't see it, the module isn't active and you're free to hook those functions yourself.
+80
View File
@@ -0,0 +1,80 @@
/*
* weirdutils_api.h - Runtime Module Control API for WeirdUtils
*
* Header-only, no .lib needed. Include this file and call the inline
* wrappers; they resolve the DLL exports at runtime via GetModuleHandleA
* and GetProcAddress. Returns 0 / no-ops if WeirdUtils is not loaded.
*
* Usage:
* #include "weirdutils_api.h"
*
* if (WeirdUtils_IsModuleActive("transmogfix"))
* WeirdUtils_DisableModule("transmogfix");
*/
#ifndef WEIRDUTILS_API_H
#define WEIRDUTILS_API_H
#include <windows.h>
#ifdef __cplusplus
extern "C" {
#endif
/* ---- Function pointer typedefs ---- */
typedef int (__cdecl *WeirdUtils_IsModuleActiveFn)(const char *name);
typedef int (__cdecl *WeirdUtils_DisableModuleFn)(const char *name);
typedef int (__cdecl *WeirdUtils_DisableAllFn)(void);
/* ---- DLL auto-discovery ---- */
static const char *const WeirdUtils__DllNames[] = {
"weirdutils.dll",
"worldmarkers.dll",
"pngscreenshots.dll",
"transmogfix.dll",
"customassets.dll",
"logsessions.dll",
"healtextfix.dll",
"bigcursor.dll",
"minimapicons.dll",
"clickthrough.dll",
"weirdperformance.dll",
NULL
};
static FARPROC WeirdUtils__Resolve(const char *func_name) {
int i;
for (i = 0; WeirdUtils__DllNames[i] != NULL; ++i) {
HMODULE hMod = GetModuleHandleA(WeirdUtils__DllNames[i]);
if (hMod) {
FARPROC proc = GetProcAddress(hMod, func_name);
if (proc) return proc;
}
}
return NULL;
}
/* ---- Inline wrappers (no-op if DLL not loaded) ---- */
static int WeirdUtils_IsModuleActive(const char *name) {
WeirdUtils_IsModuleActiveFn fn = (WeirdUtils_IsModuleActiveFn)WeirdUtils__Resolve("WeirdUtils_IsModuleActive");
return fn ? fn(name) : 0;
}
static int WeirdUtils_DisableModule(const char *name) {
WeirdUtils_DisableModuleFn fn = (WeirdUtils_DisableModuleFn)WeirdUtils__Resolve("WeirdUtils_DisableModule");
return fn ? fn(name) : 0;
}
static int WeirdUtils_DisableAll(void) {
WeirdUtils_DisableAllFn fn = (WeirdUtils_DisableAllFn)WeirdUtils__Resolve("WeirdUtils_DisableAll");
return fn ? fn() : 0;
}
#ifdef __cplusplus
}
#endif
#endif /* WEIRDUTILS_API_H */