Feathered Friend

Mailbox

featheredfriend:mailbox오프라인 택배 배송 대체에 사용되는 벽걸이형 우편함 블록입니다.

사서함 기능 스크린샷
Mailbox in-world usage view.
OFFLINE DELIVERY

사서함은 수신자가 오프라인이고 유효한 사서함 위치가 알려진 경우 배달을 리디렉션할 수 있는 곳입니다.

TLDR:

  1. 사서함을 배치합니다(소유자 UUID/이름은 블록 엔터티에 저장됩니다).
  2. 길들인 까마귀는 근처를 비행하면서 우편함을 발견할 수 있습니다.
  3. 오프라인 택배 작업은 알려진 사서함 위치로 라우팅될 수 있습니다.

제작

레시피(mailbox.json):

Gold Nugget
Chest
Gold Nugget
Gold Nugget
Blackstone
Gold Nugget
Mailbox

배치 및 보관

  • 우편함은 벽걸이형입니다(표지판 배치 규칙).
  • 튼튼한 면, 울타리, 울타리 문에 부착할 수 있습니다.
  • 플레이어가 배치하면 우편함에는 다음이 저장됩니다.
  • 소유자 UUID
  • 소유자 이름
  • 컨테이너 크기는 9개 슬롯(MailboxMenu / MailboxBlockEntity)입니다.

스토리지 컨테이너 자체는 소유자 전용 액세스 검사를 시행하지 않습니다.


우편함 찾기(위치를 학습하는 방법)

우편함은 길들인 까마귀가 자동으로 발견합니다.

  • 스캔 간격: 매 20틱(~1초)
  • 스캔 범위: 10블록
  • 스캔 소스: 까마귀 주위에 로드된 청크 근처
DEEP DIVE: mailbox registry

검색된 사서함은 다음 위치의 MailboxRegistryData에 저장됩니다.

  • 관찰자 UUID(까마귀 소유자)
  • 사서함 소유자 UUID
  • 차원 + 블록 위치(+ 소유자 이름)

이 데이터는 수신자 목록 사서함 수를 계산하는 데 사용됩니다.


오프라인 수신자를 위한 택배 통합

수신자가 오프라인일 때 Courier Runtime은 알려진 사서함 항목을 확인합니다.

  • 알려진 사서함이 존재하는 경우 작업은 사서함 모드에서 발송/리디렉션될 수 있습니다.
  • 택배 까마귀는 우편함 대상 근처에 생성되고 삽입 결과를 평가합니다.

가능한 결과:

  • 배달됨: 첫 번째 빈 우편함 슬롯에 봉인된 두루마리가 삽입되었습니다.
  • 누락: 사서함 대상이 더 이상 유효하지 않습니다. 레지스트리 항목이 정리됩니다.
  • 전체: 메일함이 있지만 여유 슬롯이 없습니다.

메일박스 모드는 정리/디스폰 처리 전에 COURIER_MAILBOX_DWELL_TICKS = 40(~2초)를 사용합니다.


기능 전환 동작

enableMailbox는 블록 항목 자체가 아닌 사서함별 런타임 시스템을 비활성화합니다.

  • 장애가 있는:
  • 까마귀 우편함 발견
  • 택배사 재전송/우편함에 입금
  • 아직 사용 가능:
  • 배치된 우편함 블록/아이템
  • 직접 사서함 저장소 액세스
Toggle scope

사서함 논리를 꺼도 기존 사서함 인벤토리는 제거되지 않습니다. Feathered Friend 메일함 로직이 이를 사용하는 것을 중지할 뿐입니다.

이 프로젝트 후원

이 위키와 모드가 마음에 드시나요?

여러분의 후원은 기능 개발, 문서 작성, 업데이트 지속에 큰 도움이 됩니다.

맨 위로