2주간 테스트를 거쳐서 드디어 공개를 합니다.

2주간이래봐야 2번 테스트 한거라. 여러 공대장님들의 피드백이 절실합니다.

피드백은 제 개인 디스코드 채널에 해주시면 빠르게 수정하겠습니다. 

일부 버그가 확인되어 업데이트 합니다. 3.1.0 에서 수정함

버그내용. 수동으로 입력하는 낙찰가격이 600 으로 입력하면 6으로 바뀌는 현상... 





일단 아래 그림처럼 생겼습니다.




간단한 애드온 소개를 하자면 아래와 같습니다.

GDKP · 골드 분배 공격대에서 낙찰 아이템·지출·분배 인원을 한 창에서 기록하고, 
공격대 채팅 요약 / 상세 출력과 텍스트 저장까지 지원하는 골드 장부 애드온입니다.

| **이름** | Raid Book |
| **용도** | 골드 런 / GDKP 장부, 분배 계산 보조 |
| **슬래시** | `/rb`, `/raidbook` (레거시: `/br`, `/rb2`) |
| **저장** | 캐릭터별 장부(`RaidBookDatabase` 등), 계정 일부 설정(`RaidBookGlobalConfig` 등) |
| **클라이언트** | 리테일·기념 서버 등 `RaidBook.toc`의 `## Interface`에 맞는 빌드 |


- 공격대에서 **아이템별 낙찰가·획득자**를 남기고 싶은 **공대장 / 경매 담당**
- **총수익·총지출·1인당 골드·파티당 골드**를 같은 자리에서 보고 싶은 분
- 공대 끝날 때 **채팅으로 장부를 공유**하거나 **메모장에 붙여넣을 텍스트**가 필요한 분
- **거래창**으로 보상·재료를 넘길 때 자동으로 지출/수익 줄을 남기고 싶은 분

## 주요 기능 (상세)

### 1. 장부 목록 (아이템 테이블)

- **수익(+)** / **지출(-)** 항목을 추가하고, 아이템 링크·획득자(득자)·**낙찰가격(골드)** 를 표로 관리합니다.
- **목록 표시용 품질 필터**(상단): **고급-**(일반·고급만) / **희귀+** / **영웅+**(전설 포함). 자동 기록으로 쌓인 줄 중 **화면에 보이는 범위**만 골라 봅니다.
- **무득처리** 체크 시 해당 줄은 분배 계산에서 제외되는 방식으로 동작합니다.
- **도안무득** 토글: 도안(레시피)류를 한 번에 무득 처리하기 쉽게 했습니다.
- 각 줄 옆 **스피커 아이콘**으로 아이템 링크를 **공대 경보/채팅** 등에 알리기 쉽게 했습니다.
- **3.0.1**: 아이템 이름 줄 글꼴을 획득자 입력란과 비슷한 크기로 맞춤(`ChatFontNormal` 계열).

### 2. 골드만 사용하는 계산

- 내부적으로 **실버/코퍼 변환 없이 골드(정수)** 기준으로 저장·합산합니다.
- 화면과 텍스트 출력의 금액은 **천 단위 콤마**와 **「골드」** 표기를 사용합니다.
- 거래 API가 주는 copper 단위 금액은 **골드로 내림**해 반영합니다.

### 3. 분배 인원 · 올분배 / 무득분

- **분배 인원**을 직접 입력합니다. 공대 규모에 따라 **기본값**이 자동으로 잡힙니다. (예: 10인 이하 10, 11~26인 25, 27인 이상 40)
- **올분배**(녹색): 입력한 인원 **전원** 기준으로 1인당·파티당 등을 계산합니다.
- **무득분**(적색): 실제 **낙찰(획득)이 있는 캐릭터**를 제외한 인원으로 나눕니다.
- 전체분배 버튼 옆에 **애드온 버전**이 표시됩니다. (TOC `## Version` 연동)

### 4. 자동 기록 · 거래 연동

- **자동기록**: 공격대(또는 설정에 따라)에서 **전리품 획득**을 장부에 넣습니다.
- **자동입력 / 수동입력**: **거래창**에서 물건·골드를 주고받을 때 자동으로 줄을 쓸지 여부를 토글합니다.
- **+아이템**: 버튼을 누른 뒤 **가방 아이템**을 **Shift+클릭**으로 수익 항목에 넣을 수 있습니다.  
  **3.0.0**부터는 **채팅·AtlasLoot 등 아이템 링크**도 Shift+클릭으로 같은 방식으로 추가할 수 있습니다. (전문 기술 도안처럼 가방에 없어도 링크만 있으면 기록 가능)
- **낙찰가격 입력**: 칸을 클릭해 비운 뒤 **숫자를 넣지 않고** 탭·다른 곳 클릭으로 포커스만 빠지면 **0**으로 확정됩니다. (**3.0.1**)

### 5. 장부포함 / 장부제외 (화이트·블랙리스트)

- **장부포함**(녹색): 이름이 맞으면 **품질 필터를 무시**하고 기록합니다.
- **장부제외**(적색): 이름이 맞으면 **무조건 제외**합니다. (최우선)
- 쉼표로 여러 이름, **부분 일치** 지원. 저장 후 **리로드 후에도 유지**됩니다.

### 6. 공격대 채팅 출력 · 텍스트 저장

- **상세기록**: 득자별 내역·무득·지출 등 **풀 내용**을 공대 채팅에 **한 줄씩** 순서대로 보냅니다.
- **요약기록**: 총수익·분배 인원·1인당·파티당 등 **요약만** 보냅니다.
- **기록저장**: 같은 내용을 **텍스트 영역**으로 띄워 복사·붙여넣기에 쓸 수 있습니다.
- 출력 끝에는 **출처 안내 두 줄**이 붙습니다. (배포 정책용 고정 문구)

### 7. 카운트다운(경매)

- **시작 / 정지**로 공대 채팅에 **5→1 카운트다운**, 마감·재개 문구를 보냅니다.
- **자동 모드**에서는 공대원이 채팅에 **숫자·한글 숫자(백, 천, 만 등)** 를 올리면 카운트다운을 멈추고 재개 메시지를 보내는 식으로 동작합니다.
- 문구는 `/rb countdown` 계열로 바꿀 수 있습니다.

### 8. 공격대 동기화 (편집 권한)

- 공대에 있을 때 **공대장·지정 편집자** 중심으로 장부를 맞추는 **동기화** 기능이 있습니다.  
  (수신 전용으로 열려 있으면 **편집 잠금**이 걸리고, 일부 버튼이 비활성화될 수 있습니다. 설정 UI 설명 참고.)

### 9. 기타

- **테스트모드**: 샘플 아이템을 넣어 UI·분배를 시험할 수 있습니다.
- **인스턴스 입장 시 장부 초기화 확인** (`/rb autoclear on|off`): 옵션이 켜져 있어도 **공격대 그룹에 있을 때(`IsInRaid`)만** “이전 데이터 삭제” 팝업이 뜹니다. **파티·솔로**로 들어가는 던전에서는 묻지 않습니다. (**3.0.1**)
- 미니맵 **RB** 아이콘: **좌클릭** 설정, **우클릭** 장부 창 토글(동작은 버전에 맞게 설정 패널 안내와 동일).

---

## 사용 방법 (빠른 시작)

1. **미니맵 RB 아이콘 우클릭** 또는 `/rb` 로 장부 창을 엽니다.  
2. 공대 인원에 맞게 **분배 인원**을 확인·수정합니다.  
3. **올분배 / 무득분** 중 하나를 선택합니다.  
4. **자동기록**·**자동입력**을 켜두면 룻·거래가 줄로 쌓입니다.  
5. 필요하면 **+아이템**으로 수동 추가(Shift+클릭 — 가방·채팅 링크).  
6. 종료 후 **상세기록** 또는 **요약기록**으로 공대에 붙이거나, **기록저장**으로 텍스트를 복사합니다.

---

## 슬래시 명령 요약

| 명령 | 설명 |
|------|------|
| `/rb` | 도움말·기능 안내 출력, 장부 창 열기 |
| `/rb toggle` | 자동 기록 모드 전환 |
| `/rb countdown` | 카운트다운 관련 메시지 설정 도움말 |
| `/rb autoclear on|off` | **공격대 중** 인스턴스 입장 시 “장부 전체 삭제” 확인 팝업 켜기/끄기 |
| `/rb synctest on|off` | 비공대에서 동기화 **수신 경로만** 테스트할 때 (개발·디버그용) |
| `/rb sync` | 동기화 상태 확인(공대장, 경매 담당, 편집 가능 여부, 애드온 사용자 목록 등) |

※ 정확한 서브커맨드는 게임 내 `/rb` 출력과 **설정(ESC → 설정 → 애드온)** 패널 하단 설명을 기준으로 하세요.

---

## 다운로드 · 문의

- **CurseForge**에서 **「SKSHIN」** 으로 검색하면 배포 페이지를 찾기 쉽습니다.  
- 애드온 출력물 하단에도 동일한 안내 문구가 포함됩니다.  
- CurseForge 프로젝트 등록 시 로고용으로 **`Media/RaidBook-CurseForge-400.png`** (400×400) 를 사용할 수 있습니다.

---

## 주의사항 · 한계

- **클라이언트 전용 Lua**이므로, 파일을 직접 수정해 출처 검사를 우회하는 것은 **원칙적으로 허용 의도가 아닙니다.** 변조가 감지되면 **상세/요약/기록저장/기록삭제** 등 일부 기능이 비활성화되고 안내 문구가 강조됩니다. (버전 숫자만 바꾸는 정상 업데이트는 문제 없습니다.)
- **법적 분쟁·세무** 등은 이 애드온 사용만으로 해결되지 않습니다. 공대 규칙과 별도 합의를 우선하세요.
- 다른 애드온·UI와의 충돌은 환경마다 다를 수 있으니, 문제가 있으면 **다른 애드온 끄고 재현** 여부를 확인해 주세요.

---

## 버전 기록

- 자세한 변경 내역은 동봉 **`CHANGELOG.md`** 를 참고하세요.  
- **3.0.1** 요약: 공격대일 때만 인스턴스 입장 초기화 팝업, 장부 아이템명·획득자 글꼴 통일, 낙찰가 빈 칸 포커스 이탈 시 **0** 확정, 버전 번호 상향.  
- **3.0.0** 요약: +아이템 링크 확장(채팅 등 Shift+클릭), 버전 표시·출처 푸터·무결성 안내, 메타데이터 API 대응, 무득 출력 대괄호 수정 등.

---

## 스크린샷 안내 (게시 시)

와우인벤 게시글에는 아래를 넣으면 이해가 빠릅니다.

1. **장부 메인 창 전체** (요약 패널 + 테이블 + 하단 버튼)  
2. **올분배/무득분·분배 인원** 이 보이는 부분  
3. **상세기록 또는 요약기록**을 공대 채팅에 보낸 모습 (개인정보 가림)  
4. (선택) **설정 패널** 또는 **미니맵 아이콘**