KoreanChat 1.1.1 — 설치 및 사용 방법
===================================

와우 포에버 베타의 다국어 채팅에 한국어 용어 풀이를 붙이는 애드온입니다.
영어 약어, 인던명, 직업, 모집 표현 등 419개 별칭을 포함합니다.
사전 풀이는 인터넷 연결이나 API 키 없이 동작합니다.

[지원 대상]
WoW Forever / Classic Beta 1.60.1, Interface 16001
제작 기준 클라이언트: 1.60.1.69893
베타용 비공식 애드온이며, 다른 버전이나 향후 업데이트의 호환성을 보장하지 않습니다.

[처음 설치하기]
1. 월드 오브 워크래프트를 완전히 종료합니다.
2. KoreanChat-1.1.1.zip의 압축을 풉니다.
3. 압축 안의 KoreanChat 폴더를 아래 위치에 복사합니다.

   World of Warcraft\_classic_beta_\Interface\AddOns\

   기본 설치 위치 예시:
   C:\Program Files (x86)\World of Warcraft\_classic_beta_\Interface\AddOns\

   게임을 다른 드라이브에 설치했다면 그 위치에서 같은 하위 폴더를 찾으세요.
   _retail_이나 _classic_이 아닌, 플레이하는 베타의 _classic_beta_ 폴더입니다.

4. 반드시 아래와 같은 구조인지 확인합니다.

   AddOns
     └─ KoreanChat
          ├─ KoreanChat.toc
          ├─ Core.lua
          ├─ Dictionary.lua
          ├─ Glossary.lua
          ├─ ChatDisplay.lua
          ├─ UI.lua
          ├─ 번역도우미.html
          ├─ helper.js
          ├─ ui.js
          ├─ README.md
          ├─ CHANGELOG.md
          └─ 설치방법.txt

   주의: AddOns\KoreanChat\KoreanChat\KoreanChat.toc 처럼
         폴더가 이중으로 들어가면 애드온이 인식되지 않습니다.

5. 게임을 실행하고 캐릭터 선택 화면의 애드온 목록에서 KoreanChat을 켭니다.
6. 접속 후 /kc demo를 입력해 예시와 기록 창이 표시되는지 확인합니다.
   예시 메시지는 본인 화면에만 표시되고 다른 플레이어에게 전송되지 않습니다.

[기존 버전 업데이트]
1. 게임을 종료하고 기존 AddOns\KoreanChat 폴더를 별도 위치에 백업합니다.
2. 새 KoreanChat 폴더를 같은 위치에 복사하고 동일한 파일은 덮어씁니다.
3. 게임을 다시 실행합니다. 파일만 교체한 상태라면 /reload로 다시 읽을 수도 있습니다.
   새 파일이 인식되지 않으면 게임을 완전히 종료했다가 실행하세요.
4. Dictionary.lua를 직접 수정했다면 백업과 비교해 사용자 용어를 다시 추가합니다.

[바로 사용하기]
설치 후 들어오는 채팅 바로 아래에 초록색 [용어] 풀이가 자동으로 붙습니다.
예: LFM DM 1 tank 1 heal
    [용어] 파티원 모집 · 죽음의 폐광/혈투의 전장(?) · 탱커 1명 · 힐러 1명

/kc 또는 /kchat : 최근 대화 기록 창 열기/닫기
/kc inline       : 기본 채팅 용어 풀이 켜기/끄기
/kc demo         : 다국어 예시 5개 표시
/kc clear        : 보관한 대화 삭제
/kc reset        : 기록 창 위치 초기화

기록 창에는 최근 300개까지 원문과 풀이가 표시됩니다.
마우스 휠로 이전 기록을 보고, 메시지 위에 마우스를 올리면 전체 내용을 봅니다.
길드·귓속말은 기본 수집하지 않으며, 기록 창의 해당 옵션을 켜면 수집·풀이합니다.
수집 일시정지는 기록 저장만 멈춥니다. 실시간 풀이는 /kc inline으로 끌 수 있습니다.
대화는 /reload, 로그아웃, 게임 종료 시 지워지고 설정만 저장됩니다.
애드온을 켜기 전의 대화나 이미 지워진 기록은 복원하지 않습니다.

[긴 문장 웹 번역 — 선택 기능]
1. /kc에서 메시지의 '웹 번역 복사'를 누릅니다.
   여러 문장은 체크 후 '선택 복사', 또는 '최근 20개 복사'를 누릅니다.
2. 열린 복사 창에서 Ctrl+A, Ctrl+C를 누릅니다.
3. 파일 탐색기에서 AddOns\KoreanChat\번역도우미.html을 브라우저로 엽니다.
   helper.js와 ui.js를 HTML과 같은 폴더에 그대로 두세요.
4. 입력란에 Ctrl+V로 붙여넣고 개별 또는 묶음 번역 버튼을 누릅니다.
5. 새 Google 번역 탭에서 한국어 결과를 확인합니다.

웹 번역에는 인터넷이 필요하며 결과가 게임에 자동으로 돌아오지 않습니다.
버튼을 누른 본문은 Google에 전달됩니다. 별도 필드의 캐릭터명·시간·채널은
제외하지만 본문 안의 이름은 남습니다. 번역 URL은 브라우저 방문 기록에 남을 수 있습니다.
여러 언어가 섞인 묶음의 언어 감지가 부정확하면 개별 번역을 사용하세요.

[알아둘 점 / 문제 해결]
- [용어]는 등록된 표현을 풀이하며 문장 전체를 번역하지 않습니다.
  조건, 부정 표현, 새로운 은어 등은 원문을 함께 확인하세요.
- DM처럼 뜻이 여러 개인 약어는 후보를 함께 표시합니다.
- 애드온 목록에 없으면 ZIP 압축 해제, 설치 경로, 이중 폴더 여부부터 확인하세요.
- 창이 안 보이면 /kc reset, 예시 확인은 /kc demo를 사용하세요.
- 풀이가 없으면 /kc inline 설정, 지원하는 채팅 종류, 사전 포함 여부를 확인하세요.
- 베타 업데이트 후 오류가 나면 애드온을 끄고 호환 버전을 확인하세요.
  오류 확인은 /console scriptErrors 1, 다시 끄기는 /console scriptErrors 0입니다.
- 문제를 제보할 때 클라이언트 버전, 애드온 버전, 재현 문장을 함께 적으면 좋습니다.
  제보에 개인 대화나 계정 정보가 포함되지 않도록 확인하세요.
- 삭제는 게임을 종료하고 AddOns\KoreanChat 폴더를 제거하면 됩니다.

이 패키지는 자동 테스트와 압축 구조를 검증했습니다.
실제 베타 클라이언트에서의 최종 동작은 사용 환경에서 확인해 주세요.

[1.1.1 글꼴 수정]
한국어 풀이는 원문 아래 별도 줄로 표시하며 와우 기본 한글 글꼴(2002.TTF)을 사용합니다.
외부 글꼴 설치는 필요하지 않습니다. 원문 채팅 글꼴과 /kc 기록 창 글꼴은 유지합니다.
이 수정은 용어 풀이 줄 대상이며 원문 캐릭터명 등의 누락된 글자까지 복구하지는 않습니다.
