# Lyra Gestalt **A visible, talking companion who watches your Hardcore run — and never presses a key.** She lives at the edge of your screen: a face with about thirty expressions, a voice in English and German, and a memory. She reacts to what happens to **you** — health dropping, a burst of damage, air running out, an elite in your target, a zone where you nearly died last week. She says less than a typical addon and remembers much more. --- ## What Lyra does - **Watches your life.** Health thresholds, sudden burst damage, fall damage, breath underwater, fatigue — spoken and shown, instantly, in combat. - **Names the danger.** Adds joining the fight, elites in your target, level gaps that will kill you, an empty potion bag. - **Warns before the place, not after the death.** A data pack aggregated from the public Deathlog database marks the cliffs, the deep water and the camps where hardcore characters die — and Lyra remembers the spots where *you* nearly died. - **Remembers.** Zone greetings with history ("Welcome back to the Barrens. Last time you nearly died here."), a bestiary of the mobs that keep hurting you, session and milestone rituals. - **Speaks.** Pre-rendered voice lines in English and German, plus a subtitle in the speech bubble. Voice packs are loaded on demand. - **Talks back.** Click her for a dialog tree, or type `/lyra ` and she answers. - **Stays out of the way.** Three warning levels, per-category switches, presets from Quiet to Streamer, combat and group quiet modes, size presets, free positioning. ## What Lyra never does > **No automation.** She never presses a key, never moves, never casts, never targets. > **No chat output.** She never writes into any channel — not say, not guild, not whisper. > **No data about other players.** No names, no whispers, no group members, no addon channel. > **No network.** Nothing leaves your machine. **No ads, no purchases, no premium features.** > Everything runs through the public AddOn API: she reads, she shows, she speaks. This addon is free and stays free. All of it. --- ## Install Get it from CurseForge or Wago — the download contains all four folders: ``` Interface/AddOns/Lyra_Gestalt/ the addon Interface/AddOns/Lyra_Gestalt_Stimme_de/ German voice, loaded on demand Interface/AddOns/Lyra_Gestalt_Stimme_en/ English voice, loaded on demand Interface/AddOns/Lyra_Gestalt_Daten/ danger map (Deathlog data) ``` Nothing extra to install and nothing to configure. On first login Lyra asks four questions (language, how to address you, talkativeness, portrait or full figure). Repeat any time with `/lyra einrichten`. **Note on sound:** WoW only finds sound files that were present in the AddOns folder **when the game client started**. After installing or updating, restart the client once — a `/reload` is not enough. ## Commands | Command | What it does | |---|---| | `/lyra` | open settings | | `/lyra status` | version, client, loaded voice packs, active options | | `/lyra lang de` / `en` | language (default: your client locale) | | `/lyra anrede m` / `f` / `keine` | how she addresses you | | `/lyra leise` / `normal` / `lebendig` / `streamer` | presets | | `/lyra still` · `/lyra stumm` | quiet mode · mute voice | | `/lyra portrait` / `figur` · `/lyra klein` / `mittel` / `gross` | view and size | | `/lyra chronik` | chronicle, bestiary, near-death map | | `/lyra frag` | dialog tree · `/lyra ` just talk to her | | `/lyra test HP20` | preview a single event (any event ID) | | `/lyra debug` | diagnostic block for bug reports — contains no names | --- ## FAQ **Is this allowed on Hardcore realms?** Yes. Lyra reads the same public AddOn API that Deathlog, Questie and DBM read. She performs no action for you: no key press, no movement, no casting, no targeting, no automation of any kind. The full source is in this repository — read it. **Does it work with Deathlog / Hardcore / Questie / unitscan?** Yes, all of them. Lyra writes nothing to chat and uses no addon communication channel, so she cannot collide with them. If you run Deathlog, Lyra deliberately stays silent about other players' deaths — that is Deathlog's job. **Which game versions?** Classic Era / Hardcore (1.15.9) right now. TBC, Wrath and Retail builds are in preparation; the Retail build will have fewer combat senses because of the Midnight combat-addon restrictions. For *WoW: Forever* we are waiting for the beta client's API. **Why is the voice not playing?** Three usual reasons: (1) you installed while the client was running — restart the client, not just `/reload`; (2) `/lyra stumm` is active; (3) the in-game "Dialog" sound channel is muted — Lyra uses `Sound_DialogVolume`. Check `/lyra status`, it lists the loaded voice packs. **Is the voice AI-generated?** Yes, and it says so everywhere. Lyra's voice is synthetic, rendered offline by an AI text-to-speech model and marked as AI-generated in line with EU AI Act Art. 50. No Blizzard audio is shipped with this addon. See `LICENSE-ASSETS.md`. **She talks too much / too little.** `/lyra leise` or `/lyra lebendig`, or open the settings and switch off individual categories. Lyra ships with the *Normal* preset and is deliberately quieter than most addons. During combat she only says the things that can save your life. **Can I move or resize her?** Drag her with the left mouse button (unless locked). `/lyra klein|mittel|gross`, or `/lyra groesse ` for a free value. `/lyra portrait` shows head and shoulders only, `/lyra figur` the full figure. **Does she send anything anywhere?** No. There is no network code in this addon. Nothing is uploaded, nothing is collected, nothing about other players is ever stored. `/lyra debug` prints no character, guild or channel names. **Will there ever be paid features?** No. The addon is free and complete, and it stays that way. Blizzard's add-on policy forbids paid features, and we agree with it. --- ## Known issues - [[KI-1]] Retail/Midnight: combat-log-based senses (burst damage, add counting, bestiary hits) are limited by the new secret-value rules. Classic Era is unaffected. - [[KI-2]] A voice pack installed while the client is running stays silent until the next full restart (WoW loads sound files only at client start). - [[KI-3]] At UI scales below 0.65 the speech bubble can overlap the default action bar. Workaround: `/lyra klein` or drag her higher. - [[KI-4]] German voice lines for the newest events fall back to the subtitle only. Report bugs as **issues** — the template asks for the `/lyra debug` block, which makes fixing fast. CurseForge comments are read weekly. --- ## Personal lines — optional, and built on your own machine There is a fifth folder that is **not** part of the download: `Lyra_Gestalt_Persoenlich`. It holds sentences written from *your own* chronicle — your zones, your sessions, your numbers — and Lyra mixes them in among her built-in lines. It is user-specific by definition, so it cannot ship with the addon. Format, rules and an empty template: [`docs/persoenlich/`](docs/persoenlich/). ## Help translate English and German are complete. Everything else is open, and translators are credited in the chronicle of supporters. See [CONTRIBUTING.md](CONTRIBUTING.md). - Text: the **Localization** tab of the CurseForge project — no GitHub account needed. - Voice: only German and English are recorded. A new voice language needs a fully translated phrase set plus a TTS voice with a clean license — talk to us first. --- ## Build it yourself This repository is the **release layout** the [BigWigs packager][pkg] expects: the main TOC in the root, the extra addons under `Pakete/`, lifted to the top level of the zip by `.pkgmeta`. It is generated from the development monorepo by `tools/release-sync.sh` — so `addon/` over there is the source of truth, not this tree. ```bash curl -sO https://raw.githubusercontent.com/BigWigsMods/packager/master/release.sh chmod +x release.sh ./release.sh -d # builds .release/*.zip, uploads nothing ``` The result must contain exactly four top-level folders. Details and the whole release procedure: [`docs/release-ablauf.md`](docs/release-ablauf.md). [pkg]: https://github.com/BigWigsMods/packager ## Credits & licenses - **Code** — MIT License, see [`LICENSE`](LICENSE). - **Voice** — synthetic speech, generated offline with an AI text-to-speech model and rendered to OGG. Labelled as AI-generated in line with EU AI Act Art. 50. All rights reserved; not for reuse outside this addon. - **Sprite art** — [[SPRITE-CREDIT]]. Licensed, bundled solely as part of this addon; extracting or redistributing the art separately is not permitted. - **Danger map data** — `Lyra_Gestalt_Daten` aggregates the public [Deathlog database](https://github.com/Deathwing/Deathlog) by Deathwing and Yazpad and is therefore distributed under **GPLv3**, as required by that project's license. The pack contains aggregated zone/level/grid danger values only — **no character names, no guild names, no last words.** - **Sound cues** — rendered with [Piper](https://github.com/rhasspy/piper) (MIT). Full detail for art, voice and data: [`LICENSE-ASSETS.md`](LICENSE-ASSETS.md). Lyra Gestalt is an independent fan project. **Not affiliated with or endorsed by Blizzard Entertainment.** World of Warcraft and Blizzard Entertainment are trademarks of Blizzard Entertainment, Inc. --- ## Links - Source code & bug reports: [[LINK-GITHUB]] - Discord (help, phrase suggestions, translations): [[LINK-DISCORD]] - Also on Wago Addons: [[LINK-WAGO]] - If you want to support development: https://buy.stripe.com/00w8wOeo2dJ71Wr5ZBcwg01 — the addon stays free and complete either way.