Wuddle brings addon management, DLL mods, MPQ patches, profiles, game launching, updates, and client-specific tools into one application for Vanilla 1.12.1, TBC 2.4.3, and WotLK 3.3.5 clients.
| Linux | Windows |
|---|---|
TL;DR: To avoid issues, every game installation directory where you intend to use the Mods tab should be whitelisted in your antivirus software.
If any mod fails to install, or if Windows Defender displays a notification as you install a mod, you need to whitelist your game install folder.
Various legacy DLL mods, including projects such as SuperWoW, UnitXP_SP3, and Nampower, are known to trigger false positives in antivirus software.
Wuddle warns you before installing known false-positive-triggering mods from the Quick Add list.
But since Wuddle performs the download and installation of these mods, your antivirus software may attribute the detection of a threat directly to Wuddle.exe itself.
The most reliable solution is to whitelist your game installation folder in your antivirus software.
If this sounds sketchy, Wuddle is open source and the code is available here on GitHub for you to inspect.
So to simplify the user-experience, Wuddle creates a hidden .wuddle cache/staging folder inside the game installation's root directory. This is where all Mods, Addons, MPQs and so on land when they first downloaded, Wuddle then moves the files to their target directories.
This makes things easier since you'd have to whitelist the game directory (or individual files) anyway, when installing DLL mods that trigger false-positives.
Screencast_20260414_150926.webm
- Install, update, reinstall/repair, and remove addons.
- Install from Git repositories, GitHub releases, direct
.zip/.7zURLs, or local archives. - Supports GitHub, GitLab, Codeberg, Gitea, and compatible Git repositories.
- Handles addon collections, nested addons, multiple
.toclayouts, and version-specific addon choices. - Compatible with existing GitAddonsManager-style addon layouts (but no guarantees).
- Detects locally modified tracked addons before replacing them.
- Install, update, repair, and remove DLL-based client mods.
- Enable or disable DLLs without uninstalling them through managed
dlls.txtentries and by appending.disabledto file names. - Supports direct DLL assets plus
.zipand.7zrelease packages. - Quick Add provides curated client-specific mods and companion addons.
- Install and manage custom MPQ patches from local files or archives.
- Detect existing custom, disabled, locale-specific, and core client MPQs.
- Rename, classify, protect, enable, disable, move, replace, and remove supported patches.
- Uses conflict checks, backups, and rollback when replacing existing files.
- Includes curated patches such as WDM and Project Epoch Water through Quick Add.
- Keep separate profiles for different WoW installations or servers.
- Each profile tracks its own addons, mods, patches, launch settings, and update state.
- Launch directly, through a custom command, or through supported external launch methods.
- Optional per-profile tab visibility keeps unsupported or unused management areas hidden.
- Starting Wuddle a second time focuses the existing window instead of opening another copy.
- When Awesome WotLK is installed, Wuddle offers easy patching of
Wow.exeto enable Awesome WotLK while retaining a backup. - When wow-optimize is installed, Wuddle provides an in-app shortcut to launch the wow-optimize launcher which acts as a configurator, directly from Wuddle.
- Optional Auto-Login (requires Awesome WotLK) stores account credentials in Windows Credential Manager or Linux Secret Service.
- Concurrent update checks for Git repositories, release-based mods, and curated patches.
- Stable and Beta self-update channels.
- Optional GitHub authentication and API-conservation controls.
- Install/update staging, ownership tracking, conflict checks, backups, and rollback.
- Backup and restore Wuddle profiles, settings, and tracked-project metadata.
- Reset Wuddle with an automatic recovery backup while leaving WoW installations and deployed game files alone.
- Privacy-sanitized verbose diagnostics for troubleshooting.
Wuddle is aimed at legacy WoW clients rather than modern Retail/Classic clients.
| Expansion | Client version | Features |
|---|---|---|
| Vanilla | 1.12.1 | Addons, DLL mods, MPQ Patches, Vanilla-Tweaks |
| The Burning Crusade | 2.4.3 | Addons, DLL mods, MPQ Patches |
| Wrath of the Lich King | 3.3.5 | Addons, DLL mods, MPQ Patches, optional Auto-Login |
Wuddle may still work with these clients since much of its profile and launch functionality is not tied to a specific client version.
Even DLL mods and MPQ patches might work on newer clients up to around Legion (7.x).
However, there has been NO testing at all for these clients, and no support is offered to them. So please do not open issue tickets related to unsupported clients.
- Quick Add and Direct Archive Installs — Fixed a v3.7.0 regression where legitimate GitHub and GitLab redirect hosts were rejected as untrusted, blocking Quick Add mod installs and direct
.zip/.7zURL installs with a "Blocked asset host" error.
v3.x Changelog
- Backup and Restore — Export profiles, preferences, launch settings, and tracked addon/mod/patch metadata into one backup ZIP, or import a backup or older Wuddle installation. Restores are validated and staged before restart, with the previous data retained as a rollback copy.
- Reset Wuddle — Start over through an explicit confirmation, with an automatic safety backup and a choice to retain or remove system-vault credentials. WoW installations and deployed addon, mod, and MPQ files remain untouched.
- Fixed Windows Self-Updates — Portable updates no longer fail with
os error 32while validating the staged executable. - Responsive Backup Dialogs — Backup and Restore workflows grow as previews and controls appear, while keeping headers and action buttons visible and making smaller layouts scrollable.
- Reliable Restore Staging — Backups and older installations using SQLite WAL mode are converted into portable database snapshots before restoration.
- Single-Instance Activation — Starting Wuddle again on Windows now restores or requests attention from the existing window instead of displaying a file-lock error.
- One-Time Manual Update May Be Required — Windows users on an affected beta may need to download this release manually. Extract it over the existing folder, or import the old folder through Backup and Restore in the fresh copy.
See the full changelog for the technical details.
- Right-Click Copy and Paste — Editable text fields throughout Wuddle now provide a consistent, themed context menu.
- Selection-Aware Editing — Copy uses the current selection, while Paste replaces it or inserts text at the existing caret position without moving the caret when the menu opens.
- Safe Password Pasting — Secure password fields allow Paste without exposing their contents through Copy or diagnostics.
- Reliable Modified Addon Detection — Rescanning now identifies edited, deleted, and newly added files in Wuddle- and GAM-managed Git addons.
- No Extra API Usage — Modification detection compares against the local checked-out Git revision without contacting GitHub.
- Manual Addons Left Alone — Addons without a local Git baseline are excluded from modification scanning.
- Clearer Warnings and Diagnostics — Modified status is retained reliably, while prompts and privacy-safe logs better explain why an addon was flagged.
- Safer Updates for Modified Addons — Wuddle now asks whether to cancel, ignore future updates, or explicitly overwrite when an addon contains local changes.
- Better Batch Behavior — Update All completes unaffected projects before grouping modified addons into one confirmation dialog.
- Real Update Ignoring — Ignored projects are excluded from automatic and manual checks before any network or GitHub API request.
- Windows Line-Ending Fix — Normal CRLF/LF differences are no longer mistaken for local addon edits, further addressing Issue #18.
- Faster Update Checks
- Git repositories, release-based projects, and curated MPQ patches now check concurrently through separate bounded workloads.
- New checks begin as soon as a worker becomes available without weakening cancellation or timeout safeguards.
- More Reliable Repository Updates
- Stale and duplicate cached update entries are discarded when repositories are removed, replaced, or reloaded.
- Update All now skips vanished repositories instead of aborting the remaining batch.
- This is intended to address Issue #18, which remains open pending reporter confirmation.
- Reliable Lutris Launching
- Lutris launches are isolated from saved Custom command fields, preventing hidden Custom values from replacing the Lutris executable or arguments.
This beta completes a full security, reliability, and data-integrity review of Wuddle, addressing 75 documented findings.
- Safer Installs and Removals — Addons, mods, DLLs, and MPQs now use stronger staging, ownership checks, backups, and rollback handling.
- Stronger Security and Privacy — Hardened downloads, archives, README previews, redirects, credentials, diagnostic exports, and release assets.
- Reliable Profile Isolation — Delayed background work can no longer affect the wrong profile, database, dialog, or WoW installation.
- More Dependable Updates — Added bounded Git operations, cancellation, stronger cache validation, accurate multi-file checks, and safer API budgeting.
- Verified Self-Updates — Linux and Windows updates now validate exact packages and digests while retaining rollback copies.
- Launcher and Platform Hardening — Improved Windows version selection, restart handoff, single-instance ownership, Linux portable paths, and window restoration.
- Better MPQ Behavior — MPQ changes are more transactional, local patches are no longer incorrectly treated as remote repositories, and multi-file packages now have clean names plus a unified package editor.
- Expanded Diagnostics — Meaningful actions, file changes, metadata commits, failures, and rollbacks are now easier to trace without exposing private data.
- Window Position Memory
- Added an optional setting to remember Wuddle’s window size and position across restarts.
- Improved Platform Integration
- Added proper Windows executable icons, metadata, and application identity.
- Improved Wuddle’s icon identification on Linux desktops and Wayland.
- Update Check Deadlock — Fixed an expired GitHub rate-limit record potentially leaving Wuddle permanently stuck checking for updates.
- Linux Update Restart — Fixed Wuddle closing without restarting after installing an AppImage update.
- More Reliable Update Checks
- Prevented local file and antivirus scanning from indefinitely blocking update checks.
- Added a 30-second timeout and disabled further checks until restart after a timeout.
- Kept missing-file detection within the explicit Rescan/Repair workflow.
- Clearer Busy Indicator — Hovering the spinner now explains what Wuddle is working on, including repository progress and elapsed time.
- Conserve GitHub API — Added an optional setting for reducing anonymous GitHub API usage.
- Infrequently updated projects follow a longer update schedule.
- Their status now persists across profile switches.
- The setting automatically becomes inactive when unnecessary.
- Improved Diagnostics — Verbose logs now record privacy-safe update-check stages, timings, outcomes, and file-verification progress.
- Parallel repository checks are tracked independently.
- Exported summaries include the active operation when diagnostics are created.
- Improved Notifications — Added a smooth lifetime indicator to notifications.
- Hovering pauses and resets the timer.
- Lengthy tooltips and API-limit warnings are formatted for easier reading.
- Reliable Shutdown — Closing Wuddle now reliably terminates blocked background work on Windows and Linux, preventing invisible processes from blocking future launches.
- Update Check Stability — Duplicate update checks are ignored, preventing overlapping operations after waking from sleep or repeatedly pressing the update button.
- Clearer GitHub API Limit Feedback
- Wuddle now explains when GitHub's anonymous hourly limit has been reached and approximately when it resets.
- Notifications link directly to GitHub Token settings and consistently cover previews, updates, Quick Add, curated patches, and other GitHub operations.
- Invalid or expired token errors now provide clearer guidance.
- Consistent Settings Icons
- Replaced platform-rendered cogwheel emoji with a bundled SVG across profile editing, Auto-Login, configuration actions, and file details.
- Added theme-aware idle and hover colors with consistent sizing across UI scales while keeping the main Options icon vis
0 comments
log in to comment.