Mailbox
featheredfriend:mailbox는 오프라인 택배 배송 대체에 사용되는 벽걸이형 우편함 블록입니다.
사서함은 수신자가 오프라인이고 유효한 사서함 위치가 알려진 경우 배달을 리디렉션할 수 있는 곳입니다.
TLDR:
- 사서함을 배치합니다(소유자 UUID/이름은 블록 엔터티에 저장됩니다).
- 길들인 까마귀는 근처를 비행하면서 우편함을 발견할 수 있습니다.
- 오프라인 택배 작업은 알려진 사서함 위치로 라우팅될 수 있습니다.
제작
레시피(mailbox.json):






→

배치 및 보관
- 우편함은 벽걸이형입니다(표지판 배치 규칙).
- 튼튼한 면, 울타리, 울타리 문에 부착할 수 있습니다.
- 플레이어가 배치하면 우편함에는 다음이 저장됩니다.
- 소유자 UUID
- 소유자 이름
- 컨테이너 크기는 9개 슬롯(
MailboxMenu/MailboxBlockEntity)입니다.
스토리지 컨테이너 자체는 소유자 전용 액세스 검사를 시행하지 않습니다.
우편함 찾기(위치를 학습하는 방법)
우편함은 길들인 까마귀가 자동으로 발견합니다.
- 스캔 간격: 매 20틱(~1초)
- 스캔 범위: 10블록
- 스캔 소스: 까마귀 주위에 로드된 청크 근처
DEEP DIVE: mailbox registry
검색된 사서함은 다음 위치의 MailboxRegistryData에 저장됩니다.
- 관찰자 UUID(까마귀 소유자)
- 사서함 소유자 UUID
- 차원 + 블록 위치(+ 소유자 이름)
이 데이터는 수신자 목록 사서함 수를 계산하는 데 사용됩니다.
오프라인 수신자를 위한 택배 통합
수신자가 오프라인일 때 Courier Runtime은 알려진 사서함 항목을 확인합니다.
- 알려진 사서함이 존재하는 경우 작업은 사서함 모드에서 발송/리디렉션될 수 있습니다.
- 택배 까마귀는 우편함 대상 근처에 생성되고 삽입 결과를 평가합니다.
가능한 결과:
- 배달됨: 첫 번째 빈 우편함 슬롯에 봉인된 두루마리가 삽입되었습니다.
- 누락: 사서함 대상이 더 이상 유효하지 않습니다. 레지스트리 항목이 정리됩니다.
- 전체: 메일함이 있지만 여유 슬롯이 없습니다.
메일박스 모드는 정리/디스폰 처리 전에 COURIER_MAILBOX_DWELL_TICKS = 40(~2초)를 사용합니다.
기능 전환 동작
enableMailbox는 블록 항목 자체가 아닌 사서함별 런타임 시스템을 비활성화합니다.
- 장애가 있는:
- 까마귀 우편함 발견
- 택배사 재전송/우편함에 입금
- 아직 사용 가능:
- 배치된 우편함 블록/아이템
- 직접 사서함 저장소 액세스
사서함 논리를 꺼도 기존 사서함 인벤토리는 제거되지 않습니다. Feathered Friend 메일함 로직이 이를 사용하는 것을 중지할 뿐입니다.
이 프로젝트 후원
이 위키와 모드가 마음에 드시나요?
여러분의 후원은 기능 개발, 문서 작성, 업데이트 지속에 큰 도움이 됩니다.