Feathered Friend

Mailbox

featheredfriend:mailbox is a wall-mounted mailbox block used for offline courier delivery fallback.

Mailbox feature screenshot
Mailbox in-world usage view.
OFFLINE DELIVERY

Mailboxes are where deliveries can be redirected when the recipient is offline and a valid mailbox location is known.

TLDR:

  1. Place a mailbox (owner UUID/name is stored on the block entity).
  2. Tamed ravens can spot mailboxes while flying nearby.
  3. Offline courier jobs can route to a known mailbox location.

Crafting

Recipe (mailbox.json):

Gold Nugget
Chest
Gold Nugget
Gold Nugget
Blackstone
Gold Nugget
→
Mailbox

Placement and storage

  • The mailbox is wall-mounted (sign-like placement rules).
  • It can attach to sturdy faces, fences, and fence gates.
  • On placement by a player, the mailbox stores:
  • owner UUID
  • owner name
  • Container size is 9 slots (MailboxMenu / MailboxBlockEntity).

The storage container itself does not enforce owner-only access checks.

Mailbox spotting (how locations are learned)

Mailboxes are discovered by your tamed raven automatically:

  • scan interval: every 20 ticks (~1 second)
  • scan range: 10 blocks
  • scan source: nearby loaded chunks around the raven
DEEP DIVE: mailbox registry

Discovered mailboxes are stored in MailboxRegistryData under:

  • observer UUID (raven owner)
  • mailbox owner UUID
  • dimension + block position (+ owner name)

This data is what powers recipient-list mailbox counts.

Courier integration for offline recipients

When a recipient is offline, courier runtime checks known mailbox entries:

  • If a known mailbox exists, job can dispatch/redirect in mailbox mode.
  • Courier raven spawns near the mailbox target and evaluates insert outcome.

Possible outcomes:

  • Delivered: sealed scroll inserted into first empty mailbox slot.
  • Missing: mailbox target no longer valid; registry entry is pruned.
  • Full: mailbox exists but no free slot.

Mailbox mode uses COURIER_MAILBOX_DWELL_TICKS = 40 (~2s) before cleanup/despawn handling.

Feature toggle behavior

enableMailbox disables mailbox-specific runtime systems, not the block item itself.

  • Disabled:
  • raven mailbox spotting
  • courier redirect/deposit to mailboxes
  • Still available:
  • placed mailbox block/item
  • direct mailbox storage access
Toggle scope

Turning mailbox logic off does not remove existing mailbox inventories. It only stops Feathered Friend mailbox logic from using them.

Support This Project

Like this wiki and these mods?

Every bit of support helps me keep building features, writing docs, and shipping updates.

Support on Patreon One-time via Ko-Fi Why would you?
Back to top