My Simple Floating and Nameplates (WoW Classic 20주년 서버용)

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

─────────────────────────────
 1. 애드온 개요
─────────────────────────────
■ My Simple Floating and Nameplates(MSFN)는 와우 클래식 환경에서 전투 메시지(치유량, 피해량)와 적 이름표(Nameplates)를 직관적이고 가볍게 관리해주는 애드온입니다.

■ 무거운 이름표 애드온 없이도 꼭 필요한 기능인 '월드 텍스트 크기 조절', '위협 수준에 따른 적 이름표 색상 변경', '시전 바 및 버프/쿨다운/디버프 표시', '대상의 대상' 기능을 통합하여 제공합니다.

■ 블리자드 기본 인터페이스의 느낌을 해치지 않으면서도, 탱킹이나 딜링 시 필요한 핵심 정보를 명확하게 전달하는 데 초점을 맞추었습니다.

─────────────────────────────
 2. 주요 기능
─────────────────────────────
■ World Text (전투 메시지) 제어
 - 힐링, 딜링 모드를 선택할 수 있습니다. (힐링, 딜링, 힐/딜, 없음)
 - 텍스트 크기를 0.5에서 3.0까지 드롭다운으로 편리하게 조절할 수 있습니다.
 - 플로팅 모드는 항상 머리 위로 떠오르는 방식으로 고정합니다.

■ 커스텀 적 이름표 (Enemy Nameplates)
 - 적 대상을 직사각형 형태의 깔끔한 3단 바(체력, 자원, 투명 시전 바) 디자인으로 변경합니다.
 - 체력 바 중앙에 현재 체력 및 최대 체력 대비 비율을 '[수치] (퍼센트%)' 형식으로 실시간 표시합니다. 체력 수치를 절대값, 1K (천 단위 압축), 1만 (만 단위 압축) 중 선택하여 표시할 수 있습니다. (기본값: 1K)
 - 대상 이름 표시 (Target of Target): 체력 바 우측에 해당 유닛이 현재 공격하는 대상의 이름을 표시합니다. 대상이 변경되면 갱신되며, 표시 후 3초 뒤에 자동으로 사라집니다. (대상이 플레이어일 경우 클래스 색상 적용)
 - 이름 텍스트는 체력바 위로, 레벨과 정예 표시는 체력바 우측 안쪽으로 배치합니다.
 - 레이드 징표가 있을 경우 체력바 왼쪽에 표시합니다.
 - 이름표 위치를 유닛의 머리 위로 일정하게 유지합니다.

■ 위협 수준(Aggro) 색상 표시
 - 적 이름표의 체력 바 색상이 플레이어의 위협 수준에 따라 실시간으로 변합니다.
 - 빨강(최고 위협/탱킹) → 주황 → 노랑 → 녹색(안전) → 회색(비전투/위협 없음)

■ 적 오라(Aura) 및 쿨다운 트래커
 - [적 디버프]: 이름표 바로 위에 대상에게 걸린 디버프 아이콘을 가로로 나열합니다. (항상 켜짐)
   * 아이콘 간격을 4픽셀로 하여 시각적 분리도를 높였습니다.
   * 최대 표시 개수 설정 가능 (기본값: 20개)
   * 내가 시전한 디버프를 노란색의 아이콘 테두리로 강조합니다.
   * 지속시간 표시: 중첩형은 모두, 개별형은 내가 시전한 경우 아이콘 상단에 표시됩니다.
 - [적 쿨다운]: 디버프 프레임 바로 위에 적이 이미 사용하여 쿨다운이 돌고 있는 스킬이나 아이템을 표시합니다.
   * 아이콘 중앙에 남은 쿨다운 시간을 숫자로 크게 표시하여 공간을 절약합니다. (분:초 형식 지원)
   * 전투 로그를 기반으로 작동하며, 주로 PvP(직업 스킬, 계급장 등)나 API로 쿨다운 확인이 가능한 공용 스킬을 추적합니다.
   * 계급장 아이콘 자동 보정: 진영(얼라이언스/호드)에 따라 계급장 아이콘을 출력합니다.
 - [적 버프]: 쿨다운 위쪽에 대상이 가진 유용한 버프를 세로 목록 형태로 표시합니다.
   * 버프 이름의 폰트를 사용자가 변경할 수 있습니다.
   * 전투 로그(Combat Log)를 보조적으로 활용하여 기본 API가 놓칠 수 있는 버프를 추가로 추적합니다.

■ 바 산개(Stacking/Spreading) 설정
 - 이름표가 겹치지 않도록 퍼뜨리는 '바 산개' 모드를 손쉽게 켜고 끌 수 있습니다.

■ 와우 기본 이름표 설정 통합
 - GUI 하단의 버튼을 통해 블리자드 기본 CVar 값을 세밀하게 조정하거나 초기화할 수 있습니다.

─────────────────────────────
 3. 명령어 및 사용법
─────────────────────────────
■ 설정창 열기 및 상태 요약: '/간단이름' 또는 '/msfn'
 - 애드온의 모든 기능을 제어할 수 있는 GUI 창을 엽니다.
 - GUI가 이미 열려있으면 창을 닫습니다.
 - 채팅창에 현재 주요 설정 상태와 모든 명령어가 요약되어 출력됩니다. (/msfn)

■ 확장 명령어 (채팅창에서 바로 설정)
 - World Text 모드 설정: '/msfn mode <HEAL|DAMAGE|BOTH|OFF>'
 - World Text 크기 설정: '/msfn scale <0.5 ~ 3.0>' (예: '/msfn scale 1.5')
 - 바 산개 설정: '/msfn spread <ON|OFF>'
 - 적 이름표 커스텀 설정: '/msfn plate <ON|OFF>' (리로드 권장)
 - 체력 수치 형식 설정: '/msfn hp <1K|10K|ABSOLUTE>'
 - 디버프 최대 개수 설정: '/msfn debuffmax <숫자>' (1~40)
 - 적 쿨다운 표시 설정: '/msfn cd <ON|OFF>'
 - 적 버프 표시 설정: '/msfn buff <ON|OFF>'

■ GUI 기능 설명
 - [World Text 활성화]: 전투 메시지 표시 모드 선택
 - [World Text 크기]: 전투 메시지 폰트 크기 조절
 - [바 산개]: 이름표가 겹치지 않게 퍼지는 기능 (ON/OFF)
 - [적 이름표]: 커스텀 3단 이름표 디자인 적용 여부
 - [체력 수치 형식]: 체력 수치를 절대값, 1K, 1만 중 선택합니다.
 - [적 디버프 최대 개수]: 최대 표시 개수 설정
 - [적 쿨다운]: 적 사용 기술 또는 아이템의 쿨다운 표시 (ON/OFF)
 - [적 버프]: 버프 목록 표시 (ON/OFF)
 - [적 버프 이름 폰트]: 버프 이름 표시에 사용할 폰트를 선택합니다.

■ 와우 기본 이름표 설정
 - GUI 하단의 버튼을 통해 블리자드 기본 CVar 값을 세밀하게 조정하거나 초기화할 수 있습니다.

─────────────────────────────
 4. 설치 방법
─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요.
(폰트 파일은 'Fonts' 폴더에 위치해야 인식됩니다.)

Fonts
├── 2002.TTF
├── 2002B.TTF
├── ARIALN.TTF
├── FRIZQT__.TTF
├── K_DAMAGE.TTF
├── K_PAGETEXT.TTF
└── ...

Interface
└── AddOns
    └── MySimpleFloatingAndNameplates
        ├── MySimpleFloatingAndNameplates.lua
        ├── MySimpleFloatingAndNameplates_TBC.toc
        ├── MySimpleFloatingAndNameplates_Vanilla.toc
        └── README.txt

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

─────────────────────────────
 5. 변경 이력
─────────────────────────────
■ 1.0.0 (2025. 12. 12.)
 - 명령어 '/msfn' 및 통합 GUI
 - 설정 상태 요약 출력
 - World Text 활성화 및 크기 조절
 - 커스텀 적 이름표: 체력/마나/시전 3단 구성, 위협 수준별 색상, 체력 수치 설정, 레이드 징표, 대상의 대상 이름, 오라 트래커
 - 와우 기본 이름표 CVar 설정

■ 1.0.1 (2025. 12. 15.)
 - 적 디버프 항상 표시로 변경
 - 적 버프 피아식별 로직 개선 (광역기 오인 방지)

■ 1.0.2 (2025. 12. 17.)
 - 적 쿨다운 표시 기능 추가 (디버프 프레임 위쪽, 아이콘 상단에 남은 시간 표시)
 - PvP 계급장 아이콘 표시 수정 (계급장 사용 주문 아이콘 → 진영별 계급장 아이콘)

■ 1.0.3 (2025. 12. 24.)
 - 와우 클라이언트 내부의 비트 연산 라이브러리 오작동 시를 대비한 예비 코드 추가

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

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

■ 1.0.6 (2026. 3. 21.)
 - 기본 명령어에 /간단이름 추가

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

■ 개발자 표기

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

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

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