My Simple Raid Ledger (WoW Classic 20주년 서버용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.5 (빌드 20505), 
Version: 1.1.4 (2026. 1. 15.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Raid Ledger(간단장부)는 공격대 진행 중 발생하는 거래(경매 낙찰, 직접 루팅, 경비 지출, 마력 추출 의뢰/수령)를 기록하고, 손님과 득자를 자동으로 구분하여 최종 분배금을 계산해주는 애드온입니다.

■ v1.1.0부터는 거래 기록 및 정산 결과를 별도의 투명 윈도우(GUI)로 띄워주어, 텍스트 복사 및 공유를 더욱 편리하게 할 수 있습니다.

■ v1.1.1부터는 중요한 정산 데이터를 별도로 영구 저장하고 언제든 다시 열람할 수 있는 기능이 추가되어, 실수로 초기화하더라도 데이터를 복구할 수 있습니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 결과 확인 창(GUI) 지원
 - 정산 명령어 입력 시 거래 내역과 정산 결과를 보여주는 투명한 창이 뜹니다.
 - 창은 드래그하여 이동 가능하며, [CTRL+A] 버튼을 통해 전체 내용을 손쉽게 복사(Ctrl+C)할 수 있습니다.

■ 장부 기록 저장 및 열람 시스템
 - 현재까지의 거래 기록과 정산 내용을 별도의 파일로 저장할 수 있습니다.
 - 저장된 기록은 '/간단장부 초기화'를 하거나 재접속을 해도 사라지지 않습니다.
 - 저장된 기록은 목록에서 확인하고 언제든 다시 GUI 창으로 불러올 수 있습니다.

■ 스마트 채널 출력 로직
 - 출력 채널이 '일반'이나 '공격대'로 설정된 경우, 채팅창 도배를 방지하기 위해 상세 거래 내역은 생략하고 요약본(각종 명단, 인원, 총액, 분배금)만 채팅으로 전송합니다.
 - 상세 내역은 팝업되는 결과 확인 창(GUI)을 통해 확인하고 복사하여 공유할 수 있습니다.

■ 자동 거래 기록 유형
 - 거래 완료 시 아이템과 골드의 흐름을 분석하여 5가지 유형(판매, 유찰/양도, 루팅, 경비, 추출/획득)으로 자동 기록합니다.

■ 자가 마력 추출 감지
 - 플레이어가 직접 마력 추출(주문 ID: 13262)을 시전하여 재료를 획득하면 자동으로 장부에 기록합니다.

■ 손님/탈퇴자 관리 및 스마트 분배금 계산
 - 손님, 무득처리 인원, 먼저 나간 탈퇴자를 관리하여 정확한 분배 인원을 계산합니다. (1인/5인 파티 분배금 동시 출력)
 - 파티나 공격대를 탈퇴한 인원은 기본적으로 분배 인원에서 제외되지만, '/간단장부 탈퇴자 [이름]'으로 등록하면 분배 인원에 합산됩니다.

─────────────────────────────
3. 명령어 및 사용법
─────────────────────────────
■ 기본 명령어: /간단장부
 - 명령어 설명과 현재 상태(채널 설정, 총액, 손님/득자/무득처리, 탈퇴자 명단)를 채팅창에 출력합니다.

■ 정산 및 결과 창 호출 (핵심 기능):
 - /간단장부 올분 [기록]
   • 기본: 올분 기준 정산 결과를 GUI로 띄우고 채팅으로 출력합니다.
   • 기록 옵션: 뒤에 '기록'을 붙이면(/간단장부 올분 기록) 결과를 파일로 저장합니다.
 - /간단장부 무득분 [기록]
   • 기본: 무득분 기준 정산 결과를 GUI로 띄우고 채팅으로 출력합니다.
   • 기록 옵션: 뒤에 '기록'을 붙이면(/간단장부 무득분 기록) 결과를 파일로 저장합니다.

■ 기록 관리:
 - /간단장부 기록 목록 : 저장된 기록의 번호와 파일명 목록을 GUI 창으로 보여줍니다.
 - /간단장부 기록 열람 [번호] : 해당 번호의 기록 내용을 GUI 창으로 불러옵니다.
 - /간단장부 기록 삭제 [번호] : 해당 번호의 기록을 삭제합니다. (0 입력 시 전체 삭제)

■ 결과 창(GUI) 버튼 사용법:
 - [CTRL+A]: 텍스트 박스 전체 선택 모드로 전환됩니다. (Ctrl+C로 복사 가능, 10초 후 자동 해제)

■ 수동 입력:
 - /간단장부 [대상] [아이템|루팅|경비/아이템|마법부여 재료] [±금액/추출]
   예: /간단장부 홍길동 가시 쐐기 +500
   예: /간단장부 임꺽정 루팅 +300
   예: /간단장부 장길산 경비 -100
   예: /간단장부 전우치 투지의 투구 -추출
   예: /간단장부 전우치 마력의 결정체 +추출
 - 대상을 '나'로 입력하면 본인의 캐릭터 이름으로 자동 기록됩니다.
   예: /간단장부 나 오닉시아 가죽 배낭 +350
   → /간단장부 Goyathlay 오닉시아 가죽 배낭 +350

■ 손님/탈퇴자/무득 관리 (토글):
 - /간단장부 손님 [이름] : 손님 목록 추가/제거
 - /간단장부 탈퇴자 [이름] : 탈퇴자(먼저 나갔지만 분배받을 사람) 목록 추가/제거
 - /간단장부 무득처리 [이름] : 득자 계산에서 제외할 인원 추가/제거

■ 출력 채널 변경:
 - /간단장부 채널 [일반|공격대|"공백"]
   • 일반/공격대: 채팅창엔 요약본만 출력, 상세 내용은 GUI 창으로 확인
   • 나에게만(공백): 채팅창에 상세 내역까지 모두 출력

■ 초기화:
 - /간단장부 초기화
   (주의: 현재 기록 중인 장부는 삭제되지만, 파일로 저장해둔 기록은 유지됩니다.)

─────────────────────────────
4. 설치 방법
─────────────────────────────
■ 아래와 같은 폴더 구조로 설치하세요.

Interface
└── AddOns
    └── MySimpleRaidLedger
        ├── MySimpleRaidLedger.lua
        ├── MySimpleRaidLedger_TBC.toc
        ├── MySimpleRaidLedger_Vanilla.toc
        └── README.txt

■ 게임 내 ‘애드온’ 탭에서 [MySimpleRaidLedger]가 활성화되어 있는지 확인합니다.

─────────────────────────────
5. 자동 거래 감지 로직 상세
─────────────────────────────
■ 판매: [아이템] +[골드]

■ 직접 루팅: 루팅 +[골드]

■ 경비 지출: 경비 -[골드]

■ 유찰/양도: [아이템] -추출

■ 추출/획득: [아이템] +추출

※ 아이템이 여러 종류일 경우 "아이템A/아이템B"로 기록되며, 같은 아이템이 여러 개일 경우 "아이템A×개수"로 자동 합산됩니다.

─────────────────────────────
6. 주의 사항
─────────────────────────────
■ 거래 도중 취소하거나 가방이 꽉 차서 실패한 경우에는 기록되지 않습니다. (취소 시 내부 데이터가 즉시 초기화되어 중복 기록을 방지합니다)

■ 복합적인 거래(예: 아이템+골드를 주고 아이템을 받는 등)는 자동 감지 로직이 복잡해질 수 있어, 위 5가지 주 케이스 외에는 수동 확인이 필요할 수 있습니다.

■ 분배금 계산 시 골드 단위는 정수(골드)만 계산하며 실버/코퍼 단위는 절삭합니다.

■ 경매 종료 후 분배금을 나눠주는 거래 또한 자동으로 장부에 기록됩니다. 따라서 정산 시점의 정확한 데이터를 보존하려면, 정산 시 '/간단장부 올분 기록', '/간단장부 무득분 기록'과 같이 '기록' 옵션을 붙여 저장해두는 것을 권장합니다. (저장된 데이터는 거래가 추가되어도 변하지 않습니다.)

─────────────────────────────
7. 변경 이력
─────────────────────────────
■ 1.0.0 (2025. 12. 1.)
 - 자동 거래 감지 5종, 수동 거래 기록, 본인 마력 추출 감지, 손님/무득 관리, 정산 기능, 인스턴스 진입시 초기화 확인 창 팝업

■ 1.0.1 (2025. 12. 3.)
 - 손님 또는 득자가 파티/공격대를 탈퇴했을 때 분배 인원이 잘못 계산되던 오류 수정 (잔류 인원 체크 로직 추가)

■ 1.0.2 (2025. 12. 5.)
 - 일반/공격대 채널 출력 시 세부 내역 출력 오류 수정

■ 1.1.0 (2025. 12. 5.)
 - 결과 출력용 GUI 프레임 추가 (CTRL+A 버튼, 투명도 70%, 이동 가능)
 - 공용 채널(일반/공격대) 출력 시 채팅창 도배 방지를 위해 '요약본'만 출력하도록 변경

■ 1.1.1 (2025. 12. 6.)
 - GUI 내 CTRL+A 기능 오류 수정 (전체 선택 박스 위치 고정)
 - 데이터 저장/관리 추가 (/간단장부 [올분/무득분] 기록, /간단장부 기록 [목록/열람/삭제])

■ 1.1.2 (2025. 12. 6.)
 - 탈퇴자 관리 기능 추가 (/간단장부 탈퇴자 [이름])
 - 분배 인원 계산 시 부재중인 탈퇴자 자동 합산 로직 적용
 - 채널 변경 시 변경된 채널명(일반/공격대/나에게만)을 명확히 안내하도록 개선

■ 1.1.3 (2025. 12. 9.)
 - 수동 입력 편의성 개선: 거래 대상에 '나' 입력 시 본인 캐릭터 이름으로 자동 기록

■ 1.1.4 (2026. 1. 15.)
 - 기존 toc 파일명 변경 및 TBC용 toc 추가 

─────────────────────────────
8. 저작권 및 이용 조건
─────────────────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

─────────────────────────────
9. 개발자 정보
─────────────────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드
