# WowlogRoster — 와우로그 명단

> CurseForge Description 칸에 그대로 붙여넣는 본문. **한국어를 먼저, 영어를 아래에** 둔다.
> CurseForge는 프로젝트당 설명이 하나뿐이라(언어별 분리 없음) 주 사용자 언어를 위에 놓는다.
>
> ⚠ 도메인은 **와우로그.kr**(퓨니코드 `xn--2i0b10r1sl2ma.kr`)이다. `wowlog.kr`이 아니다 —
> 2026-08-05 이전 원고에 잘못 적혀 있었다.
> ⚠ 아직 실전에서 확인 못 한 기능은 단정하지 않는다(docs/addon-curseforge-listing.md 참고).

---

**[와우로그.kr](https://xn--2i0b10r1sl2ma.kr/lfg) 구인 게시판에서 짠 공대 명단을, 인게임에 붙여넣고 한 번에 초대하는 애드온입니다.**
공대를 굴리는 동안 골팟 장부까지 이 창 하나에서 봅니다.

이 애드온은 **인터넷에 접속하지 않습니다.** 오가는 건 여러분이 직접 복사·붙여넣기 하는 글자 한 덩어리뿐이고,
계정을 읽거나 어디로 보내는 게 전혀 없습니다.

## 명단과 초대

- **붙여넣으면 끝** — 사이트에서 [명단 텍스트 복사]를 누르고 애드온에 붙여넣으면 이름·직업·전문화·역할·서버가 그대로 들어옵니다.
- **[전체 초대] 한 번** — 0.4초 간격 큐로 나가서 클라이언트가 조용히 흘리지 않습니다. 이미 파티에 있는 사람은 건너뛰고, 5명이 넘으면 알아서 공격대로 전환합니다.
- **다른 서버도 그대로** — 서버 슬러그를 인게임 서버명으로 바꿔 `이름-서버`로 초대합니다. 손으로 칠 게 없습니다.
- **예비 명단** — 확정 예비가 명단에 같이 옵니다. 노쇼가 나면 창에서 바로 충원합니다.
- **지각 통보** — 사이트에 "늦어요"를 남긴 사람은 줄에 표시됩니다. 오고 있는 사람을 자르지 않게.
- **부공대장** — 사이트에서 지정한 인원을 표시하고, 합류하면 인게임 부공대장으로 올려 줍니다.
- **시작 카운트다운** — 일정 시각이 명단과 함께 와서 남은 시간이 뜨고, 30분·10분 전에 알리고 정시에 미합류 인원을 호명합니다.
- **공대 버프 점검** — 확정 명단의 직업 구성으로 빠진 공대 버프를 짚어 줍니다. 아무도 입장하기 전에 알 수 있습니다.

## 인게임 달력

- **일정 자동 생성** — 제목·날짜·시각·난이도까지 채워서 달력에 올립니다. 창에서 손으로 고를 게 없습니다.
- **전원 초대장** — 한 명씩 순서대로 나가고 진행 막대로 몇 명째인지 보입니다. 개명·서버 이전·삭제로 초대가 안 되는 이름은 **알려주고 건너뜁니다.**
- **탄력적 공격대 대응** — 달력에 신화 항목이 따로 없는 레이드가 있습니다. 짐작하지 않고 게임에 어느 난이도인지 물어서 맞춥니다.
- **중복 없음** — 같은 날 같은 제목의 일정이 있으면 새로 만들지 않고 빠진 사람에게만 초대장을 보냅니다.

## 자리 배치

- **명단 순서대로** — 버튼 한 번으로 인게임 공대 그룹을 사이트에서 짠 순서에 맞춰 정리합니다.

## 골팟 정산

한국 골팟이 실제로 도는 방식 그대로입니다 — 공대장이 전리품을 모으고, 경매로 팔고, 마지막에 나눕니다.

- **전리품 장부** — 보스가 죽으면 영웅 이상 전리품이 자동으로 잡히고, 거래 제한 시간도 같이 카운트됩니다. 그 외 아이템은 링크를 끌어다 놓으면 됩니다.
- **낙찰은 보통 적을 일이 없습니다** — 낙찰자에게 아이템을 건네면서 골드를 받으면, 그 거래 하나에 누가·무엇을·얼마에가 다 들어 있습니다. 애드온이 읽어서 **낙찰과 수금을 한 번에** 끝냅니다. 외상·우편처럼 돈과 물건이 따로 오간 건만 직접 적으면 됩니다.
- **못 맞춘 거래는 남깁니다** — 추측으로 처리하지 않고 미분류로 두고, 어느 낙찰 건인지 지정하거나 이번 판 수입으로 인정하면 됩니다.
- **내 소지 골드** — 지금 골드와 골팟 시작 후 증감을 같이 보여줘서, 장부가 맞는지 대조할 기준이 생깁니다.
- **정산** — 수수료(없음·공장 N+1·정액)와 분배(올분·무득분·조건부 올분)를 고르면 인당 금액이 나옵니다. 손님은 버튼 한 번으로 분배에서 빠집니다. 거래로 지급하면 체크가 알아서 켜집니다.
- **파티 단위 요약** — 공대챗 공지가 파티별로 나뉘어서, 파티장에게 한 뭉치 주고 넘기는 방식도 됩니다.
- **잘못 넣어도 고칠 수 있습니다** — 낙찰자·금액 수정, 판매 취소, 잘못된 거래 무효 처리. 골드 장부는 덮어쓰지 않고 쌓이기만 해서 기록한 게 조용히 사라지지 않습니다.

## 명령어

| 명령어 | 하는 일 |
|---|---|
| `/wowlog` 또는 `/wr` | 명단 창 열기·닫기 |
| `/wr gp` | 골팟 정산 창 |
| `/wr invite` | 명단 전원 초대 |
| `/wr stop` | 진행 중인 달력 초대 중단 |
| `/wr clear` | 명단 비우기 |
| `/wr sort` | 명단을 원래 순서로 |
| `/wr promote` | 부공대장 자동 승급 켜기·끄기 |
| `/wr config` | 설정 |
| `/wr minimap` | 미니맵 버튼 표시·숨김 |
| `/wr unlock` | 이번 접속만 초대 제한 해제 (공대장이 부캐일 때) |
| `/wr ver` | 버전·빌드 확인 |

## 알아두실 것

- 리테일만 지원합니다.
- 보스 전리품은 공격대에서만 자동으로 잡힙니다. 5인 던전에서는 직접 넣어 주세요.
- 계정을 읽거나, 어디로 보내거나, 게임 제한을 우회하지 않습니다 — 초대는 기본 UI가 쓰는 것과 같은 방식입니다.

---

# English

**Paste the roster you built on [와우로그.kr](https://xn--2i0b10r1sl2ma.kr/lfg) (a Korean WoW recruitment board) and invite everyone in one click** — then keep your gold-run books in the same window while you raid.

The addon **never connects to the internet.** Everything moves through a single text string you copy and paste yourself. Nothing is uploaded, and nothing is read from your account.

## Roster & invites

- **Paste and go** — names, classes, specs, roles and realms come in as one block.
- **One-click invites** — sent on a 0.4s queue so the client never silently drops them. Players already in your group are skipped, and party converts to raid automatically past five.
- **Cross-realm handled** — realm slugs are translated to in-game realm names, so `Name-Realm` invites work without typing.
- **Standby list** — confirmed standbys ride along. Invite a replacement from the panel when someone no-shows.
- **Late notices** — if an applicant told the site they'd be late, their row says so.
- **Officers** — people you promoted on the site are marked, and can be promoted to assistant in game once they join.
- **Start countdown** — heads-up at 30 and 10 minutes out, plus a roll call at start time.
- **Raid buff check** — see which raid buffs your roster is missing before anyone zones in, computed from class composition.

## Calendar

- **Event created for you** — title, date, time and difficulty filled in.
- **Everyone invited** — invites go out one at a time with a progress bar. Names that can't be invited (renamed, transferred, deleted) are reported and skipped instead of stalling.
- **Flexible raids handled** — some raids have no separate Mythic entry; the addon asks the game which difficulty is which instead of guessing.
- **No duplicates** — if an event with that title already exists that day, only the missing invites are added.

## Raid layout

- **Seat by roster order** — one button arranges in-game raid groups to match the order you planned.

## Gold-run ledger (GDKP)

Built for the way Korean gold runs actually work: the leader collects every drop, auctions it, and splits the pot at the end.

- **Loot book** — epic-or-better drops are recorded when a boss dies, with the trade timer counting down. Drag anything else in.
- **Sales record themselves** — hand the item over and take the gold in one trade, and the addon reads who bought what for how much, closing the sale and the payment together. Only split payments (gold now, item later, or by mail) need typing in.
- **Unmatched trades are kept, not guessed** — assign them to a sale or mark them as income for the run.
- **Your purse, in view** — current gold and the change since the run started, so the books have something to check against.
- **Settlement** — host cut (none / one extra share / flat fee) and split rules (everyone, no-gain-only, or above a threshold); guests drop out with one button. Pay by trade and the checklist ticks itself.
- **Party-level payouts** — the raid chat summary breaks the pot down per party.
- **Mistakes are fixable** — fix a winner or price, cancel a sale, void a bad trade line. The gold ledger is append-only, so nothing you record can quietly vanish.

## Notes

- **The interface is in Korean** — it pairs with a Korean service.
- Retail only for now.
- Boss loot is captured in raids; in five-player groups add items by hand.
- The addon does not read your account, send anything anywhere, or bypass any in-game restriction — invites use the same API the default UI does.