Target-scoped event handlers for Lua scripts

A shared helper module that ships with GoS: SWTOR Core.

Overview

combat_events is a shared Lua helper built on the public gos.events.combat stream. It owns one combat cursor for the importing script and delivers ordered events to target-scoped handlers. It adds no native surface, and fields the stream did not report stay absent - nothing is estimated or guessed.

• One cursor - the module reads one bounded batch (up to 64 events) per tick and keeps its own cursor, so your script never manages one. A backlog drains across later ticks through that cursor.
• Target scopes - register handlers for the local player, the current target, or resolved friendly allies.
• Kind or action - a handler name matches either event.kind or event.action.
• Ordered and contained - events are delivered in stream order, and a failing handler is logged without stopping the others.
• Drop reporting - overwritten stream records are reported through the script log with a running total.
• Idle when unused - polling starts with the first handler registered for that script.
• No history replay - the first cursorless poll subscribes at the stream's current head. Events produced before the first registered handler starts polling are not replayed.

One stream reader, three destination scopes: you, your current target, and your allies.

Usage

local Combat = require("combat_events")

-- Events targeting the local player.
Combat.on_player("damage", function(event)
  gos.log.info("Player damage", event.effective_amount or 0)
end)

-- Damage whose destination is the current target.
Combat.on_current_target("damage", function(event)
  gos.log.debug("Target damage", event.effective_amount or 0)
end)

-- Healing on a resolved friendly ally.
Combat.on_ally("heal", function(event)
  gos.log.success("Ally healed", event.amount or 0)
end)

Event scopes

• Combat.on_player - events whose destination is the local player. It is not every event sourced by that player: for outgoing damage or historical identities, read gos.events.combat directly and compare source_handle.
• Combat.on_current_target - events whose destination matches the target selected when that batch is polled. It does not mean the selected target sourced the event.
• Combat.on_ally - events whose destination resolves to a friendly unit other than the local player.
• A friendly current target can match both on_current_target and on_ally. Registering the same callback under both scopes therefore allows two deliveries by design.

Register handlers at load time. The module owns its polling callback.

Event fields

• Identity - kind, action, result, source/target/ability/effect handles, each event's actor_epoch, and optional source_name / target_name snapshots when Core captured a matching handle and name.
• Values - name, amount, effective_amount, damage_type, critical, and a monotonic millisecond timestamp.
• Fields other than kind are optional and appear only when the client reported them. name is never emitted for effect-kind events; use the documented effect queries instead.
• The native batch also carries actor_epoch and actor_revision metadata alongside cursor, dropped, more, and events. The helper uses the event rows and does not expose the batch object to handlers.

Requirements

• GoS: SWTOR Core (v1.0.0 or newer) with scripting enabled.
• Star Wars: The Old Republic, retail client.

Installation

• combat_events.lua ships with Core in the shared modules folder, next to the other common helpers.
• Load it in your script with local Combat = require("combat_events"). Modules resolve only from the approved script roots and are cached per script.

Notes

• The module is a Lua convenience over the public API, not an extra native interface.
• Every handler runs inside a guarded call: a failure is written to the script log and the remaining handlers still receive the event.
• Part of GoS: SWTOR Core - see the full feature overview: Detailed Explanation of All Features.

Built on GoS: SWTOR Core.

Cooldown awareness and action cues beside player nameplates

A standalone Core script for PvP and any fight with enemy players.

Overview

pvp_sense turns known active timed buffs on players into instant reads: defensive and offensive icons beside nameplates, plus action cues for a current hostile target, such as DO NOT CC while Entrench or Combat Trance is freshly observed.

• Cooldown icons - a researched allow-list of normalized timed-buff names, each drawn beside the nameplate on its own side, laid out horizontally or from top to bottom. Unknown names stay hidden.
• Timers and stacks - remaining time over each icon, stack counts, colored borders per category, and an animated time sweep wash when the effect includes total duration. Stack counts share the timer label and are not drawn when timers are disabled.
• Action cues - an explicit response attached to the highest-priority fresh catalog entry in each enabled category for your current hostile target, so one defensive and one offensive cue may appear together. The ability name and double-drawn bold effect are optional. Retained last-known rows remain dimmed icon continuity only.
• Objective interactions - a movable, clickable window recognizes reviewed capture, orb pickup, bomb, bridge, forcefield, data-core, emplacement, artifact, ball-pickup, and Ilum interaction names. It accepts both localized titles and explicit Core prototype-name aliases, including Plant Bomb, Use Objective, Use Objective Purple, Gather Energy, and Generator1 / Generator2 / Generator3. Rows are labeled CAPTURE, ORB, PLANT, DISARM, PICKUP, or INTERACT. Each row requires an active cast and a resolved player; hostile rows sort first and at most eight rows are drawn. Core captures the displayed entity at mouse press, independently of later reordering or Lua/render rates. Lua resolves the captured handle and submits its opaque click ticket; Core retains undispatched intent during contention for up to two seconds. A newer click/manual selection supersedes stale pending intent; hiding/disabling the window, session changes, or an ended/filtered objective cancels pending intent if it has not dispatched. Lua does not retry uncertain selections.
• Layout controls - icon size, gap, side distance, vertical offset, per-side icon cap, timer and cue text sizes, cue gap, border width, and sweep opacity.
• Hostile roster - a separate movable window lists known hostile players nearest first, including off-screen players in Core's snapshot. Columns show abbreviated class, clickable name, observed spec, HP percentage/bar, iLvl (overall equipped item rating), and distance in metres. Unknown fields show --. It reuses the Seer action window's [=] drag handle and X close control, plus the objective window's captured-entity click ticket and target-request lifecycle. No cast or interrupt is automated. Hiding one window cancels only that window's pending target intent; a newer click in either window replaces the script's older undispatched intent.
• Filters - friendly, hostile, neutral, and self targets, with a max player count and a max distance.
• Readable at range - icons follow the same nameplate distance scaling as Core's plates: full size up to 30 m, shrinking to half size by 60 m.
• Preview - cycle the catalog on yourself to tune the layout without waiting for a fight, at a configurable speed.

pvp_sense - DO NOT CC action cues

Controls

• PvP Sense - Enabled, Preview - Cycle Icons, and Preview - Cycle Speed.
• Objectives - Interaction Window, Objectives - Friendly Players, Objectives - Hostile Players, and Objectives - Remaining Time, with Objectives - Position X, Objectives - Position Y, and Objectives - Window Width.
• Hostiles - Roster Window, Hostiles - Position X, Hostiles - Position Y, Hostiles - Window Width, and Hostiles - Rows. Re-enable Roster Window after closing it with X. The default is 16 rows; at most 32 are drawn, further limited by viewport height. The roster inspects at most 64 prepared hostile players.
• Player Cooldowns - Defensives, Player Cooldowns - Offensives, and Player Cooldowns - Action Cues.
• Action Cues - Ability Name and Action Cues - Bold Text.
• Player Cooldowns - Timers, Player Cooldowns - Stack Counts, Player Cooldowns - Colored Borders, and Icon Effects - Time Sweep.
• Player Cooldowns - Side Layout and PvP Layout - Icon Direction.
• Targets - Friendly, Targets - Hostile, Targets - Neutral, and Targets - Self with Limits - Max Players, Limits - Player Icons per Side, and Limits - Max Distance.
• PvP Layout - Icon Size, PvP Layout - Icon Gap, PvP Layout - Y Offset, PvP Layout - Side Distance, PvP Layout - Timer Text Size, PvP Layout - Cue Text Size, PvP Layout - Cue Gap, and PvP Layout - Border Width, plus Icon Effects - Sweep Opacity.
• PvP Colors - Defensive, PvP Colors - Offensive, and Diagnostics - Effect Observations. Diagnostics are off by default and emit bounded aggregate effect/objective status at most once per second.

Requirements

• GoS: SWTOR Core with scripting enabled and the native click-ticket / target-request contract. The shared Core repair is source/regression tested but UNTESTED LIVE; the Lua script and matching native build must be activated together by the user.
• Star Wars: The Old Republic, retail client.
• No other Lua modules are needed. The package must retain its bundled SWTOR sprite files; the script reads them from the sandbox sprite root and has no configurable icon-root control.

Installation

• Open the Script Library in Core, select PvP Sense, and install or update to the latest release.
• Enable the script in the Scripts list and open its settings card.
• Use the preview cycle to place the icons and cues before heading into a fight.

Notes

• Cooldowns are matched against an explicit allow-list after lower-casing and normalizing spaces, hyphens, and punctuation in the reported effect name. This is exact catalog-name matching, not numeric effect-definition matching; unknown observations stay hidden.
• The script never casts or runs a rotation. Cooldown awareness is display-only, but an explicit click in the objective window does request a target change and waits up to two seconds for confirmation.
• Preview replaces only the cooldown observations with rotating self-anchored catalog samples. The objective window continues to use live active casts while preview is enabled.
• Objective remaining time always comes from Core. Bar totals come from the reviewed definitions: pylon aliases and modern bomb plant 6 s, orb pickup 5 s, defuse 3 s, turret control 8 s, Novare emplacement channel 18 s, bridge/forcefield 6 s, and modern data core 0.5 s. A bar measures the current cast/channel, not objective ownership or capture percentage. Capturing the Objective is shared by 6 s capture and 8 s extraction; Turretswitch is shared by different actions. Those ambiguous names and generic Accessing retain their reported countdown without a guessed fill. Instant ball pickup has no invented duration and appears only if an active cast row exists. Explosions, taxis, bolster, grapples, carrier buffs, and scoring/support effects are excluded.
• The roster's iLvl column requires Core's unit:item_rating() getter and reads the same prepared equipped-rating value as native nameplates, not an inventory item's level or the character's level. Older Core builds show -- and log the missing API once. Remote specs remain optional; the roster does not infer them from buffs or abilities. Native/Lua source tests do not establish live behavior; activate the rebuilt Core and reload Lua before testing the new window.
• Part of GoS: SWTOR Core - see the full feature overview: Detailed Explanation of All Features.

Built on GoS: SWTOR Core.

Live DPS, HPS, and damage-taken tracking for Star Wars: The Old Republic

A GoS: SWTOR Core feature script that reads the live combat event stream and shared actor-label metadata.

Overview

combat_meter turns Core's combat event stream into a live SWTOR combat meter: damage (DPS), healing (HPS), and damage taken (DTPS), with contributor or incoming-source totals plus ability and target detail. It is a full script-built window - every pixel is drawn by the script.

• Three modes - Damage (DPS), Healing (HPS), and Taken (DTPS) tabs. Click a tab to switch the whole meter.
• Live rows - eligible friendly players and companions receive damage/healing totals, rate, and share. A completed summary remains visible until Reset or the next observed encounter starts.
• Detail view - the compact view shows the top five contributors. Open one for up to 12 ability rows and 6 target rows, then select an ability for casts, hits, criticals, rate, share, and its top targets.
• Incoming tracking - combat_meter_incoming records damage to the local player from positive or zero effective_amount events, local-player interrupt events, effect lifecycle, and death. Crowd-control rows are explicitly 200 ms snapshot observations from a 533-definition catalog, not fabricated combat events or exact durations.
• Window controls - drag the meter by its header to move it; panel and detail positions persist between sessions. Toggle with F5 (configurable), and tune font size, transparency, and background color.
• Bounded - capture reads at most four native batches per 16 ms callback; contributor, source, ability, target, history, and timeline models all have explicit caps. A dropped-event or model-limit condition is shown as incomplete rather than estimated away.

combat_meter - live SWTOR DPS and HPS tracking drawn by a script

combat_meter - damage done to us

SWTOR Combat Log, DPS, HPS, and DTPS

If you are looking for a SWTOR combat log, damage meter, or HPS meter, combat_meter is the live option: it reads the client's combat event stream while you play instead of reading a log file after the fight. Damage per second (DPS), healing per second (HPS), and damage taken per second (DTPS) update as events arrive, so the fight stays visible while it happens.

This script does not tail or parse the game's text combat log. Damage, healing, lifecycle, and interrupt rows come from Core's ordered event stream; CC rows are clearly labeled local-player snapshot observations. Use it for operations, flashpoints, warzones, or dummy parses to inspect live totals and breakdowns. Reset is available between pulls but is not required to replace a completed encounter when the next one begins.

Controls

• Meter Toggle - the show/hide hotkey (default F5).
• Visible, Position X, and Position Y - also updated by dragging the header.
• Detail Position X and Detail Position Y.
• Font Size, Overlay Transparency, and Background Color.
• In-frame controls: mode tabs, per-row hover details, click to open a player, and the Reset button.

Requirements

• GoS: SWTOR Core (v1.0.0 or newer) with scripting enabled.
• Star Wars: The Old Republic, retail client.
• The meter requires combat_meter_incoming.lua and actor_labels.lua. It reads gos.events.combat directly and does not import combat_events.lua.

Installation

• Open the Script Library in Core, select Combat Meter, and install or update to the latest release. The library installs the script and its shared modules together.
• Enable the script in the Scripts list and open its settings card.
• Press F5 to toggle the meter and drag it into place. Reset clears the current model immediately; a newly observed encounter also replaces a completed one.

Roadmap

Planned work, not yet implemented:

• Class colors - color meter rows by the player's class the way SWTOR uses class colors elsewhere in the UI, so a group's composition reads at a glance.
• Ability icons - show each ability's icon next to its row in the detail view, so breakdowns match what players already recognize from the game. Under consideration.

Notes

• Damage done uses positive effective_amount; damage taken accepts non-negative effective_amount so zero-result rows remain visible; healing uses positive reported amount because Core does not expose a separate overheal value. Rates use observed combat timestamps, and missing timing or dropped events are surfaced as incomplete. The meter never changes what your character does.
• Works alongside any rotation script - the meter and the rotations do not share state.
• Capture, actor-metadata, and CC-sampler callback failures are surfaced in the meter and Lua console; a stopped callback requires a script reload. Dropped events, absent timing, invalid incoming amounts, history rollover, and bounded-model limits are reported separately rather than hidden.
• Part of GoS: SWTOR Core - see the full feature overview: Detailed Explanation of All Features.

Built on GoS: SWTOR Core.

Ability icons with live countdowns, drawn over units

A standalone Core script for crowd-control awareness.

Overview

crowd_control_viewer draws crowd-control debuffs as icons with live countdowns over the units they affect, so you can see at a glance who is locked down.

• Crowd control - timed debuffs whose normalized reported names exist in the viewer's explicit catalog render as icons above the unit with their remaining time.
• Explicit name catalog - matching lower-cases the reported effect name and normalizes spaces, hyphens, and punctuation before an exact catalog lookup. This is not numeric effect-definition matching. Core last-known rows may remain as dimmed presentation continuity; timers are aged from the cached observation rather than fabricated.
• Target layers - friendly, hostile, neutral, and self layers can each be toggled. The current target remains eligible even when its reaction layer is disabled, except that the Self toggle still excludes the local player.
• Bounded - units are distance-sorted with the current target first, capped at 64 by default, and live effects refresh on a rotating 16-unit budget after the initial cache bootstrap. Per-unit icon limits and a 120-command draw budget bound presentation work.
• Test mode - cycles sample icons over visible units so you can preview sizes and layout before a fight.

crowd_control_viewer - ability sprites with live countdowns

Controls

• CC Viewer - Enabled and Preview - Test Mode.
• Awareness - Crowd Control.
• Targets - Friendly, Targets - Hostile, Targets - Neutral, and Targets - Self.
• Limits - Max Units, Limits - CC Icons per Unit, and Limits - Max Distance.
• CC - Icon Size and CC - Y Offset.

Requirements

• GoS: SWTOR Core (v1.0.0 or newer) with scripting enabled.
• Star Wars: The Old Republic, retail client.
• No other Lua modules are needed. The package must retain its bundled SWTOR sprite files; the script reads them from the sandbox sprite root and exposes no icon-root setting.

Installation

• Open the Script Library in Core, select Crowd Control Viewer, and install or update to the latest release.
• Enable the script in the Scripts list and open its settings card.
• Use test mode any time to preview the icons, then disable it for live play.

Notes

• The viewer is display only: it never casts, changes targets, or interacts with your rotation.
• Icons can be drawn over multiple eligible units at once. The current target is sorted first and can bypass its reaction filter, but the viewer is not limited to that target.
• Test mode stops live effect refresh and draws rotating catalog samples over the eligible units instead. Disable it to return to observed debuffs.
• Part of GoS: SWTOR Core - see the full feature overview: Detailed Explanation of All Features.

Built on GoS: SWTOR Core.

Clickable party and ally frames for GoS: SWTOR Core

A standalone Core script. Enable it, and click any frame to select that unit.

Overview

better_ally_frames adds a compact panel drawn by Core alongside SWTOR's stock UI; it does not hide or replace the stock party frames. It renders friendly players, companions, and ally NPCs with observed health, optional resources, distance, and range awareness, and every displayed frame is clickable.

• Click to select - Core binds the click to the entity shown when mouse press began, even if the frames re-sort before release. Lua resolves that captured handle in the current session and submits Core's opaque click ticket. Core retains undispatched intent for up to two seconds during contention; Lua does not retry the selection. A newer click or manual selection supersedes stale undispatched intent, while already-dispatched work retains its outcome evidence. Hiding/disabling the panel, expiry, session changes, or losing frame eligibility cancels pending intent where dispatch has not won.
• Compact and movable - drag the panel by its title bar, minimize it with the title button, or hide it with the hotkey (default F6). A completed drag saves the position; configured frame dimensions persist as settings.
• Type-aware - self, players, companions, and ally NPCs can each be enabled or disabled, with distinct accents: gold border, purple companions, and green ally NPCs. The active selection is highlighted in cyan.
• Health and resources - observed health bars with a below-30% color and a zero-health dead state, plus an optional resource bar colored by resource type: Force, energy/ammo, rage/focus/heat, or generic. Missing snapshots remain empty/unavailable.
• Range awareness - allies beyond the implemented threshold dim to the out-of-range opacity; the selected or pending-selection frame remains at full opacity. See the current distance-conversion limitation below.
• Sorting and layout - choose Group then name, Distance, Health %, or Name, with configurable columns, frame width and height, and distance readouts.
• Bounded - up to 32 sorted frames are drawn. Any additional eligible allies are reported by an overflow line instead of creating an unbounded panel.

better_ally_frames - clickable ally frames drawn by a script

Controls

• Visible and Show / Hide Hotkey (default F6) with Minimized.
• Sort Frames, Columns, Frame Width, and Frame Height.
• Out-of-Range Opacity and Range (metres).
• Position X and Position Y (also updated by dragging the title bar).
• Show Self, Show Players, Show Companions, and Show Ally NPCs.
• Show Distance and Show Resource Bar.
• Targeting Diagnostics - shows left-mouse input, cursor availability, frame rectangles and hit tests, interaction edges, retained slot handles, target requests, queue or busy state, confirmation latency, and failures in the script's Log tab with INFO enabled. A status update once per second remains visible even when no click event arrives. Disabled by default; use Save to export the retained log.

Requirements

• GoS: SWTOR Core with scripting enabled and the native click-ticket / target-request contract. The shared Core repair is source/regression tested but UNTESTED LIVE; the Lua script and matching native build must be activated together by the user.
• Star Wars: The Old Republic, retail client.
• No other scripts or modules needed - better_ally_frames is standalone.

Installation

• Open the Script Library in Core, select Better Ally Frames, and install or update to the latest release.
• Enable the script in the Scripts list and open its settings card.
• Drag the panel where you want it; the position is saved.

Roadmap

Planned work, not yet implemented:

• Buff, debuff, and cleansable icons - display each unit's effects on its frame the way SWTOR shows them, so you can read an ally's buffs, debuffs, and cleansable effects at a glance.

Notes

• The script never casts or runs a rotation. Its one gameplay action is the explicit user-requested target change when you click a frame.
• Frames render from prepared snapshots. Missing health is shown as --; missing distance is shown as ?m and treated as out of range rather than guessed.
• Current distance limitation: this Lua revision multiplies unit:distance() by 10 even though the current Core snapshot already reports metres. The displayed distance and the value compared with Range (metres) are therefore ten times Core's current metre value. The label is retained because it is the live settings field; this page does not pretend the present conversion is correct.
• Part of GoS: SWTOR Core - see the full feature overview: Detailed Explanation of All Features.

Built on GoS: SWTOR Core.

Concealment, Lethality, and Medicine for GoS: SWTOR Core

Current runtime support: Imperial Agent Operative only. Scoundrel names below are a future-support mirror reference, not a supported route.

Support Status

The current Lua is Operative-only. The dispatcher requires combat_style == "operative" and the exact Operative discipline names Concealment, Lethality, or Core's authoritative Medic value. It does not translate Scoundrel loadouts, abilities, effects, casts, or combat events. Scrapper, Ruffian, and Sawbones are therefore not runnable today. Their mirror names are retained and corrected in this topic so a future implementation has an accurate reference.

• Coverage: all three Operative modules are capability-driven through level 80. The route reads owned abilities, passives, and choices from the live loadout instead of inferring them from level.
• Fail-closed loadout gate: the combat route waits when the style, discipline, loadout, ability, effect, resource, target, or required geometry is unavailable.
• One executor: the top-level dispatcher owns one shared AbilityExecutor, polls it once per tick, and passes it to every route and utility.
• Current-target DPS: Concealment and Lethality use the selected hostile target. Medicine chooses friendly patients independently and never changes the visible selection to heal.
• Manual ownership: Evasion, Cloaking Screen, Flash Bang, Infiltrate, and other major defensives or crowd-control actions stay player-owned unless a specific behavior below says otherwise.

Executor, Scheduling, And Targeting

• Hold-to-run: normal rotation, cleanse, interrupt, and DPS self-healing work only while Rotation Key is active. Auto Stealth may be configured to work without the key. Stealth-detector awareness and the cursor Holotraverse gesture are separate from the rotation key.
• Dispatcher order: after the one executor poll, the script updates combat evidence, draws Medicine actions when applicable, services cursor Holotraverse, then the shared interrupt. Route-owned pending admission is serviced before new work. DPS cleanse, DPS self-heal, Auto Stealth, and the selected discipline route then take their defined turns.
• One request at a time: an accepted command owns the executor until Core reports its lifecycle terminal. Admission-pending means “retry this exact intent next tick,” not success or failure. A route cancels only a command carrying its own exact ownership prefix.
• No target fallback: explicit friendly, cleanse, interrupt, cursor, and Concealment casts require the requested handle and target_fallback="none". Contract mismatches are rejected. Lethality deliberately uses Core's captured selected-target path and verifies that no override or fallback occurred.
• Selection changes: Lethality releases only its own cancellable selected-target command when the selection changes. Medicine re-resolves friendly handles before retrying admission. Life-saving/burst healing stays pinned to the endangered patient instead of silently healing a healthier fallback.
• Action timing: the Lua queue window controls when normal actions may be offered. Core remains authoritative for cooldown, resource, range, facing, line of sight, target state, native result, and cleanup.
• AoE counts: automatic counting uses bounded target-centered, player-centered, or cone geometry as appropriate. Manual Relevant Targets replaces only the quantity when automatic counting is disabled; it never overrides missing range/facing geometry or observed breakable crowd control.

Controls

The settings card is discipline-aware. Ability-gated controls appear only when the current loadout owns the required ability. Defaults below are the current Lua defaults.

General, Energy, And Logs

AoE And Damage Target Counting

DPS Self-Healing

Concealment

Lethality

Medicine

Medicine Action Feed

Auto Stealth And Detector Awareness

Cursor Holotraverse

Shared PvP Interrupt And Cleanse

Concealment Rotation

• Protected opener: proven Stealth reserves Backstab as the only damage action. Unknown out-of-combat Stealth also preserves it. Backstab still needs a real rear-half-plane result unless Critical Stims or the player's own Revealing Weakness provides the observed positional override.
• Level-80 capability route: learned Veiled Strike authoritatively replaces Shiv; the route recognizes choices through level 73 and passives through level 78. Owning a passive never fabricates its proc.
• Acid Lash: uses only the observed, locally owned Poisoned (Acid Blade) component. It restores missing Acid Blade with legal Backstab and can refresh an expiring poison with Laceration.
• Volatile Strike: an observed unexploded Volatile Substance may be detonated by Veiled Strike without requiring Corrosive Dart. A real Revealing Weakness then promotes Backstab.
• Base priority: durable-target poison/setup, confirmed tactical and Active Stealth windows, Volatile Substance, Backstab, the learned TA builder, Laceration, optional Dart, Crippling filler, then Overload/Rifle filler.
• Crippling branch: Crippling Wounds uses the best legal direct follow-up; Crippling Throw builds TA below the observed cap; The Best Defense permits the legal free Slice filler. A blocked step never freezes the route.
• AoE: Toxic Haze uses the exact player-centered 8 m footprint; Noxious Knives uses the authored 45-degree cone; Fragmentation Grenade uses the exact target-centered 5 m cluster and seven-target cap. Observed breakable control vetoes splash, and unknown control state vetoes player splash.
• Resource/defense: Culling's 2 Energy refund is used only in reserve projection after its real engine condition; Shield Probe is the only automatic major defense. Evasion and Cloaking Screen remain manual.

Lethality Rotation

• Protected opener: Stealth reserves the learned strike: Lethal Strike when owned, otherwise Backstab. Automatic Holotraverse may close a real gap before the strike unless it is reserved for the hotkey.
• Poison identity: Corrosive Dart and Corrosive Grenade use exact current-client primary effect definitions. Secondary marks, slows, lingering poisons, a queue receipt, or another player's effect never extend upkeep.
• Full-poison spender: Corrosive Assault requires every owned, resolved, bound primary poison. A learned but unusable/unbound Grenade does not deadlock the route.
• Priority: poison setup/refresh, tactical burst setup, Toxic Blast, worthwhile Haze, learned strike, Fatality/Shiv resource work, Corrosive Assault, bounded AoE, then paid/free filler.
• Tacticals: Synox Shots relaxes the Energy policy for sustained Toxic Blast; Viral Elements still needs real player-centered pack geometry; Catalyzed Toxins uses freshly confirmed PvP poisons, Lethal Strike, then Toxic Blast without pretending the poisons were consumed.
• Observed continuity: server activations and fresh charge snapshots reconcile TA, Fatality, Corrosive Return, and DoT applications. Zero TA is a known state; dropped or old samples are not guessed into buffs.
• Target lifetime/rank: fresh DoTs and long cooldowns are conserved on measured short-lived targets. Players are meaningful burst targets; automatic PvE Stim Boost/Tactical Superiority is reserved for major threats.
• AoE safety: the same exact 8 m Haze, 45-degree Knives cone, 5 m Grenade geometry, and observed breakable-control veto apply. Lethality has no separate PvP-AoE disable; use Automatic AoE when needed.

Medicine Scheduler

• Exact patients: every friendly heal re-resolves the unit immediately before admission and requires explicit-target/no-fallback Core metadata. Kolto Waves keeps its separate ground/omitted-target contract.
• Incoming Damage Formula: uses disjoint recent damage windows (0-0.75 s, 0.75-2 s, and 2-4 s), current/recent/persistent attackers, recent owned HoT healing, projected HP at 2/4 s, and time-to-die bands. With no evidence it keeps HP ordering; after dropped events it degrades to HP ordering for the history window.
• Patient stickiness: an established burst-band patient stays focused until safer, a lower-HP patient appears, or a band-0 emergency preempts. True life-saving and burst target failures stay pinned instead of becoming a heal on somebody healthier.
• Life-saving refusal: a proven three-stack Diagnostics Probe instant Injection, Surgical Probe, Infusion, Injection, Nanotech, and last-resort Diagnostic Scan get one patient-pinned refusal before must-cleanse utility.
• HoT policy: builds the focused patient's two Probes first when survivable, preserves established two-stack refreshes, and resumes the wider sticky roster only after urgent pressure. Probe activation/refresh uses lifecycle and fresh effect evidence rather than assuming a submitted cast landed.
• Group healing: Kolto Burst is self-Injection inside 8 m; Recuperative Nanotech chooses an injured center inside 10 m and honors Nano Mark/Critical Nanotech/Nanotech Stim; Kolto Waves requires the configured injured count inside the best exact 8 m cluster and is never single-target filler.
• TA and procs: TA comes only from current charge observations. Surgical Precision raises the cap to three. Accomplished Doctor refreshes an existing two-stack Probe with Infusion/Surgical Probe. Curative Jolt spends its guaranteed Surgical Probe crit. Reactive Substance, Diagnostics Probe, Kolto Stim, Stim Burst, and Tactical Overdrive follow their observed/owned gates.
• Battle rez and cleanse: life-saving healing and must-cleanses outrank automatic battle rez. Movement cleanses, pressure cleanses, and target-specific backoff retain their defined scheduler positions.
• Idle damage: a safe lull may use Corrosive Dart, Backstab, Shiv/TA banking, Curbing Strategies Noxious Knives, Overload Shot, and Rifle Shot while protecting the Medicine Energy reserve.
• Action feed: presentation only. It never owns a cast, target, triage choice, or command lifecycle. Accepted actions can later be enriched by measured heal/damage events and exact proc metadata.

Stealth Detection

• Tracks boss stealth detection, Advanced Stealth Detection, Stealth Detection, and Stealth Scan on every bounded observed hostile, not only the selected target.
• Icons attach to each hostile's world origin with the configured world-space height. They keep a fixed pixel size; there is no nameplate-size, distance-scaling, CC-row, or fixed Y-offset formula.
• Advanced Stealth Detection, Stealth Detection, and Stealth Scan use the verified 15 m catalog radius. Boss stealth detection has an unverified radius, so it gets a DETECT badge but no fabricated range ring.
• The selected unit may receive the optional maximum known-radius ground ring. Unselected detectors keep their icons. Last-known timed rows are visibly dimmed.

Operative / Scoundrel Mirror Reference

The following names are reference data for future Lua support. They do not make the current Operative-only dispatcher run on Scoundrel. A future route must translate loadout, ability, effect, cast, and combat-event names at the runtime boundary and remain fail-closed for any unverified mirror.

Disciplines, Shared Abilities, And Utility

Concealment / Scrapper

Lethality / Ruffian

Medicine / Sawbones

Requirements And Dependencies

• An active GoS: SWTOR subscription - 1 Week or 1 Month - is required for the loader and official script releases.
• GoS: SWTOR Core with scripting, current command-lifecycle/admission APIs, combat and cast event streams, explicit target support, cursor/screen-position APIs, actor-name metadata, and spatial overlay drawing.
• Star Wars: The Old Republic retail client and an Operative loadout. Scoundrel is not currently accepted by the dispatcher.
• The Operative package: live/operative.lua; operative_concealment.lua; operative_lethality.lua; operative_lethality_runtime.lua; operative_medicine.lua; operative_route_common.lua; operative_dps_self_heal.lua; operative_cursor_holotraverse.lua; operative_stealth_detection.lua; and the detector sprites raw/chaffflare.dds, raw/focusfire.dds, and raw/probedroid.dds.
• The shared modules actually required by this entrypoint/import graph: ability_executor.lua, cleanse.lua, cleanse_db.lua, interrupt.lua, interrupt_db.lua, medicine_pressure_formula.lua, healer_action_window.lua, and its actor_labels.lua dependency.
• No third-party addon is required. The Script Library installs the package's live, common, and sprites files together.

Distribution check: healer_action_window.lua is a direct runtime requirement of the current entrypoint. The Script Library package must include it even if an older package manifest omits it.

Installation And Quick Check

1. Install or update Operative from the Script Library in Core; the package and its shared dependencies are installed together.
2. Enable Operative in the script list and select the script.
3. Verify that the settings card loads without a module error and that only controls valid for the current Operative discipline/owned abilities are shown.
4. Hold Rotation Key. Cast Log confirms accepted submissions; Decision Log and the dedicated diagnostics switches explain gates. None of those alone proves server activation or live combat correctness.

Limits

• Operative only today; the Scoundrel mirror tables are documentation for future work.
• Equipped tactical identity is not exposed to these routes. Select the exact Concealment/Lethality tactical manually or keep Auto / Unknown.
• Missing or stale evidence disables the affected branch. The routine does not substitute another effect, target, timer, or ability.
• Automatic PvP AoE for Concealment is off by default. Lethality follows the shared Automatic AoE switch and exact crowd-control/geometry guards.
• Cursor Holotraverse continuously retries while the full chord is held, but only after the previous exact command outcome and cleanup settle. Cooldown, geometry, line of sight, and native game rules remain authoritative.
• The Medicine action feed is presentation, not proof. Measured combat events can confirm amounts; accepted submissions may still remain activation-unconfirmed.

Built on GoS: SWTOR Core. Operative-only, loadout-aware, exact-targeted, and fail-closed.

A loadout-aware combat routine for GoS: SWTOR Core

Current Lua support: Commando - Gunnery, Assault Specialist, and Combat Medic. Mercenary mirror names are retained for planned support.

Overview

The current script covers all three Commando disciplines: Gunnery, Assault Specialist, and Combat Medic. It scales from the first discipline unlock to level 80 through the actual loadout. The current loadout gate requires the commando combat style; Mercenary is not implemented yet. Arsenal, Innovative Ordnance, Bodyguard, and their Imperial ability names remain in this post as the mirror reference for that planned Lua work.

• Loadout-aware - the active discipline, every unlock, and every discipline tree choice the route depends on are read from your current loadout. Optional abilities are never assumed from character level, and the script stays inert if the loadout does not match.
• One executor - the top-level script owns one AbilityExecutor for all three routes and shared cleanses. Gunnery and Combat Medic retain exact pending admission identity where their current schedulers require it, and every route cancels only a command whose ownership is proven.
• Real client checks - every cast passes Core's admitted cast path: resource cost, range, facing, target state, and line of sight.
• Cell budgeting - energy cells are budgeted with real costs. Full channels reserve their full channel cost, and a zero startup cost alone is never treated as free.
• Current layout - commando.lua owns the dispatcher, executor, shared utilities, and Gunnery priority. commando_gunnery_kit.lua supplies Gunnery loadout/effect/settings helpers. Assault Specialist and Combat Medic have their own route modules.
• PvE first, PvP tools available - exact-definition cleanses, player-target High Impact Bolt pressure rules, optional defensives, and an opt-in current-target interrupt are available. Experimental target-disappearance markers and auto-reveal belong to the separate Stealth Detector script.
• Leveling friendly - optional abilities come only from what you have learned, so the same script works while leveling and at 80.

Shared UI Controls

Everything is configured from the Commando Core settings card. Changes validate on save and persist between sessions. Discipline-specific controls appear only for their discipline, and ability-specific controls require that ability in the active loadout.

• Rotation Key (Mouse 4) - hold to run the active discipline.
• Ability Queue Window (0.20 s, Gunnery / Assault Specialist) - permits early submission of normal selected-target actions. Assault Specialist currently waits for a completely open GCD because Core admission is now-only; ground-targeted and exact-start channels also wait for an open lock.
• Automatic AoE (On), Target-Centered Auto Count (On), Relevant Targets (1), AoE Minimum Targets (3), and AoE Count Radius (5 m) - control Gunnery and Assault Specialist target counts. The manual count is used when target-centered spatial counting is disabled or unavailable.
• Auto Recharge Cells (On) - enables automatic recovery for both DPS routes. Recharge Cells At % defaults to 45%; Assault Specialist uses its separate AS: Recharge Below % threshold.
• Auto Reactive Shield (Off) + Reactive Shield HP % (40), Auto Diversion (Off) + Diversion HP % (50), Auto Adrenaline Rush (Off) + Adrenaline Rush HP % (35), and Auto Supercharged Celerity (Off) - shared Gunnery / Assault Specialist automations. They remain hidden when the corresponding ability or selected loadout choice is absent.
• Shared PvP Cleanse (On), Shared Cleanse: Self (On), Shared Cleanse: Allies (On), Shared Cleanse: Roots (On), Shared Cleanse: Slows (Off), Shared Cleanse: Pressure Debuffs (Off), Shared Cleanse: Minimum Seconds (0.8), Shared Cleanse: Pressure HP % (90), and Shared Cleanse: Diagnostics (Off) configure Field Aid for all three disciplines. Field Aid removes exact catalogued Tech/Physical effects and adds Mental effects only when Psych Aid is present.
• Enable Diagnostics / Logging (Off) is the final control on the card and is the master gate for optional Commando logging. Cast Log (On) records submitted actions and outcomes for the DPS routes, Decision Log (Off) records deduplicated state changes, and Ability Diagnostics (Off, Gunnery only) logs modeled availability and blockers once per second. Combat Medic has its own Healing Diagnostics; shared cleanse diagnostics remain separately selectable. With the master switch Off, those streams skip their diagnostic polling and formatting.

Separate Stealth Detector

Stealth detection is no longer part of commando.lua. Install and enable the separate Stealth Detector feature if you want temporary inferred last-seen markers or automatic reveal attempts. It runs independently of this routine and its Rotation Key.

• No hidden dependency - Gunnery, Assault Specialist, and Combat Medic work without the Stealth Detector package.
• Separate settings - reveal choices, markers, and fallback behavior are configured on the Stealth Detector card, not the Commando card.
• Mirror reference - Advanced Recon Droid and the Imperial detector names remain relevant to the planned Mercenary route, but they are not automatic actions in the current Commando routine.

Gunnery (PvE)

Ranged burst with strict proc and cell handling, from the first unlock to level 80.

• Gravity Vortex / Heat Signature is required before the cooldowns that depend on it. The routine accepts either the exact debuff snapshot or confirmed Grav Round damage on that target as evidence. Vortex Bolt / Priming Shot is the high-priority cooldown and its acknowledged activation supplies the short Grav Primer handoff used by the next filler; Demolition Round / Heatseeker Missiles is the vortexed-target payoff.
• An exact Curtain of Fire / Barrage effect promotes Boltstorm / Blazing Bolts ahead of Demolition Round so another Grav Round cannot overwrite the proc. A normally ready Boltstorm remains a later priority even without that proc. Full Auto / Unload is used only before Boltstorm is learned, and channels require an exact open start instead of being prequeued.
• Charged Barrel / Tracer Lock is observed by exact stack count. Those stacks gate when High Impact Bolt / Rail Shot is spent; five stacks also prove the instant Medical Probe / Rapid Scan self-heal. Five-Barrel Stationary Payoff is enabled by default.
• Instant-cast permissions are scoped to the ability they actually affect: Tech Override / Power Surge and five Charged Barrel stacks can authorize Medical Probe; Tech Override or Grav Primer can authorize the relevant Gunnery filler while moving. No timer prediction manufactures a proc.
• AoE: selected Thermonuclear setup and spread, Mortar Volley / Death from Above, the three-target Grav Trio, Hail of Bolts / Sweeping Blasters, and Sticky Grenade / Explosive Dart at 4+ relevant targets.
• Explosive Round / Missile Blast fills while moving, and Hammer Shot / Rapid Shots is the free filler.
• A one-tick Core admission response is retained with the same ability, selected target, player, and idempotency key. Gunnery retries that exact request before choosing another priority, so castability_pending is not treated as a failed cast or given the normal 0.25 s failure backoff.
• Emergency self-heals name yourself explicitly and never heal a healthy player: Bacta Infusion, Medical Probe, and Med Shot each have their own HP threshold.
• Discipline path choices are read from the loadout: Gravitating Bolt strengthens Vortex Bolt / Priming Shot on a vortexed target, Thermonuclear Plasma spreads Gravity Vortex / Heat Signature with Plasma Grenade / Fusion Missile on grouped targets, and Grav Trio turns Grav Round / Tracer Missile into a three-target attack. Charged Barrier, Overclock, Cell Capacitor, Reflexive Shield, Tenacious Defense, Combat Shield, One Man Army, Concussive Force, Parallactic Combat Stims, and Trauma Stabilizers gate their branches only when selected.
• High Impact Bolt / Rail Shot spends at the normal Charged Barrel threshold (4 by default, or 5 while Five-Barrel Stationary Payoff is enabled), drops to the pressure threshold (2) while moving or against a hostile player at 50% HP or lower, and ignores stacks for hostile-player executes at 25% HP or lower. It normally requires at least 60% current Energy before the spend; a ready Recharge Cells can authorize the existing controlled rescue budget.
• Passives such as Blowback, Target Lock, Blazing Barrel, Deadly Cannon, Honed Lock, Cell Charger, Decoy, Forced March, and Armor-piercing Cell are read from the loadout; their effects stay owned by the game's engine.

Controls

• Energy Floor % (60), Auto High Velocity Supercharged Cell (On), and Explosive Round While Moving (On) control the ordinary Gunnery resource, Supercharge, and mobile-filler policy.
• HIB Normal Stacks (4), HIB Pressure Stacks (2), and Gunnery: Five-Barrel Stationary Payoff (On) control when High Impact Bolt spends Charged Barrel stacks.
• Gunnery: Emergency Self-Heals (On), Bacta HP % (45), Instant Probe HP % (55), Med Shot HP % (25), and Healing Energy Reserve % (10) configure the three self-heal tiers and their post-spend floor.
• Gunnery: Tech Override for Healing (On) reserves Tech Override for an instant Medical Probe when needed. Gunnery: Mobile Tech Override (On) permits the scoped moving filler that the observed proc can make instant.
• Gunnery: Use Electro Net (On), Emergency Echoing Deterrence (Off) + Echoing HP % (35), Adrenal Surge 60% Trigger (On), Emergency Player Stun (Off) + Cryo HP % (40), and Interrupt Current Target (Off) control optional damage and emergency PvP utility. These labels carry the Gunnery: prefix in the UI.
• Auto Concussion Charge (Off) and Concussion Charge HP % (50) permit a defensive knockback only when the selected hostile is within 4 m. The shared Reactive Shield, Diversion, Adrenaline Rush, and Supercharged Celerity controls also apply.

Assault Specialist (PvE)

Sustained damage over time with Ionic Accelerator scheduling and a controlled opener.

• Maintains Incendiary Round / Incendiary Missile and Serrated Bolt / Serrated Shot with a refresh window and an established-target policy.
• Ionic Accelerator is scheduled around its observed proc and eligibility window. Charged Bolts starts inside the short setup window; Full Auto / Unload (or Hail of Bolts in a real 3+ target cluster) is reserved for the wider channel window. Only the exact proc makes Mag Bolt / Mag Shot or High Impact Bolt / Rail Shot free.
• Hyper Assault Rounds / Superheated Shot discounts the next Explosive Round / Missile Blast, and the observed buff is authoritative for the modifier.
• Assault Plastique / Thermal Detonator is a core cooldown. With Pre-emptive Strike and without Impact Explosives, its acknowledged start retains the contiguous follow-up: Mag Bolt, then Charged Bolts, with the resulting Ionic Accelerator payoff observed separately. Before Mag Bolt is learned the bridge is Assault Plastique into Charged Bolts. High Impact Bolt is the pre-Mag-Bolt payoff and still requires a burning target plus native admission.
• Group decisions remain target-centered. Explosive Dissemination can spread an established burn or bleed at the configured AoE threshold; Hail of Bolts and Mortar Volley require a real 3+ target channel opportunity; selected Sticky Grenade is an AoE filler. Electro Net stays behind DoT, Ionic Accelerator, Hyper Assault, and spread obligations and can be disabled for player-owned PvP timing.
• Supercharged Cell / Supercharged Gas is used at ten Supercharge stacks after Incendiary Round is established on the selected target.
• Assault Specialist has its own defensive self-heal thresholds: Bacta Infusion first, an exact Tech Override reserved for instant Medical Probe, and Med Shot only as the critical free fallback. Medical Probe is never hard-cast by this DPS route, and paid heals use the separate heal reserve.
• The first observed combat engagement uses a guided opener that establishes the DoTs, spends the one unprocced Mag Bolt when learned, and establishes the first Ionic Accelerator cycle. Key release does not recreate the opener; a new observed combat epoch does.
• Proc and DoT identities use exact client definition keys. Ionic Accelerator, Hyper Assault Rounds / Superheated Shot, Reserve Powercell / Thermal Sensor Override, Blazing Celerity, and the two owned DoTs directly affect admission or priority. Other selected passives and observed effects, including Relentless Assault / Relentless Ordnance, Boosted Bolts / Surging Shots, One Man Army, and Trauma Stabilizers, remain game-owned and are retained as route state/diagnostics rather than guessed Lua bonuses.
• Field Aid / Cure is scheduled through the shared exact-definition cleanse controller. Movement, long control, interrupt timing, detector abilities, and Recharge and Reload remain player-owned.

Controls

• AS: Incendiary Refresh (s) (1.5) sets the remaining-duration window for Incendiary Round. AS: Priority Reserve % (60) and AS: Filler Reserve % (60) are separate post-spend floors for priority actions and ordinary fillers.
• AS: Recharge Below % (45) is the Assault-specific trigger used when shared Auto Recharge Cells is enabled. AS: Auto Supercharged Cell (On) spends ten observed stacks only after Incendiary Round is established.
• AS: Use Hyper Assault Rounds (On), AS: Use Sticky Grenade (On), and AS: Use Electro Net (On) control optional proc consumption, the selected AoE filler, and the long-cooldown damage action.
• AS: Defensive Self-Heal (On), AS: Bacta Infusion HP % (45), AS: Instant Medical Probe HP % (55), AS: Med Shot Fallback HP % (25), and AS: Heal Energy Reserve % (10) configure self rescue. Medical Probe still requires exact Tech Override and is never hard-cast.
• AS: Auto Echoing Deterrence (Off) and AS: Echoing Deterrence HP % (35) configure its selected emergency defensive. Shared Automatic AoE/counting, Reactive Shield, Diversion, Adrenaline Rush, and Supercharged Celerity controls also apply; the shared defensive automations are Off by default.

Combat Medic (Healing, PvE and PvP)

Strict explicit-target healing that scales from the early kit to level 80 through your loadout.

• Every ally cast names a current friendly unit with selected-target fallback disabled, so your selection is never hijacked. Self heals are explicit self casts.
• Healing styles Safe, Balanced, Efficient, and Custom map Seer-style thresholds to the Commando kit, not Force mechanics.
• Heal Priority: Incoming Damage Formula (default) - heal targets are ordered by projected survivability instead of health alone: damage taken over the last 0.75 s / 2 s / 4 s windows, how many different attackers are on them, HoT healing already carried, projected HP at 2 s and 4 s, and an estimated time-to-die with critical / high / medium bands. Near-death patients are picked first, with projected HP and time-to-die breaking ties. The Current HP option restores the older health-only order; if combat events are dropped, the formula falls back to HP for a few seconds instead of acting on stale pressure.
• Core heals: Medical Probe / Rapid Scan, Advanced Medical Probe / Healing Scan, Bacta Infusion / Emergency Scan, Med Shot / Kolto Shot, and Successive Treatment / Progressive Scan.
• Trauma Probe / Kolto Shell is maintained on eligible allies, refreshed by charges, kept up during lulls, and never overwrites foreign ownership. Incoming-target protection triggers only when a hostile activation names that exact ally.
• Group healing uses real positions and measured missing health. Kolto Bomb / Kolto Missile uses an 8 m cluster and Successive Treatment / Progressive Scan a 20 m spread radius, each with its own minimum or the shared minimum. A group rescue chosen for a critical patient must actually cover that patient.
• Supercharged Kolto Cell / Supercharged Kolto Gas requires ten observed Supercharge stacks and a meaningful Advanced Medical Probe window. It can reset a real AMP cooldown or use the authored ten-cell refund to fund AMP, then reserves AMP as the follow-up until the effect/receipt settles. It does not fire for tiny scratches or because a timer was guessed.
• Energy uses separate routine, critical, and emergency reserves. The patient's current/forecast triage band selects the reserve; true emergencies can spend through the routine floor. Automatic Recharge Cells / Vent Heat runs before idle damage during a safe observed-combat lull, and free-ability/instant-cast effects are preserved for healing.
• Cleanses are interleaved with healing by urgency: imminent direct rescue, must-cleanse, emergency healing, movement cleanse, routine healing, pressure cleanse, then DPS. Field Aid supports Tech and Physical effects, plus Mental effects only with Psych Aid. The catalog matches exact effect definitions and never guesses from display names.
• Idle DPS requires a complete friendly snapshot, no healing candidate, every eligible ally above both the healing and DPS safety floors, observed combat by default, and the exact selected hostile. Free Hammer Shot / Rapid Shots is the final filler; optional Charged Bolts, High Impact Bolt, Full Auto, and Electro Net obey their own toggles, resource/proc preservation, movement, and native target-condition checks. A rejected heal never becomes permission to deal damage.
• A mobile Advanced Medical Probe / Healing Scan is permitted only by observed Emergency Response, Tech Override / Power Surge, or Running Restoration. Successive Treatment delegates its movement condition to Core. An already active Support Cell prevents a redundant Supercharged Kolto Cell / Supercharged Kolto Gas request.
• Self survival is a policy boundary, not a permanent self-first rule. Below the configured threshold the healer gets first refusal, but a more urgent critical ally can still preempt while the healer is above Emergency HP. The route staggers Echoing Deterrence, Reactive Shield, and Adrenaline Rush, and can use a self-centered Kolto Bomb when moving or when direct options are unavailable.
• Exact proc handling includes Emergency Response expiry promotion, Bacta-to-AMP follow-up, Tech Override snapshot handoff, Field Triage cost observation, Running Restoration movement, Parallactic Combat Stims, and SC-4 Treatment Scanner. SC-4 may choose a useful Treatment channel to build an observed 2-4 stack deficit; no stacks are credited before they are actually observed.
• The frameless Combat Medic Actions feed records accepted heals, protection, cleanses, support/resource actions, and optional downtime damage. It can show measured heal/damage totals and observed proc labels, fades rows on the configured lifetime, is draggable, and can be hidden with its on-screen X.

Controls

• Medic: Enable Healing (On), Medic: Healing: Style (Balanced; Safe / Balanced / Efficient / Custom), Medic: Healing: Targets (Players + Companions; Players only / Players + Companions / All Friendlies), and Medic: Heal Priority (Incoming Damage Formula; or Current HP) select the main healing policy.
• Custom thresholds are Medic: Custom: Burst Heal HP % (98), Custom: Group Heal Injury HP % (98), Custom: Single-Target Treatment HP % (70), Custom: Heal Below HP % (98), and Custom: Medical Probe HP % (85). They are saved but used only by the Custom style.
• Medic: Emergency HP % (40), Critical: Spend Through Reserve HP % (65), Critical Energy Reserve % (20), Self Triage Priority % (5), Self Survival: Prioritize Healer (On), Self Survival: First-Priority HP % (70), and Self Survival: Kolto Bomb (On) control emergency and self-survival boundaries.
• Medic: Routine Energy Reserve % (60), Emergency Energy Reserve % (0), Auto Recharge Cells (On), Recharge Below Energy % (45), and Recovery: Recharge Before Idle DPS (On) configure healing and recovery spending.
• Medic: Auto Supercharged Kolto Cell (On), Supercharge: Single-Target Burst HP % (75), Supercharge: Group Injury HP % (80), and Supercharge: Group Injured Count (2) define a meaningful ten-stack Cell window and its reserved AMP follow-up.
• Medic: Emergency Tech Override (On), Healing: Medical Probe Between Burst Heals (On), Procs: Emergency Response Expiry Seconds (3), Readiness: Preferred Heal Wait (ms) (150), and Continuity: Free DPS After Unusable Heals (On) configure proc use and bounded admission waiting.
• Medic: Maintain Trauma Probe (On), Trauma: Maintain Roster During Lulls (On), Trauma Refresh Charges (2), and Trauma: Protect Incoming Target (On) configure exact owned-probe maintenance and hostile-activation protection.
• Medic: Group Healing (On), Group Heal Minimum Injured (2), Group: Kolto Bomb Minimum Injured (0 = shared minimum), and Group: Treatment Minimum Injured (0 = shared minimum) control the 8 m Kolto Bomb and 20 m Successive Treatment clusters.
• Medic: Emergency Reactive Shield (On) + Reactive Shield HP % (40), Emergency Adrenaline Rush (On), and Emergency Echoing Deterrence (Off) use the healer's staggered survival policy rather than the shared DPS defensive settings.
• Downtime damage controls are Medic: DPS: Enable During Healing Downtime (On), DPS: In Combat Only (On), DPS: Minimum Ally HP % (98), DPS: Energy Reserve % (75), DPS: Free Attacks Only (Off), DPS: Charged Bolts (On), DPS: High Impact Bolt (On), DPS: Full Auto Channel (Off), DPS: Electro Net (Off), and DPS: Reserve Healing Procs (On).
• Medic: Healing Diagnostics (On) logs bounded healing-policy and admission reasons. Disable it when that detail is not needed.
• Action-feed controls are Medic: Actions: Visible (On), Actions: Position X (700), Actions: Position Y (220), Actions: Main Font Size (24), Actions: Visible Rows (5), Actions: Lifetime (8 s), Actions: Show Heal Amount (On), Actions: Show Damage (On), and Actions: Show Proc Enhancements (On). Dragging the handle persists X/Y; the on-screen X hides the feed until Visible is restored.

Commando / Mercenary Name Key

This table preserves the Mercenary mirror reference for the planned Imperial implementation. The current Lua resolves only the Commando column; these names do not mean Mercenary is already accepted by the loadout gate.

Requirements

• An active GoS: SWTOR subscription - 1 Week or 1 Month - is required for the loader and official script releases.
• The current GoS: SWTOR Core release with Lua scripting and the current cast/admission API enabled.
• Star Wars: The Old Republic, retail client.
• No other addon is required for the combat routine. Stealth Detector is optional and installed separately.

Installation

• Open the Script Library in Core, select Commando / Mercenary, and install or update to the latest release. The library installs the script and its shared dependencies together.
• Enable the script in the Scripts list and hold the Rotation Key (default Mouse 4).
• The settings card appears in the selected-script panel, changes apply live, and the healing options appear when Combat Medic is the active discipline.

Distribution check: healer_action_window.lua is a direct runtime requirement of live/commando.lua. The Script Library package must include it even if an older package manifest omits it.

Quick check

• Select the script, open the Log tab, and hold the key. The cast log confirms every submitted action.
• If nothing happens, confirm the discipline matches, the key is held, and the script status dot is green.

Notes And Roadmap

• Loadout-gated by design: a wrong discipline, missing data, or missing abilities leave the route inert instead of guessing.
• Effect identity, ownership, cooldown, position, and target-dependent branches fail closed when their required live data is unavailable. Cleanse and proc identities use exact client definitions. Runtime resource costs are preferred; only explicitly authored fallback costs are used where the route defines one.
• Every paid action checks affordability and its route's post-spend reserve. Full Auto, Boltstorm, Hail of Bolts, Mortar Volley, and Successive Treatment budget the full authored channel cost rather than trusting a zero startup cost.
• The dispatcher and one shared executor own route switching. Gunnery currently lives in the dispatcher with a helper catalog; Assault Specialist and Combat Medic are separate route modules. Mercenary support will require mirror-aware loadout, ability, effect, resource, and settings handling rather than a name-only substitution.
• Found a bug or want an addition? Post in this thread.

Built on GoS: SWTOR Core. Loadout-aware, fail-closed, and actively expanded.

One loadout-aware routine for Telekinetics / Lightning, Balance / Madness, and Seer / Corruption.

Current release: Jedi Sage and Sith Sorcerer. Both combat styles use the same priorities through an explicit name-mapping boundary.

Script build: 2026-09-30-sage-sorcerer-mirror-r27 · Settings schema: 38

Overview

The script reads the current Sage or Sorcerer loadout and dispatches exactly one mirrored route: Telekinetics / Lightning, Balance / Madness, or Seer / Corruption. A different combat style or discipline leaves the routine inactive instead of guessing.

• One command owner - all three disciplines share one top-level AbilityExecutor. A route cannot submit over an action already owned by another route.
• Core admission - Core makes the final decision on cooldown, global cooldown, resource cost, range, facing, target state, line of sight, and command lifecycle.
• Exact targeting - damage routes use the selected hostile. Seer / Corruption healing submits one explicit friendly target without replacing your visible selection or falling back to it.
• Observed state - proc, effect, position, cooldown, combat-event, and target data must be current enough for the branch that consumes it. Missing data disables that branch.
• Shared PvP cleanse - both damage routes can cleanse before their damage action. Seer / Corruption uses the same exact-definition catalog with additional healer priorities and controls.
• Per-discipline settings - the Core settings card shows controls only for the selected discipline, while shared activation, cleanse, and logging controls remain common.

Sage / Sorcerer Name Map

The priority model uses Sage names internally and resolves the matching Sorcerer name before every Core ability, effect, cast, and combat-event lookup. The settings keep their existing Sage labels so saved settings continue to work for both styles.

Shared Controls

• Rotation Key - hold to run (default Mouse 4).
• Ability Queue Window - how early Telekinetics / Lightning and Balance / Madness may prepare their next legal action before the current GCD, cast, or channel finishes.
• Shared PvP Cleanse - exact-definition cleansing while the rotation is active, with Shared Cleanse: Self, Shared Cleanse: Allies, Shared Cleanse: Roots, Shared Cleanse: Slows, Shared Cleanse: Pressure Debuffs, Shared Cleanse: Minimum Seconds, Shared Cleanse: Pressure HP %, and bounded Shared Cleanse: Diagnostics controls. It never guesses from a display name.
• Cast Log - records admissions, activations, ground-target confirmations, and important lifecycle transitions.
• Decision Log - verbose, deduplicated route and data-gate diagnostics (off by default).

Telekinetics / Lightning (PvE)

A selected-target burst route with proc-owned Telekinetic Wave, target-centered AoE counting, movement guidance, and an optional fixed burst sequence.

• Telekinetic Wave is never hard-cast. It is submitted only from an observed Tidal Force effect or a matching one-shot combat-event grant. The proc generation remains claimed until the command reaches an exact outcome.
• Weaken Mind is maintained when the target is a hostile player, a durable NPC, or movement makes it the correct mobile action. Turbulence requires enough observed Weaken Mind duration to cover the cast.
• Telekinetic Gust establishes the observed buff required before Mind Crush. Mind Crush also respects the configurable HP floor and durable-target policy.
• Dormant Tremors permits a lower Forcequake threshold. A Tremors Forcequake against two or three targets is clipped after its first GCD; normal Forcequake uses its separate threshold.
• Forceful Retribution is the two-to-three-target cleave filler when selected and the normal Forcequake threshold has not been reached.
• Disturbance is replaced by Telekinetic Burst when learned. A confirmed Clamoring Force effect makes the filler instant; Project is the final movement action.
• Pressure-aware self-preservation - with Magnifying Vibrations and an observed Reserved Light proc, the route can use instant Benevolence on itself at 85% HP or lower. Fresh urgent incoming-damage evidence can also trigger Mental Alacrity independently of the manual burst package.
• Manual burst prepares the exact level-51 package, then executes Weaken Mind, Telekinetic Gust, Force Potency, Turbulence, proc-confirmed Telekinetic Wave, Mind Crush, and Project. If Clamoring Force is selected, it continues through Force Speed and two instant fillers. Mental Alacrity is deliberately not a burst requirement.

Telekinetics / Lightning controls

• Relevant Targets (1-8) and Target-Centered Auto Count. Manual count remains authoritative unless a target-centered position sample succeeds; hostiles around the player are never substituted.
• Forceful Retribution Radius, Forcequake Count Radius, Tremors Forcequake Targets, and Normal Forcequake Targets.
• Weaken Mind HP Ratio and Mind Crush HP Floor.
• Target Count Visual (off by default), Mobility Bar: Enabled, Mobility Bar: X, and Mobility Bar: Y.
• Telekinetics: Pool for Burst, Telekinetics: Burst Key (default B), Telekinetics: Burst Status Label, and Telekinetics: Burst Readiness %.

Balance / Madness (PvE)

A sustained-damage route built around owned DoTs, observed Presence of Mind stacks, target-centered AoE decisions, optional exact-target spreading, and a movement advisor.

• Four observed Presence of Mind stacks own the next spender. Vanquish is preferred when selected; Mind Crush is used on the earlier loadout. If the primary spender is unavailable, Destructive Wave or Disturbance is the alternate instant spender. A completed four-stack proc can pre-empt the end of Telekinetic Throw at the queue edge.
• The route maintains its own Sever Force, Weaken Mind, and primary Vanquish/Mind Crush effect. Ownership must be observed; another player's DoT is not treated as yours.
• Force Serenity / Force Leech follows active Weaken Mind / Affliction and is treated as mobile because Force Mobility is baseline for Balance / Madness.
• Force in Balance is used after both maintained DoTs and spreads them when the current loadout and target cluster prove that branch. Shifted Balance is selected instead when that loadout replacement is learned.
• Forcequake is a Presence-of-Mind AoE spender at the configured two-or-more target threshold and receives the four-target priority path. Telekinetic Throw builds stacks when the proc is not ready.
• Max AoE Spread can use Force in Balance for a proven cluster or apply one missing Sever Force/Weaken Mind to one exact nearby hostile without changing your selected target.
• Optional self-support includes moving Rejuvenate below the configured HP threshold and Mending Force Armor only when no known Sage/Sorcerer shield or reapplication lockout is observed.
• While moving, the mobility overlay forecasts the actual priority chain: yellow means keep moving until the countdown ends; red means plant now for the next stationary action. Telekinetic Blitz or Project is used only when the selected loadout and priority permit it.

Balance / Madness controls

• Balance: Max AoE Spread and Balance: Max Spread Key (default Mouse 5).
• Balance: Spread Radius (default 20 m), with the cyan target range and orange next-target marker while Max Spread runs.
• Balance: Forcequake Radius (default 8 m) and Balance: Forcequake Targets (default 2).
• Balance: Moving Rejuvenate, Balance: Rejuvenate HP %, and Balance: Self Mending Armor.
• Balance Mobility Overlay: Enabled, Balance Mobility Overlay: X, Balance Mobility Overlay: Y, and Balance Mobility Overlay: Width.

Seer / Corruption (Healing, PvE and PvP)

An explicit-target healer with pressure-aware triage, proc scheduling, group-heal placement, safe Force recovery, exact-definition cleansing, and guarded idle DPS.

• Exact patients - the route includes the local player explicitly, deduplicates eligible friendlies, applies the configured Players/Companions/NPC filter, and submits every targeted heal with selected-target fallback disabled.
• Healing styles set the normal HP thresholds: Safe begins at 98%, Balanced at 95%, and Efficient at 90%, with matching thresholds for Healing Trance, Wandering Mend, and the direct filler.
• Incoming Damage Formula (default) orders patients by recent 0.75 s, 2 s, and 4 s pressure, attacker counts, observed HoT carry, projected HP, and time-to-die. Fresh urgent forecasts can admit a patient before the normal style threshold. Dropped combat events temporarily fall back to current-HP ordering instead of using stale pressure.
• Proc-aware healing preserves and spends Conveyance, Altruism, Resplendence, Force Potency, Rejuvenating Aura, Renewal, and related observed effects. The plan prioritizes immediate rescue, pressure shielding, proc consumption, group value, routine maintenance, and safe fallback actions in that order.
• Core kit - Benevolence, Rejuvenate, Healing Trance, Salvation, one supported Force Armor variant, and either Keeper of Peace or Deliverance are required before the route starts. Wandering Mend, Force Mend, Mental Alacrity, Force Potency, Vindicate, and other loadout choices are used only when learned.
• Shields and group healing - Force Armor respects Sage and Sorcerer shield/lockout observations; incoming hostile targets can be pre-shielded. Wandering Mend evaluates connected injured targets, while Salvation chooses a valid cluster center and respects its configurable ally count.
• Throughput cooldowns - Mental Alacrity is a setup action under heavy pressure. Force Potency is reserved for a useful Healing Trance/direct-heal spend and is not wasted on Rejuvenate or Wandering Mend.
• Force optimizer distinguishes routine, active, and emergency pressure. It uses observed Resplendence / Force Surge and Amnesty / Reverse Corruptions for safe Vindicate / Consuming Darkness, can build stacks with Healing Trance / Innervate, and accepts Weary debt only when one recovery action unlocks a useful emergency heal. Sage can also use free Telekinetic Throw with Telekinetic Regeneration during true downtime; the unconfirmed Corruption counterpart remains disabled. The configured reserve protects routine healing and DPS but relaxes for active or life-saving treatment.
• PvP cleansing uses the shared exact-definition catalog. Hard control normally precedes healing except for true life-saving treatment; movement and pressure effects follow their configured priorities. Physical coverage requires Mend Wounds.
• Idle DPS requires a complete friendly observation, every observed ally at or above the effective Minimum Ally HP threshold, a valid selected hostile, and enough Force to preserve the configured reserve. Priority is Weaken Mind, proven two-target Forcequake, then stationary Mind Crush, Project, Telekinetic Throw, and Disturbance; while moving it stops after Project.
• Seer Actions is a draggable recent-action feed for heals, shields, cleanses, Force recovery, DPS, confirmed amounts, and proc enhancements.
• Cast Target Lines join each hostile caster to the target captured from its matching activation event. They do not represent the player's current cast target.

Seer Actions - recent heals, shields, cleanses, Force recovery, damage, and proc enhancements

Seer / Corruption controls

• Seer: Heal Priority (Current HP / Incoming Damage Formula), Seer Healing: Style (Safe / Balanced / Efficient), and Seer Healing: Targets (Players only / Players + Companions / All Friendlies).
• Seer Healing: Auto Force Armor, Seer Healing: Pre-Shield Incoming, Seer Healing: Auto Force Mend, and Seer Healing: Force Mend HP %.
• Seer Healing: Auto Mental Alacrity, Seer Healing: Auto Force Potency, and Seer Healing: Salvation Allies.
• Seer Force: Auto Vindicate, Seer Force: Recover Below %, and Seer Force: Reserve %.
• Seer PvP: Auto Cleanse, Seer PvP: Cleanse Self, Seer PvP: Cleanse Allies, Seer PvP: Physical with Mend Wounds, Seer PvP: Cleanse Pressure Debuffs, Seer PvP: Pressure Cleanse HP %, and Seer PvP: Min Cleanse Remaining. These refine the shared cleanse controls; both layers must permit the action.
• Seer Actions: Visible, Seer Actions: Position X, Seer Actions: Position Y, Seer Actions: Main Font Size, Seer Actions: Visible Rows, Seer Actions: Lifetime, Seer Actions: Show Heal Amount, Seer Actions: Show Damage, and Seer Actions: Show Proc Enhancements.
• Seer Awareness: Cast Target Lines, Seer Awareness: Line Thickness, and Seer Awareness: Dark Outline.
• Seer DPS: Enabled, Seer DPS: Minimum Ally HP %, Seer Force: Reserve %, Seer DPS: Weaken Mind, Seer DPS: Forcequake, Seer DPS: Mind Crush, Seer DPS: Project, Seer DPS: Telekinetic Throw, and Seer DPS: Disturbance.

Current Loadout Gates

Requirements And Installation

• An active GoS: SWTOR subscription - 1 Week or 1 Month - is required for the loader and official script releases.
• Use the current GoS: SWTOR Core build shipped for this script release. The route depends on current loadout, effect, combat-event, explicit-target, command-status, and overlay contracts.
• Install and update the script from the Script Library in Core: open the Script Library, select Sage / Sorcerer, and install the latest release. The library installs the script and its shared dependencies together.

Quick check

• Select Sage or Sorcerer in the script list, enable it, and hold the Rotation Key.
• Open the script Log tab. The first line should show build 2026-09-30-sage-sorcerer-mirror-r27.
• If the routine stays inactive, check the exact combat style/discipline, required loadout choices, selected target for a damage route, script status, and current Core build before changing settings.

Limits And Support

• Confirmed names only: the Sorcerer boundary maps names backed by current client data or official Sage / Sorcerer pairings. It does not guess an unresolved display name.
• A Madness loadout that replaces Lightning Strike with the still-unconfirmed Sorcerer counterpart of Destructive Wave remains inactive until that exact live name is confirmed.
• Corruption recognizes the shared Force Mobility name. It does not assume an unconfirmed counterpart for Telekinetic Regeneration, so that optional downtime-recovery branch remains unavailable.
• Telekinetics / Lightning and Balance / Madness require a usable selected hostile. Seer / Corruption idle DPS also requires one; healing does not.
• Seer / Corruption is not an early-kit route. It remains inactive until its required healing loadout is present.
• Unknown effects, incomplete friendly observations, missing positions, stale combat events, or unavailable cooldown/cost metadata can disable only the branch that needs that evidence.
• Core remains authoritative for every cast request and terminal command outcome.
• Found a bug or want an addition? Post the current script build, discipline, relevant settings, and the matching script-log section in this thread.

Built on GoS: SWTOR Core. Loadout-aware, explicit-targeted, and fail-closed.