Mailbox

featheredfriend:mailbox — это настенный блок почтового ящика, используемый для отключения курьерской доставки в автономном режиме.

Скриншот функции почтового ящика — Mailbox in-world usage view.

OFFLINE DELIVERY

Почтовые ящики — это места, куда можно перенаправить доставку, когда получатель не в сети и известно допустимое местоположение почтового ящика.

TLDR:

Разместите почтовый ящик (UUID/имя владельца хранится в объекте блока).
Прирученные вороны могут замечать почтовые ящики, летая поблизости.
Задания автономной курьерской доставки могут направляться в известный почтовый ящик.

Крафт

Рецепт (mailbox.json):

ZZTOKEN00006ZZ <div class="ff-slot"><img alt="Chest" src="../assets/images/items/minecraft/chest.png"></div>

→

Размещение и хранение

Почтовый ящик настенный (правила размещения таблички).
Его можно прикрепить к прочным лицам, заборам и воротам забора.
При размещении игроком в почтовом ящике хранятся:
UUID владельца
имя владельца
Размер контейнера составляет 9 слотов (MailboxMenu / MailboxBlockEntity).

Сам контейнер хранилища не обеспечивает проверку доступа только для владельца.

Обнаружение почтовых ящиков (как определяется местоположение)

Ваш прирученный ворон обнаруживает почтовые ящики автоматически:

интервал сканирования: каждые 20 тиков (~1 секунда)
диапазон сканирования: 10 блоков
источник сканирования: близлежащие загруженные куски вокруг ворона

DEEP DIVE: mailbox registry

Обнаруженные почтовые ящики хранятся в MailboxRegistryData в папке:

UUID наблюдателя (владелец ворона)
UUID владельца почтового ящика
размер + позиция блока (+ имя владельца)

Именно эти данные позволяют подсчитывать почтовые ящики в списке получателей.

Интеграция курьера для офлайн-получателей

Когда получатель не в сети, среда выполнения Courier проверяет известные записи почтового ящика:

Если известный почтовый ящик существует, задание можно отправить/перенаправить в режиме почтового ящика.
Ворон-курьер появляется рядом с почтовым ящиком и оценивает результат вставки.

Возможные результаты:

Доставлено: запечатанный свиток вставлен в первый пустой слот почтового ящика.
Отсутствует: целевой почтовый ящик больше не действителен; запись реестра удалена.
Полный: почтовый ящик существует, но нет свободного места.

В режиме почтового ящика перед очисткой/удалением используется COURIER_MAILBOX_DWELL_TICKS = 40 (~2 с).

Поведение переключения функций

enableMailbox отключает системы выполнения, специфичные для почтового ящика, а не сам блокируемый элемент.

Отключено:
обнаружение почтового ящика ворона
курьерское перенаправление/зачисление в почтовые ящики
Еще доступны:
размещен блок/предмет почтового ящика
прямой доступ к хранилищу почтовых ящиков

Toggle scope

Отключение логики почтового ящика не удаляет существующие реестры почтовых ящиков. Это только мешает логике почтового ящика Feathed Friend использовать их.