My Simple Hunter (WoW Classic 20주년 서버 & TBC 호환용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.6 (빌드 20506)
Version: 1.0.6 (2026. 9. 15.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Hunter는 사냥꾼의 상과 덫을 직관적으로 관리하고, 주요 쿨다운, 발동 효과, 디버프 지속시간을 한눈에 파악할 수 있도록 순수 Lua로 가볍게 작성된 사냥꾼 전용 애드온입니다.

■ 현재 접속한 캐릭터가 사냥꾼일 때만 활성화되며, 7개의 상 바와 5개의 덫 바를 독립적으로 배치할 수 있습니다. 또한 죽은척하기 및 눈속임 지속시간, 덫 발동 디버프 추적, 전투 중 사냥꾼의 징표 누락 경보 및 각종 스킬의 쿨다운과 특성 발동 상태에 대한 개인 화면 중앙 알림(경보음 포함)을 제공합니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 상 및 덫 관리 바
 - 상 버튼: 7개의 주요 상(매, 독사, 원숭이, 야생, 치타, 치타 무리, 야수)을 가로로 배치하여 클릭으로 즉시 시전합니다. 현재 활성화된 상은 아이콘이 밝게 표시됩니다.
 - 덫 버튼: 5개의 덫(얼음, 냉기, 제물, 폭발, 뱀)과 이동 잠금/해제 토글 버튼을 가로로 배치하고 버튼 하단에 덫 시전 쿨다운(노란색)을, 버튼 외곽에 덫 설치 지속시간 카운트다운(흰색)을 직관적으로 표시합니다.
 - 덫 디버프: 적에게 덫(얼음, 냉기, 제물, 폭발, 뱀)이 발동되면 덫 바 오른쪽에 그 아이콘과 지속시간을 표시하며, 종료 5초 전부터는 텍스트 색상이 Cyan에서 Magenta로 변경되어 직관적인 덫 관리가 가능합니다.
 - 독립적 이동: 상 바와 덫 바는 각각 독립적으로 화면 내 원하는 곳으로 드래그하여 배치할 수 있습니다.

■ 화면 중앙 추적기
 - 죽은척하기: 시전 시 화면 중앙 하단에 스킬 아이콘과 함께 남은 지속시간을 분:초 단위로 카운트다운합니다.
 - 눈속임: 시전 시 화면 중앙 하단에 스킬 아이콘과 함께 남은 지속시간을 초 단위로 카운트다운합니다. 지속시간이 남아 있더라도 3회 공격시 사라집니다.

■ 전투 및 스킬 알림 (개인 화면 중앙)
 - 쿨다운 종료: 주요 스킬(위협, 야수의 격노, 산탄 사격, 공격 저지, 속사, 죽은척하기, 눈속임, 섬광, 종족 특성 등)의 쿨다운 종료 전(빨간색) 및 시전 가능 시점(초록색)을 출력합니다.
 - 발동 효과: 신속 사격(매의 상 연마), 역습, 살상 명령, 올가미 특성 발동 시에 출력합니다.
 - 사냥꾼의 징표 누락: 전투 중인데 어떤 대상에게도 내 사냥꾼의 징표가 안 걸려 있다면 출력합니다. 추가로 덫 바의 외곽(덫 설치 지속시간의 하단이나 상단)에 내 사냥꾼의 징표가 걸린 대상 이름을 출력합니다.
 - 상 주의: 전투 중인데 치타의 상이나 치타 무리의 상이 켜져 있다면 출력합니다.
 - 경보음 재생: 본 애드온 폴더 안에 MSH_RW.ogg 파일이 있으면 우선 재생하고, 없다면 기본 경보음(RaidWarning.ogg)을 재생합니다. 설정 창에서 세부 알림을 개별적으로 켜거나 끌 수 있습니다.

■ 지속시간 표시 상단/하단 설정
 - 덫 바 외곽에 덫 설치 지속시간, 덫 디버프 지속시간, 사냥꾼의 징표 대상이 표시되는 위치를 상단 또는 하단으로 설정할 수 있습니다.

─────────────────────────────
3. 명령어 및 사용 방법
─────────────────────────────
■ 기본 명령어
 - /간단냥꾼 또는 /msh : 설정 창 열기/닫기

■ 화면 중앙 메시지 및 경보음 설정
 - 설정 창에서 ON(RW), ON, OFF로 전체 알림 모드를 변경할 수 있습니다.
 - 징표/정조준, 죽척/섬광, 위협/올가미/역습, 상/덫 등 카테고리별로 체크박스를 통해 세밀하게 켜고 끌 수 있습니다.

■ 위치 이동 및 잠금
 - 덫 바의 6번째 버튼(사냥꾼 직업 아이콘)을 Shift+우클릭하여 상 바와 덫 바의 이동 잠금/해제를 동시에 토글합니다.
 - 잠금 해제 시 드래그하여 두 바를 각각 원하는 위치에 배치한 후 다시 Shift+우클릭하여 고정합니다.

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

Interface
└── AddOns
    └── MySimpleHunter
        ├── MySimpleHunter.lua
        ├── MySimpleHunter_Vanilla.toc
        ├── MySimpleHunter_TBC.toc
        ├── README.txt
        └── MSH_RW.ogg (선택 사항 - 커스텀 경보음)

■ 게임 내 '애드온' 탭에서 [My Simple Hunter]가 활성화되어 있는지 확인합니다.

─────────────────────────────
5. 주의 사항 및 팁
─────────────────────────────
■ 사냥꾼 전용: 이 애드온은 사냥꾼 이외의 직업으로 접속하면 동작하지 않습니다.

■ 이동 상태 제한: UI 이동 잠금이 해제된 상태(연녹색 테두리 표시)에서는 좌클릭을 통한 상 변경 및 덫 설치가 작동하지 않으므로, 위치 설정 후 반드시 다시 6번째 버튼을 Shift+우클릭해서 잠가주시기 바랍니다.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 4. 1.)
 - 사냥꾼 전용 독립형 상 바 및 덫 바 프레임
 - 주요 스킬 쿨다운, 덫 설치 및 디버프 지속시간, 죽은척하기, 발동 효과(신속 사격, 역습, 올가미), 사냥꾼의 징표 누락 추적

■ 1.0.1 (2026. 7. 9.)
 - 지속시간 표시 상단/하단 설정 추가 (덫 설치 지속시간, 덫 디버프 지속시간, 사냥꾼의 징표 대상 및 지속시간)
 - 덫 바 우측의 덫 디버프 지속시간에 덫 개량 특성이 반영되도록 수정 (얼음의 덫, 냉기의 덫)
 - TOC 파일 버전 수정

■ 1.0.2 (2026. 8. 4.)
 - 개인 화면 중앙의 전투 및 스킬 알림에서 발동 효과에 살상 명령을 추가 (시전시 또는 비활성화시에 즉시 사라지고 활성화됐더라도 쿨다운이 종료되지 않았다면 옆에 추가 표시)
 - 개인 화면 중앙의 전투 및 스킬 알림에서 사냥꾼의 징표 누락 경보가 징표 시전시에 즉시 사라지도록 수정

■ 1.0.3 (2026. 8. 4.)
 - 개인 화면 중앙의 전투 및 스킬 알림에서 쿨다운 종료에 눈속임을 추가하고 화면 중앙 추적기에 눈속임 지속시간을 추가

■ 1.0.4 (2026. 8. 4.)
 - 전투 중 판정으로 인해 버튼 속성 재주입이 차단되는 문제를 수정

■ 1.0.5 (2026. 9. 8.)
 - 개인 화면 중앙의 전투 및 스킬 알림에서 전투 중 치타/치타 무리의 상 경보가 다른 상 시전시에 즉시 사라지도록 수정

■ 1.0.6 (2026. 9. 15.)
 - TOC 파일 카테고리 추가

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

■ 개발자 표기

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

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

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