My Simple Gear Swapper (WoW Classic 20주년 서버용)

Game Version: WoW Classic 1.15.8 (빌드 11508) / 2.5.5 (빌드 20505)
Version: 1.3.0 (2026. 3. 14.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Gear Swapper는 라이브러리 없이 순수 Lua로 작성된 초경량 장비 세트 및 장신구 교체 애드온입니다.

■ 기존의 바(Bar) 형태 UI에서 탈피하여, SecureActionButtonTemplate 기반의 아이콘 버튼과 드롭다운 메뉴 형식을 채택하여 시인성과 편의성을 높였습니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 스마트 장비 관리
 - 현재 착용 중인 장비를 세트로 저장하고 즉시 착용 (세트를 착용한 상테에서, 일부 아이템을 교체한 상태에서 한 번 더 이름을 입력하면 세트를 삭제하거나 갱신)
 - 상태 동기화: 장비 교체 시 메인 버튼이 자동으로 갱신되며, 세트와 다른 장비 착용 시 공백(투명) 상태로 전환
 - 은행 연동: 은행 창이 열린 상태에서는 은행 내 아이템까지 검색하여 즉시 교체 지원
 - 전투 대응: 전투 중일 경우 무기류(주장비, 보조장비, 원거리)만 자동으로 교체
 - 자동 최적화: 현재 착용 중인 세트는 드롭다운 목록에서 자동 제외
 - 툴팁 확장: 장비 세트에 포함된 아이템에 대해서는 툴팁에 해당 세트 이름을 표시
 - 캐릭터 정보 창의 개별 슬롯에서 단일 장비 교체

■ 장신구 순환 시스템 (큐 시스템)
 - 장신구 2개를 선택하여 순환 로직 적용 (사용효과 장신구 2개에 최적화)
 - 로직 순서: [A 착용] → [A 사용] → [B 즉시 교체] → [B 사용] 반복
 - 알림 기능: 쿨다운 10초 전, 5초 전, 사용 가능 시점에 중앙 경보 및 효과음 출력

■ 당근과 채찍 (자동 탈것)
 - 탈것 소환 및 해제 시 지정된 세트로 자동 교체
 - 전투 중 탈것 해제 시 교체 예약 기능 (전투 종료 즉시 실행)

─────────────────────────────
3. UI 구조 및 설정
─────────────────────────────
■ 버튼 구성
 - 장비 세트 버튼: 해당 세트의 주무기 아이콘 + 세트 이름 표시 (중앙)
 - 장신구 버튼: 현재 13번 슬롯 아이콘 + 쿨다운 시간 표시 (중앙, 1분 미만 시 초 단위 강조)
 - 크기 조절: 설정에서 36px(기본) / 60px(대형) 선택 시 폰트 크기까지 자동 조절

■ 설정 창 (/간단장비 또는 /msgs)
 - 1행 (기본): 애드온 활성화 여부 및 버튼 크기 설정
 - 2행 (세트): 장비 세트 이름 입력 및 저장/삭제
 - 3~4행 (장신구): 교체할 장신구 A, B 선택
 - 5행 (자동): '당근과 채찍' 기능 활성화 및 탈것 소환/해제용 세트 지정

─────────────────────────────
4. 사용 방법
─────────────────────────────
■ 장비 세트 버튼
 - 마우스 오버: 저장된 다른 세트 목록이 아래로 드롭다운
 - 목록 좌클릭: 해당 세트로 즉시 교체 (메인 버튼 아이콘 변경)
 - 메인 좌클릭: 현재 표시된 세트 재확인 착용 (은행 아이템 포함)

■ 장신구 버튼
 - 좌클릭: 순환 로직에 따라 장신구 착용 또는 사용 실행
 - 우클릭: 버튼 이동 잠금/해제 토글 (장비 세트 버튼의 테두리도 함께 제어)
 - 시프트+우클릭: 버튼 및 폰트 크기 토글 (잠금 상태일 때)

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

Interface
└──AddOns
    └──MySimpleGearSwapper
          ├── MySimpleGearSwapper.lua
          ├── MySimpleGearSwapper_TBC.toc
          ├── MySimpleGearSwapper_Vanilla.toc
          └── README.txt

─────────────────────────────
6. 주의 사항
─────────────────────────────
■ 장비 세트 아이콘: 해당 세트의 16번 슬롯(주무기/양손무기) 아이콘

■ 장비 세트 이름: 버튼 크기를 고려해서 1~2글자를 권장

■ 전투 중 제한: 전투 중에는 장비 세트의 전체 교체가 제한되어 무기류만 교체, 장신구 교체는 비전투 시에만 가능

─────────────────────────────
7. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 1. 16.)
 - 착용 중인 장비로 세트 교체 설정
 - 선택한 장신구 2개로 순환 교체 설정
 - Vanilla 및 TBC용 toc

■ 1.1.0 (2026. 1. 25.)
 - 장신구 버튼(착용-사용-교체-사용 순환 로직 보완, 쿨다운 표시, 우클릭 잠금-해제 토글) 분리
 - 쿨다운(10/5/완료), 장신구 순환 단계(착용 완료, 사용 확인 후 교체) 알림 경보 추가

■ 1.2.0 (2026. 1. 26.)
 - '당근과 채찍' 기능 추가: 탈것 소환/해제 시 지정된 장비 세트로 자동 교체, 전투 중 탈것 해제 시 교체 예약(전투 종료 시에 즉시 실행)

■ 1.2.1 (2026. 2. 9.)
 - 장비 세트 UI를 바 형태에서 아이콘 및 드롭다운 메뉴 방식으로 수정 (장신구 버튼처럼 SecureActionButtonTemplate 적용, 실시간 장비 대조를 통한 메인 버튼 아이콘/텍스트 동기화)
 - 은행 보관 아이템 교체 기능 추가: 은행 창을 연 상태에서 세트 버튼 클릭 시 은행 내 아이템까지 포함하여 즉시 교체
 - 장신구 설정 간소화 (이름 입력 및 확인 버튼 삭제)

■ 1.2.2 (2026. 2. 27.)
 - 장신구 경보 메시지 폰트 깨짐 현상 수정
 - 장비 세트에 포함된 아이템에 대해 툴팁에 해당 세트 이름 표시 추가

■ 1.2.3 (2026. 3. 6.)
 - 장신구 버튼 시프트+우클릭으로도 크기를 토글하도록 수정 (잠금 상태일 때)
 - 착용한 장비 세트가 없을 때 기본 버튼이 기본 아이콘과 'SET' 텍스트를 표시하도록 수정

■ 1.2.4 (2026. 3. 7.)
 - 장신구 버튼 우클릭|시프트+우클릭 시에 장신구를 착용하던 오작동 수정

■ 1.3.0 (2026. 3. 14.)
 - 캐릭터 정보 창의 개별 아이템 슬롯에서 단일 장비 교체 기능 추가

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

■ 개발자 표기

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

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

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