Skip to content

Releases

Offhand 2.1.5 Pre-Release Beta 34

Choose a tag to compare

@N4UX-GIT N4UX-GIT released this 13 Nov 06:53

Offhand 2.1.5 Beta 34

Mainhand and native dialogs

  • Use /offhand centerline while spanned to show the Mainhand center and
    quarter marks. Run it again to hide them. The marks follow Mainhand when the
    viewport changes and mouse input passes through them.
  • On Forever, newly generated native XP and reputation bars center across
    Mainhand when Action Bar 1 is attached to the Micro Menu. They remain attached
    above Action Bar 1 as the menu and action bar are fitted. A rebuild can also
    center a matching overlapping Beta 32 XP anchor and a matching reputation
    anchor. Custom status anchors keep their saved placement.
  • On Forever, if Cooldown Manager's New Layout or Import Layout dialog
    would open off-screen or in a gap between monitors, Offhand recovers it onto
    Mainhand outside combat. This works from Cooldown Settings with Edit Mode
    closed. Reachable dialogs keep their positions.

EllesmereUI setup

  • Export a backup of the active EllesmereUI profile before spanning.
  • Preview the Offhand HUD profile during setup. The import asks for a unique
    profile name through EllesmereUI, so the existing profile remains available.
    You can also finish with the current profile.
  • If specialization assignments leave the new profile inactive, the wizard
    explains what happened. Follow the reload prompt when the imported profile is
    active and a reload is needed.

Workspace C preview

  • The paired portable Companion 2.1.9-beta.1 adds Workspace C in the custom
    layout editor. A plan can use Mainhand plus three workspaces on up to four
    physical displays. Use Identify Displays and check the preview before
    saving. The Companion checks the addon's workspace capability before spanning
    a three-workspace plan.
  • The addon reads the expanded layout formats and exposes Workspace C in its
    per-workspace options. Existing one- and two-workspace plans still load.
    Removing a workspace keeps its saved panel positions and sends its panels
    to the default workspace.
  • The portable beta also carries forward Companion 2.1.8 changes. Workspace
    Profiles explains when the current layout cannot save a profile. Display
    diagnostics identify a display with a missing stable identity and retain the
    most recent span bounds failure with the requested bounds, observed bounds
    and rollback result.

Installation and upgrades

  • Addon ZIP. Install through your addon manager or place its Offhand
    folder in your WoW client's Interface/AddOns folder. Your existing
    compatible Companion and manual setup remain supported.
  • Complete Windows ZIP. Includes the same addon and portable Companion
    2.1.9-beta.1 for Workspace C testing. Extract the ZIP and follow
    README-FIRST.txt. The standalone Companion ZIP contains the same executable.
  • The current Microsoft Store release is Companion 2.1.8. The in-game
    /offhand whatsnew notice lists it separately from the paired portable beta.
    Microsoft Store listing
  • On Forever, leave combat and close Edit Mode before using Offhand Settings
    → Recovery & Preview → Create Mainhand HUD Layout
    . Reload when prompted.
    Offhand keeps the source layout available. Existing manually placed bars can
    be adjusted through Blizzard Edit Mode.

Verification

The candidate passed 134 Lua suites and all six client manifest checks.

The contributor build was exercised in live Forever with simulated workspace
rectangles and a separate two-monitor span and restore. Four physical
displays, mixed-DPI/HDR spans, and the assembled Beta 34 build on live Retail
and Forever remain to be verified. Native popup and Trade recovery during
combat is still under investigation.

Downloads

Offhand v2.1.5 Pre-Release Beta 33

Choose a tag to compare

@N4UX-GIT N4UX-GIT released this 12 Nov 21:05

Offhand 2.1.5 Pre-Release Beta 33

This update fixes overlapping action bars on Retail and an overlapping XP bar on Forever when rebuilding a Mainhand HUD created in Beta 32. It also adds in-game release notes and clearer setup completion prompts.

Mainhand HUD and Edit Mode

  • Retail: Rebuilding a saved Beta 32 Mainhand HUD moves eligible default Action Bars 2 and 3 above Action Bar 1 and its status bars. The secondary rows stay spaced when the main bar sits higher on the screen. The rebuild preserves manually placed rows and Action Bar 1's existing status bar attachment.
  • Retail: Offhand applies the HUD when a saved layout takes over the slot index previously used by the active layout. This fixes a case where Edit Mode showed the expected layout as selected while its frames still used the old positions.
  • Forever: In newly generated native layouts, eligible XP, reputation, and secondary action bars follow Action Bar 1 when Mainhand fitting moves it. Rebuilding a Beta 32 layout repairs an overlapping XP bar when its anchor still matches the old generated position. A matching default reputation anchor can follow the repair. Custom status-bar anchors are preserved.
  • Retail and Forever: Rebuild recognizes the rounded offsets Blizzard writes when saving an Edit Mode layout across a restart. This lets Offhand identify eligible Beta 32 placements after relaunch.
  • Forever: Party and Raid Frame recovery waits for Edit Mode to finish closing and rechecks frames that have returned to a reachable display. When a targeted HUD repair would save the same active layout again, Offhand gives recovery guidance without prompting for another reload.

World Map and workspace compatibility

  • Forever, Blizzard World Map: With workspace persistence enabled, Escape keeps the open workspace map in place even if you haven't saved its position yet. A detached map can close normally with Escape when workspace persistence is disabled.
  • Forever, MoveAny and OpenMap: Offhand preserves workspace Escape behavior while the map addon manages placement. If OpenMap re-registers the map with Blizzard's close handling, Offhand restores workspace Escape protection even when the map has stayed in the same position.
  • Forever, map fading: Settings now explain Blizzard's movement fade. Use /console mapFade 0 to turn fading off while moving or /console mapFade 1 to restore it.
  • Forever, native backpack: The backpack checks whether it fits a custom workspace at 100% size as well as at custom scales. An oversized backpack can fall back to Mainhand while retaining its saved workspace placement.
  • Forever, EllesmereUI bags: Opening Talents keeps an eligible workspace bag open, including its reagent bag if it was already open.
  • Titan Panel: Popup recovery preserves both anchors of full-width Titan bars, keeping their width and placement.
  • Blizzard Queue Status: Offhand leaves the button's anchor under Blizzard Edit Mode control. Minimap diagnostics now include its frame state and report frame bounds when available.

Setup and release notes

  • A new Offhand workspace ready message highlights the workspace after setup and explains how to move the World Map, other supported windows, and HUD elements. If setup needs a reload, the message waits until the layout is ready.
  • An EllesmereUI HUD import prompts for a reload when the imported profile is active and requires one. If combat or the native Gamepad UI prevents the reload button from acting, Offhand shows the manual reload instructions.
  • What's New appears on the first login after an update. Dismiss it once per account, or reopen it any time with /offhand whatsnew. It provides copyable links to the full release notes and Microsoft Store and shows which Companion version last spanned the game when that information is available. A pending setup reload takes priority.
  • Help buttons have a clearer question-mark label. Each client manifest now loads the workspace scaling code and controls once.

Upgrading from Beta 32

If the bars overlap in your generated layout, close Blizzard Edit Mode and leave combat. Open Offhand Settings → Recovery & Preview → Create Mainhand HUD Layout, confirm the rebuild, then /reload when prompted. Your original Blizzard source layout remains available.

Downloads and installation

  • Addon only works with an existing compatible Companion or manual setup. Install the ZIP through your addon manager or copy its Offhand folder into your client's Interface/AddOns folder. Addon ZIP · SHA-256 checksum
  • Complete Windows bundle includes the same Beta 33 addon and the released portable Companion 2.1.5. Extract it and follow README-FIRST.txt. Manual panel sizing works with this bundle. Automatic workspace sizing estimates from Windows display scaling require Companion 2.1.7 or later. Complete ZIP · SHA-256 checksum

Verification

The archive passed 132 Lua suites and all six manifest checks. Live upgrade tests on Retail 12.1.5.70783 and Forever 1.60.1.70888 verified the overlap repairs, manual anchor preservation, and persistence after /reload with the native keyboard HUD out of combat. For layout reports, include your WoW client build, display arrangement, affected UI addons, and the output of /offhand diag full.

Offhand v2.1.5 Pre-Release Beta 32

Pre-release

Choose a tag to compare

@N4UX-GIT N4UX-GIT released this 11 Nov 20:58
9c6a58d
  • Set separate sizes for supported panels in each Offhand workspace from
    Workspace settings or calibration. Existing layouts keep their current sizes
    until you apply a change.
  • Preview sizes before applying them. With Companion 2.1.7, you can also
    estimate a size from the Windows scaling of the game and workspace displays.
    Manual sizing is available with older compatible Companion versions.
  • Reorganize settings so panel routing and sizing are together. Add help beside
    the settings it explains, and make setup and recovery prompts easier to follow.
  • Fit the World Map before panel reflow and recover unreachable map drag handles
    on Forever. Preserve native NPC interactions during single-screen recovery.
  • Keep comparison tooltips together, improve mixed-scale loot roll placement,
    and prevent saved input controls from reopening as workspace panels.
  • Improve Mainhand HUD fitting and EllesmereUI previews while preserving saved
    source layouts. Keep Forever Gamepad recovery available and repair a Retail
    action-bar placement case involving the default status bars.
  • Keep support reports concise by default. Use /offhand diag panels,
    /offhand diag tooltip, or /offhand diag debug for targeted troubleshooting.

Install

Install the ZIP through your addon manager or extract its Offhand folder into the Interface/AddOns folder for your WoW client. Back up your Offhand SavedVariables and upgrade over the existing addon. In a first setup, type /offhand guide in WoW. After applying a new Companion span, type /reload.

Use the Microsoft Store listing to get the Companion. Companion 2.1.7 provides the Windows scaling estimates. Earlier compatible versions still support manual panel sizing. Microsoft Store

Verification

The merged source passed 131 Lua suites and validation of all six manifests. A prior Forever 1.60.1.70888 live test verified that a visible native backpack resized from 75% to 100% after combat and the second workspace retained its size. For support, include the client and build, your display layout, and /offhand diag full.

Verify the addon ZIP with the attached SHA-256 checksum.

Offhand v2.1.5 Pre-Release Beta 30

Pre-release

Choose a tag to compare

@N4UX-GIT N4UX-GIT released this 11 Nov 00:14

Offhand v2.1.5 Pre-Release Beta 30

This is a public testing build. Back up your existing Offhand SavedVariables before installing and report regressions with the requested diagnostics.

Changes in this build

Loot-roll and UI compatibility hotfix

  • Fixed a case where remaining loot-roll windows could move to the screen seam
    after an earlier roll finished.
  • Keeps loot-roll windows in Mainhand when Blizzard rearranges the loot container.
  • Expanded EllesmereUI layout transfers to include supported cooldown, utility,
    cast, pet, stance and current-spec tracking bars, while keeping linked groups
    together.
  • Clearer EllesmereUI preview guidance for missing or disabled modules,
    dependencies, linked anchors and profile overrides. Empty override stores
    no longer block a transfer.
  • Improved Questie tracker and Social/Quick Join button compatibility so
    automatic window recovery preserves their anchors.
  • Retail now respects your friendly-player name-text preference instead of
    forcing names on.

Includes the fixes from Beta 29. Existing settings and layouts are preserved.
No Companion update is required.

Beta feedback: The placement fix passed spanned Forever testing with private
panels using Blizzard's loot-container functions. Real simultaneous loot choices
and combat behavior still need player verification. Native Retail preference
behavior, active Questie-objective dragging and populated tracking-bar imports
also need player feedback. Report issues with /offhand diag full, your
client/build and other UI addons.

Downloads

  • Recommended Windows Companion: Install from Microsoft Store for a Store-signed package and Microsoft-managed updates.
  • Portable / Linux / Wine Companion: download Offhand-Companion-v2.1.5.zip from the official GitHub release.
  • Complete package: Offhand-Complete-v2.1.5-beta.30.zip: addon and Companion together.
  • Addon only: Offhand-v2.1.5-beta.30.zip: install the contained Offhand folder in Interface/AddOns.
  • Companion package: Offhand-Companion-v2.1.5.zip: unchanged, byte-identical 2.1.5 archive, named for the Companion build rather than the addon release that carries it.
  • Standalone Companion: Offhand.exe: unchanged, byte-identical 2.1.5 executable.
  • Companion source release: v2.1.5.

Test focus

The loot-container correction passed a controlled before/after comparison in Forever 1.60.1.70862 with spanning applied. Removing the first of three private test panels moved the remaining panels to the seam with the prior code; this build kept both visible and centered inside Mainhand through native reflow and maintenance. No real items or roll choices were used. Real simultaneous loot rolls, expiration/queue behavior and combat still need player verification.

The release source passes 125 Lua regression suites and six manifest/syntax checks. This build includes the loot-container correction, expanded EllesmereUI layout transfers and dependency/blocker guidance, Questie/Social anchor preservation and the Retail friendly-name preference correction. The owner requested inclusion of these previously deferred addon changes. Companion and the existing DaylightUI implementation are unchanged; further Daylight testing remains deferred.

Earlier spanned Forever checks cover supported EllesmereUI cooldown/cast imports and reload, disabled-module guidance, controlled linked-anchor/override preview cases and Social/Quick Join anchor preservation. These scoped results do not establish exact reporter-profile acceptance. Native Retail preference behavior, active Questie-objective dragging, populated/spec-changing tracking-bar imports and combat remain unverified. Global tracking-bar groups are not transferred. Exact controller paths and physical portrait/4K layouts are not newly verified. Legacy Retail cleanup can restore a saved off preference once before returning control to the player.

Keep your existing profiles. Report regressions with /offhand diag full, the client/build, display arrangement and other UI addons. Companion 2.1.5 is unchanged; an already-working Companion does not need to be replaced.

Linux and Wine status

The Companion is still a Windows WinForms application. Wine support is experimental: run WoW and the Companion as the same user in the same WINEPREFIX and with the same Wine/Proton runner version. See Companion/Linux.md in the source repository for a Lutris example and extraction checks. Native Linux, X11, and general Wayland support are not claimed by this release.

Reporting issues

Use the GitHub issue tracker and include reproduction steps plus the diagnostics listed above.

Verification

The Companion is unsigned. Download it only from the official release linked above. Use the attached SHA-256 checksums to verify the downloads. All seven release assets were reproduced and attested by the Beta 30 release workflow. The addon ZIP matches the package submitted to CurseForge; Companion 2.1.5 is unchanged.

Full changelog

Offhand v2.1.5 Pre-Release Beta 28

Choose a tag to compare

@github-actions github-actions released this 09 Nov 03:10
dc5e9eb

Offhand v2.1.5 Pre-Release Beta 28

This is a public testing build. Back up your existing Offhand SavedVariables before installing and report regressions with the requested diagnostics.

Changes in this build

Guided setup and settings

  • Split placement into explicit Window is positioned, Reload UI and Confirm
    placement actions, with a final review. Add visual task cards, progress and a
    highlighted next action to the guide and calibration wizard.
  • Keep placement and HUD confirmation dialogs inside Mainhand before showing
    them, avoiding the shared popup stack's seam-to-top jump.
  • Improve settings header spacing, readable versions, Website/Discord links,
    typed slider values and consistent action styling. Show a compact Character
    scaling section when stronger workspace window locking is unsupported.
  • Correct the first-install calibration path that follows Next without choosing
    Auto-Configure. Explicit continuation now enables the validated layout while
    preserving calibration values. Source and packaged regressions pass. Native
    Forever 70862 Next activation, HUD creation and two reloads pass on the private
    span-setup-test1 single-display split. A second clean-account/default-Companion
    run also passes first HUD creation, reload and cold WoW/Companion restart.
    An independent repeat passes with zero Lua errors and cold in-world re-span
    plus reload retaining the same HUD.
    Exact reporter topology remains unverified.

Map, panels and compatibility

  • Apply native map scale to the map's actual Mainhand/workspace side. Preserve
    Auto Fit and explicit same-value presets without triggering unrelated layouts.
  • For the reviewed OpenMap v0.7.5-beta on Forever, route explicit scale actions
    through its own guarded settings and offer title recovery while preserving
    owner size/scale. Unsupported owners, combat and restricted UI retain guards.
    No third-party source patch is included in the add-on package.
  • Improve guarded Forever map Escape behavior, gamepad Back deferral, transient
    menu placement and HUD/EncounterBar ownership. Preserve custom-workspace,
    panel-routing, themes and background-library behavior from Beta 27.
  • Add translated setup/settings strings and retain locale fallback policy.

Matching Companion 2.1.5

  • Update all six add-on manifests and portable links to Companion 2.1.5 while
    retaining protocol 1 and minimum version 2.1.2-beta.19. No forced companion
    upgrade is introduced for previously compatible standard layouts.
  • Include the redesigned 2.1.4 dashboard: prominent Span/Restore, collapsed
    status with a concise indicator, stable Show/Hide sizing and dark scrollbars.
  • Add quiet, daily Store update availability checks and a static update action.
    The Store handles installation. Portable GitHub checks remain manual.
  • Retain the Store settings-save hotfix and existing monitor-identity, custom
    layout, scaling, taskbar and window-recovery safeguards. Type /reload in WoW
    after spanning or changing Mainhand/layout.

Validation and release status

  • Merged add-on: 114 Lua 5.1 regression suites pass before final package checks.
    New exact-package and release validation is recorded in
    docs/PUBLICATION-2.1.5-PREPARATION-20261109.md.
  • Companion uses the unchanged 2.1.5.1 executable submitted as Store package
    2.1.500.0. WACK passed all 13 required checks; one existing optional finding
    is reviewed. The local Defender scan found no threats, without a Microsoft
    file-review verdict or future detection guarantee.
  • Store Submission 6 is in certification with automatic publication enabled.
    The publisher chose to proceed without awaiting private-flight acceptance.
    Full Store-delivered upgrade, real Available and real signed-out/offline
    observations remain unverified. Exact combined-package live WoW, full
    physical mixed-DPI/hotplug/three-monitor, Wine and complete all-client
    combat/protected-action acceptance remain open, separately from prior scoped QA.

Downloads

  • Recommended Windows Companion: Install from Microsoft Store for a Store-signed package and Microsoft-managed updates.
  • Portable / Linux / Wine Companion: download Offhand-Companion-v2.1.5.zip from the official GitHub release.
  • Complete package: Offhand-Complete-v2.1.5-beta.28.zip: addon and Companion together.
  • Addon only: Offhand-v2.1.5-beta.28.zip: install the contained Offhand folder in Interface/AddOns.
  • Companion package: Offhand-Companion-v2.1.5.zip: unchanged, byte-identical 2.1.5 archive, named for the Companion build rather than the addon release that carries it.
  • Standalone Companion: Offhand.exe: unchanged, byte-identical 2.1.5 executable.
  • Companion source release: v2.1.5.

Test focus

  1. Back up SavedVariables, Companion preferences and native/replacement HUD layouts. Upgrade without deleting settings. Install the add-on separately from Store Companion.
  2. Use /offhand guide for first setup. Position WoW, acknowledge Window is positioned, reload, then review Confirm placement. Continue calibration using either the recommendation or Next and complete the HUD/reload steps. Verify a normal restart retains your setup.
  3. In Companion, review displays/Mainhand and click Span WoW Now. Type /reload after spanning or changing layout. Save plan stores choices only. Restore Window returns the previous geometry.
  4. Check custom workspaces, Flexible Layout, saved profiles, supported-panel routing, manual-position priority and region themes/backgrounds. Workspace layout > Use standard display layout returns to ordinary spanning.
  5. Check map scaling on Mainhand and Offhand, fixed presets and Auto Fit. Supported OpenMap remains its own owner. Test title recovery only when needed, outside combat; no third-party source patch is included.
  6. Check settings typed values/sliders, dialog alignment and normal native map/bag/menu behavior, including controller/combat where used. Include fresh Lua/taint evidence. Full exact-package native, physical mixed-DPI/hotplug/three-monitor and Wine coverage remain open.
  7. Store Companion can show a static Update available action after a quiet daily query. It opens Microsoft Store for installation; portable updates stay manual. Store 2.1.5 is in certification. Actual Store-delivered 2.1.5 upgrade, real Available and real signed-out/offline behavior remain unverified; publication proceeds at the owner's request without waiting for the private flight.

Linux and Wine status

The Companion is still a Windows WinForms application. Wine support is experimental: run WoW and the Companion as the same user in the same WINEPREFIX and with the same Wine/Proton runner version. See Companion/Linux.md in the source repository for a Lutris example and extraction checks. Native Linux, X11, and general Wayland support are not claimed by this release.

Reporting issues

Use the GitHub issue tracker and include reproduction steps plus the diagnostics listed above.

Verification

The Companion is unsigned. Download it only from the official release linked above. Use the attached SHA-256 checksums to verify the downloads. Locally prepared draft assets do not carry GitHub Actions build-provenance attestations; those are produced by the tagged release workflow.

Full changelog

Offhand Companion v2.1.5

Choose a tag to compare

@github-actions github-actions released this 09 Nov 03:10
dc5e9eb

Offhand Companion 2.1.5

Adds quiet update availability detection for Microsoft Store installations, with
a static Update available button and tray action. Checks start after the
dashboard loads and run at most once daily. Clicking the action opens Store;
the Companion does not download/install updates or restart itself. Portable
GitHub checks remain manual. Help/privacy explain the separate local cache.

Also includes the redesigned 2.1.4 dashboard: Span WoW Now and Restore Window at
the top, guidance beneath each button, a collapsed System Status indicator,
Configuration open by default, stable Show/Hide sizing and dark scrollbars.
Retains the 2.1.3 Store settings-save hotfix, custom workspaces/Flexible Layout,
monitor-identity/scaling safeguards and window recovery.

After spanning or changing Mainhand/layout, type /reload in WoW. Save plan
stores choices only; Span WoW Now applies them. Install the add-on separately.
The paired add-on is 2.1.5 Pre-Release Beta 28. Existing protocol-1 add-ons
remain compatible.

  • Recommended signed Microsoft Store installation.
  • Portable: Offhand-Companion-v2.1.5.zip, containing Offhand.exe, README.txt and LICENSE.
  • Exact EXE build 2.1.5.1, SHA-256 95811DBB7020A20E2541AE123E69FE80721C83A0FD52D0EE5557DD6D54DCCC2A.

Store Submission 6 is in certification, with automatic publication after approval;
public Store availability is not yet confirmed. Full flight acceptance was not
awaited at the owner's request. A real identity-bound NoUpdate query and cached
relaunch passed; Store-delivered 2.1.5 upgrade, real Available and real signed-out/
offline observations remain unverified. Manual Store access remains available.

WACK passed all 13 required checks, with one reviewed existing optional finding.
A local Defender scan found no threats. The portable EXE is unsigned and has no
Microsoft Defender file-review verdict; Store certification does not sign the
portable EXE or guarantee reputation. Check the attached SHA-256 checksums. Do
not disable antivirus or add exclusions to bypass a detection. Wine remains
experimental; physical display and complete client/combat coverage are not
established by automated checks.

Offhand v2.1.3 Pre-Release Beta 27

Choose a tag to compare

@N4UX-GIT N4UX-GIT released this 08 Nov 02:17
a2eee0c

Offhand v2.1.3 Pre-Release Beta 27

This is a public testing build. Back up your existing Offhand SavedVariables before installing and report regressions with the requested diagnostics.

Changes in this build

Matching Companion and add-on

  • Continue the add-on sequence as 2.1.3 Pre-Release Beta 27 in all six manifests.
    Companion retains clean version 2.1.3. Its EXE version
    is 2.1.3.9. Companion 2.1.3 is now published on Microsoft Store.
    Store installs Companion only; the matching add-on is separate.
  • Reuse the exact frozen portable EXE/ZIP matching the submitted Store executable.
    No runtime rebuild accompanies add-on reconciliation or publication packaging.

Custom workspaces and backgrounds

  • Standard spanning, game/workspace areas on one monitor, partial secondary-monitor
    areas, multiple workspaces and Flexible Layout, with visual area selection,
    previews, saved display plans and an option to return to standard layout.
  • Named in-game workspace profiles, supported-panel routing, manual-position
    priority, separate region themes and installed background-library images.
  • Retain Background Studio export/library support, per-region image/fit choices
    and theme fallback for missing images. General add-on profiles, workspace
    profiles and Blizzard HUD layouts remain separate.

Companion reliability and guidance

  • Map saved monitor identities to active Windows display targets rather than
    assuming the first monitor child belongs to an output. Handle stale, disabled,
    virtual and ambiguous display assignments with explicit review and safe refusal.
  • Improve scaling/layout, HDR/SDR diagnostics, taskbar presentation, Restore and
    failure rollback. Bounded graphics-reset recovery applies to Retail/Anniversary.
  • Refresh dashboard, Help and workspace editors, window icons and community links.
    Make Span WoW Now followed by manual /reload explicit after layout/Mainhand changes.

Add-on fixes and compatibility

  • Improve first-launch guidance, per-character setup and shared/character HUD
    reuse, explicit repair and recovery. Retain Ellesmere ownership and preview/import
    safeguards; imported or generated native layouts still require the user's reload.
  • Preserve native bag state, separate/combined ownership and permitted saved-root
    placement through keyboard/controller combat reopening on Forever. Cold,
    restricted, secret and replacement-owned roots retain their guarded deferral.
  • Preserve BetterBags/RestedXP and user-owned popup placement during automatic
    rescue. Improve native confirmation stacking, EncounterBar repair and external
    HUD ownership. Leave native map pin/content rebuilding to Blizzard on Forever.
  • Improve supported add-on settings/Kerzo Escape and reversible close-button
    policies, Kerzo reload restoration, ForeverPlus warnings, bubble-font ownership
    and Ellesmere toolbar refitting after settled display changes.
  • Retain Retail secret-value guards, workspace-aware tooltip/comparison bounds,
    native map/bag lifecycle and earlier Beta 26 onboarding/persistence fixes.
  • Complete existing EFIGS translations and the 44 custom-workspace keys across
    deDE, frFR, itIT, esES and esMX. Other locale dictionaries retain existing fallback
    policy. Native-language layout acceptance remains distinct from dictionary tests.

Verification and remaining acceptance

  • Combined add-on: 109 Lua regression suites and six TOCs/Lua 5.1 syntax passed.
    Broader Companion, publication and website verification is recorded in
    docs/PUBLICATION-2.1.3-PREPARATION-20261108.md.
  • Local WACK overall PASS, all 13 required tests passed; one optional finding is
    reviewed and retained. Local Defender scans were clean. The portable sample
    has no Defender file-review determination; local scans are not Microsoft approval.
  • Native evidence remains scoped to its documented clients, builds and scenarios.
    Physical mixed-DPI/hotplug/three-monitor, Wine, combined exact-package live WoW
    and complete combat/protected-action acceptance remain separate open coverage.

Earlier candidate notes: docs/2.1.3-DEVELOPMENT-CHANGELOG.md.

Downloads

  • Recommended Windows Companion: Install from Microsoft Store for a Store-signed package and Microsoft-managed updates.
  • Portable / Linux / Wine Companion: download Offhand-Companion-v2.1.3.zip from the official GitHub release.
  • Complete package: Offhand-Complete-v2.1.3-beta.27.zip: addon and Companion together.
  • Addon only: Offhand-v2.1.3-beta.27.zip: install the contained Offhand folder in Interface/AddOns.
  • Companion package: Offhand-Companion-v2.1.3.zip: unchanged, byte-identical 2.1.3 archive, named for the Companion build rather than the addon release that carries it.
  • Standalone Companion: Offhand.exe: unchanged, byte-identical 2.1.3 executable.
  • Companion source release: v2.1.3.

Test focus

  1. Back up Offhand SavedVariables, Companion preferences and native/replacement HUD layouts. Install the 2.1.3 Pre-Release Beta 27 add-on and Companion 2.1.3 without deleting settings. The Store installs Companion only.
  2. Start WoW in ordinary Windowed mode. Review checked displays and Mainhand. Save plan stores choices; Span WoW Now applies them. Type /reload after spanning or changing Mainhand/layout. Use /offhand guide for first setup.
  3. Test standard, single-monitor, partial-secondary, multiple-workspace and Flexible Layout plans that fit your setup. Review the preview, visual area selection, profile reload and missing-display safeguards. Use Workspace layout > Use standard display layout to disable custom areas.
  4. Check supported-panel routing, manual-position priority, independent region themes and installed background-library images. Keep general add-on profiles and Blizzard HUD layouts separate from workspace profiles.
  5. Verify Restore Window, relaunch, existing saved positions, native/replacement bag and map behavior, controller mode where used, and normal actions before/during/after combat. Include fresh Lua and taint evidence; source/simulated passes do not establish full hardware or protected-action coverage.
  6. Report client/build, display identities, arrangement/scaling, affected add-ons, steps and Display Diagnostics. Physical mixed-DPI/hotplug/three-monitor, Wine and full exact-package live acceptance remain separate checks.

Local WACK passed all 13 required tests; one optional blocked-executable finding was reviewed and retained. Local Defender scans were clean. The exact portable sample has not received a Defender review determination; Store certification and SmartScreen reputation are separate. Keep security protections enabled and report exact detections.

Linux and Wine status

The Companion is still a Windows WinForms application. Wine support is experimental: run WoW and the Companion as the same user in the same WINEPREFIX and with the same Wine/Proton runner version. See Companion/Linux.md in the source repository for a Lutris example and extraction checks. Native Linux, X11, and general Wayland support are not claimed by this release.

Reporting issues

Use the GitHub issue tracker and include reproduction steps plus the diagnostics listed above.

Verification

The Companion is unsigned. Download it only from the official release linked above. Use the attached SHA-256 checksums to verify the downloads. These prepared add-on archives were uploaded manually. They do not use the regenerated tag-workflow ZIPs or their provenance attestations. The portable Companion files retain their exact frozen hashes.

Full changelog

Offhand Companion v2.1.3

Pre-release

Choose a tag to compare

@N4UX-GIT N4UX-GIT released this 08 Nov 02:17
a2eee0c

Offhand Companion v2.1.3

Companion 2.1.3 is now published on Microsoft Store and available here as an exact portable build. The separately installed
Offhand add-on remains 2.1.3 Pre-Release Beta 27, not a stable add-on release.

  • Custom workspace plans, visual area selection, previews and named display-plan
    profiles, including single-monitor, partial-secondary and Flexible Layout options.
  • Active Windows display-target identities, safer stale/missing monitor handling,
    Windows scaling and HDR/SDR diagnostics.
  • Window recovery/Restore safeguards, fullscreen taskbar presentation and clearer
    setup, Help, editor and manual /reload guidance.

Microsoft Store remains the recommended Windows installation:
https://apps.microsoft.com/detail/9PL4PW84Q90W

Portable assets: Offhand-Companion-v2.1.3.zip and Offhand.exe.
Install the matching 2.1.3 Pre-Release Beta 27 add-on separately for the new
workspace integration. Run WoW in ordinary Windowed mode, review Mainhand and
Workspace layout, click Span WoW Now, then type /reload in WoW.

The portable EXE is unsigned. Verify the attached checksums and keep security
protections enabled. This exact sample has clean local Defender scans but no
Defender file-review determination. Store certification, portable signing and
SmartScreen reputation are separate. Previous Microsoft results concern other
hashes. See the source release records for the WACK results and acceptance limits.

EXE SHA-256: 88916B6FBAA4FF2E81EC574F8FA248C553ED531AD7A3DC828FF4948568797443

Portable ZIP SHA-256: C277105FEFA08B8A7EC7B089151D418960FF0378B449375BBBF56B2686AB816A

Offhand Custom Workspace Test 3 Revision 4 (Unofficial)

Choose a tag to compare

Unofficial, opt-in Discord test build. Test 3 Revision 4 pairs the updated Companion 2.1.3 Beta 6 with the matching Beta 26-based Flexible Layout add-on.

Download Offhand-Complete-custom-workspace-test3-r4.zip under Assets. This is a prerelease and does not replace the official release or the Microsoft Store version.

New in Revision 4

  • Monitor identity lookup now follows each display's active Windows display path, rather than assuming its first monitor entry identifies the active monitor. This closes a remaining gap in the earlier monitor-ID correction where stale entries could give two checked displays the same identity.
  • Old migration aliases are retained only when they match the active monitor target. Missing or ambiguous bindings require review instead of silently assigning another monitor.
  • Copied Display Diagnostics now include identity lookup details even when a display layout cannot be confirmed.

The reported Beta 20 selection error cleared after the reporter restarted their PC. That confirms a workaround, but their exact cause and acceptance of this new executable remain unconfirmed.

Matching add-on and workspace features

The add-on runtime is the same reconciled source as Revision 3, with the in-game label [Workspace Test 3 r4]. It combines the Beta 26 baseline, the previously reconciled local add-on candidates and Test 3 workspace features, including Flexible Layout.

Included features remain custom single/multiple-monitor workspaces, named workspace profiles, supported-panel routing, independent region themes and installed custom background libraries. Earlier onboarding, per-character HUD setup/reuse, Forever controller, native bag/map, Ellesmere compatibility, aura ownership, native-dialog, Retail secret-value, tooltip placement and French text candidates remain included.

Companion retains its Beta 6 version label. Use TEST-BUILD.json, the package name and checksums to identify this Revision 4 executable. Previous Revision 3 downloads do not gain this correction.

Install or update

  1. Close WoW and exit any running Companion through its tray menu. Back up the installed Offhand folder, Offhand SavedVariables and Companion preferences.
  2. Extract the ZIP to a writable folder. Copy its Offhand folder into your test client's Interface/AddOns, without an extra nested Offhand folder. Run the extracted Offhand.exe.
  3. Start WoW in ordinary Windowed mode with the included add-on enabled. For first setup, type /offhand guide and choose Use Companion.
  4. Review the checked displays and Mainhand (game). If asked to review old monitor identities, confirm the intended monitors. For custom layouts, open Workspace layout, review and save the plan.
  5. Click Span WoW Now, return to WoW and /reload once. Complete the in-game setup guide where needed.

Restore Window returns to the remembered ordinary window. Workspace layout > Use standard display layout turns off custom workspaces. A saved plan does not resize WoW until applied. See README-FIRST.txt for rollback and further guidance.

Verification and test focus

All 15 Companion regression suites passed, including 178 display identity/migration checks per architecture, 3057 native rollback/Restore assertions per architecture on synthetic windows, named profiles, missing-display handling, workspace geometry, schema 1/2/3 bridges, Remote Desktop planning, taskbar behavior, recovery, UI/scaling and interaction-boundary checks.

All 101 add-on Lua suites, six manifests and Lua 5.1 syntax checks passed. Fresh processes using the exact Revision 4 executable loaded named custom profiles saved by the actual Revision 3 executable, retaining both choices of game monitor, workspace assignment and region geometry. Local native reads returned distinct active targets for the physical monitor pair. Package contents and hashes were verified.

Test identical-resolution monitors, docks, disabled connected outputs, virtual displays and reconnects where available. Check initial Span/Restore, reopening Companion, saved roles/profiles, reload, routing, themes, backgrounds and affected native/replacement panels. Include Test 3 Revision 4, client/build, monitor arrangement/scaling, steps, expected/observed behavior and fresh Lua errors. Copy Display Diagnostics for monitor problems.

Remaining acceptance: combined-package live WoW behavior, affected reporter hardware, physical hotplug, mixed DPI, three physical displays, Wine, remote-session hardware coverage and complete combat/protected-action testing. Synthetic windows and read-only native queries do not establish those results.

Known Forever controller behavior: choosing Game Menu from Blizzard's radial closes open workspace panels, including the combined backpack.

Security and provenance

This portable executable is unsigned and has not been submitted to Microsoft Defender for review. A local Defender scan of this exact ZIP found no threats, using definitions 1.463.176.0 with real-time protection enabled. That is not Microsoft approval or a guarantee against SmartScreen/antivirus detections. Keep protection enabled and report the exact detection if flagged.

This correction reads Windows display configuration; no game-memory access, injection or simulated input was added. No Blizzard approval, anti-cheat certification or GitHub Actions build attestation is claimed.

Verify the download against checksums-sha256.txt. ZIP SHA-256:
AB05C0D8E44194226547E15724A9F44B651A692F4AFD1A8E27C36E24D570C204

Source: 5a71a02c2da3e434195c4163a4edd982045302ad. The included receipt records the executable and source hashes. Frozen official Companion artifacts remain unchanged.

Offhand Custom Workspace Test 3 Revision 3 (Unofficial)

Choose a tag to compare

Unofficial, opt-in Discord test build. Revision 3 pairs Companion 2.1.3 Beta 6 with the current reconciled addon source. Download Offhand-Complete-custom-workspace-test3-r3.zip under Assets.

The included addon combines the Beta 26 baseline, the current local addon candidates, and the workspace features from Test 3. Its in-game label is [Workspace Test 3 r3], and its addon release metadata is Beta 26.

Included

  • Custom workspaces and Flexible Layout, named workspace profiles, supported-panel routing, independent workspace themes and installed background libraries.
  • Current account onboarding and per-character HUD setup/reuse.
  • Current Forever controller, bag/map, Ellesmere layout-preview and compatibility candidates, with expanded diagnostics.
  • Retail secret-value guards and tooltip comparison placement within the selected workspace.
  • Local follow-up guards for Ellesmere player aura bars, user-placed native dialogs, and French text corrections.

Install

  1. Close WoW and Companion. Back up the installed Offhand addon, SavedVariables and Companion preferences.
  2. Extract the ZIP. Copy its Offhand folder into the test client's Interface/AddOns and run the extracted Offhand.exe.
  3. Enter the game in Windowed mode with the included addon enabled. For initial setup, type /offhand guide and choose Use Companion.
  4. In Companion, open Workspace layout, select and save a plan, then click Span WoW Now and /reload in WoW.

Restore Window undoes the current span. Workspace layout → Use standard display layout turns off custom workspaces. See README-FIRST.txt for setup, rollback and reporting.

Validation and test focus

All 101 Lua suites, six manifests and Lua 5.1 syntax checks passed. Companion schema 1/2/3 bridges, named profiles and partial-topology tests passed. Live acceptance of this combined package, protected actions/combat, mixed DPI, physical third-monitor behavior and monitor reconnects remain pending.

Test setup on new/returning characters, HUD layout reuse, span/reload/restore, workspace profiles, panel routing, themes and affected native/replacement panels. Include your client/build, monitor layout/scaling, steps and fresh Lua errors in reports.

Known Forever controller behavior. Choosing Game Menu from Blizzard's radial closes open workspace panels, including the combined backpack.

Security

The portable executable is unsigned. Microsoft submission is pending. A local Defender scan found no threats in the revision 3 ZIP, including the packaged executable. Checksums are attached. If security software flags the package, keep protection enabled and report the exact detection.