| **이름** | 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. (선택) **설정 패널** 또는 **미니맵 아이콘**
spiceair
