AutoSetup is a World of Warcraft addon that automatically applies per‑resolution profiles for:
- Edit Mode layouts (base layout + optional combat/target layout)
- UI scale
- AddOn enable/disable sets
- The game's Damage Meter (on, off or left alone)
When you play on different devices (e.g. PC monitor, laptop, Steam Deck, TV) that run WoW at different resolutions, AutoSetup detects the current resolution and applies the right profile without you touching Edit Mode or the AddOns screen.
Works on Retail and WoW Forever.
With a newborn child, playtime is short and precious.
Switching between PC, laptop, and Steam Deck meant that every session started with:
- Manually picking the correct Edit Mode layout for that device
- Toggling a different set of addons on or off
- Adjusting UI scale so things were readable on small screens
AutoSetup removes that friction: once profiles are configured, you log in and just play. The addon quietly applies the correct layout, scale, and addon set based on the resolution WoW is currently running at.
-
Per‑resolution profiles
- Each profile is keyed by resolution (e.g.
1920x1080,1280x800). - Store a friendly name, base layout, optional target/combat layout, scale, and addon set.
- Each profile is keyed by resolution (e.g.
-
Base + target layout support
Baselayout is used out of combat / no target.- Optional
Targetlayout is used when:- you are in combat, or
- you have a target / soft enemy.
-
AddOn set management
- Per‑profile addon map: enable some addons, disable others.
- Supports addon names with spaces and resolves titles (e.g.
Midnight Viewport) to folder names. - Only touches the addons you list; everything else is left alone.
-
UI scale per profile
- Optional override for
uiScaleper resolution.
- Optional override for
-
Damage Meter per profile
- Each profile can turn the game's Damage Meter on or off, or leave it alone, which is what a new profile does. No reload needed.
- It is the same switch as the game's advanced options, not Edit Mode's Damage Meter checkbox, which only controls the preview shown while placing it.
- Leave alone changes nothing, and nothing restores an earlier value: a profile that needs the Damage Meter on after a profile that turned it off should say On.
-
Native controller support per profile (WoW Forever only)
- Optional flag marking whether a profile expects WoW Forever's built-in native controller support to be on or off (e.g. on for a Steam Deck/couch profile, off for a mouse-and-keyboard profile).
- This setting doesn't exist on any other flavor, so the checkbox is hidden entirely unless AutoSetup detects it's running on Forever.
- AutoSetup switches it at login/reload and then reloads the UI once by itself, which is when the switch takes effect (the game's own checkbox reloads too). The game logs an "action blocked" error for AutoSetup when this happens; the switch works regardless.
- The game doesn't let addons change it later in a session (e.g. right when you switch resolutions), and AutoSetup never reloads by itself in combat or twice in a row. In those cases it shows the "reload required" popup instead. Edit Mode is left untouched until the setting matches the profile.
-
Non‑intrusive behavior
- Never changes your actual resolution; it only observes it.
- Skips layout and addon changes in combat to avoid taint.
- Avoids redundant layout switches and stutter when you're already on the right layout.
- Switches layouts quietly: AutoSetup's own switches print no "layout applied" line in chat. A layout you pick in Edit Mode yourself, or the one a specialization change brings, still shows Blizzard's message.
- Copy the
AutoSetupfolder into:World of Warcraft/_retail_/Interface/AddOns/AutoSetup/
- Restart WoW or run
/reload. - Enable AutoSetup on the AddOns screen.
You can configure AutoSetup via:
- Settings → AddOns → AutoSetup, or
- The slash command:
/autosetup(alias:/as)
In the options panel:
- Resolution
- Click Use Current to fill in the current resolution (e.g.
1920x1080).
- Click Use Current to fill in the current resolution (e.g.
- Profile name
- Any descriptive name (e.g.
PC 1440p,Steam Deck,Laptop).
- Any descriptive name (e.g.
- Base Edit Mode layout
- Either type the layout name or click Pick Layout to choose from existing Edit Mode layouts.
- Leave blank if this profile has native controller support enabled: controller mode uses its own hidden default layout that doesn't appear in the layout picker, and a keyboard/mouse layout can't be applied while controller mode is active anyway. AutoSetup skips Edit Mode entirely for such profiles and lets the client manage it.
- Target layout (optional)
- Optional alternate layout used while in combat or when you have a target.
- Leave blank if you only want one layout for this resolution, or if this profile has native controller support enabled (same reason as above).
- UI Scale
- Tick Set UI scale and adjust the slider for a per‑profile UI scale. Unticked leaves the scale alone.
- Damage Meter
- Click the button to step through
Damage Meter: Leave alone,OnandOff. - On and Off apply whenever the profile is applied. In combat the change waits until combat ends.
- Click the button to step through
- Enable native controller support (only shown on WoW Forever)
- Check this if the profile expects WoW Forever's native controller support to be on (leave unchecked for keyboard/mouse profiles).
- AutoSetup switches it at the next login/reload and reloads the UI once by itself to finish. Mid-session (e.g. right after you save the profile or switch resolutions) it shows the reload popup first. Edit Mode is left alone until the setting matches the profile.
- AddOns
- Comma/semicolon‑separated list of addons to enable/disable:
WeakAuras, Details, Midnight ViewportWeakAuras, !Details, !Midnight Viewport
Name= enable that addon!Name= disable that addon- Names can be either folder names or titles from the AddOns list; the addon resolves them internally.
- Addon features (no reload needed):
Addon:featureswitches a single feature of a supported addon instead of the whole addon, e.g.QoL:viewportturns the Viewport of Quality of Life on and!QoL:viewportturns it off (QoL=viewportworks too). It is applied live whenever the profile is evaluated. If the addon isn't loaded, the entry is skipped.
- Comma/semicolon‑separated list of addons to enable/disable:
- Click Save / Update to store the profile for that resolution.
Saved profiles are listed in the scrollable list at the bottom:
- Edit: loads the profile back into the form for changes.
- X: deletes the profile for that resolution.
-
On login /
/reload(once, not again after loading screens):- As soon as Edit Mode's layouts are loaded, AutoSetup detects the current resolution and applies:
- Scale (if set)
- Base or target layout (depending on combat/target state)
- Addon set (enabling/disabling only the configured addons) and addon features
- Damage Meter (if the profile says On or Off)
- As soon as Edit Mode's layouts are loaded, AutoSetup detects the current resolution and applies:
-
When resolution changes (e.g. window resize, different screen), or you save a profile or delete the current resolution's:
- AutoSetup reapplies the matching profile (if any).
-
When combat/target state changes:
- AutoSetup re‑evaluates whether to be on the base or target layout and switches only if needed. Scale, addons, features and the Damage Meter are left alone.
- While Edit Mode is open it doesn't switch layouts; it catches up when you close Edit Mode.
If AutoSetup detects that addons need to change for a profile, or that native controller support needs a reload it won't do by itself, it shows a popup with Reload UI and Later buttons so you can apply those changes when it's convenient. If more than one thing needs a reload at the same time, the popup lists each reason on its own line rather than showing them one at a time.
Use:
/autosetup debug
This will:
- Print the current resolution.
- Dump the recent internal debug log (layout switches, resolution changes, etc.) to chat for troubleshooting.
- AutoSetup never changes your screen resolution.
- It avoids making changes while you are in combat.
- AutoSetup itself is never disabled by its own addon set configuration, even if you accidentally list it with a
!.