premium banner

Description

# Loot-Roll

A **roll (/roll) tracker + dungeon loot log** addon for WoW **Classic**.
Developed and tested on the **20th Anniversary Edition** (Burning Crusade Classic). Also supports Era, Cataclysm Classic, and other Classic flavors.

**Folder**: `Loot-Roll`
**Version** matches `## Version` in `Loot-Roll.toc`.

## Features

- **Roll list window**: Displays roll results sorted highest-first, with tie elimination, instant close, and result announce.
- **Loot log window**: Records dungeon boss loot (Need/Greed/Pass rolls) with quality filters (All / Uncommon+ / Rare+ / Epic+ / Legendary+) and toast notifications.
- **Loot report**: Send selected loot lines to Say / Party / Raid / Guild channels with clickable item links.
- **Settings (ESC → Options → AddOns)**: **Loot-Roll** entry.
- **Minimap icon** (no library required)
  - **Left-click**: Toggle settings
  - **Right-click**: Toggle roll window
  - **Shift+Right-click**: Toggle loot log window
  - **Alt+Right-click**: Enable/Disable addon
  - **Drag**: Reposition around minimap
- **Slash commands**: `/lootroll` · `/lr` (legacy: `/croll`, `/compactroll`)

## Icons

- **Minimap / Addon list**: Default Blizzard **`Interface\Buttons\UI-GroupLoot-Dice-Up`** (dice) texture.

## CurseForge Project Icon

- **`Art/CompactRoll-CurseForge-400.png`** — **400×400 pixels, 1:1** (listing spec).

## Data Storage

`WTF\Account\<Account>\SavedVariables\Loot-Roll.lua` — `LootRollSaved` (auto-migrates from legacy `CompactRollDB` / `CompactRollSaved`)

> **Existing CompactRoll users**: The folder name has changed. To keep your settings, copy (or rename) `CompactRoll.lua` to `Loot-Roll.lua` in your WTF SavedVariables folder.

## License / Credits

- Minimap uses default Blizzard border/background texture IDs.

RollTracker / RollTrackerClassicZ are **separate projects**; no code was directly forked from them.

---

# 한국어 (Korean)

WoW **클래식**용 **주사위(/roll) 기록 + 인던 전리품 로그** 애드온입니다.
**20주년 기념판** (불타는 성전 클래식)에서 개발·테스트되었으며, 에라 / 카타클리즘 클래식 등 다른 클래식 버전도 지원합니다.

## 기능

- **주사위 목록 창**: 주사위 결과를 높은 순으로 표시, 동수 탈락, 즉시 마감, 결과 알림.
- **전리품 기록 창**: 인던 보스 전리품(입찰/차비/포기 주사위) 결과 기록, 품질 필터(일반+/고급+/희귀+/영웅+/전설+), 토스트 알림.
- **전리품 보고**: 선택한 전리품 줄을 일반/파티/공격대/길드 채널로 아이템 링크와 함께 전송.
- **설정(ESC → 옵션 → 애드온)**: **Loot-Roll** 항목.
- **미니맵 아이콘** (라이브러리 불필요)
  - **왼쪽 클릭**: 설정 열기/닫기
  - **오른쪽 클릭**: 주사위 창 열기/닫기
  - **Shift+오른쪽 클릭**: 전리품 기록 창 열기/닫기
  - **Alt+오른쪽 클릭**: 사용함/사용안함 전환
  - **드래그**: 미니맵 둘레 위치 이동
- **슬래시**: `/lootroll` · `/lr` (레거시: `/croll`, `/compactroll`)

## 저장

`WTF\Account\<계정>\SavedVariables\Loot-Roll.lua` — `LootRollSaved` (레거시 `CompactRollDB`/`CompactRollSaved`에서 자동 마이그레이션)

> **기존 CompactRoll 사용자**: 폴더명이 바뀌었으므로, 기존 설정을 유지하려면 WTF 폴더에서
> `CompactRoll.lua` 파일을 `Loot-Roll.lua`로 복사(또는 이름 변경)해 주세요.