My Simple Class Timer (WoW Classic 20주년 서버용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.5 (빌드 20505), 
Version: 1.0.4 (2026. 3. 27.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Class Timer는 와우 클래식 환경에서 플레이어에게 걸린 단기 버프, 스킬/아이템 쿨다운, 디버프와 대상에게 건 디버프를 직관적인 타이머 바(Bar) 형태로 추적해 주는 애드온입니다.

■ 복잡한 설정 없이 가볍게 동작하며, 본인에게 걸린 3분 이하의 짧은 버프와 중요 스킬/아이템의 쿨다운을 시각적으로 관리할 수 있도록 돕습니다.

■ 전사의 '무모한 희생', '죽음의 소원'이나 오크의 '피의 격노'처럼 시스템상 디버프로 분류되지만 실제로는 버프인 기술들을 자동으로 버프 창에 통합하여 표시합니다.

■ 명령어 입력이 번거로운 사용자를 위해 직관적인 GUI 설정 창을 지원하며, 30% 불투명도의 반투명한 디자인으로 화면을 가리지 않습니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ GUI 설정 창 및 명령어
 - /간단직업 : 설정 창(GUI) 열기
 - /msct : 설정 창(GUI) 열기, 명령어 안내
 - /msct b|c|d|u|m on|off, /msct b|c|d|u|m l|ul : 각 바 세트별 활성화(보이기/숨기기), 위치(잠금/해제) 설정
 - 잠금 해제 시 초록색 배경의 앵커가 나타나 드래그로 위치 이동 가능
 - /msct up|down, /msct set com|sep|uni, /msct b p|m : 바 생성 방향(상단/하단), 바 세트 모드(결속/분리/통합), 버프 출처(본인/아군) 필터링 설정 
 - /msct ex [주문 이름], /msct ex list : 쿨다운 숨김 목록 추가/삭제 및 조회
 - /msct d [주문 이름/지속 시간], /msct d list : 디버프 지속 목록 추가/삭제/수정 및 조회
 - /msct b item|skill : 아이템 쿨다운 추적(ON/OFF) 설정
 - /msct reset : 모든 설정 및 DB 목록 초기화 (이후 기본 목록 적용)

■ 3가지 독립적인 바 세트 (기본 설정)
 1. 버프/쿨다운 :
    - 지속시간 3분(180초) 이하의 버프 및 토템 추적 (파란색)
    - 장신구, 물약 등 사용 가능한 아이템의 쿨다운도 함께 추적 (설정으로 ON/OFF 가능)
    - 토템 소환 시 레벨(랭크)을 표시하며, 쿨다운 바를 통합하여 표시
    - 전사/오크의 특수 스킬(무모한 희생, 죽음의 소원, 피의 격노)은 디버프여도 버프로 인식하여 표시 (주황색)
    - 쿨다운 고스트 바(Ghost Bar): 버프 종료 후에도 쿨다운 잔여 시 회색 바 유지
    - 쿨다운 완료 시 5초간 "Ready" 텍스트 출력

 2. 디버프/메즈 :
    - 플레이어에게 걸린 해로운 효과 중 특수 버프를 제외한 나머지(기절, 공포 등)를 추적 (빨간색)

 3. 대상 디버프 :
    - 내가 현재 대상(Target)에게 건 디버프만 추적 (보라색)

 4. 중첩형 스킬(방어구 가르기 등)은 아이콘에 '×5' 형식으로 횟수 표시

■ 다중 대상 디버프 (Multi-Target Debuffs)
 - 현재 대상이 아닌 다른 적들에게 건 디버프를 최대 3개 유닛까지 추적
 - '#1', '#2', '#3'으로 구분되며, 공격대 징표가 있을 경우 해당 아이콘으로 표시됨
 - 별도의 앵커로 위치 이동 가능하며, 통합 모드 시에는 통합 타이머에 합쳐져 표시됨
 - 디버프 지속 목록(커스텀 DB)을 사용하여, 대상, 마우스오버, 주시대상, 이름표 생성 유닛이 아닌 경우에도 지속시간 추적 가능

■ 통합 타이머 (Unified Timer)
 - 버프/쿨다운, 디버프/메즈, 대상 디버프, 다중 디버프의 모든 바를 하나의 앵커에 표시
 - 개별 바 세트의 숨기기 설정을 통해 선택적으로 통합 가능

■ 바(Bar) 디자인 및 정보 표시
 - 구조: [스킬 아이콘] [스택 횟수] [바(Bar)] [스킬 이름] [남은 시간(내부)] [쿨다운(외부)]
 - 쿨다운 타이머: 스킬 시전 중에도 쿨다운이 있다면 바 오른쪽에 시간 표시
   (예시: 1일 이상은 '1d 2h', 1시간 이상은 '2h 30m', 1시간 미만은 59:50, 1분 미만은 소수점 초 단위 표시)
 - 쿨다운 임박 경고: 쿨다운 10초 전부터 빨간색 텍스트로 강조
 - 자동 병합: 토템이나 버프가 활성화된 상태라면 별도의 쿨다운 바를 만들지 않고 해당 바에 쿨다운 정보 병합

■ 바 세트 관리 및 통합 타이머
 - 3개의 바 세트를 각각 독립적으로 관리하거나, 하나의 '통합 타이머'로 합쳐서 볼 수 있습니다.
 - 결속(Combined) 모드: 중앙 바 이동 시 좌우 바가 함께 이동 (기본값)
 - 분리(Separate) 모드: 각 바 세트를 완전히 독립적으로 이동
 - 통합(Unified) 모드: 모든 바를 하나의 앵커에 순서대로 쌓아서 표시

■ 쿨다운 숨김 관리 (Cooldown Exclusion)
 - 충격류, 덫류 등 쿨다운을 공유하는 스킬들 중 불필요한 스킬이 바에 표시되는 것을 방지
 - GUI 설정 창이나 명령어를 통해 특정 스킬을 쿨다운 숨김 목록 추가/삭제
 - 냉기 충격, 화염 충격을 추가하면 대지 충격 하나만 쿨다운 표시

■ 기본 쿨다운 숨김 목록
 - 냉기 충격/화염 충격 (대지 충격 남김)
 - 냉기의 덫/제물의 덫/폭발의 덫/뱀 덫 (얼음의 덫 남김)
 - 방패 가격 (자루 공격 남김)
 - 보복/무모한 희생 (방패의 벽 남김)

■ 디버프 지속 관리 (Custom Debuff Duration)
 - 다중 타겟 추적 시, 유닛 정보를 가져올 수 없는 경우(대상, 주시대상, 마우스오버, 이름표로 확인할 수 없는 유닛) 사용할 기본 지속시간을 관리
 - 기본적으로 제물, 부패 등 주요 스킬들이 등록되어 있음
 - GUI 설정 창이나 명령어를 통해 특정 스킬을 디버프 지속 목록 추가/삭제/수정

■ 기본 디버프 지속 목록
 - 마법사: 얼음 회오리/8, 변이/50
 - 흑마법사: 현혹/15, 제물/15, 부패/18, 부패의 씨앗/18, 공포/20, 고통의 저주/24, 언어의 저주/30, 파멸의 저주/60, 무력화 저주/120, 무모함의 저주/120, 원소의 저주/300, 어둠의 저주/300, 추방/30
 - 사제: 평정/15, 어둠의 권능: 고통/18, 흡혈의 손길/15, 흡혈의 선물/60, 언데드 속박/50
 - 드루이드: 회오리바람/6, 곤충 떼/12, 달빛 섬광/12, 휘감는 뿌리/27, 요정의 불꽃/40, 겨울잠/40
 - 전사: 방어구 가르기/30, 치명상/12, 분쇄/21
 - 도적: 실명/10, 기절시키기/45
 - 사냥꾼: 살무사 쐐기/8, 비룡 쐐기/12, 독사 쐐기/15, 전갈 쐐기/20, 얼음의 덫/20, 야수 겁주기/20
 - 성기사: 악령 퇴치/20

■ 초기화 버튼 (Reset Button)
 - 각 설정을 초기화하고 DB에 저장된 쿨다운 숨김 목록 및 디버프 지속 목록을 기본값으로 복구

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

Interface
└── AddOns
  └── MySimpleClassTimer
    ├── MySimpleClassTimer.lua
    ├── MySimpleClassTimer_TBC.toc
    ├── MySimpleClassTimer_Vanilla.toc
    └── README.txt

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

─────────────────────────────
4. 사용 예시
─────────────────────────────
■ 버프 및 쿨다운 추적:
 상황: 전사가 '죽음의 소원' 사용 (지속 30초, 쿨다운 3분)
 1. [주황색 바] 생성, 내부 타이머 30초 감소, 오른쪽 쿨다운 2:59 감소 시작
 2. 30초 후 버프 종료 → [회색 바]로 변경 (고스트 모드)
 3. 오른쪽 쿨다운 타이머만 계속 감소
 4. 쿨다운 완료 시 녹색 "Ready" 텍스트 5초간 표시 후 사라짐

 상황: 주술사가 '돌발톱 토템 VI' 소환 (지속 15초, 쿨다운 30초)
 1. [파란색 바] 생성, 내부 타이머 15초 감소, 오른쪽 쿨다운 30 감소 시작
 2. 15초 후 '돌발톱 토템 VI' 소멸 → [회색 바]로 변경 (고스트 모드)
 3. 오른쪽 쿨다운 타이머만 계속 감소
 4. 쿨다운이 끝나기 전에 다른 대지 속성 토템인 '진동의 토템'을 설치
 5. 새로 '진동의 토템' 바가 생기고 내부 타이머 2분 감소
 6. 고스트 모드의 '돌발톱 토템 VI' 바는 남아 있고 오른쪽 쿨다운 타이머는 계속 감소
 7. 쿨다운 완료 시 녹색 "Ready" 텍스트 5초간 표시 후 사라짐

 상황: 사냥꾼이 '얼음의 덫 3 레벨' 설치 (지속 1분, 쿨다운 15초)
 1. [파란색 바] 생성, 내부 타이머 1분 감소, 오른쪽 쿨다운 15 감소 시작
 2. 5초 후 '얼음의 덫 3 레벨'을 적대적 대상이 밟아서 소멸 → [회색 바]로 변경 (고스트 모드)
 3. 오른쪽 쿨다운 타이머만 계속 감소
 4. 덫을 밟은 유닛은 '얼음의 덫' 디버프에 걸려서 만약 현재 대상이라면 대상 디버프 앵커에 [보라색 바]가 생성되고, 현재 대상이 아니리면 다중 디버프 앵커 #1에(공격대 징표가 찍힌 유닛이라면 해당 징표로 표시) [보라색 바]가 생성되며 오른쪽에 20 쿨다운 감소 시작
 5. 버프/쿨다운의 [회색 바]는 쿨다운 완료 시 녹색 "Ready" 텍스트 5초간 표시 후 사라짐

■ 아이템 쿨다운 추적:
 상황: '일급 마나 물약' 사용 (쿨다운 2분)
 1. '버프/쿨다운' 바 세트에 '일급 마나 물약' 아이콘과 함께 회색 쿨다운 바 생성
 2. 2분 카운트다운 후 사라짐 (아이템 추적 옵션이 ON일 때만 작동)

■ 쿨다운 숨김 설정:
 상황: 사냥꾼이 '냉기의 덫'을 사용해도 쿨다운 바에 표시하고 싶지 않음 (얼음의 덫만 보고 싶음)
 1. 채팅창에 '/msct ex 냉기의 덫' 입력 또는 GUI 창에서 입력 후 확인
 2. '냉기의 덫'은 쿨다운이 돌아도 바에 표시되지 않음

■ 디버프 지속 설정:
 상황: '부패' 2레벨을 쓰다가 3레벨을 쓰게 되면서 지속 시간이 15초에서 18초로 상향
 1. 채팅창에 '/msct d 부패/18' 입력
 2. 다중 타겟(이름표 밖)에게 부패 시전 시 18초 바 생성

■ 통합 모드 사용:
 1. 채팅창에 '/msct set uni' 입력 또는 GUI 창에서 '바 세트' 모드를 '통합' 선택 후 확인 (통합 모드)
 2. 화면에 '통합 타이머' 앵커 하나만 생성
 3. 버프, CC, 디버프, 다중 디버프가 한 곳에 순서대로 쌓여서 표시됨
 4. 개별 바 세트 중 숨기기 한 것이 있다면 그걸 제외한 바 세트만 표시
 5. 채팅창에 '/msct u l' 입력 또는 GUI 창에서 '통합 타이머'를 '잠금' 선택 후 확인 (통합 타이머 잠금)

■ 바 이동 및 설정:
 1. 채팅창에 '/msct b ul' 입력 또는 GUI 창에서 '버프/쿨다운'을 '해제' 선택 후 확인 (버프/쿨다운 바 잠금 해제)
 2. 화면에 생긴 초록색 박스를 드래그하여 이동 후 채팅창에 '/msct b l' 입력 또는 GUI창에서 버프/쿨다운 '잠금' 선택 후 확인 (버프/쿨다운 바 잠금)
 3. '바 세트'가 '결속' 상태라면 중앙의 '디버프/메즈'를 움직여서 3개의 바 세트를 함께 위치 조정하는 것이 가능

─────────────────────────────
5. 주의 사항
─────────────────────────────
■ 지속시간이 3분을 초과하는 긴 버프(인내의 기원 등)는 화면을 가리는 것을 방지하기 위해 표시되지 않습니다.

■ 결속/분리 모드에서는 통합 타이머 앵커가, 통합 모드에서는 통합 타이머 이외의 앵커가 해제 상태라도 움직이지 않습니다.

■ '대상 디버프', '다중 디버프'는 플레이어 본인 또는 펫이 시전한 것만 표시합니다.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 1. 15.)
 - 3분 이하 버프, 토템, 디버프, 대상 디버프, 다중 디버프의 중첩 및 지속시간 추적
 - 스킬/아이템의 쿨다운 추적(고스트 바) 및 Ready 알림
 - 바 생성 방향(상/하), 바 세트 모드(결속/분리/통합), 버프 출처(본인/아군) 설정
 - 쿨다운 숨김 목록 및 디버프 지속 목록 관리
 - Vanilla 및 TBC용 toc

■ 1.0.1 (2026. 1. 17.)
 - 사냥꾼 '섬광' 지속시간 미표시 수정
 - GetTime 함수 32비트 정수 오버플로우 수정

■ 1.0.2 (2026. 3. 1.)
 - 에디트 박스 입력값을 설정하는 것 이외의 확인 버튼을 삭제하고, 드롭다운 메뉴 항목을 선택하면 즉시 설정하도록 수정

■ 1.0.3 (2026. 3. 21.)
 - 기본 명령어에 /간단직업 추가

■ 1.0.4 (2026. 3. 27.)
 - 사냥꾼 '섬광'의 지속시간에 불타는 성전 기준 20초 추가

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

■ 개발자 표기

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

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

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