premium banner

Enhanced Bloodlust Reborn

Play custom audio when Bloodlust/Heroism is activated! An addon based on _ForgeUser53673's creation "Enhanced Bloodlust".

Description

Enhanced Bloodlust Reborn

Version Beta WoW License

Play custom music during Bloodlust/Heroism and make your battles more epic!
Original from: https://www.curseforge.com/wow/addons/enhbloodlust
Many thanks for _ForgeUser53673 creating this wonderful addon!

Features in Reborn

🎵 Sound List System

  • Plays a sound from a list when you gain Bloodlust/Heroism or similar effect.
  • Normal Bloodlust Sound (config.sound): For standard 40-second Bloodlust effects.
  • Short Bloodlust Sound (config.soundShort): For 15-second short duration effects.
    (e.g., Power Infusion)
  • The Sound List stores file path AND sound length.
    (Example: {"Interface/AddOns/EnhBloodlustReborn/music/sound1.mp3", 42})
  • There are some audio inside the music folder for testing, remember to remove them if you don't want them.

🔊 Audio Related System

  • Sound Channel Increment: Temporary increases sound channels to 128 to prevent sounds from being overridden, restores after.
  • Background Volume Control: Temporary lowers game music and ambience to 0 during playback, restores after.
  • Followed Sound Length: Instead of always stop the sound after 40 seconds, it stops and restore the volume/sound channel after the Sound Length seconds.
    • If you still want a fixated audio cut, you can re-enable this feature in enableSoundCut and enableSoundCutShort for short Bloodlust buffs.

🎲 Randomization System

  • Non-Repeating Randomize: Uses play order list to ensure all songs play once before repeating, the list is saved after logout/reload. The list will reset if the sound list is changed.
  • True Randomize Mode: Optional completely random playback (enable it from enableTrueRandomize).
  • Independent Play Queues: Normal and short music have separate play orders.

🎮 Test Commands

  • /enhbl and /enhbl test - Test play normal Bloodlust music.
  • /enhbl testshort - Test play short Bloodlust music.
  • /enhbl stop - Stop current playback.
  • /enhbl help - Show command help.

Configuration

Basic Setup

  1. Place your music files in the Interface/AddOns/EnhBloodlustReborn/music/ folder.
    For short buffs, place them in Interface/AddOns/EnhBloodlustReborn/music_short/.
  2. Open EnhBloodlustConfig.lua and follow config.sound's instruction.
  3. Reload the game.

Configuration Example:

config.sound = {
    {"Interface/AddOns/EnhBloodlustReborn/music/song1.mp3", 40},
    {"Interface/AddOns/EnhBloodlustReborn/music/song2.mp3", 42},
    {"Interface/AddOns/EnhBloodlustReborn/music/song3.mp3", 45}
}

config.soundShort = {
    {"Interface/AddOns/EnhBloodlustReborn/music/short1.mp3", 15},
    {"Interface/AddOns/EnhBloodlustReborn/music/short2.mp3", 16}
}

⚙️ Advanced Configuration

Audio Settings

  • config.channel - Which audio channel should be used by the sound.
    • Available value: "Master", "SFX", "Dialog"
  • config.enableIncreaseChannel - Enable sound channel enhancement (prevents sound ends prematurely).
    • Avilable value: true, false
  • config.enableSoundCut - Whether to end normal music early.
    • Avilable value: true, false
  • config.enableSoundCutShort - Whether to end short music early.
    • Avilable value: true, false
  • config.soundCutDuration - Normal music end time (seconds), this only works if config.enableSoundCut is true.
    • Default value: 40
  • config.soundCutDurationShort - Short music end time (seconds), this only works if config.enableSoundCutShort is true.
    • Default value: 15
  • config.enableTrueRandomize - Use random number instead of a randomized play order list.
    • Avilable value: true, false

Custom Spell List

  • You can add the spellID into config.spells manually
    • All buff duration below 40 seconds will be considered as a short buff.

Spell List Example:

config.spells = {
    2825,        -- Bloodlust
    32182,        -- Heroism
    80353,        -- Time Warp
    264667,        -- Primal Rage
    10060,        -- Power Infusion
    -- More spell IDs...
}

💡 Tips

  • Music Length: Recommend 38-50 seconds for normal music, 14-17 seconds for short music
  • File Format: Make sure your sound format is mp3, ogg, etc, which is supported by WoW.
  • Test Feature: After setup, use /enhbl test and /enhbl testshort to test effects

🔧 Troubleshooting

1. Music Not Playing

  • Verify music file paths are correct
  • Check if music duration is set correctly
  • Confirm config.channel is set correctly
  • Try enabling config.enableIncreaseChannel

2. Music Disappeared when Playing / Music Ends Prematurely

  • Make sure config.enableIncreaseChannel is true
  • Check if config.enableSoundCut is mistakenly set to true
  • Verify music duration parameter is set correctly

📝 Version Information

Current Version: 1.0.0
Supported Version: World of Warcraft 11.2.5+, not tested with other version.
Author: Fontan, Original EnhBloodlust by _ForgeUser53673

📄 License

This addon is adapted from Enhanced Bloodlust by _ForgeUser53673.

Enjoy your epic moments! 🔥

If you have any questions or suggestions, feel free to report them!

Enhanced Bloodlust Reborn - 強化嗜血重生版

Version Beta WoW License

在嗜血/英雄主義期間播放自訂音樂，讓你的戰鬥更加熱血！
原始版本來自：https://www.curseforge.com/wow/addons/enhbloodlust
特別感謝 _ForgeUser53673 製作了這個超棒的插件！

重生版的新功能

🎵 音效清單系統

  • 在你獲得嗜血/英勇或類似的buff時播放音效清單裡的音樂。
  • 一般嗜血音效 (config.sound)：用於標準 40 秒的嗜血效果。
  • 短時嗜血音效 (config.soundShort)：用於 15 秒的短時效果(例如：注入能量)。
  • 音效清單會同時儲存檔案路徑和音樂長度。
    • (範例：{"Interface/AddOns/EnhBloodlustReborn/music/sound1.mp3", 42})

🔊 音效相關系統

  • 增加音效頻道：暫時將音效頻道提升至 128 以避免音效被覆蓋，播放完畢後恢復
  • 背景音量控制：播放期間暫時將遊戲音樂和環境音效降為 0，播放完畢後恢復
  • 依照音樂長度播放：不再固定在 40 秒後停止音樂，而是根據音樂實際長度來停止並恢復音量
    • 如果你還是想要固定的音效停止時間，可以在 enableSoundCut 和 enableSoundCutShort(針對短時嗜血)重新啟用此功能。

🎲 改進的隨機播放系統

  • 不重複隨機播放：使用播放順序清單，確保所有歌曲都播放過一輪才會重複，清單會在登出/重載後保存。
    如果音樂清單有變更，播放順序清單會重置。
  • 真隨機模式：可選擇不使用播放順序清單，使用完全隨機的播放方式(透過 enableTrueRandomize 啟用)。
  • 獨立播放佇列：一般音效和短時音效有各自獨立的播放順序。

🎮 測試指令

  • /enhbl 和 /enhbl test - 測試播放一般嗜血音樂
  • /enhbl testshort - 測試播放短時嗜血音樂
  • /enhbl stop - 停止目前播放
  • /enhbl help - 顯示指令說明

設定選項

基本設定

  1. 將你的音樂檔案放到 Interface/AddOns/EnhBloodlustReborn/music/ 資料夾。
    短時嗜血 buff 的音樂請放到 Interface/AddOns/EnhBloodlustReborn/music_short/。
  2. 開啟 EnhBloodlustConfig.lua 並按照以下說明設定：
  • 以路徑"Interface/AddOns/EnhBloodlustReborn/"作為前綴，將路徑存放在大括號{}中。
  • 然後，在路徑的後面加一個逗號，輸入音效時長。
  • 完成一筆資料後，在大括號後面加上逗號，然後繼續下一筆資料。
  • 最後一筆資料後面不要加上逗號。
  1. 重新載入遊戲

設定範例：

config.sound = {
    {"Interface/AddOns/EnhBloodlustReborn/music/song1.mp3", 40},
    {"Interface/AddOns/EnhBloodlustReborn/music/song2.mp3", 42},
    {"Interface/AddOns/EnhBloodlustReborn/music/song3.mp3", 45}
}

config.soundShort = {
    {"Interface/AddOns/EnhBloodlustReborn/music/short1.mp3", 15},
    {"Interface/AddOns/EnhBloodlustReborn/music/short2.mp3", 16}
}

⚙️ 進階設定

音效設定

  • config.channel：音效使用的音訊頻道。
    • 可用值："Master"、"SFX"、"Dialog"。
  • config.enableIncreaseChannel：啟用音效頻道增強(避免音效提前結束)。
    • 可用值：true、false。
  • config.enableSoundCut：是否提前結束一般音樂。
    • 可用值：true、false。
  • config.enableSoundCutShort：是否提前結束短時音樂。
    • 可用值：true、false。
  • config.soundCutDuration：一般音樂的結束時間(秒)。
    • 預設值：40。
  • config.soundCutDurationShort：短時音樂的結束時間(秒)。
    • 預設值：15。
  • config.enableTrueRandomize：使用真隨機而非隨機播放順序清單。
    • 可用值：true、false。

自訂法術清單

  • 你可以手動將法術 ID 加入 config.spells。
    • 所有持續時間低於 40 秒的 buff 都會被視為短時 buff。

法術清單範例：

config.spells = {
    2825,        -- 嗜血
    32182,        -- 英勇氣概
    80353,        -- 時間扭曲
    264667,        -- 原始狂怒
    10060,        -- 注入能量
    -- 更多法術 ID...
}

💡 小技巧

  1. 音樂長度：建議一般音樂使用 38-50 秒，短時音樂使用 14-17 秒。
  2. 檔案格式：確保你的音樂格式是 WoW 支援的 mp3、ogg 等格式。
  3. 測試功能：設定完成後，使用 /enhbl test 和 /enhbl testshort 來測試效果。

🔧 疑難排解

1. 音樂沒有播放

  • 確認音效檔案路徑是否正確
  • 確認 config.channel 設定是否正確
  • 試著啟用 config.enableIncreaseChannel

2. 音樂播放到一半消失 / 音樂提前結束

  • 檢查音效時長是否設定正確
  • 確保 config.enableIncreaseChannel 設為 true
  • 檢查 config.enableSoundCut 是否誤設為 true

📝 版本資訊

目前版本：1.0.0
支援版本：魔獸世界 11.2.5+，其他版本未測試
作者：Fontan，原版 EnhBloodlust 作者為 _ForgeUser53673

📄 授權

本插件改編自 _ForgeUser53673 的 Enhanced Bloodlust。

享受你的史詩時刻吧！ 🔥

如果有任何問題或建議，歡迎回報！