TM Bars 1.0.2 — GrimfallWoW
============================

TM Bars is a lightweight action-bar replacement adapted for GrimfallWoW's
Wrath-era 3.3.5a client (Interface 30300). It is not intended for Retail WoW.

Features
--------
- Up to six independently configurable 12-slot action bars
- A dynamically populated stance bar
- An active, movable pet action bar positioned above the main bar stack
- Secure stance, stealth, and optional Alt/Ctrl/Shift page switching
- A mount and vehicle Dismount button
- Native spell, item, macro, cooldown, count, usability, and range display
- Hover keybinding mode with abbreviated key labels
- Mouseover fading and movable, scalable bars
- Reversible hiding of Blizzard's original bars without requiring a reload
- Named profiles with per-character profile selection
- Backward-compatible saved-setting migration and validation
- Combat-safe deferral for protected layout and paging changes
- Optional debug and status commands for bug reports
- A draggable TM bag minimap icon for settings and quick bar locking
- A compact default-UI mini menu for character, spellbook, talents, quests,
  friends, map, help, and game-menu access
- A custom gold-and-teal TM emblem for the Character mini-menu button
- Mini-menu visibility and position controls in the TM Bars options
- A bag button with a live empty-slot count
- Per-bar size, scale, spacing, total-button, and buttons-per-row settings
- Independent saved drag anchors for every enabled action bar and the stance bar
- Horizontal, multi-row, or vertical layouts for each bar
- A movable TM Quest Bar for usable quest-completion items
- A movable TM Auto Bar that keeps the strongest usable consumables by purpose

Installation
------------
1. Exit the game or return to the character-selection screen.
2. Extract the TMBars folder into Interface\AddOns.
3. Enable TM Bars in the AddOns list.
4. Disable other action-bar modules if they overlap TM Bars.
5. Enter the world and type /reload if necessary.

Upgrading
---------
Replace the existing TMBars folder with the new one. Existing profiles migrate
their original three bars into the independent layout automatically. Action
assignments remain in the game's normal action slots and are not rewritten.

Configuration
-------------
Type /tmb or /tmbars to open the panel. Select Bar 1–6 to control its enabled
state, button size, scale, spacing, total buttons, and buttons per row. Setting
one button per row creates a vertical bar. The panel also controls mouseover
opacity, Blizzard-bar visibility, modifier paging, keybindings, locking, and
stance-page assignments.

Profiles
--------
/tmb profiles              List profiles
/tmb profile <name>        Select or create a profile
/tmb copy <name>           Copy another profile into the current profile

Profiles are selected per character. New profiles begin with the standard
defaults. Profile changes cannot be applied during combat.

Commands
--------
/tmb                       Open configuration
/tmb unlock                Unlock and move the bars
/tmb lock                  Lock the bars
/tmb quest                 Toggle the TM Quest Bar
/tmb auto                  Toggle the TM Auto Bar
/tmb bind                  Start or finish hover keybinding mode
/tmb reset                 Reset the current profile after confirmation
/tmb profiles              List available profiles
/tmb profile <name>        Select or create a profile
/tmb copy <name>           Copy settings from a profile
/tmb debug                 Toggle diagnostic messages
/tmb minimap               Show and reset the minimap icon
/tmb status                Print version, profile, and current page
/tmb help                  Print command help

Default paging
--------------
No stance = page 1          Alt = page 2
Stance 1 = page 5           Ctrl = page 3
Stealth = page 6            Shift = page 4
Stance 2 = page 7
Stance 3 = page 8
Stance 4 = page 9
Stance 5 = page 10

Modifier paging is disabled by default to preserve existing key behavior.

Troubleshooting
---------------
- No minimap icon: type /tmb minimap to show it and reset its position.
- No Dismount button: verify TM Bars is version 1.1.3 and type /reload.
- Overlapping bars: enable "Hide Blizzard action bars" or disable the bar
  module in ElvUI, Bartender, or Dominos.
- A setting waits during combat: leave combat and TM Bars will apply it.
- For a bug report, run /tmb status and enable /tmb debug while reproducing it.

License
-------
TM Bars is authored by Kendo, copyright © 2026 TaintedMorals.com, and released
under the MIT License. See LICENSE.txt.

XP bar (1.0.2)
--------------
The XP bar starts below the main action bars. It shows current / required XP,
percentage progress, XP/hour, and estimated time to the next level.
Use /tmb unlock, drag the XP bar, then /tmb lock. Its orange border indicates
that it is unlocked. Position and visibility are saved with your profile.

/tmb xp                    Show or hide the XP bar
/tmb xp reset              Restart the XP/hour tracking session
/tmb xp position           Restore the XP bar to its default visible position

The settings panel also includes Show XP bar and Reset XP session controls.
XP/hour uses XP earned since login, reload, or manual reset, including idle time.
The time estimate uses that average rate and shows Gathering data before XP is
earned. Normal level-ups retain the session; zoning and profile changes do too.
Multi-level jumps or prestige level resets restart the session because the
intermediate XP requirements are unknown. No level cap is hard-coded.
When the client reports no next-level XP requirement, the estimate shows N/A;
when the client reports XP gain disabled, it shows XP paused.
The XP bar stays readable independently of action-button mouseover fading.

Validation: Lua 5.1 compilation and mocked XP calculations, event handling,
movement, and profile tests passed. In-game appearance still needs verification.