Getting started
After you install ForeverUI and log in, its frames replace the game's. Here's how to find the options and put things where you want them.
The current release is 0.3.0. The addon has moved on since that release: 30 more modules and 14 more commands are written and waiting for the next release, which isn't out yet. This site marks those Next release. They are not in v0.3.0.
Open the options
- Type
/fui(or/foreverui) in chat./fuiagain closes it. - Or left-click ForeverUI on the game's addons button by the minimap. Right-click it to turn move mode on or off.
- Or the ForeverUI button at the top of the game menu (Escape). Next release
The options window has a page per area. Use Search settings at the top to find a setting: pages that don't match fade, and Enter opens the first match. Some changes need a reload: the window then says “Some changes need a reload” and shows a Reload now button. Every page and setting is listed on Settings.
Source: Core/Options.lua (ForeverUI_OnAddonCompartmentClick), Core/OptionsWindow.lua, Core/Slash.lua in the ForeverUI addon repository.
Move your frames
- Type
/fui unlock(or/fui move), or click Move frames under General → Layout. Every ForeverUI frame gets a drag handle. - Drag a handle to move that frame. Click a handle, then the arrow keys nudge it (Shift: 10 px).
- Right-click a handle for its exact anchor and offsets; the next release adds its scale (50% to 200%) and opacity (10% to 100%) there too Next release.
- Type
/fui lockwhen you're done.
While moving: /fui grid [size|on|off] shows a grid (size 8 to 256 px) and /fui snap on|off snaps frames to each other. /fui frames lists the movable frames and /fui reset <frame|all> puts one (or all) back. Unlocking doesn't work during combat.
Source: Core/Slash.lua (HELP, gridCommand), Core/Options.lua (layoutRows), Core/Movers.lua in the ForeverUI addon repository.
Pick an accent color
Click a swatch under /fui → General → Look, or type /fui accent <name> with one of these names (or any rrggbb color). /fui accent reset puts the default back.
- brass (default) #d9a441
- arcane #5aa2f0
- fel #5bcb7e
- void #a47bf0
- ember #e0664b
Source: Core/Theme.lua (T.PRESETS), Core/Slash.lua (accentCommand) in the ForeverUI addon repository.
Keep the game's version of something
Every part of ForeverUI is a module you can turn off under /fui → Modules (or /fui disable <module>, then /reload). The options say: “A module that's off builds nothing and costs nothing.” The list is on Features.
The setup wizard Next release
The setup wizard isn't in the current release. It is written and waits for the next release. This is what it will do, read straight from the addon's code.
The first time you log in on an account, a 4-step wizard (“Set up ForeverUI”) opens: Layout, Screen, Look, Move things. It waits until you're out of combat (it says “Setup opens when combat ends.”). Done, the close button and Escape all end it, and it doesn't come back on its own: /fui setup reopens it.
Step 1 · Layout
“How do you mostly play? You can change it all later in /fui.”
| Layout | What it does |
|---|---|
| Centered: damage and tanking Default | Your frames around your character; party and raid just above your player frame. |
| Centered: healing | Party and raid centered above your frames, click casting on. |
| Like the game's | Your frames at the top left as the game has them, party and raid down the left side. |
Step 2 · Screen
“Sizes for your screen. You can change them later in /fui.” The preset that matches your screen is marked “· your screen”; on a screen under 1000 pixels tall, “Keep my current sizes” is picked.
| Preset | Made for | What it sets |
|---|---|---|
| 1080p | 1920 x 1080 | UI scale 80%, action buttons 38 px, raid tiles 100 x 48, text 100%. |
| 1440p | 2560 x 1440 | UI scale 70%, action buttons 38 px, raid tiles 110 x 48, text 105%. |
| 4K | 3840 x 2160 | UI scale 65%, action buttons 38 px, raid tiles 110 x 48, text 110%. |
| Ultrawide | 3440 x 1440 | UI scale 70%, action buttons 38 px, raid tiles 110 x 48, text 105%. |
| Keep my current sizes | any screen | Changes nothing: your UI scale and frame, button, tile and text sizes stay as they are. |
Step 3 · Look
Pick an accent color (the swatches below) and a raid frame style: Softened (Class colors, softened), Dark (Dark, class-colored names), Bright (Class colors, bright).
Step 4 · Move things
- “Your frames are unlocked: drag a handle to move that frame.”
- “Click a handle, then the arrow keys nudge it (Shift: 10 px).”
- “Done locks them. /fui unlock moves them any time.”
With the defaults it's Next, Next, Next, Done. It may then offer a reload: “Setup turned on a module that was off.” or “The new raid tile size shows after a reload.”
The wizard's caption reads like “Step 1 of 4 · Layout”.
Source: Core/Setup.lua, README.md (First-run setup) in the ForeverUI addon repository.