우편 시스템 (Mail)

보상 전달, 전투 보고서, 시스템 알림, 길드 통지 등을 관리하는 비동기 메시징 시스템입니다. 아이템 첨부, 전투 리플레이, 다국어 지원을 제공합니다.

보상 우편

아이템/재화 첨부 가능

일괄 수령 (최대 100통)

미수령 시 만료 후 소멸

전투 보고서

공격/방어 결과 자동 발송

상세 전투 정보 + 데미지

전투 리플레이 지원

시스템 & 이벤트

공개 우편 (전체 방송)

이벤트/랭킹 보상 발송

시스템 해금 안내

우편 카테고리

카테고리 설명 첨부 보상 만료 기간
일반 일반 보상 우편, 시스템 해금 안내 O 7일
시스템 공개 우편, 전체/채널 방송 O 30일
전투 보고서 공격/방어 전투 결과, 스캔 보고 O 7일
길드 길드 관련 통지, 지원 요청 O 30일
이벤트 아레나, 랭킹, 이벤트 보상 O 30일

* 만료 기간 내에 수령하지 않으면 우편과 첨부 보상이 소멸됩니다.

* 카테고리당 최대 100통까지 표시됩니다.

보상 수령

수신
우편 도착
→
확인
내용 열람
→
수령
첨부 보상 획득
→
완료
인벤토리 반영
개별 수령

우편을 선택하여 첨부 보상 수령

수령 후 우편은 "수령 완료" 상태

수령 완료 우편은 삭제 가능

일괄 수령

최대 100통 한 번에 수령

미수령 우편만 대상

만료/삭제된 우편은 자동 제외

전투 보고서

자동 발송

전투가 종료되면 양측 모두에게 전투 보고서 우편이 자동으로 발송됩니다.

보고서 유형

유형 공격 결과 방어 결과
기지 전투 공격 승리/패배 방어 승리/패배
영지 점령 점령 성공/실패 점령 방어/탈취
요새전 요새 공격 결과 요새 방어 결과
채집 쟁탈 채집지 탈취 결과 채집 방어 결과
NPC 전투 몬스터 토벌 결과 -
스캔 스캔 보고서 스캔 당함 알림

보고서 포함 정보

전투 정보
  • 양측 계정/닉네임/길드
  • 전투 좌표 (dotQ, dotR)
  • 전투 시간 및 종료 사유
  • 승패 결과
상세 데이터
  • 스쿼드별 데미지 통계
  • 미니언 상태 (전투 전/후)
  • 양측 획득 보상 목록
  • 전투 리플레이 데이터

시스템 우편 (공개 우편)

전체 방송

시스템 우편은 모든 플레이어 또는 특정 채널에 동시 발송되는 공개 우편입니다.

Redis 캐싱으로 고속 조회하며, 30초마다 만료 우편을 자동 정리합니다.

발송 대상
  • 전체 서버: 모든 채널 플레이어
  • 특정 채널: 해당 채널만 수신
  • 수령 여부는 유저별 개별 추적
주요 사용처
  • 운영자 공지 및 보상
  • 점검 보상 지급
  • 이벤트 전체 보상
  • 시스템 업데이트 안내

자동 발송 우편 템플릿

특정 게임 이벤트 발생 시 MailData.json에 정의된 템플릿으로 우편이 자동 발송됩니다.

카테고리 내용 첨부 보상
시스템 해금 가디언 제단, 망원경, 장비 등 신규 기능 해금 안내 소환 티켓, 경험치 서적 등
전투 결과 기지/영지/요새/채집 전투 승패 전투 보상 (보상 목록 포함)
아레나 보상 일일/시즌 랭킹 보상 등급별 보상
성채전 보상 국왕, 핵심 유저, 참여자 등급별 등급별 보상 (1~20명)
집결 보상 스파이키/로지 토벌 보상 주최자/참가자 보상
구매 확인 웹스토어 인증 코드, 구매 성공 구매 아이템

상세 가이드

우편 만료 규칙

  • 일반/전투보고서: 발송일로부터 7일 후 만료
  • 시스템/길드/이벤트: 발송일로부터 30일 후 만료
  • 만료된 우편의 첨부 보상은 복구 불가
  • 삭제한 우편도 복구 불가 (소프트 삭제)

수령 메커니즘

  • 우편 수령 시 첨부 아이템이 인벤토리에 직접 반영
  • 일괄 수령은 최대 100통 (초과 시 여러 번 수령 필요)
  • 공개 우편(시스템)은 유저별 수령 상태가 별도 관리됨
  • 수령 시 인벤토리 공간 확인 (공간 부족 시 수령 불가할 수 있음)

전투 보고서 활용

  • 전투 보고서에서 상세 데미지 통계 확인 가능
  • 전투 리플레이로 실제 전투 과정을 재현하여 분석 가능
  • 스캔 보고서로 적 기지 전력을 사전 파악
  • 방어 실패 시 보고서를 통해 방어 전략 수정 가능

운영 팁

  • 매일 접속 시 미수령 우편 확인 → 만료 전 보상 챙기기
  • 이벤트 보상 우편은 30일이지만 이벤트 종료 전 수령 권장
  • 전투 보고서는 7일이므로 중요한 전투 결과는 빠르게 확인
  • 시스템 해금 우편에 포함된 티켓/재료는 초반 성장에 유용