# SimpleFindParty

A World of Warcraft Classic 1.12 addon for filtering and managing party finding messages.

## English

### Overview

SimpleFindParty is an addon designed to help players efficiently find and manage party recruitment messages in WoW Classic. It filters messages from party finding channels, highlights keywords, and provides a clean interface for managing party-related communications.

### Features

- **Channel Message Filtering**: Automatically captures and filters messages from selected channels (default: "파티찾기" channel)

- **Keyword Filtering**: Set specific keywords to filter messages you're interested in

- **Ignore Keywords**: Exclude messages containing certain words even if they match your filters

- **Message Management**:

- Automatically removes duplicate messages from the same user

- Auto-cleanup of messages older than 60 seconds

- Maximum 50 messages stored to prevent memory issues

- **User Interface**:

- Minimap button for quick access

- Draggable and resizable message window

- Settings panel for configuration

- Quick whisper feature - click on any message to whisper the sender

- **Sound Notifications**: Plays a notification sound when messages matching your filter keywords appear

- **User Blocking**: Block specific users from appearing in your message list

### Installation

1. Download the SimpleFindParty addon

2. Extract to your `World of Warcraft\_classic_\Interface\AddOns\` folder

3. Ensure the folder is named `SimpleFindParty`

4. Restart WoW or type `/reload` in game

### Usage

- **Minimap Button**:

- Left-click: Open settings window

- Right-click: Toggle message window

- Drag: Move the minimap button position

- **Commands**:

- `/sfp` or `/simplefindparty` - Show help

- `/sfp show` - Show message window

- `/sfp hide` - Hide message window

- `/sfp settings` - Open settings window

- `/sfp debug` - Show debug information

- `/sfp reset` - Reset all settings to default

### Configuration

In the settings window, you can:

1. **Select Channel**: Choose which channel to monitor

2. **Filter Keywords**: Enter keywords separated by commas (e.g., "울다만, 성전, 격노")

3. **Ignore Keywords**: Enter words to exclude (e.g., "풀퀘, 일위상")

4. **Sound Toggle**: Enable/disable notification sounds

5. **Manage Blocked Users**: View and unblock users

### Message Window Features

- **Top Bar Icons**:

- Bell icon: Toggle sound notifications

- Gear icon: Open settings

- X button: Close window

- **Message Display**:

- Green nickname (max 8 Korean characters displayed)

- Highlighted keywords in yellow

- Click message to whisper

- Delete button (-) to remove message

- Block button (stop icon) to block user

- **Resize Handle**: Bottom-right corner for resizing

### Technical Details

- Compatible with WoW Classic 1.12

- Saves settings per character

- Supports Korean language

- Custom sound file support (place `ring.wav` in addon folder)

### Author

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

### License

This addon is free to use and modify for personal use.

---

## 한국어

### 개요

SimpleFindParty는 WoW 클래식에서 파티 모집 메시지를 효율적으로 찾고 관리할 수 있도록 도와주는 애드온입니다. 파티 찾기 채널의 메시지를 필터링하고, 키워드를 강조 표시하며, 파티 관련 커뮤니케이션을 관리할 수 있는 깔끔한 인터페이스를 제공합니다.

### 주요 기능

- **채널 메시지 필터링**: 선택한 채널의 메시지를 자동으로 캡처하고 필터링 (기본: "파티찾기" 채널)

- **키워드 필터링**: 관심 있는 메시지만 보기 위한 특정 키워드 설정

- **무시 키워드**: 필터와 일치하더라도 특정 단어가 포함된 메시지 제외

- **메시지 관리**:

- 같은 사용자의 중복 메시지 자동 제거

- 60초 이상 된 메시지 자동 정리

- 메모리 문제 방지를 위해 최대 50개 메시지만 저장

- **사용자 인터페이스**:

- 빠른 접근을 위한 미니맵 버튼

- 드래그 및 크기 조절 가능한 메시지 창

- 설정 패널

- 빠른 귓속말 기능 - 메시지 클릭으로 발신자에게 귓속말

- **소리 알림**: 필터 키워드와 일치하는 메시지가 나타날 때 알림음 재생

- **사용자 차단**: 특정 사용자를 메시지 목록에서 차단

### 설치 방법

1. SimpleFindParty 애드온 다운로드

2. `World of Warcraft\_classic_\Interface\AddOns\` 폴더에 압축 해제

3. 폴더 이름이 `SimpleFindParty`인지 확인

4. WoW 재시작 또는 게임 내에서 `/reload` 입력

### 사용 방법

- **미니맵 버튼**:

- 좌클릭: 설정창 열기

- 우클릭: 메시지창 토글

- 드래그: 미니맵 버튼 위치 이동

- **명령어**:

- `/sfp` 또는 `/simplefindparty` - 도움말 표시

- `/sfp show` - 메시지창 표시

- `/sfp hide` - 메시지창 숨기기

- `/sfp settings` - 설정창 열기

- `/sfp debug` - 디버그 정보 표시

- `/sfp reset` - 모든 설정 초기화

### 설정

설정창에서 다음을 구성할 수 있습니다:

1. **채널 선택**: 모니터링할 채널 선택

2. **필터링 키워드**: 쉼표로 구분된 키워드 입력 (예: "울다만, 성전, 격노")

3. **무시할 키워드**: 제외할 단어 입력 (예: "풀퀘, 일위상")

4. **알림 소리 켜기**: 알림음 활성화/비활성화

5. **차단된 사용자 목록**: 차단된 사용자 확인 및 해제

### 메시지창 기능

- **상단 아이콘**:

- 종 아이콘: 알림음 토글

- 톱니바퀴 아이콘: 설정창 열기

- X 버튼: 창 닫기

- **메시지 표시**:

- 녹색 닉네임 (한글 최대 8글자 표시)

- 노란색으로 강조된 키워드

- 메시지 클릭으로 귓속말

- 삭제 버튼 (-) 메시지 제거

- 차단 버튼 (정지 아이콘) 사용자 차단

- **크기 조절**: 우하단 모서리로 창 크기 조절

### 기술 사양

- WoW Classic 1.12 호환

- 캐릭터별 설정 저장

- 한국어 지원

- 커스텀 사운드 파일 지원 (애드온 폴더에 `ring.wav` 파일 배치)

### 제작자

**우르사 (Ursa)** - Fox and Wolf 서버 (20주년 기념 하드코어)

### 라이선스

이 애드온은 개인 사용을 위해 자유롭게 사용하고 수정할 수 있습니다.

---

## Version History / 버전 기록

### v1.0.0 (2025)

- Initial release / 최초 릴리즈

- Core filtering system / 핵심 필터링 시스템

- Message management / 메시지 관리

- Sound notifications / 소리 알림

- User interface / 사용자 인터페이스

## Support / 지원

For bugs or suggestions, please contact the author in-game.

버그나 제안사항은 게임 내에서 제작자에게 연락해주세요.

**Character / 캐릭터**: 우르사 (Ursa)

**Server / 서버**: Fox and Wolf (20th Anniversary Hardcore)

**Region / 지역**: Korea

Simple Find Party