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

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

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Chat Filter는 무거운 라이브러리를 사용하지 않고 순수 Lua로 작성된 가볍고 강력한 채팅 필터 및 유틸리티 애드온입니다.

■ 중요한 키워드는 알림으로 받아보고, 보고 싶지 않은 키워드나 광고 도배를 무시하며, 채팅 복사, URL 복사나 자동 인사, 지원 귓속말, 거래 내역 알림 및 기록, 대화 시각 모드, 시계 패널 및 각종 타이머 같은 편의 기능을 통합하여 쾌적한 채팅 환경을 제공합니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 알림 및 무시 필터링
 - 알림 키워드: 공개, 파티찾기 등 채널 채팅에서 설정된 단어나 내 캐릭터 이름이 언급되면 소리 알림과 함께 별도의 팝업 창을 띄워 놓치지 않게 해줍니다.
 - 지원 귓속말: 알림 키워드 팝업 창에 뜬 캐릭터 이름을 클릭하면 미리 설정해둔 문구가 귓속말로 자동 입력됩니다. 엔터 키를 누르면 보냅니다.
 - 무시 키워드: 설정된 단어가 포함된 메시지를 채팅 창에서 숨깁니다.
 - 매크로 무시: 동일한 내용의 메시지가 N회 이상 연속으로 올라오면 자동으로 채팅 창에서 숨김니다. (5~10회 설정)

■ 자동 인사
 - 상황별 자동 인사: 접속 시(길드), 접속 종료 시(길드), 파티나 공격대 참여 시 설정한 인사말을 자동으로 출력합니다. 리로드 시에 자동 인사를 반복하는 것을 막기 위한 안전 장치를 포함합니다.

■ 채팅 복사 (기본 적용)
 - 전체 채팅 복사: 각 채팅 프레임 우측 상단의 'Ctrl+A' 버튼을 누르면, 해당 채팅창의 대화 내역이 색상이나 링크 코드가 제거된 순수 텍스트로 추출되어 별도의 복사 전용 창에 나타납니다.

■ 채팅 가독성 및 시각 표시 (기본 적용)
 - 직업 색상 표시: 채팅 작성자의 이름을 직업 고유 색상으로 표시합니다.
 - 타임스탬프: 채팅 작성자 앞에 블리자드에서 제공하는 대화 시각을 [시:분], [시:분:초] 형식으로 표시하거나 비활성화합니다.
(예: [12:30:45] Goyathlay: 안녕하세요)
 - 시계 패널 및 시간측정/휴식시간/풀링 타이머: 상단 메뉴 버튼(시간측정, 휴식시간 10분/5분, 풀링 30초/15초/5초, 크기 설정), 우클릭 잠금/해제

■ URL 링크 복사 (기본 적용)
 - URL 링크 복사: 채팅창에 http나 www로 시작하는 주소가 있으면 클릭 가능한 하늘색 링크로 변환합니다. 클릭 시 주소를 바로 복사할 수 있는 팝업 창이 뜹니다.

■ 팝업 창 높이 조절
 - URL 복사, Ad 돋보기, CHAT 복사 팝업 창의 높이는 창 우측 상단의 '높이' 버튼을 통해 조절할 수 있습니다. (총 6단계로 출력 줄 수는 1~25)
 - 기본 높이는 URL 복사 1단계, Ad 돋보기 2단계, CHAT 복사 3단계로 각각 다르게 설정되어 있습니다. 거래 기록은 단계 구분 없이 400으로 고정되어 있습니다.

■ 거래 알림
 - 상세 거래 보고: 거래가 완료되면 내가 대상에게 무엇을 주거나 받았는지를 귓속말로 즉시 알립니다. ('<A> B 님에게 준 것은 C, 받은 것은 D' 형식, 없을 때도 포함)
 - 거래 내역은 대화 시각 활성화 여부와 상관없이 대화 시각을 표시합니다.
 - 수량 합산: 동일한 아이템을 여러 슬롯에 나누어 거래하더라도 합산하여 총량으로 표시합니다. (예시: 20개씩 2덩이, 10개 1덩이라면 50개로 표시)
 - 다중 아이템 정렬: 여러 종류의 아이템을 거래할 경우 이름을 가나다/알파벳 순서로 정렬합니다.
 - 금액 및 우선순위: 골드, 실버, 쿠퍼 단위로 표시하며, 아이템과 골드를 함께 주거나 받을 경우 아이템을 먼저 언급합니다.
 - 거래 내역을 DB에 기록하며 일부 또는 전체를 삭제할 수 있습니다.

─────────────────────────────
3. 명령어 및 사용 방법
─────────────────────────────
■ 기본 명령어
 - /간단채팅 또는 /mscf: 설정창 열기

■ 설정 창 가이드
 - 알림 키워드: 놓치면 안 되는 단어를 등록합니다. (본인 이름 알림 포함)
 - 무시 키워드: 보기 싫은 단어를 등록합니다.
 - 매크로 무시: 연속된 메시지 허용 횟수를 설정합니다.
 - 길드/파티 인사: 상황별(로그인, 로그아웃, 파티나 공격대 합류) 인사말을 설정합니다.
 - 지원 귓속말: 알림 키워드 팝업 창에서 이름을 클릭했을 때 보낼 귓속말 문구를 설정합니다.
 - 거래 알림: 거래 성공 또는 실패 시에 채팅 출력 여부를 설정합니다.

■ 키워드 관리
 - 키워드 추가: 입력 칸에 단어를 쓰고 확인을 누르면 목록에 추가됩니다.
 - 키워드 삭제: 이미 등록된 단어를 다시 입력하고 확인을 누르면 목록에서 삭제됩니다.

■ 거래 알림
 - 첫 번째 드롭다운 메뉴 ON/OFF: 대상에게 귓속말로 거래 알림을 보내는 기능의 활성화 여부를 결정합니다.
 - 두 번째 체크박스 버튼 선택: 현재 파티나 공격대에 속해 있다면 귓속말 외에 해당 채팅으로도 거래 알림을 출력할지를 결정합니다.
 - 거래 기록: 거래 알림을 각 대상마다 시간 순서대로 항목을 매겨서 DB에 저장합니다. 설정 창에서 일부 또는 전체를 삭제할 수 있습니다.

■ 초기화
 - 설정 창 최하단의 [초기화] 버튼을 누르면 모든 기능의 ON/OFF 상태와 저장된 키워드, 인사말 텍스트, 거래 기록 등 모든 데이터를 삭제하고 초기 상태로 되돌립니다.

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

Interface
└── AddOns
    └── MySimpleChatFilter
          ├── MySimpleChatFilter.lua
          ├── MySimpleChatFilter_TBC.toc
          ├── MySimpleChatFilter_Vanilla.toc
          └── README.txt

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

─────────────────────────────
5. 주의 사항
─────────────────────────────
■ 알림 키워드와 무시 키워드가 같이 포함된 채팅이라면 키워드 우선순위에 의해 보이지 않습니다.

■ 귓속말 지원: 알림 팝업의 이름을 좌클릭하면 설정한 문구가 자동으로 채팅창에 입력됩니다. 마우스를 올리면 툴팁으로 안내가 표시됩니다.

■ CHAT 복사(Ctrl+A) 창이 열리면 텍스트가 자동으로 전체 선택되므로 Ctrl+C를 눌러 복사하면 됩니다.

■ 스마트 메시지 전환: 거래 내역에 아이템 링크가 포함되어 메시지가 너무 길어질 경우(약 250바이트 초과), 시스템이 자동으로 링크를 일반 텍스트로 변환하여 메시지 잘림 없이 안전하게 전송합니다.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 1. 26.)
 - 캐릭터 이름 직업 색상, 시각 표시, URL 복사
 - 알림 키워드(팝업 창 지원 귓속말 자동완성), 무시 키워드, 매크로 무시 필터링
 - 상황별 자동 인사 출력 (리로드 시에 반복 방지)

■ 1.0.1 (2026. 1. 27.)
 - 리로드 시에 파티나 공격대 합류 자동 인사 반복 방지 수정

■ 1.1.0 (2026. 2. 27.)
 - 각 채팅 프레임별 텍스트 복사 기능 추가 (Ctrl+A 버튼 및 전용 팝업 창)
 - 드롭다운 메뉴에서 항목을 선택하면 즉시 설정하도록 수정

■ 1.2.0 (2026. 3. 11.)
 - 거래 알림(귓속말, 그룹 채팅, 기록) 기능 추가

■ 1.2.1 (2026. 3. 11.)
 - 스냅샷 갱신 타이밍으로 인한 거래 알림 메시지 오류 수정

■ 1.2.2 (2026. 3. 13.)
 - 설정 창 9행 거래 기록의 항목 간격 수정

■ 1.3.0 (2026. 3. 19.)
 - 채팅 메시지 앞에 표시하던 대화 시각을 블리자드 설정값으로 작성자 앞에 표시하도록 수정
 - 시계 패널 및 시간측정/휴식시간/풀링 타이머 추가

■ 1.3.1 (2026. 3. 21.)
 - 시계 패널 ON/OFF 버튼의 텍스트가 반대로 표시되던 오류를 수정

■ 1.3.2 (2026. 3. 22.)
 - 리로드/재접속을 하면 시계 패널이 기본 위치로 돌아가며 잠긴 상태인데도 연녹색 테두리가 보이던 오류를 수정
 - 풀링 타이머 메시지가 이중으로 나오던 것을 수정

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

■ 개발자 표기

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

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

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