AspirWatch

An Ashita v4 addon for HorizonXI that displays a pulsing on-screen alert when Aspir (and optionally Drain) is ready to cast — no box, no border, just clean floating text.

---

Screenshots

Cooldown countdown — gray text showing remaining seconds, turns orange under 5s:

Ready alert — bold pulsing text when the spell is off cooldown:

---

Features

• No box overlay — text renders directly on screen like SimpleLog ability pop-ups
• Pulsing color animation when the spell is ready
• Countdown timer while the spell is on cooldown (turns orange under 5 seconds)
• Sound alert when the spell comes off cooldown
• Full config menu (/aspir) with:
  • Custom ready text (ASCII)
  • Font family (9 choices), size, and color picker
  • X/Y position sliders
  • Sound toggle
  • Optional Drain tracking

---

Installation

This repository contains versions for both Ashita v4 (default) and Windower 4.

For Ashita v4 (HorizonXI default)

1. Download the latest release zip and extract the aspirwatch folder into your Ashita/addons/ directory (e.g. HorizonXI/Game/addons/aspirwatch/)
2. In game, load the addon: /addon load aspirwatch
3. Open the config menu to position and customize: /aspir

For Windower 4

1. Download the latest release zip, open the windower folder inside, and extract that aspirwatch folder into your Windower4/addons/ directory.
2. In game, load the addon: //lua load aspirwatch
3. Position by clicking and dragging the text on screen. Use chat commands to configure:
   • //aspir size 42 — Set font size
   • //aspir text ~~ ASPIR READY ~~ — Set custom text
   • //aspir sound — Toggle ready sound
   • //aspir drain — Toggle Drain tracking
   • //aspir pulse — Toggle pulsing effect

---

How It Works

AspirWatch reads the spell recast timer directly from game memory every frame using Ashita's GetRecast():GetSpellTimer() API — the same method used by tCrossBar. The spell is found by name scan at load time, so it works regardless of server-specific spell ID differences.

• Timer > 0 → spell is on cooldown → shows countdown
• Timer = 0 → spell is ready → shows your custom alert text, pulsing

---

Version History

• v3.6 — Spell lookup by name scan (HorizonXI compatibility), resource.Index recast fix
• v3.5 — Switched to resource.Index for GetSpellTimer (tCrossBar method)
• v3.4 — Simplified state machine, removed drag box
• v3.3 — ASCII-only text, removed drag handle box
• v3.2 — Full config menu with tabbed UI
• v3.1 — State machine cooldown tracking
• v3.0 — Switched from ImGui to Ashita native fonts API (no-box rendering)
• v2.0 — Full config menu with ImGui
• v1.0 — Initial release

---

Credits

Built for HorizonXI — a classic FFXI private server. Created by Schmeee.