Feathered Friend

Mailbox

featheredfriend:mailbox 是一款壁挂式邮箱块,用于离线快递投递后备

![邮箱功能截图](../assets/images/features/mailbox/mailbox.webp)
Mailbox in-world usage view.
OFFLINE DELIVERY

邮箱是当收件人离线且已知有效邮箱位置时可以重定向递送的位置。

总而言之:

1.放置一个邮箱(所有者UUID/名称存储在块实体上)。

  1. 驯服的乌鸦在附近飞行时可以发现邮箱。
  2. 离线快递作业可以路由到已知的邮箱位置。

制作

配方(mailbox.json):

Gold Nugget
Chest
Gold Nugget
Gold Nugget
Blackstone
Mailbox

放置和存储

  • 邮箱是壁挂式的(类似标志的放置规则)。
  • 它可以附着在坚固的表面、栅栏和栅栏门上。
  • 玩家放置后,邮箱会存储:
  • 所有者UUID
  • 所有者姓名
  • 容器大小为 9 个插槽 (MailboxMenu / MailboxBlockEntity)。

存储容器本身不强制执行仅限所有者的访问检查。


邮箱定位(如何学习位置)

邮箱会被您的驯服的乌鸦自动发现:

  • 扫描间隔:每 20 个刻度(约 1 秒)
  • 扫描范围:10 个区块
  • 扫描源:乌鸦周围附近加载的块
DEEP DIVE: mailbox registry

发现的邮箱存储在 MailboxRegistryData 下:

  • 观察者UUID(乌鸦所有者)
  • 邮箱所有者UUID
  • 尺寸+块位置(+所有者姓名)

该数据是收件人列表邮箱计数的动力。


离线收件人的快递集成

当收件人离线时,courier 运行时会检查已知的邮箱条目:

  • 如果存在已知邮箱,作业可以在邮箱模式下调度/重定向。
  • 信使乌鸦在邮箱目标附近产卵并评估插入结果。

可能的结果:

  • 已交付:密封卷轴插入第一个空邮箱插槽中。
  • 丢失:邮箱目标不再有效;注册表项被修剪。
  • 已满:邮箱存在,但没有空闲插槽。

邮箱模式在清理/消失处理之前使用 COURIER_MAILBOX_DWELL_TICKS = 40 (~2s)。


功能切换行为

enableMailbox 禁用邮箱特定的运行时系统,而不是块项目本身。

  • 禁用:
  • 乌鸦邮箱发现
  • 快递重定向/存款到邮箱
  • 仍然可用:
  • 放置的邮箱块/物品
  • 直接邮箱存储访问
Toggle scope

关闭邮箱逻辑不会删除现有邮箱清单。它只会阻止 Feathered Friend 邮箱逻辑使用它们。

支持这个项目

喜欢这个 Wiki 和这些模组吗?

你的每一份支持都能帮助我持续开发新功能、完善文档并发布更新。

返回顶部