MageSphere Forever

A compact companion for mages in World of Warcraft: Forever. Keep teleport, portal and conjuring shortcuts close at hand with a movable sphere and configurable flyout menus.

Version: 1.0
Author: Issoo
Target client: Forever 1.60.1, Interface 16001

Compatibility and validation

This Forever port targets client 1.60.1. The options interface has been tested in game, but gameplay features are still being verified. The reported repeated DecurseHelper aura-access error is addressed in this release, with in-game confirmation still pending; this build should not yet be considered fully validated.

Features

• Movable, lockable sphere with configurable flyout assignments.
• Teleport, portal, food, water and mana-gem shortcuts, with reagent counts and unavailable-spell indicators.
• Minimap launcher positioned on the outer rim, including after minimap resizing.
• Arcane Compendium options: violet panels, gold details, turquoise accents and chapter navigation.
• German and English interface languages and settings profiles.
• Optional Titan Panel integration.
• Configurable group chat announcements.
• Merchant restocking and personal-bank refill settings with item slots and target quantities.
• SheepHelper focus buttons, out-of-combat BuffHelper recommendations and DecurseHelper controls.

Spell availability depends on the spells your character has learned. The inherited catalogue still contains TBC destinations and ranks; catalogue entries do not guarantee availability in Forever.

Controls

Options are also available through Settings > AddOns > MageSphere.

Helpers and current limitations

SheepHelper: Uses WoW's focus target for its saved-target buttons. Combat-log countdowns and automatic Polymorph break warnings are unavailable in this Forever build.

BuffHelper: Calculates recommendations outside combat. Protected actions are not reassigned during combat.

DecurseHelper: Curse detection depends on readable aura data. Aura access is checked before scanning. While access is restricted or unknown, scans are skipped and the tooltip reports that aura status is unavailable; manual curse-removal buttons remain available.

The client controls which protected actions and combat data addons can use. Some inherited features, including bank refills and helper casting, still require further in-game verification.

Installation

Extract the release archive into your Forever client's Interface/AddOns directory. The resulting path must be:

Interface/AddOns/MageSphere/MageSphere.toc

Restart WoW after the first installation or after adding new files. For updates to existing Lua files, use /reload. MageSphere stores settings in MageSphereDB; existing profiles are retained.

Commands

On non-mage characters, the options and minimap launcher remain available; mage-specific sphere menus are not loaded.

Reporting a problem

Include the client build, what you clicked or did, and the exact Lua error if available. /console scriptErrors 1 enables the game's error display.

MageSphere records its own blocked/forbidden actions and call stacks in MageSphereDebugDB. These records share the MageSphere.lua SavedVariables file and are written by WoW on /reload or logout. Storage is limited to 60 records.

Automatic capture of general Lua errors is disabled: Forever reserves AddLuaErrorHandler for Blizzard code. /ms debug reports Lua capture as OFF. For ordinary Lua errors, enable /console scriptErrors 1 and copy the displayed message and stack into your report. The game's error handler is not replaced and errors are not suppressed.

See CHANGELOG.md for release notes.