# FoxChat

A World of Warcraft Classic addon for chat message filtering and highlighting with keyword detection.

## Developer

**우르사 (Ursa)** - 20th Anniversary Hardcore Classic Server, Fox and Wolf Guild

## Features

- **Keyword Highlighting**: Automatically highlights messages containing your specified keywords

- **Smart Filtering**:

- Your own messages are never filtered

- Prefix/suffix text is excluded from filtering

- Configurable ignore keywords

- **Chat Filtering**: Filter messages to show only those containing your keywords

- **Sound Alerts**: Play sound notifications when keywords are detected

- **Toast Notifications**: Visual popup alerts for keyword matches with customizable position

- **Prefix/Suffix**: Automatically add custom text before and after your messages

- **Minimap Button**: Quick access to toggle filtering and open settings

- **Multi-Channel Support**: Monitor multiple chat channels simultaneously

- **Party Recruitment System**:

- Semi-automated advertising with manual click requirement (EULA compliant)

- First Come message feature for quick party announcements

- Party size management with auto-stop option

- Configurable cooldowns and channel selection

- **Tab-based UI**: Modern, organized settings interface with four tabs

- **Auto Features**:

- Trade completion messages with automatic whisper

- Party auto-greeting with random message selection

- Smart auto-reply system with cooldown management

- Dice roll tracking and automatic result announcement

- Auto repair alerts

- **Localization**: Full support for English and Korean

## Installation

1. Download the FoxChat folder

2. Place it in your WoW Classic addons directory:

- Windows: `World of Warcraft\_classic_\Interface\AddOns\`

- Mac: `World of Warcraft/_classic_/Interface/AddOns/`

3. Restart WoW or type `/reload` in chat

## Usage

### Commands

- `/fc` or `/foxchat` - Open settings window

- `/fc toggle` - Enable/disable the addon

- `/fc add <keyword>` - Add a keyword

- `/fc remove <keyword>` - Remove a keyword

- `/fc list` - Show current keywords

- `/fcdbg autoreply` - Toggle auto-reply debug mode

### Minimap Button

- **Left Click**: Toggle chat filtering on/off

- **Right Click**: Open settings window

- **Drag**: Move button around minimap

### Settings Window (Tab UI)

The new tab-based interface includes four sections:

#### Tab 1: Chat Filtering

- Configure keywords (comma-separated)

- Set ignore keywords to exclude certain messages

- Select which channels to monitor

- Choose highlight style (bold, color, or both)

- Configure channel-specific colors

- Adjust toast notification position

#### Tab 2: Prefix/Suffix

- Enable/disable prefix and suffix

- Set custom text for message prefix

- Set custom text for message suffix

- Select which channels to apply

#### Tab 3: Advertisement

- Set advertisement message (multi-line support)

- Configure button position (X, Y coordinates)

- Select cooldown duration (15/30/45/60 seconds)

- Choose target channel (automatic channel list)

- Start/stop advertising

#### Tab 4: Auto Features (Left Menu Navigation)

Enhanced UI with left-side menu and right-side content area:

**Trade (거래)**

- Automatically sends trade details via whisper after successful trades

**Greetings (인사)**

- **When I Join**: Sends random greeting when you join a party

- Supports {me} variable for your character name

- Multiple messages (one per line, randomly selected)

- **When Others Join**: Sends greeting when others join your party/raid

- Supports {name} variable for the joiner's name

- Multiple messages with random selection

- **Leader Exclusive Greetings** (NEW)

- **Party Leader**: All lines sent in order when you're party leader

- **Raid Leader**: All lines sent in order when you're raid leader

- Overrides normal greetings when you have leader role

**Reply (응답)**

- **Combat Auto-Reply**: Responds to whispers during combat (excludes party/raid members)

- **Instance Auto-Reply**: Responds to whispers while in dungeons (excludes party/raid members)

- **AFK/DND**: Always active automatic responses

- **Cooldown System**: Configurable cooldown per sender (default: 5 minutes)

- Custom messages for each situation

**Dice (주사위)**

- Automatic dice roll tracking for party/raid

- Configurable collection time: 10/15/20/30/45/60 seconds (default: 10)

- Output options: Party/Raid or Self only (default: Self)

- Winner display: Top N players (default: 1 winner only)

## Configuration Options

### Chat Channels

- Say, Yell, Party, Guild, Raid

- Instance, Whisper

- General, Trade, LookingForGroup

### Highlight Styles

- **Bold**: Makes keywords appear in bold white

- **Color Only**: Highlights keywords in your chosen color

- **Bold + Color**: Combines both effects

### Toast Notifications

- Position: X, Y coordinates (0, 0 = screen center)

- Default: (0, -320) - bottom center

- Maximum 3 toasts displayed simultaneously

### Advertisement System (EULA Compliant)

- **Manual Click Required**: Button must be clicked each time (no automation)

- **Configurable Cooldown**: Choose between 15, 30, 45, or 60 seconds

- **Channel Selection**: Automatically lists available channels

- **Default Position**: X: 350, Y: -150 (right side of screen)

- **Shift+Drag**: Move the advertisement button

- **Smart Cooldown**: Resets when stopping ads

### Auto-Reply System

- **Smart Group Detection**: Never auto-replies to party/raid members

- **Multiple Trigger Conditions**: Combat, Instance, AFK/DND

- **Per-Sender Cooldown**: Prevents spam to the same person

- **Customizable Messages**: Different messages for each situation

- **Debug Mode**: `/fcdbg autoreply` to see detection process

---

# FoxChat (한국어)

월드 오브 워크래프트 클래식용 채팅 메시지 필터링 및 키워드 강조 애드온입니다.

## 기능

- **키워드 강조**: 지정한 키워드가 포함된 메시지를 자동으로 강조 표시

- **채팅 필터링**: 키워드가 포함된 메시지만 표시하도록 필터링

- **소리 알림**: 키워드 감지 시 소리 알림 재생

- **토스트 알림**: 키워드 매칭 시 위치 조정 가능한 시각적 팝업 알림

- **말머리/말꼬리**: 메시지 앞뒤에 자동으로 텍스트 추가

- **미니맵 버튼**: 필터 전환 및 설정창 열기 빠른 접근

- **다중 채널 지원**: 여러 채팅 채널 동시 모니터링

- **광고 시스템**: 수동 클릭 필요한 반자동 모집 (EULA 준수)

- **탭 기반 UI**: 4개 탭으로 구성된 현대적이고 정리된 설정 인터페이스

- **자동 기능**:

- 거래 완료 시 자동 귓속말 메시지

- 파티 자동 인사 (랜덤 메시지)

- 스마트 자동응답 시스템 (쿨다운 관리)

- 주사위 자동 집계 및 결과 발표

- 자동 수리 알림

- **현지화**: 영어 및 한국어 완벽 지원

## 설치 방법

1. FoxChat 폴더를 다운로드합니다

2. WoW 클래식 애드온 디렉토리에 넣습니다:

- Windows: `World of Warcraft\_classic_\Interface\AddOns\`

- Mac: `World of Warcraft/_classic_/Interface/AddOns/`

3. WoW를 재시작하거나 채팅창에 `/reload` 입력

## 사용법

### 명령어

- `/fc` 또는 `/foxchat` - 설정창 열기

- `/fc toggle` - 애드온 켜기/끄기

- `/fc add <키워드>` - 키워드 추가

- `/fc remove <키워드>` - 키워드 제거

- `/fc list` - 현재 키워드 목록 표시

- `/fcdbg autoreply` - 자동응답 디버그 모드 토글

### 미니맵 버튼

- **왼쪽 클릭**: 채팅 필터링 켜기/끄기

- **오른쪽 클릭**: 설정창 열기

- **드래그**: 미니맵 주위로 버튼 이동

### 설정창 (탭 UI)

새로운 탭 기반 인터페이스는 네 가지 섹션으로 구성됩니다:

#### 탭 1: 채팅 필터링

- 키워드 설정 (쉼표로 구분)

- 무시할 키워드 설정

- 모니터링할 채널 선택

- 강조 스타일 선택 (굵게, 색상, 또는 둘 다)

- 채널별 색상 설정

- 토스트 알림 위치 조정

#### 탭 2: 말머리/말꼬리

- 말머리/말꼬리 활성화/비활성화

- 말머리 텍스트 설정

- 말꼬리 텍스트 설정

- 적용할 채널 선택

#### 탭 3: 광고 설정

- 광고 메시지 설정 (여러 줄 지원)

- 버튼 위치 설정 (X, Y 좌표)

- 쿨타임 선택 (15/30/45/60초)

- 대상 채널 선택 (자동 채널 목록)

- 광고 시작/중지

#### 탭 4: 자동 기능 (좌측 메뉴 네비게이션)

좌측 메뉴와 우측 컨텐츠 영역으로 개선된 UI:

**거래 (Trade)**

- 거래 완료 시 자동으로 거래 내역을 귓속말로 전송

**인사 (Greetings)**

- **내가 참가할 때**: 파티 참가 시 랜덤 인사 메시지 전송

- {me} 변수 지원 (내 캐릭터 이름)

- 여러 메시지 설정 가능 (한 줄에 하나씩, 랜덤 선택)

- **다른 사람이 참가할 때**: 다른 사람이 파티/공대 참가 시 인사

- {name} 변수 지원 (참가자 이름)

- 여러 메시지 랜덤 선택

- **리더 전용 인사말** (신규)

- **파티장일 때**: 파티장인 경우 모든 줄을 순서대로 전송

- **공대장일 때**: 공대장인 경우 모든 줄을 순서대로 전송

- 리더 권한이 있을 때 일반 인사말보다 우선 적용

**응답 (Reply)**

- **전투 중 자동응답**: 전투 중 귓속말 자동응답 (파티/공대원 제외)

- **인던 중 자동응답**: 던전 진행 중 자동응답 (파티/공대원 제외)

- **AFK/DND**: 항상 활성화되는 자동응답

- **쿨다운 시스템**: 발신자별 재응답 대기시간 설정 (기본: 5분)

- 각 상황별 사용자 정의 메시지 설정

**주사위 (Dice)**

- 파티/공대 주사위 자동 집계

- 집계 시간 설정: 10/15/20/30/45/60초 (기본: 10초)

- 출력 옵션: 파티/공대 또는 나에게만 (기본: 나에게만)

- 우승자 표시: 상위 N명 (기본: 1명만)

## 설정 옵션

### 채팅 채널

- 일반 대화, 외치기, 파티, 길드, 공격대

- 인스턴스, 귓속말

- 공개, 거래, 파티찾기

### 강조 스타일

- **굵게**: 키워드를 굵은 흰색으로 표시

- **색상만**: 선택한 색상으로 키워드 강조

- **굵게 + 색상**: 두 효과를 결합

### 토스트 알림

- 위치: X, Y 좌표 (0, 0 = 화면 정중앙)

- 기본값: (0, -320) - 화면 하단 중앙

- 최대 3개의 토스트 동시 표시

### 광고 시스템 (EULA 준수)

- **수동 클릭 필수**: 매번 버튼을 클릭해야 함 (자동화 없음)

- **설정 가능한 쿨타임**: 15, 30, 45, 60초 중 선택

- **채널 선택**: 사용 가능한 채널 자동 표시

- **기본 위치**: X: 350, Y: -150 (화면 오른쪽)

- **Shift+드래그**: 광고 버튼 이동

- **스마트 쿨타임**: 광고 중지 시 초기화

### 자동응답 시스템

- **스마트 그룹 감지**: 파티/공대원에게는 자동응답하지 않음

- **다중 트리거 조건**: 전투, 인스턴스, AFK/DND

- **발신자별 쿨다운**: 같은 사람에게 스팸 방지

- **사용자 정의 메시지**: 각 상황별 다른 메시지

- **디버그 모드**: `/fcdbg autoreply`로 감지 과정 확인

## 특징

- 플레이어 이름은 필터링하지 않고 메시지 내용만 필터링

- 위상 메시지(일위상, 이위상, 삼위상)는 말머리/말꼬리 제외

- 광고 메시지는 말머리/말꼬리 미적용

- 설정은 캐릭터별로 저장됨

- 탭별 설정 초기화 기능

## 문제 해결

- 애드온이 작동하지 않는 경우: `/reload` 명령어 실행

- 미니맵 버튼이 보이지 않는 경우: 설정창에서 "미니맵 버튼 표시" 확인

- 키워드가 작동하지 않는 경우: 키워드가 쉼표로 올바르게 구분되었는지 확인

- 광고 버튼이 보이지 않는 경우: 광고 메시지를 먼저 입력하고 시작 버튼 클릭

- 자동응답 테스트: `/fcdbg autoreply`로 디버그 모드 활성화

## 버전

- 현재 버전: 3.1

- WoW 클래식 호환

- 최신 업데이트 (3.1):

- 리더 전용 인사말 시스템 추가

- 공격대 지원 완벽 구현 (GetRaidRosterInfo 활용)

- 인사 메뉴 UI 2열 레이아웃 개선

- 광고 버튼 우클릭 시 설정창 열기 기능 추가

- 공대장 인사말 채널 수정 (RAID_WARNING → RAID)

- 이전 업데이트 (3.0):

- 자동 탭 UI를 좌측 메뉴 방식으로 완전 개편

- 스마트 자동응답 시스템 추가 (파티/공대원 제외)

- 주사위 자동 집계 기능 구현

- 파티 자동인사 메시지에 변수 지원 추가

- 각 기능별 상세 설정 UI 개선

## 개발자

개발자 : 우르사 (20주년 하드코어 클래식 서버 , Fox and Wolf 길드)

## 라이선스

이 애드온은 자유롭게 사용 및 수정할 수 있습니다.

Fox Chat