Release V1.7.7

2026-08-30

• Luacheck Warning Elimination (triune.lua).

  • Direct Discipline Metric Initialization (UI.getTrackedCooldownItems): Initialized totalSec, endCost, activeTotalSec, timerGroupId, and discIdx directly from discInfo instead of pre-initializing with dummy zeroes/nil, resolving all luacheck overwritten variable warnings and ensuring clean CI passes (0 warnings / 0 errors in 10 files).

• LuaLS Type Warnings & Nil Check Hardening (triune_buttons.lua).

  • Type-Safe Timer Key Assignment (saveEdit): Decoupled buffer string reading from tk variable declaration, eliminating LuaLS static type conversion warnings when assigning numeric gem indices, integer second delays, or nil.
  • Button Edit State Nil Guard (drawEditWindow): Added an explicit edit.tmp nil check and early close fallback before rendering the button edit controls, preventing nil index warnings across all button attribute inputs.

• Project Version Bump (v1.7.7): Synchronized version 1.7.7 across triune.lua, triune_updater.lua, and README.md.

• Cooldown & Active Duration Accuracy Overhaul (triune.lua, triune_buttons.lua).

  • Accurate Active Duration Calculation (parseDurationSec): Fixed active duration parsing across Alternate Advancements, Disciplines, Buffs, and Songs. MacroQuest's Me.Buff.Duration timestamp object is now parsed directly via .TotalSeconds(), .Raw() (/ 1000.0), or standard string conversion, eliminating previous tick-multiplication bugs (duration * 6 on millisecond timestamps) that erroneously multiplied milliseconds by 6.
  • Discipline Reuse & Base Cooldown Engine (getDiscCooldownAndDuration, DISC_BASE_COOLDOWNS, DISC_BASE_DURATIONS): Added a comprehensive database of era-accurate discipline cooldowns and durations across all melee/hybrid classes (War, Pal, SK, Mnk, Rog, Rng, Ber, Bst). Discipline recast lookups now seamlessly merge spell data with DISC_BASE_COOLDOWNS fallbacks when MacroQuest Spell.RecastTime returns 0 for classic EQ combat abilities.
  • Discipline Timer Parsing (parseCombatAbilityTimer): Fixed CombatAbilityTimer lookups by supporting dual-path query (both by discipline name and integer combat ability index) and properly converting raw tick values (1 tick = 6s) to seconds while safely handling millisecond returns.
  • Eliminated Phantom Cooldown Loops: Removed destructive fallback blocks in UI.getTrackedCooldownItems() that falsely set full artificial cooldowns and stamped lastDiscFiredAt = now on every frame for ready abilities gated by resource/combat checks (LOW END, BLOCKED, NEED BURN, NEED BOSS, MIN XTAR).
  • Cyan Active Progress Bar Scaling (activeTotalSec): Connected each ability's true baseline active duration (activeTotalSec) to both Table and HUD Card progress bars, ensuring active stances and buffs render a full 100% -> 0% countdown rather than a thin 2% sliver.
  • Toolbar Buttons Cooldown Sync (triune_buttons.lua): Updated getCooldown(btn) to use the shared parseTloTimer logic, properly converting CombatAbilityTimer ticks to seconds rather than misinterpreting ticks as milliseconds.

• Control Tab UI Streamlining (triune.lua).

  • Removed Redundant Closer-Mobs Checkboxes: Removed the duplicate Check for Closer NPCs while Traveling checkboxes from the Hunter and Camp submode sections on the Control tab, consolidating closer-target movement configuration onto the dedicated Closer-NPC Retargeting During Movement section on the Settings tab.

• Dedicated Cooldowns Tab & Shared Popout Integration (triune.lua).

  • New Cooldowns Tab (UI.drawCooldownsTab): Added a dedicated Cooldowns tab directly in the main Triune window positioned right after the AAs tab (Status -> Control -> Settings -> Spell Gems -> Abilities -> AAs -> Cooldowns -> Disciplines -> Clickies -> Help).
  • Shared Collision-Free Cooldown UI (UI.renderCooldownContent): Refactored the live ability, AA, discipline, spell, and clickie cooldown monitoring view into a unified renderer accepting unique ImGui ID suffixes (_tab vs _win), preventing ID collisions and input freezing when both the main window tab and the floating popout window are active simultaneously.
  • Popout Window Option Inside Tab: Added a dedicated Popout Window button directly inside the Cooldowns tab header, allowing users to pop out the monitor into a standalone floating window at any time while retaining full in-tab functionality.
  • Unit Tests: Added test cases in tests/test_pure_logic.lua validating the presence and exact tab sequence ordering of UI.drawCooldownsTab() right after UI.drawAATab().

• Lua Variable Shadowing Fix (triune_map.lua).

  • Luacheck Warning Elimination: Renamed shadowed childFlags variables within DrawMapCanvas to unique identifiers (canvasChildFlags, floorNavFlags, overlayFlags), resolving all luacheck shadowing warnings and ensuring clean CI passes.

• Map Loading Time & Anti-Stutter Performance Engine Overhaul (triune_map.lua).

  • High-Speed Stream Map Parser (parseMapFile): Replaced line-by-line regex parsing (gmatch('[^\r\n]+') + line:match(...)) with direct single-pass stream tokenizers for lines and labels, eliminating hundreds of thousands of intermediate string allocations and reducing zone map parse times by over 80%.
  • Eliminated Blocking Process Spawns (io.popen): Removed all blocking subshell child process spawns (cmd /c dir / find) from folder and file scanning routines, substituting them with instant C-level non-blocking direct file probes (<1ms total probe time across all 300+ Atlas zones) to eliminate game hitching on scan/init.
  • O(1) Navmesh Background Queue (processNavBatch): Replaced $O(N)$ table.remove(queue, 1) array shifts with an $O(1)$ amortized queueHead pointer, preventing frame drops during background navmesh path verification.
  • Optimized Radar Spawn Scans (scanZoneSpawns): Throttled maximum nearby NPC radar queries to 120 closest spawns, eliminating $O(N^2)$ NearestSpawn iteration freezes in densely populated zones.

• Compact Map UI & Floating Bottom Control Dock (triune_map.lua).

  • Removed Redundant Top Toolbar: Eliminated the top text bar and metrics header above the tab bar so the tabs start flush at the top of the window, maximizing vertical map canvas viewing area.
  • Unified Floating Canvas Control Dock (##MapControlOverlayChild): Relocated the Follow checkbox, Center Me / Center Map, POIs drawer toggle, Stop Nav, and Live Zone return buttons down into a sleek floating 2-row bottom-right overlay dock alongside +, -, ⟲, and AZ controls.
  • Larger Button Hitboxes & Double-Click Exclusion: Increased button dimensions from 24px to 28px/26px and expanded the hitbox exclusion barrier so double-clicking on or near on-canvas control buttons never triggers accidental ground navigation or mob targeting on the underlying map canvas.
  • ImGui Style Stack Balance Guard: Fixed a state-flip condition on the POIs button where toggling state.showPoiDrawer during the click callback caused PopStyleColor to be called without a preceding push, eliminating the Calling PopStyleColor() too many times! crash.

• Left-Click Only Map Panning (triune_map.lua).

  • Restricted Viewport Drag Panning: Updated viewport drag panning to trigger strictly when holding down the primary Left Mouse Button (isItemActive and ImGui.IsMouseDown(0) without Ctrl held), removing right-click panning initiation and right-click drag tracking.

• Interactive Mouse Wheel Zoom Fix (triune_map.lua).

  • Scrollable Child Window Region (##MapCanvasScrollRegion): Enclosed the 2D map canvas in a dedicated child window container with virtual scroll content height (SetNextWindowContentSize) and baseline scroll midpoint tracking (ImGui.GetScrollY), replacing the unsupported io.MouseWheel query (which is not bound on MacroQuest's ImGuiIO Lua usertype) with native ImGui scroll delta capture.
  • Window Scroll Flag Unlocking: Removed ImGuiWindowFlags.NoScrollWithMouse from the top-level main window flags so mouse wheel scroll events cleanly reach the canvas viewport and inner scrollable list panes.
  • Cursor-Centered Smooth Zooming: Restored smooth zooming in (wheel up) and zooming out (wheel down) centered on the active mouse cursor coordinate.

• ImGui Window Layout Streamlining & Spacing Cleanup (triune.lua).

  • Removed Extraneous Dummy Spacing: Removed 77 redundant ImGui.Dummy(0, N) and ImGui.Dummy(N, 0) spacers across all tabs (Status, Control, Settings, Gems, Clickies, Abilities, AAs, Discs, Help, and Class Picker), relying on natural theme item spacing for consistent, uncluttered padding.
  • Streamlined Action Controls Bar (UI.drawActionControls): Compacted START/PAUSE and BURN buttons to sleek 130x24 standard dimensions with direct ImGui.SameLine() alignment right above the tab bar.
  • Mini HUD Mode Spacing Refinement (drawMiniGui): Replaced double-spaced separator blocks (Spacing(); Separator(); Spacing()) with clean single separators and removed empty spacing lines, keeping the compact mini-window tightly fitted.
  • Tighter Tab Layouts & Metric Overview: Compacted vertical padding in the Status tab overview table, Target Threat card, Navigation diagnostics, and Settings tabs so key combat telemetry and controls fit naturally on screen without excessive scrolling.

• Popout Cooldown & Ability Monitor Window (triune.lua).

  • Standalone Popout ImGui Window (TriuneCooldownWindow): Registered an independent, top-level ImGui window (TriuneCooldownWindow) providing real-time live monitoring of all enabled Innate Combat Abilities, Alternate Advancements (AAs), Disciplines, Spells (Gems), and Clickie items across all three character classes.
  • Cooldown-First Automatic Sorting: Updated default time sorting so items currently on cooldown and active effects sort directly to the top of the list with soonest-to-recover abilities appearing first, followed by ready abilities ordered by priority.
  • AA & Discipline Cooldown Timer Overhaul (runtime.fireAA, runtime.fireDisc, isDiscReady):
    • Alternate Advancements (AAs): Dual-path lookup querying mq.TLO.Me.AltAbilityTimer by both name and integer AA ID (aaObj.ID()), evaluating hastened reuse times (MyReuseTime()), tracking software timestamps (runtime.lastAAFiredAt), and inspecting spell-name buffers (Buff(spellName), Song(spellName)) so AA durations and cooldowns tick down second-by-second.
    • Combat Disciplines (Discs): Handled MQ CombatAbilityTimer ticks conversion (1 tick = 6s) and milliseconds normalization, added shared EverQuest Timer Group cooldown tracking (runtime.timerGroupCooldown), and software elapsed tracking (runtime.lastDiscFiredAt).
    • Innate Abilities: Implemented ABILITY_BASE_COOLDOWNS lookup database and dual-path TLO inspection (mq.TLO.Me.AbilityTimer(nm), mq.TLO.Me.AbilityTimer(idx), AbilityTimerTotal) with software elapsed time tracking (runtime.lastSkillFiredAt).
  • Active Duration & Stance Countdown: Displays active buff and discipline stance durations with glowing cyan progress bars and countdowns ([ ACTIVE: Xs ]) before transitioning into cooldown.
  • Smart Readiness & Condition Diagnostics: Pinpoints the exact reason why an ability is gated: [ READY ], [ LOW END ] (with required vs current endurance values), [ LOW MANA ], [ NEED BURN ], [ NEED BOSS ], [ MIN XTAR ], [ LOCKED ], and [ BLOCKED ].
  • EverQuest Shared Timer Group Detection: Identifies and badges EQ discipline and skill timer groups ([T1], [T2], [T4], etc.) to clearly highlight shared cooldown lockouts.
  • Compact Mode & Streamlined Screen Space Footprint:
    • Reduced default window footprint to a sleek 500x340 overlay with tight padding (CellPadding 3,2, ItemSpacing 4,3, FramePadding 3,2).
    • Merged multi-line toolbars into a clean 2-line header: Line 1 hosts live counters (R:5 A:1 CD:2), [HUD]/[Table] toggle, Lock checkbox, Compact checkbox, and inline Tune toggle; Line 2 provides compact category, status, sort, search, and alpha controls.
    • Removed unused "Next Up" indicator and star column, streamlining the table directly to Class, Ability Name, Status & Timer, and Action button.
  • Floating Overlay Controls: Configurable background transparency slider (Alpha 0.10 - 1.00), window lock mode (NoTitleBar / NoMove / NoResize), category filters (All, Abilities, AAs, Disciplines, Spells, Items), status filters (All, Ready, Cooldown, Active), sort selector (Time Left, Status, Priority, Class, Type, Alphabetical), and live name search box.
  • In-Place Loadout Tuning: Optional inline editing controls enabling live adjustment of Enabled, threshold HP %, and Burn Only toggles directly from the monitor table.
  • UI Integration & Slash Commands: Added popout toggle buttons across the Main Header Bar (Cooldowns##hdrCooldowns), Mini HUD (CDs##miniCooldowns), Status Tab (Popout Cooldowns##statCdBtn), Abilities Tab, AAs Tab, and Disciplines Tab, along with /ac cd, /ac cds, /ac cooldown, /ac cooldowns, and /triune cd slash commands.
  • Unit Tests: Added test suites in tests/test_pure_logic.lua verifying cooldown configuration fields in defaultCtrl(), ability base cooldowns, AA/disc timer conversions, shared timer groups, status evaluation, and cooldown-first sorting algorithms.

• Beneficial Spell Lockout Exemption & Detrimental-Only Lockout Restriction (triune.lua).

  • Zero Lockout Policy for Beneficial Spells: Ensured that beneficial spells (heals, buffs, pet summons, cures, teleports) are never locked out under any failure scenario (fizzles, interrupts, "did not take hold", generic failures, or out-of-range).
  • Authoritative Beneficial vs Detrimental Classification (isDetrimentalSpell): Added multi-layered action classification checking explicit entry kind tags (heal, buff, pet, cure, util vs dd, dot, debuff, nuke), target token prefixes (E: vs S:, P:, G:, A:, C:), live MacroQuest spell/ability beneficial properties (Spell().Beneficial(), AltAbility().Spell.Beneficial(), CombatAbility().Spell.Beneficial()), era spell database definitions, and fallback keyword heuristics.
  • Restricted Cast Tracker Failures (createCastTracker):
    • isLockedOut(spellName, targetId, kind) immediately returns false for any beneficial spell or ability.
    • recordFailure(spellName, targetId, reason, ...) ignores failures on beneficial spells without creating target lockouts, global lockouts, or immunity flags.
    • onFailureEvent(reason, ...) skips failure logging on beneficial spells so healer and buffer rotations never stall due to non-stacking buffs or interrupted casts.
    • runtime.fireAA updated to maintain cast tracker context (lastSpell, activeSpell, activeTargetId, activeKind, castStartTime).
    • runtime.castGem, runtime.fireAA, runtime.useClickie, and combatTick loop updated to pass kind to isLockedOut for reliable spell classification.
  • Unit Tests: Added test suites in tests/test_pure_logic.lua covering isDetrimentalSpell classification across beneficial/detrimental spells and verifying that beneficial spells never lock out while detrimental spells retain target immunity, debuff resist backoff, and failure recovery.

• Function Parameter Consistency (triune_map.lua):

  • Updated getZAlphaMultiplier(avgZ, minZ, maxZ, zFilterMode, zDepthFading) signature to formally declare optional zFilterMode and zDepthFading parameters with fallbacks to ctrl, eliminating language server argument count mismatch warnings.

• Status Page Active NPC On XTarget Combat State (triune.lua):

  • Strict XTarget NPC In-Combat Filter (hasActualNPCXtarget): Updated the Status tab to only display the engine in combat (• COMBAT: IN COMBAT / Combat: Yes) when there is an actual live, non-ignored, hostile NPC occupying an active Extended Target (XTarget) slot, preventing lingering out-of-combat timers or idle auto-attack from misrepresenting combat state.
  • Threat Monitor Threat Filtering: Updated the active XTarget list generator in the Threat Monitor table to filter out corpses, dead targets, players, friendly pets, and ignored spawns.
  • Unit Tests: Added unit tests in tests/test_pure_logic.lua covering hasActualNPCXtarget across live hostile NPCs, corpses, players, friendly pets, and ignored targets.

• Combat Engine Spell Gems, Abilities, AA, Disciplines, Buffs & Heals Overhaul (triune.lua).

  • Out-of-Combat min_xtar Gate Fix: Updated Spell Gems, Clickies, AAs, Autoskill Actions, Priority Conditional Actions, and Disciplines execution loops to allow beneficial actions (buffs, heals, cures, pet summons, resurrection) to execute out of combat when numXtar == 0, evaluating xtOk = (numXtar >= minXt) or (not isDet and minXt <= 1).
  • Deferred Target Restoration for Cast-Time Spells & Clickies: Fixed an issue in castGem and useClickie where beneficial spells and cast-time clickies targeting friendly party members or pets prematurely retargeted the mob after 60ms during mid-cast. The engine now holds target on the ally throughout the cast bar, and defers restoring the combat mob target until the spell finishes casting in combatTick.
  • Assist Mode Friendly Pet Target Safety: Fixed a critical target-acquisition bug in resolveTargetId where friendly player pets (stype == 'Pet') were rejected in Assist mode by the unengaged mob gate. Added isHostileTarget(id) verification so only unengaged hostile enemy pets/adds are gated.
  • Whole Group Heal & Cure Condition Evaluation: Updated conditionMet to evaluate the lowest health in the group (pctHP(runtime.lowestHpAlly()) <= pct) and scan all group members for poison/disease when targeting F: Whole Group, ensuring group heals and group cures fire when party members are endangered.
  • Target Token Beneficial Prefix (F:): Added tok:sub(1, 2) == 'F:' to isDetrimentalSpell to immediately recognize all standard friendly target tokens (F: Myself, F: Lowest-HP Ally, F: Whole Group, F: Pet, F: Tank, F: Main Assist) as beneficial actions.
  • Group Member Cure Counter Inspection: Enhanced isPoisonedOrDiseased to iterate through standard Group.Member(0..total) party members and inspect their poison/disease status and counter totals (CountersPoison, CountersDisease), allowing party curing even without NetBots.
  • Bard Twist Song Cycling: Updated castGem to allow bard songs with when == 'twist while fighting' to bypass the dur > 0 and buffActive lockout, ensuring bard song twist rotations continuously cycle and refresh.
  • Unit Tests: Added test cases in tests/test_pure_logic.lua validating F: target tokens and out-of-combat min_xtar evaluation.

• Spell Gems Modernization: Presets, Advanced Triggers, Rebuffing & Live Badges (triune.lua).

  • Spell Gem Presets & Multi-Spec Profiles: Added full named loadout preset management (loadout.presets) with in-UI selector combo, save/load/delete buttons, and slash commands (/ac preset [save|load|delete|list], /ac loadout). Loading a preset automatically memorizes the entire spell set to the spell bar.
  • Live In-UI Gem Status Badges (UI.getGemStatusBadge): Added color-coded live feedback badges on every gem row: [Ready] (Green), [CD: X.Xs] (Gold with active countdown timer), [Not Memmed] / [Memming...] (Orange), [Low Mana] (Red with mana requirement tooltip), and [Locked Out] (Purple).
  • 1-Click Gem Slot Reordering (▲ / ▼): Added interactive Move Up and Move Down buttons on every gem slot for instant swapping and reordering without manual dropdown re-selection.
  • Advanced Triggers & Conditions:
    • target HP between: Added configurable Min HP% and Max HP% window for damage-over-time (DoT) and nukes, preventing wasting mana on mobs about to die.
    • has Curse & has Corruption: Added full cure evaluation (isCursed, isCorrupted) inspecting Me, Group.Member(i), NetBots, and Target counters.
    • Aggro on Me & my Aggro >=: Added threat triggers reacting when mob aggro shifts to the player or exceeds a percentage threshold.
    • Boss Only Toggle on Gems: Added dedicated Named / Boss mob filtering checkbox per gem slot.
  • Intelligent Pre-Buff Refreshing & Reagent Verification:
    • Added proactive out-of-combat buff refreshing (ctrl.buff_refresh_sec, default 45s) so buffs are renewed before falling off mid-combat.
    • Added hasSpellReagents(spellName) verifying inventory component counts (Spell.ReagentID) before casting to eliminate missing reagent chat spam.
  • Compact UI Layout & Screen Space Optimization: Streamlined the entire Spell Gems tab with concise status badges ([RDY], [CD], [UNMEM], [MANA], [LOCK], [--]), optimized dropdown and slider widths, compact plain numerical text boxes for level range filtering without stepper +/- buttons, tight button padding, and compact two-row header controls, significantly reducing horizontal width footprint by ~240px.
  • Dynamic Spell Gem Slot Support (getNumGems): Automatically queries mq.TLO.Me.NumGems() to dynamically display 8 to 12 gem slots based on character AAs and server client capabilities.
  • Unit Tests: Added test suite in tests/test_pure_logic.lua covering preset snapshots and deep-copy isolation, gem slot swapping, target HP between windows, aggro triggers, and reagent verification.

---

📦 Installation & Updating Instructions

🆕 New Installation

1. Go here and grab the latest macroquest release https://github.com/macroquest/macroquest/releases and extract under your user folder.
2. Download TriuneAutocombat-full.zip below and extract contents to the same folder you extract macroquest to.
3. Start MacroQuest.exe before launching EverQuest.

🔄 Updating an Existing Install

• Option 1 (Recommended — Easiest): In-Game Updater
  • Click the [Updater] button on the top window header or type /ac update in chat.
  • Click Check for Updates, then Update Now to update and reload all scripts automatically without leaving the game.
  • Alternatively, run update.bat (Windows) or update.sh (Linux) from your TAC/ folder.
• Option 2 (Manual Update):
  • Download TriuneAutocombat-Update.zip from the Assets below.
  • Extract and overwrite the files into your existing MacroQuest directory.
  • Note: Your personal settings and saved loadouts in triune_loadout.lua are preserved and will never be overwritten.