Sound Files for UnrealDBAnnouncer
=================================

Overview
--------
- The addon logs a keyword to `logs/UnrealDBAnnouncer.log`.
- The helper (`UnrealDBAnnouncer.exe` / `UnrealDBAnnouncer.au3`) plays
  `files\<keyword>.wav` from this addon folder.
- Alerts have toggles: `/udba alerts [readycheck|scenario|fortress|lotd|defeat|embrace|fetch|choppa] [on|off|toggle]`.
- Any keyword can be tested with `/udba play <keyword>`.
- Long keywords have short aliases (e.g. `overhere`, `choppa`, `spree`);
  `/udba list` shows them all.

Replace a sound
---------------
Easiest way: double-click `SwapSound.bat`. It lists every sound slot,
lets you pick your own WAV, checks the format, backs up the original to
`files\backup\`, and can restore originals later.
If it reports a file is in use, the announcer is usually holding it:
close it, retry the swap, and start it again afterwards.

Manual way: overwrite the WAV file for a known keyword, for example:
`files\doublekill.wav`, `files\holyshit.wav`, `files\fortressreservation.wav`,
or `files\lotdticket.wav`. Files must be plain PCM WAV (16-bit is safest;
in Audacity: File -> Export -> WAV, 16-bit PCM) -- other formats play as
silence. Keep custom clips at a similar loudness to the shipped ones.

The defeat alert uses a random pool. Replace any of:
`files\defeat.wav`, `files\defeat2.wav`, `files\defeat3.wav`,
`files\defeat4.wav`, `files\defeat5.wav`, `files\defeat6.wav`,
or `files\defeat7.wav`.
`defeat2` through `defeat7` use narrator clips from Darkest Dungeon.

Scenario pop
------------
Scenario pops play `files\notify.wav` and also flash the game window
(on by default, toggle with `/udba alerts scenario`).
To change the scenario pop sound, replace `files\notify.wav`.

Pull alerts (off by default)
----------------------------
A level 40 Marauder casting Terrible Embrace, or a level 40 White Lion
casting Fetch!, plays `files\getoverhere.wav`. A level 29+ Choppa casting
Git to da Choppa plays `files\gettothechoppa.wav`. Enable with
`/udba alerts embrace on` (Marauder), `/udba alerts fetch on` (White Lion),
or `/udba alerts choppa on` (Choppa).
Test the sounds with `/udba play getoverhere` or `/udba play gettothechoppa`.

Shipped WAVs
------------
Deathblow (fixed)
  firstblood           files\firstblood.wav              First kill in a streak
  doublekill           files\doublekill.wav              Second kill within 5s

Deathblow (normal pool, after >5s since last kill)
  annihilation         files\annihilation.wav            Random after >5s
  erradication         files\erradication.wav            Random after >5s
  extermination        files\extermination.wav           Random after >5s
  godlike              files\godlike.wav                 Random after >5s
  headshot             files\headshot.wav                Random after >5s
  dominating           files\dominating.wav              Random after >5s
  denied               files\denied.wav                  Random after >5s
  wickedsick           files\wickedsick.wav              Random after >5s

Deathblow (multi-kill pool, 3rd+ within 5s)
  bloodbath            files\bloodbath.wav               Random after 3rd+ fast kill
  holyshit             files\holyshit.wav                Random after 3rd+ fast kill
  killingspree         files\killingspree.wav            Random after 3rd+ fast kill
  ludicrous            files\ludicrous.wav               Random after 3rd+ fast kill
  megakill             files\megakill.wav                Random after 3rd+ fast kill
  monsterkill1         files\monsterkill1.wav            Random after 3rd+ fast kill
  monsterkill2         files\monsterkill2.wav            Random after 3rd+ fast kill
  multikill            files\multikill.wav               Random after 3rd+ fast kill
  rampage              files\rampage.wav                 Random after 3rd+ fast kill
  slaughter            files\slaughter.wav               Random after 3rd+ fast kill
  unstoppable          files\unstoppable.wav             Random after 3rd+ fast kill

Alerts (non-deathblow)
  readycheck           files\readycheck.wav              Ready check / bio prompt
  scenariopop          files\notify.wav                  Scenario pop + window flash
  fortressreservation  files\fortressreservation.wav     Fortress reservation pop
  lotdticket           files\lotdticket.wav              Land of the Dead ticket pop
  getoverhere          files\getoverhere.wav             Pull alerts: Terrible Embrace / Fetch! (default OFF)
  gettothechoppa       files\gettothechoppa.wav          Pull alert: Git to da Choppa (default OFF)
  defeat               files\defeat.wav                  Player death pool (random variant; default OFF)
  defeat2              files\defeat2.wav                 Player death pool (Darkest Dungeon narrator)
  defeat3              files\defeat3.wav                 Player death pool (Darkest Dungeon narrator)
  defeat4              files\defeat4.wav                 Player death pool (Darkest Dungeon narrator)
  defeat5              files\defeat5.wav                 Player death pool (Darkest Dungeon narrator)
  defeat6              files\defeat6.wav                 Player death pool (Darkest Dungeon narrator)
  defeat7              files\defeat7.wav                 Player death pool (Darkest Dungeon narrator)

Unused (shipped but never triggered automatically; playable via /udba play)
  triplekill           files\triplekill.wav              Manual play only
  ultrakill            files\ultrakill.wav               Manual play only
