원래 위와 같은 모양이었으나,
아래와 같이 기능을 추가하였습니다.
커스포지 등록 완료 : 검색어 SKSHIN / RAID BOOK
공격대 운영을 하면서, 이런 저런 애드온을 다 써보다가, 이런 기능이 있으면 좋겠다 싶은것들을 다 모아서
제작해보았습니다.
(추가기능) 동일 애드온 사용자간 데이터 일치 여부 아이콘 추가 : 공격대장 또는 경매담당자의 기록이 업데이트 되는 동시에, 동일 애드온 사용자간 데이터가 실시간으로 동기화 됩니다. 다만, 와우 게임 자체의 제한으로 10개의 메시지 내에서 전송이 이뤄쟈아 하는 관계로, 약간의 딜레이를 추가해서, 실제로는 막대그래프가 보이면서, 순차적으로 동기화 됩니다. 레이드에 중간 참여한 사람도 이 애드온을 사용한다면, 해당 공대의 전체 기록이 동기화 됩니다.
1) 자동기록 : 자동기록 버튼이 켜져 있으면, 공격대가 시작되면 드랍되는 아이템을 일반탬부터 모두 기록합니다.
상단에, 일반+, 고급+, 희귀+, 영웅+, 전설+ 로 드랍된 아이템들을 필터링해서 보실 수 있습니다.
2) 자동입력 : 분배 담당자가 아이템을 플레이어에게 거래하면, 자동으로 입찰가격이 기록됩니다. 꺼져 있으면
수동 입력해야 합니다.
[Raid Book] OOO님이 [아이템링크]을 XXX골드에 구매하였습니다.
3) 고급+ : 일반+,고급+,희귀+,영웅+,전설+ 로 드랍다운 선택을 하면 아이템 리스트들이 필터링 되어 보여집니다.
4) 도안무득 : 도안무득 버튼을 on 상태로 하면, 모든 도안은 입찰가격과 무관하게 무득처리 되어,
해당 도안 획득자는 무득처리됩니다.
5) 테스트모드 : 이건 레이드 가기전에 이 애드온에 익숙해지기 전에, 가상 데이터로 경매 연습을 하실 수 있는
기능입니다. 20개의 아이템을 품질별로 가상 획득한 상태로 가정하고, 낙찰가격, 무득처리, 경매시작,
카운트 등을 연습해 보실 수 있는 기능입니다,
6) 아이템 옆 스피커 버튼 : 경보창으로 아이템을 링크하고, [맹습의 벨트] (판금, 허리) 를 알리고, 공격대 채팅창에 === [맹습의 벨트] (판금, 허리) 경매 시작합니다.=== 를 입력하여 경매시작을 알립니다.
7) 아이템, 획득자, 낙찰가격, 무득처리 : 경매가 끝난 아이템은 흐리게 처리가 되어,
직관적으로 경매 완료 아이템임을 보기 쉽게 해주며,
만약 낙찰가격을 100으로 수동 입력했으나, 다시 입력해야 되는 경우,
낙찰가격 칸을 클릭하면, 0 으로 초기화 되지만, 기존 가격 100 을 기억하도록
상단에 희미하게 100을 보여줍니다.
또한, 낙찰가격에 0 이더라도 무득처리 한 경우에는 경매 완료 아이템으로 자동간주됩니다.
8) 무득처리 : 도안무득 처리 버튼을 누른 경우, 모든 도안은 무득처리되지만,
수동으로 비싼 도안은 경매하여, 입찰가격이 입력되게 할 수 있고, 이때 무득처리 체크를 끄면 됩니다.
9) +수익, -지출 : 레이드 기본 수익과 지출 항목을 입력하실 수 있으며, 이 경우 획득자는 비워놔도 처리됩니다.
기능추가) + 아이템 : 수동으로 아이템을 추가 할 수 있습니다. + 아이템을 누른 후에 가방에 있는 아이템이나 아틀라스루트 등에 있는 아이템 링크를 누르면 수동 입력됩니다.
10) 경매안함 (0) : 아직 경매가 완료되지 않은 아이템 숫자를 보여주며, 모두 완료되면 경매완료 버튼으로 바뀝니다.
기능추가) 경매담당자 이름이 표시됩니다. 공격대장이 이 애드온을 사용하는 공대원을 경매담당자를 부공대장으로 승격시키면, (애드온 로딩시, 동일 애드온 사용중인 공격대원의 캐릭터명이 수집됩니다.) 이후 , 나머지 공대원들은 모든 버튼 (아이템필터링 버튼 제외) 이 비활성화되서 방해가 없게끔 하고, 나머지 공대원들은 실시간으로 경매 현황을 지켜볼 수 있습니다. 즉 실시간으로 모든 경매 아이템과 낙찰가격 무득처리를 볼 수 있습니다.
11) 분배인원 설정 : 현재 N 명 : 경매 완료 후 분배 시점에 남아 있는 공대원 수
12) 획득자 N 명 : 무득 처리 제외하고 획득한 공대원 수
13) 무득분배 (N) : 토글로 전체 분배 (N), 무득분배 (N) 으로 누를떄마다 바뀌니까 올분, 무득분에 따라 세팅.
14) 총수익 , 총지출, 총수입 부분은 모두 자동 계산, 개인당 파티당 골드를 알려주며,
계산기 필요없게 파티원이 2~4명인 파티도 골드를 얼마 줘야 하는지 바로 알 수 있게 표현
15) 상세기록, 요약기록 : 말 그대로, 상세기록을 보여줄지, 요약기록을 보여줄지에 따라 누르면 됩니다.
16) 기록저장 : 텍스트 형식으로 기록을 보여줘서, 디스코드나 , 기타 sns 에 복사해 줄 수 있습니다.
17) 기록삭제 : 모든 기록을 삭제하며, 인던 최초 진입시 기존 기록을 일괄 삭제할 지 물어봅니다.
18) 자동버튼 : 이걸 자동 / 수동 토글 할 수 있고, 자동인 경우, 경매 카운트 진행하다가 ,
누군가 숫자와 관련된 말을 공대창에 쓰면 카운트가 자동으로 멈춥니다.
19) 플레이버튼 : 카운트를 시작합니다. 5초로 세팅되어 있습니다.
20) 수동정지 버튼 : 카운트를 정지합니다. 다시 플레이버튼 누르면 5초부터 다시 카운트 합니다.
만약 자동이 아니라 수동인 경우에 스탑기능 역할입니다.
21) 장부포함/장부제외 : 버튼이 토글되며, 장부포함 또는 장부제외할 아이템이름을 입력하고 포함/제외를 누르면
해당 아이템은 목록에 보이지 않습니다.
이상의 기능을 가지고 있습니다. RaidLedger 등 많은 애드온을 사용해봤는데, 세팅을 따로 해야 하는것도
귀찮고, 제가 공대 운영하면서 꼭 필요한 기능만 넣어서 만들었습니다.
그리고, 화폐단위는 골드단위로 통일해서, 실버 이하 입력은 되지 않습니다. 따라서, 거래시 1골드 20실버 이런식으로는 입력되지 않습니다. 코퍼, 실버, 골드 단위 일일이 변환해서 코딩하기 귀찮아서....
이상의 애드온을 현재 완성은 하였고, 실제 레이드에서 테스트는 아직 못했습니다.
레이드에서 테스트 후, 버그가 발견되면 수정해서 정식 배포할 생각입니다.
## 한 줄 요약
**GDKP·골드 분배 공격대**에서 낙찰 아이템·지출·분배 인원을 한 창에서 기록하고, **공대 채팅 요약/상세 출력**과 **텍스트 저장**까지 지원하는 **골드 장부 애드온**입니다.
---
## 애드온 정보
| 항목 | 내용 |
|------|------|
| **이름** | Raid Book |
| **용도** | 골드 런 / GDKP 장부, 분배 계산 보조 |
| **슬래시** | `/rb`, `/raidbook` (레거시: `/br`, `/rb2`) |
| **저장** | 캐릭터별 장부 데이터, 계정 일부 설정 |
| **클라이언트** | 리테일·기념 서버 등 `RaidBook.toc`의 `## Interface`에 맞는 빌드 |
---
## 이런 분께 추천합니다
- 공격대에서 **아이템별 낙찰가·획득자**를 남기고 싶은 **공대장 / 경매 담당**
- **총수익·총지출·1인당 골드·파티당 골드**를 같은 자리에서 보고 싶은 분
- 공대 끝날 때 **채팅으로 장부를 공유**하거나 **메모장에 붙여넣을 텍스트**가 필요한 분
- **거래창**으로 보상·재료를 넘길 때 자동으로 지출/수익 줄을 남기고 싶은 분
---
## 주요 기능 (상세)
### 1. 장부 목록 (아이템 테이블)
- **수익(+)** / **지출(-)** 항목을 추가하고, 아이템 링크·획득자(득자)·**낙찰가격(골드)** 를 표로 관리합니다.
- **품질 필터**(일반+ ~ 전설+)로 자동 기록 시 **잡템 등 낮은 등급**을 제외할 수 있습니다.
- **무득처리** 체크 시 해당 줄은 분배 계산에서 제외되는 방식으로 동작합니다.
- **도안무득** 토글: 도안(레시피)류를 한 번에 무득 처리하기 쉽게 했습니다.
- 각 줄 옆 **스피커 아이콘**으로 아이템 링크를 **공대 경보/채팅** 등에 알리기 쉽게 했습니다.
### 2. 골드만 사용하는 계산
- 내부적으로 **실버/코퍼 변환 없이 골드(정수)** 기준으로 저장·합산합니다.
- 화면과 텍스트 출력의 금액은 **천 단위 콤마**와 **「골드」** 표기를 사용합니다.
- 거래 API가 주는 copper 단위 금액은 **골드로 내림**해 반영합니다.
### 3. 분배 인원 · 올분배 / 무득분
- **분배 인원**을 직접 입력합니다. 공대 규모에 따라 **기본값**이 자동으로 잡힙니다. (예: 10인 이하 10, 11~26인 25, 27인 이상 40)
- **올분배**(녹색): 입력한 인원 **전원** 기준으로 1인당·파티당 등을 계산합니다.
- **무득분**(적색): 실제 **낙찰(획득)이 있는 캐릭터**를 제외한 인원으로 나눕니다.
- 전체분배 버튼 옆에 **애드온 버전**이 표시됩니다. (TOC `## Version` 연동)
### 4. 자동 기록 · 거래 연동
- **자동기록**: 공격대(또는 설정에 따라)에서 **전리품 획득**을 장부에 넣습니다.
- **자동입력 / 수동입력**: **거래창**에서 물건·골드를 주고받을 때 자동으로 줄을 쓸지 여부를 토글합니다.
- **+아이템**: 버튼을 누른 뒤 **가방 아이템**을 **Shift+클릭**으로 수익 항목에 넣을 수 있습니다.
**3.0.0**부터는 **채팅·AtlasLoot 등 아이템 링크**도 Shift+클릭으로 같은 방식으로 추가할 수 있습니다. (전문 기술 도안처럼 직접 못 룻하는 것도 링크만 있으면 기록 가능)
### 5. 장부포함 / 장부제외 (화이트·블랙리스트)
- **장부포함**(녹색): 이름이 맞으면 **품질 필터를 무시**하고 기록합니다.
- **장부제외**(적색): 이름이 맞으면 **무조건 제외**합니다. (최우선)
- 쉼표로 여러 이름, **부분 일치** 지원. 저장 후 **리로드 후에도 유지**됩니다.
### 6. 공격대 채팅 출력 · 텍스트 저장
- **상세기록**: 득자별 내역·무득·지출 등 **풀 내용**을 공대 채팅에 **한 줄씩** 순서대로 보냅니다.
- **요약기록**: 총수익·분배 인원·1인당·파티당 등 **요약만** 보냅니다.
- **기록저장**: 같은 내용을 **텍스트 영역**으로 띄워 복사·붙여넣기에 쓸 수 있습니다.
- 출력 끝에는 **출처 안내 두 줄**이 붙습니다. (배포 정책용 고정 문구)
### 7. 카운트다운(경매)
- **시작 / 정지**로 공대 채팅에 **5→1 카운트다운**, 마감·재개 문구를 보냅니다.
- **자동 모드**에서는 공대원이 채팅에 **숫자·한글 숫자(백, 천, 만 등)** 를 올리면 카운트다운을 멈추고 재개 메시지를 보내는 식으로 동작합니다.
- 문구는 `/rb countdown` 계열로 바꿀 수 있습니다.
### 8. 공격대 동기화 (편집 권한)
- 공대에 있을 때 **공대장·지정 편집자** 중심으로 장부를 맞추는 **동기화** 기능이 있습니다.
(수신 전용으로 열려 있으면 **편집 잠금**이 걸리고, 일부 버튼이 비활성화될 수 있습니다. 설정 UI 설명 참고.)
### 9. 기타
- **테스트모드**: 샘플 아이템을 넣어 UI·분배를 시험할 수 있습니다.
- **던전 입장 시 장부 자동 초기화** 옵션 (`/rb autoclear`) 등 편의 명령이 있습니다.
- 미니맵 **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」** 으로 검색하면 배포 페이지를 찾기 쉽습니다.
- 애드온 출력물 하단에도 동일한 안내 문구가 포함됩니다.
---
## 주의사항 · 한계
- **클라이언트 전용 Lua**이므로, 파일을 직접 수정해 출처 검사를 우회하는 것은 **원칙적으로 허용 의도가 아닙니다.** 변조가 감지되면 **상세/요약/기록저장/기록삭제** 등 일부 기능이 비활성화되고 안내 문구가 강조됩니다. (버전 숫자만 바꾸는 정상 업데이트는 문제 없습니다.)
- **법적 분쟁·세무** 등은 이 애드온 사용만으로 해결되지 않습니다. 공대 규칙과 별도 합의를 우선하세요.
- 다른 애드온·UI와의 충돌은 환경마다 다를 수 있으니, 문제가 있으면 **다른 애드온 끄고 재현** 여부를 확인해 주세요.
---
## 버전 기록
- 자세한 변경 내역은 동봉 **`CHANGELOG.md`** 를 참고하세요.
- **3.0.0** 요약: +아이템 링크 확장, 버전 표시·출처 푸터·무결성 안내, 메타데이터 API 대응, 무득 출력 대괄호 수정 등.
-
spiceair
