# keoo88/itargetingframes_warmane architecture

> Architecture diagram of the GitHub repository keoo88/itargetingframes_warmane, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/keoo88/itargetingframes_warmane
- Repository: https://github.com/keoo88/itargetingframes_warmane

## Overview

iTargetingFrames replaces enemy nameplates with configurable unit frames: the player opens its settings, and the addon presents visible units with health, casts, auras, indicators, and bindings. Its documented feature set also includes layout, appearance, role and NPC filtering, and custom conditionals. Two optional companion addons expose the client library’s nameplate/interact API and its CVar controls. Source excerpts were not provided, so internal call relationships are omitted; edges reflect only relationships stated in the README.

Main entry points: [`iTargetingFrames/iTargetingFrames.lua`](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/iTargetingFrames.lua) (Targeting addon), [`iTargetingFrames/options.lua`](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/options.lua) (Settings window), [`AWNamePlateAPI/AWNamePlateAPI.lua`](https://github.com/keoo88/itargetingframes_warmane/blob/main/AWNamePlateAPI/AWNamePlateAPI.lua) (Nameplate API), [`AWNamePlateAPI/AWInteract.lua`](https://github.com/keoo88/itargetingframes_warmane/blob/main/AWNamePlateAPI/AWInteract.lua) (Interact command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frames["Targeting Frames"]
  node_itf["Targeting addon"]
  node_options["Settings window<br/>[options.lua]"]
end

subgraph group_features["Frame Features"]
  node_layout["Frame layout<br/>[layouts.lua]"]
  node_auras["Aura filtering<br/>[auraBlacklist.lua]"]
  node_conditionals["Custom conditions"]
  node_priority["Priority NPCs<br/>[priorityNPCs.lua]"]
  node_ranges["Range spells<br/>[rangeSpells.lua]"]
end

subgraph group_api["Nameplate API"]
  node_nameplateapi["Nameplate API<br/>[AWNamePlateAPI.lua]"]
  node_interact["Interact command<br/>[AWInteract.lua]"]
end

subgraph group_controls["Client Controls"]
  node_cvarui["CVar window<br/>[UI.lua]"]
  node_cvarcore["CVar controls<br/>[Core.lua]"]
  node_cvarconstants["CVar constants<br/>[Constants.lua]"]
  node_elvui["ElvUI skin<br/>[ElvUI.lua]"]
end

node_player(("Player"))
node_wow["WoW client"]
node_awlib["AwesomeWotlkLib"]

node_player -->|"opens /itf"| node_options
node_options -->|"configures"| node_itf
node_wow -->|"provides units"| node_itf
node_itf -->|"replaces nameplates"| node_wow
node_itf -.->|"optionally reads"| node_awlib
node_awlib -->|"publishes tokens"| node_nameplateapi
node_awlib -->|"provides channel"| node_interact
node_awlib -->|"registers controls"| node_cvarcore
node_player -->|"opens /awesome"| node_cvarui

click node_itf "https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/iTargetingFrames.lua"
click node_options "https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/options.lua"
click node_layout "https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/layouts.lua"
click node_auras "https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/auraBlacklist.lua"
click node_conditionals "https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/customConditionalTemplates.lua"
click node_priority "https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/priorityNPCs.lua"
click node_ranges "https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/rangeSpells.lua"
click node_nameplateapi "https://github.com/keoo88/itargetingframes_warmane/blob/main/AWNamePlateAPI/AWNamePlateAPI.lua"
click node_interact "https://github.com/keoo88/itargetingframes_warmane/blob/main/AWNamePlateAPI/AWInteract.lua"
click node_cvarui "https://github.com/keoo88/itargetingframes_warmane/blob/main/AwesomeCVar/UI.lua"
click node_cvarcore "https://github.com/keoo88/itargetingframes_warmane/blob/main/AwesomeCVar/Core.lua"
click node_cvarconstants "https://github.com/keoo88/itargetingframes_warmane/blob/main/AwesomeCVar/Constants.lua"
click node_elvui "https://github.com/keoo88/itargetingframes_warmane/blob/main/AwesomeCVar/Skins/ElvUI.lua"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_itf,node_options,node_wow toneBlue
class node_layout,node_auras,node_conditionals,node_priority,node_ranges toneAmber
class node_nameplateapi,node_interact toneMint
class node_cvarui,node_cvarcore,node_cvarconstants,node_elvui toneRose
class node_player,node_awlib toneIndigo
```

## Components

### Targeting Frames

- [Targeting addon](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/iTargetingFrames.lua): `iTargetingFrames/iTargetingFrames.lua`
- [Settings window](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/options.lua): `iTargetingFrames/options.lua`

### Frame Features

- [Frame layout](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/layouts.lua): `iTargetingFrames/layouts.lua`
- [Aura filtering](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/auraBlacklist.lua): `iTargetingFrames/auraBlacklist.lua`
- [Custom conditions](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/customConditionalTemplates.lua): `iTargetingFrames/customConditionalTemplates.lua`
- [Priority NPCs](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/priorityNPCs.lua): `iTargetingFrames/priorityNPCs.lua`
- [Range spells](https://github.com/keoo88/itargetingframes_warmane/blob/main/iTargetingFrames/rangeSpells.lua): `iTargetingFrames/rangeSpells.lua`

### Nameplate API

- [Nameplate API](https://github.com/keoo88/itargetingframes_warmane/blob/main/AWNamePlateAPI/AWNamePlateAPI.lua): `AWNamePlateAPI/AWNamePlateAPI.lua`
- [Interact command](https://github.com/keoo88/itargetingframes_warmane/blob/main/AWNamePlateAPI/AWInteract.lua): `AWNamePlateAPI/AWInteract.lua`

### Client Controls

- [CVar window](https://github.com/keoo88/itargetingframes_warmane/blob/main/AwesomeCVar/UI.lua): `AwesomeCVar/UI.lua`
- [CVar controls](https://github.com/keoo88/itargetingframes_warmane/blob/main/AwesomeCVar/Core.lua): `AwesomeCVar/Core.lua`
- [CVar constants](https://github.com/keoo88/itargetingframes_warmane/blob/main/AwesomeCVar/Constants.lua): `AwesomeCVar/Constants.lua`
- [ElvUI skin](https://github.com/keoo88/itargetingframes_warmane/blob/main/AwesomeCVar/Skins/ElvUI.lua): `AwesomeCVar/Skins/ElvUI.lua`

### Other components

- **Player**
- **WoW client**
- **AwesomeWotlkLib**

## Connections

- Player → Settings window: opens /itf (evidence: `README.md`)
- Settings window → Targeting addon: configures (evidence: `README.md`)
- WoW client → Targeting addon: provides units (evidence: `README.md`)
- Targeting addon → WoW client: replaces nameplates (evidence: `README.md`)
- Targeting addon → AwesomeWotlkLib: optionally reads (evidence: `README.md`)
- AwesomeWotlkLib → Nameplate API: publishes tokens (evidence: `README.md`)
- AwesomeWotlkLib → Interact command: provides channel (evidence: `README.md`)
- AwesomeWotlkLib → CVar controls: registers controls (evidence: `README.md`)
- Player → CVar window: opens /awesome (evidence: `README.md`)
