íë©´ ìº¡ì² 2026-08-01 010341.png
adv-01-sync.png
Description
# Raid Book
A **GDKP / gold-run raid ledger** addon for WoW **Classic**.
Developed and tested on the **20th Anniversary Edition** (Burning Crusade Classic). Also supports other Classic flavors listed in `RaidBook.toc`.
**Folder**: `RaidBook`
**Version** matches `## Version` in `RaidBook.toc` (currently **17.2.0**).
## Features
- **Raid ledger**: Credit/debit rows for loot, auction prices, beneficiaries, confirm flags, and manual raid income/expense.
- **Auction manager role**: One officer owns the live ledger and sends it to the raid; receivers view a locked copy. Sync requires the **exact same addon version**.
- **Auction panel**: Raid chat bids, countdown, sold/pass close, ×N stack auctions, leftover copy assign (`−` / `+` on the sold banner).
- **Trade settle**: Put sold items into the trade window (optional auto-put). **Other-looter / unique rows** settle as **gold-only (remote)** — your bag copy of the same itemID is not put; the winner whisper can say who to collect from.
- **Trade timer**: Remaining trade time on ledger rows; sort via the **남은시간** header on the item column.
- **Ledger sort**: `#` (loot order), item name, beneficiary, **status (signal lights)**, bid gold, remaining time. Entering **미확정 N** starts on `#` newest-first; use **상태** for red→yellow→green order.
- **Distribution**: Full split vs no-beneficiary split, guests excluded, optional loot-status / roster tools. **분배 주의** modal shows mode (**전체 분배** green / **무득 분배** blue) with **장부검토** (X) / **장부확인** (speaker).
- **Sync**: Always-on in raid; send/receive diamond indicator. Send failures print to **your chat only** (no center dim modal); `/rb syncerrors` lists recent errors. Peers that fail repeatedly are muted briefly.
- **Minimap**: Left-click ledger, right-click options/help (`/rb options`).
## Slash commands (common)
| Command | Purpose |
|--------|---------|
| `/rb` · `/raidbook` | Open ledger |
| `/rb options` | In-game manual |
| `/rb sync` | Authority / version / sync status |
| `/rb claim` | Claim auction manager (officer) |
| `/rb bid show\|hide\|settings` | Auction panel |
| `/rb syncerrors` | Recent sync error log |
| `/rb autput on\|off` | Auto-put sold items on trade |
## Data storage
- Account: `WTF\Account\<Account>\SavedVariables\RaidBook.lua` (`RaidBookGlobalConfig`, `RaidLedgerGlobalConfig`)
- Character: `WTF\Account\<Account>\<Realm>\<Char>\SavedVariables\RaidBook.lua` (`RaidBookDatabase`, `RaidLedgerDatabase`)
Legacy `RaidLedger*` names are still accepted where migrated.
## Changelog
See [`CHANGELOG.md`](CHANGELOG.md). Older patch notes may live in `CHANGELOG-archive.md` (local).
---
# 한국어 (Korean)
WoW **클래식**용 **골드 분배(GDKP) 장부** 애드온입니다.
**20주년 기념판**(불타는 성전 클래식)에서 개발·테스트했으며, `RaidBook.toc`에 적힌 다른 클래식 인터페이스도 지원합니다.
**버전**은 `RaidBook.toc`의 `## Version`과 같습니다 (현재 **17.2.0**).
## 기능
- **레이드 장부**: 루팅·낙찰가·득자·확정, 수동 공대 수입/지출.
- **경매담당**: 임원 1명이 편집·송신, 나머지는 수신(잠금). **애드온 버전이 담당과 완전히 같아야** 동기화됩니다.
- **경매 진행 창**: 공대 채팅 입찰, 카운트다운, 낙찰/유찰, ×N, 잔여 사본 `−`/`+`.
- **거래 확정**: 낙찰 아이템 거래칸 올리기(자동 올리기 옵션). **다른 루터·고유템 행**은 **골드만(remote)** — 내 가방 같은 itemID는 올리지 않음. 귓말에 루터 수령 안내 가능.
- **거래 남은시간**: 행에 표시, 아이템 열 우측 **남은시간** 헤더로 정렬.
- **장부 정렬**: `#`(루팅순), 이름, 득자, **상태(신호등)**, 낙찰가, 남은시간. **미확정 N** 진입 시 `#` 최신순; 신호등순은 **상태** 헤더.
- **분배**: 전체 분배 / 무득 분배, 손님 제외. **분배 주의** 창에 모드 크게 표시(전체=초록, 무득=파랑), 버튼 **장부검토**(X) / **장부확인**(스피커).
- **동기화**: 공대에서 상시. 전송 실패는 **채팅만** 표시(`/rb syncerrors`). 실패 누적 peer는 잠시 sync 중단.
- **미니맵**: 좌클릭 장부, 우클릭 설명서(`/rb options`).
## 자주 쓰는 명령
| 명령 | 설명 |
|------|------|
| `/rb` | 장부 |
| `/rb options` | 사용 설명서 |
| `/rb sync` | 담당·버전·동기화 상태 |
| `/rb claim` | 경매담당 수락 |
| `/rb bid show\|hide\|settings` | 경매 창 |
| `/rb syncerrors` | 동기화 오류 기록 |
| `/rb autput on\|off` | 낙찰 아이템 자동 올리기 |
## 저장 위치
- 계정: `WTF\Account\<계정>\SavedVariables\RaidBook.lua`
- 캐릭터: `WTF\Account\<계정>\<서버>\<캐릭>\SavedVariables\RaidBook.lua`
변경 이력은 [`CHANGELOG.md`](CHANGELOG.md)를 참고하세요.
The RaidBook Team
