Mailbox
featheredfriend:mailbox 是一款壁挂式邮箱块,用于离线快递投递后备。
邮箱是当收件人离线且已知有效邮箱位置时可以重定向递送的位置。
总而言之:
1.放置一个邮箱(所有者UUID/名称存储在块实体上)。
- 驯服的乌鸦在附近飞行时可以发现邮箱。
- 离线快递作业可以路由到已知的邮箱位置。
制作
配方(mailbox.json):





→

放置和存储
- 邮箱是壁挂式的(类似标志的放置规则)。
- 它可以附着在坚固的表面、栅栏和栅栏门上。
- 玩家放置后,邮箱会存储:
- 所有者UUID
- 所有者姓名
- 容器大小为 9 个插槽 (
MailboxMenu/MailboxBlockEntity)。
存储容器本身不强制执行仅限所有者的访问检查。
邮箱定位(如何学习位置)
邮箱会被您的驯服的乌鸦自动发现:
- 扫描间隔:每 20 个刻度(约 1 秒)
- 扫描范围:10 个区块
- 扫描源:乌鸦周围附近加载的块
DEEP DIVE: mailbox registry
发现的邮箱存储在 MailboxRegistryData 下:
- 观察者UUID(乌鸦所有者)
- 邮箱所有者UUID
- 尺寸+块位置(+所有者姓名)
该数据是收件人列表邮箱计数的动力。
离线收件人的快递集成
当收件人离线时,courier 运行时会检查已知的邮箱条目:
- 如果存在已知邮箱,作业可以在邮箱模式下调度/重定向。
- 信使乌鸦在邮箱目标附近产卵并评估插入结果。
可能的结果:
- 已交付:密封卷轴插入第一个空邮箱插槽中。
- 丢失:邮箱目标不再有效;注册表项被修剪。
- 已满:邮箱存在,但没有空闲插槽。
邮箱模式在清理/消失处理之前使用 COURIER_MAILBOX_DWELL_TICKS = 40 (~2s)。
功能切换行为
enableMailbox 禁用邮箱特定的运行时系统,而不是块项目本身。
- 禁用:
- 乌鸦邮箱发现
- 快递重定向/存款到邮箱
- 仍然可用:
- 放置的邮箱块/物品
- 直接邮箱存储访问
关闭邮箱逻辑不会删除现有邮箱清单。它只会阻止 Feathered Friend 邮箱逻辑使用它们。
支持这个项目
喜欢这个 Wiki 和这些模组吗?
你的每一份支持都能帮助我持续开发新功能、完善文档并发布更新。