My Simple Mail Box (WoW Classic 20주년 서버 & TBC 호환용)

Game Version: WoW Classic 1.15.8 (빌드 11508), 2.5.5 (빌드 20505)
Version: 1.2.4 (2026. 3. 22.)

─────────────────────────────
1. 애드온 개요
─────────────────────────────
■ My Simple Mail Box는 순수 Lua로 작성된 가벼운 우편 관리 애드온입니다.

■ 우편을 선택적으로 수령/반송, 모두 또는 골드만 수령하는 기능 외에 수신 대상을 입력할 때 자동완성으로 추천, 발신 내역을 자동으로 본인 알림/대상 귓속말/DB 기록, 자가 학습을 통한 부캐 귓속말 방지, 가방이 가득 찼을 때 필요한 빈 공간 계산, 대량 첨부 같은 다양한 편의 기능을 제공합니다.

─────────────────────────────
2. 주요 기능
─────────────────────────────
■ 우편 관리
 - [수령/반송]: 체크한 우편을 수령하거나 반송합니다. 만약 체크한 우편이 반송 불가라면(보낸 사람이 없거나 나에게 반송된 경우) 반송 버튼을 누를 때 해당 우편은 체크 해제됩니다.
 - [전체]: 우편함의 모든 아이템과 골드를 연속으로 수령합니다. 가방이 가득 차면 작업을 중단하고, 남은 우편을 모두 받기 위해 몇 칸이 더 필요한지 계산해서 알려줍니다. (대금 청구나 보유 제한 제외)
 - [골드]: 아이템은 남겨두고 동봉된 우편의 돈만 수령합니다.
 - 수령 속도를 설정할 수 있습니다.

■ 수신 대상 관리
 - 수신 대상 자동완성: 받는 사람 이름을 입력하면 저장된 목록에서 자동으로 추천합니다. (설정에 따라 '앞글자 일치' 또는 '포함' 검색 지원)
 - 내 캐릭터는 한 번 접속하면, 다른 사람의 캐릭터는 한 번 우편을 보내면 목록에 저장됩니다.
 - 추천 목록이 입력 칸 위쪽으로 생성되어 시야를 방해하지 않습니다.

■ 발신 내역 관리 (아이템 링크 지원)
 - 본인 알림: 발송 즉시 채팅창에 발송 내역을 요약하여 출력합니다.
 - 대상 귓속말: 우편을 보내면 상대방에게 '무엇을 보냈는지' 자동으로 귓속말을 보냅니다. (메시지 길이에 따라 아이템 링크 또는 텍스트 자동 전환)
 - 자가 학습: 내 계정의 다른 캐릭터(부캐)로 접속할 때마다 자동으로 인식하여, 부캐에게 우편을 보낼 때는 귓속말 보내기를 시도하지 않습니다.
 - 대금 청구: 대금 청구 여부와 청구 금액을 본인 알림, 대상 귓속말, DB 기록에 표시합니다.
 - 보낸 아이템들이 여러 슬롯이더라도 동일한 아이템이라면 수량을 합산해서 표시합니다.
 - 발신 내역 기록: DB에 저장할지, 아니면 단순히 발송 확인만 할지 선택 가능합니다.
 - 기록 내용: 보낸 시각, 수신 대상, 제목, 금액, 대금 청구 여부, 청구 금액, 아이템 이름과 수량(× 표시)을 기록합니다.
 - [Ctrl+A] 복사: 발신 내역 목록 창에서 Ctrl+A 버튼을 누르면 전체 텍스트가 선택되어, 쉽게 복사/붙여넣기 할 수 있습니다.

■ 대량 첨부
 - 가방에서 아이템에 Ctrl+마우스 좌클릭을 하면 해당 아이템을 우편에 대량 첨부합니다.
 - 흩어져 있더라도 먼저 최대 수량으로 정렬한 다음에 첨부합니다.

─────────────────────────────
3. 명령어 및 사용 방법
─────────────────────────────
■ 기본 명령어
 - '/간단우편' 또는 '/msmb' : GUI 열기, 명령어 설명

■ 애드온 활성화/비활성화
 - '/간단우편 활성화' : 애드온 기능 켜기
 - '/간단우편 비활성화' : 애드온 기능 끄기

■ 수신 대상 자동완성 설정
 - '/간단우편 자동 일치' : 앞글자가 같을 때만 추천 (예: '가' 입력 → '가나다')
 - '/간단우편 자동 포함' : 글자가 포함되면 추천 (예: '나' 입력 → '가나다')

■ 발신 내역 저장 설정
 - '/간단우편 내역 저장' : 발신 내역을 DB 파일에 저장하고 본인 알림과 대상 귓속말을 수행합니다.
 - '/간단우편 내역 발송' : 발신 내역을 DB 파일에 저장하지 않고 본인 알림과 대상 귓속말만 수행합니다.

■ 목록 확인
 - '/간단우편 목록 수신' : 저장된 수신 대상 목록 창을 엽니다.
 - '/간단우편 목록 내역' : 저장된 발신 내역 창을 엽니다.

■ 데이터 삭제
 - '/간단우편 삭제 [이름]' : 해당 캐릭터를 수신 대상 목록에서 지웁니다.
 - '/간단우편 삭제 [이름] [번호]' : 해당 캐릭터의 특정 번호 발신 내역을 지웁니다.
 - '/간단우편 삭제 [이름] 0' : 해당 캐릭터의 모든 발신 내역을 지웁니다.

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

Interface
└── AddOns
    └── MySimpleMailBox
        ├── MySimpleMailBox.lua
        ├── MySimpleMailBox_TBC.toc
        ├── MySimpleMailBox_Vanilla.toc
        └── README.txt

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

─────────────────────────────
5. 주의 사항 및 팁
─────────────────────────────
■ 수신 대상 목록을 전체 삭제하더라도, 자가 학습된 내 캐릭터들의 이름은 목록에서 삭제되지 않고 보호됩니다.

■ 수령 속도는 설정 창에서만 변경 가능합니다. 서버 렉이 심한 날에는 속도를 0.5초 이상으로 늦추는 것을 권장합니다.

■ 발신 내역 목록 창에서 [Ctrl+A]를 누르면 5초 동안 텍스트가 전체 선택됩니다. 이 시간 안에 Ctrl+C를 눌러 복사하세요.

─────────────────────────────
6. 변경 이력
─────────────────────────────
■ 1.0.0 (2026. 1. 23.)
 - 우편 전체 열기 및 필요한 가방 공간 계산 (대금 청구나 보유 제한 제외)
 - 골드만 받기
 - 수신 대상 자동완성 검색 (일치/포함)
 - 발신 내역 본인 알림/대상 귓속말/DB 기록
 - 귓속말 전송 시 메시지 길이에 따른 아이템 링크/텍스트 자동 전환
 - 대금 청구 여부와 청구 금액 표시
 - 내 계정 캐릭터(부캐) 인식 (접속 시 자동 등록, 귓속말 시도 방지, 수신 대상 목록 전체 삭제 시 제외)
 - Vanilla 및 TBC용 toc

■ 1.1.0 (2026. 2. 25.)
 - 대량 첨부 기능 추가

■ 1.1.1 (2026. 3. 1.)
 - 확인 버튼을 삭제하고, 드롭다운 메뉴 항목을 선택하면 즉시 설정하도록 수정 (수신 대상 및 발신 내역 삭제를 위한 드롭다운 메뉴는 현행 유지)

■ 1.2.0 (2026. 3. 7.)
 - 체크박스 버튼으로 선택한 우편을 수령/반송하는 기능 추가

■ 1.2.1 (2026. 3. 8.)
 - 선택된 체크박스 버튼이 하나도 없을 때의 메시지 오류 수정

■ 1.2.2 (2026. 3. 13.)
 - 우편 수령/반송 직후에 처리할 수 없는 우편(텍스트만 있는 우편)만 남아 있으면 우편 목록이 갱신되는 과정에서 체크박스 선택 상태가 밀리는 오류 수정
 - 수령/반송 처리할 수 없는 우편(텍스트만 있는 우편)만 선택하고 수령/반송을 시도할 때 체크박스가 유지되며 완료 메시지가 뜨던 오류 수정 (체크박스는 자동 해제되며 '처리 가능한 우편이 선택되지 않았습니다.'라는 안내 메시지를 출력)

■ 1.2.3 (2026. 3. 20.)
 - 대기 우편이나 보유 제한/대금 청구로 인해 건너뛴 우편 때문에 체크박스 선택 상태가 밀리는 오류를 수정

■ 1.2.4 (2026. 3. 22.)
 - 이전/다음 페이지, 개별 우편의 번호 표시 추가

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

■ 개발자 표기

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

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

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