Boss Kill Predictor (WoW Classic 20주년 서버용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.5 (빌드 20505), 
Version: 1.1.6 (2026. 1. 15.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ Boss Kill Predictor는 전투 중 보스의 생명력 변화 속도를 기반으로 '처치까지 남은 예상 시간(Time To Die, TTD)'을 실시간으로 계산하고, TTD가 65초, 35초, 25초 이하가 되었을 때 자동으로 알림을 출력하는 애드온입니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 보스 판별
 - 공격대 던전 보스: UnitIsBossMob(unit)
 - 야외 월드보스: UnitClassification(unit) == "worldboss"

■ TTD(Time To Die) 계산
 - 보스의 체력 변화를 10초 구간 단위로 추적하고, 지수 이동 평균(EMA)을 적용해 RDPS(초당 체력 감소량)를 보정한 뒤 남은 시간을 예측합니다.
 - 초기 안정화 구간(3초) 이후부터 예측이 시작됩니다.

■ 자동 알림
 - 남은 처치 예상 시간이 다음 구간 이하로 내려갈 때 한 번씩 알림:
   • 65초  
   • 35초  
   • 25초
 - 각 구간에서 한 번만 출력되며, 전투 종료 시 리셋됩니다.
 - 출력 채널은 사용자 설정 가능 (기본: /say)

■ BossKillPredictorDB
 - 채널, on|off 설정 저장

─────────────────────────────
3. 출력 채널 설정 및 제어 명령어
─────────────────────────────
■ 기본 명령어:  
 - /bkp : 도움말 및 현재 상태 출력  

■ 애드온 켜기/끄기:  
 - /bkp on : Boss Kill Predictor 활성화  
 - /bkp off : Boss Kill Predictor 비활성화  

■ 출력 채널 변경 (약칭 입력 허용):  
 - /bkp channel [say|raid|whisper]
   • /bkp channel say 또는 s
   → 일반 대화(/say)로 출력 (기본 설정)
   • /bkp channel raid 또는 r
   → 공격대 대화(/raid)로 출력
   • /bkp channel raid_warning 또는 rw
   → 공격대 경보 대화(/raid_warning)로 출력
   • /bkp channel whisper 또는 w
   → 플레이어 본인에게 귓속말로 출력 (개인용 알림)

─────────────────────────────
4. 설치 방법
─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요.

Interface
└── AddOns
    └── BossKillPredictor
        ├── BossKillPredictor.lua
        ├── BossKillPredictor_TBC.toc
        ├── BossKillPredictor_Vanilla.toc
        └── README.txt

■ 게임 내 ‘애드온’ 탭에서 [Boss Kill Predictor]가 활성화되어 있는지 확인합니다.

■ 전투 중 보스 타겟을 인식하면 자동으로 동작합니다.

─────────────────────────────
5. 사용 예시
─────────────────────────────
■ 보스 체력 감소로 TTD가 65초 이하일 때 : <라그나로스> 예상 처치까지 남은 시간: 63초

■ 이후 35초, 25초 구간에서도 동일 형식의 메시지가 한 번씩 출력됩니다. 출력 시점은 DPS 변화에 따라 약간의 차이가 있을 수 있습니다.

─────────────────────────────
6. 주의 사항
─────────────────────────────
■ 실제 처치 시간은 파티/공대 DPS 변화에 따라 달라질 수 있습니다.

■ 각 임계 구간에서는 한 번만 알림이 발생합니다.

■ 전투 종료 시 모든 데이터와 알림 플래그가 자동 초기화됩니다.

■ WHISPER 모드는 본인에게만 메시지가 전달되므로 타인에게는 보이지 않습니다.

─────────────────────────────
7. 변경 이력
─────────────────────────────
■ 1.0.0 (2025. 10. 13.)
 - RDPS 기반 TTD 예측 기능
 - 죽음의 소원 / 무모한 희생 시전

■ 1.0.3 (2025. 10. 17.)
 - 단순화 버전: 위 스킬 관련 기능 제거
 - 30초/20초 구간에서 /say 알림만 출력

■ 1.0.4 (2025. 10. 18.)
 - GUID 기반 DPS 추적, TTD 계산 정밀도 향상

■ 1.0.5 (2025. 10. 22.)
 - 첫 타격 시 0초 남음 출력 버그 수정
 - timeToDie가 계산된 이후(>0)부터만 알림 허용

■ 1.0.6 (2025. 10. 22.)
 - '직전 체력 대비 감소율' 기반 계산으로 개선
 - DPS 급변 완충 및 알림 타이밍 조정
 - 알림 임계값을 65초, 35초, 25초로 조정

■ 1.1.0 (2025. 10. 23.)
 - 예측 로직 개선 (슬라이딩 윈도우 방식 도입으로 입력값을 안정화시켜서 지수 이동 평균의 정확도 향상)

■ 1.1.1 (2025. 10. 23.)
 - 출력 채널 설정 기능 추가 (/bkp channel [say|raid|raid_warning|whisper])
 - WHISPER 모드 지원 (본인에게 귓속말 알림)
 - 애드온 활성/비활성 명령어 추가 (/bkp on, /bkp off)

■ 1.1.2 (2025. 10. 24.)
 - 사용자 입력 약칭(s/r/rw/w) 지원 및 내부 정식 채널명 변환 적용
 - 안내 메시지 수정: 약칭 입력 안내 반영

■ 1.1.3 (2025. 10. 25.)
 - 예측 로직 개선 (히스테리시스 방식 도입으로 TTD 상승 시에 둔감하도록 해서 지수 이동 평균의 정확도 향상)

■ 1.1.4 (2025. 10. 31.)
 - 보스 판별 방식 수정
 - 활성화/비활성화 오류 수정

■ 1.1.5 (2025. 11. 6.)
 - 채널, on|off 설정 저장 (BossKillPredictorDB)

■ 1.1.6 (2026. 1. 15.)
 - 기존 toc 파일명 변경 및 TBC용 toc 추가 

─────────────────────────────
8. 저작권 및 이용 조건
─────────────────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

─────────────────────────────
9. 개발자 정보
─────────────────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드
