Storage Finder

Storage Finder

Storage Finder — клиентский мод для Fabric, который помогает находить предметы в ближайших контейнерах.

Он запоминает содержимое контейнеров, которые вы открывали ранее, объединяет эту информацию с видимыми рамками для предметов, подсвечивает каждый подходящий блок хранилища и прокладывает безопасные наземные маршруты к трём ближайшим достижимым целям.

Установка на сервере не требуется.

Возможности

• Поиск по сундукам, сундукам-ловушкам, бочкам и установленным шалкерам.
• Использование видимых рамок для предметов как дополнительного источника поиска.
• Поиск по предмету в руке или по его локализованному названию.
• Несколько одновременных поисков с разными цветами.
• Подсветка каждого подходящего блока хранилища.
• Отображение активных поисков, иконок предметов, количества совпадений и статуса маршрута в компактной панели HUD.
• Построение безопасных наземных маршрутов к трём ближайшим достижимым целям.
• Настройка радиуса поиска от 1 до 8 чанков.
• Локальное хранение информации о контейнерах с автоматическими резервными копиями.
• Настройка мода через Mod Menu.

Эндер-сундуки намеренно исключены из индексации и результатов поиска.

Поиск по предмету в руке

1. Возьмите нужный предмет в основную руку.
2. Нажмите клавишу поиска Storage Finder.
3. Нажмите клавишу ещё раз с тем же предметом, чтобы убрать этот поиск.

Клавиша поиска по умолчанию — Right Alt. Её можно изменить в стандартном меню управления Minecraft.

Разные предметы в руке можно добавлять как одновременные поиски. Каждый активный запрос получает свой цвет подсветки.

Поиск по названию

1. Освободите основную руку.
2. Нажмите клавишу поиска Storage Finder.
3. Введите локализованное название предмета.
4. Выберите подсказку мышью или клавиатурой.

Каталог следует языку, выбранному в Minecraft.

Активные поиски отображаются вверху каталога и могут быть удалены по отдельности. Отдельная кнопка очищает все активные поиски.

Индексация контейнеров

Клиент Minecraft не может просматривать произвольные закрытые контейнеры. Storage Finder может искать по контейнеру после того, как вы открыли его хотя бы раз.

Мод индексирует только инвентарь хранилища. Предметы из инвентаря игрока никогда не учитываются.

Снимки контейнеров обновляются:

• при первом открытии контейнера;
• при изменении содержимого, пока контейнер открыт;
• перед закрытием экрана контейнера;
• при смене мира;
• при остановке клиента.

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

Сопоставление предметов

Обычные предметы сопоставляются по их базовому типу в реестре.

Следующие свойства игнорируются:

• пользовательские названия;
• прочность;
• обычные зачарования;
• другие компоненты, специфичные для стека.

Например, поиск алмазной кирки найдёт алмазные кирки с любой прочностью, названием или зачарованиями.

Зачарованные книги обрабатываются отдельно. Каждое хранимое зачарование индексируется как отдельная единица поиска, при этом уровни зачарований и пользовательские названия книг игнорируются.

Рамки для предметов

Видимые рамки для предметов могут служить метками для блока хранилища за ними.

Результаты по рамкам объединяются с запомненным содержимым контейнеров. Текущие наблюдения имеют приоритет над старой сохранённой информацией.

Поиск идёт только по рамкам и контейнерам в чанках, уже загруженных клиентом.

Подсветка и HUD

Каждый подходящий блок хранилища получает цветной контур.

Панель HUD отображает:

• иконку предмета;
• локализованное название предмета;
• цвет запроса;
• количество подходящих блоков хранилища;
• статус расчёта маршрута;
• количество доступных маршрутов.

Открытие подходящего контейнера автоматически убирает только те поиски, которые удовлетворяются этим контейнером. Несвязанные поиски остаются активными.

Безопасные маршруты

Storage Finder использует инкрементальный многоцелевой поиск пути A* вместо простой отрисовки прямой линии до цели.

Маршруты учитывают:

• стены и коллизионные формы блоков;
• полный хитбокс игрока;
• плиты, ступени, ковры и слои снега;
• перепады высот;
• достижимые позиции рядом с целью;
• обе половины двойного сундука.

Когда включено избегание опасностей, маршруты также обходят жидкости, огонь, кактусы, блоки магмы, рыхлый снег и другие небезопасные поверхности.

Поиск пути выполняется инкрементально по игровым тикам, чтобы уменьшить просадки кадров при сложных вычислениях. Рассчитанные пути кэшируются, проверяются и периодически обновляются.

Маршрутизация рассчитана на обычное передвижение по земле. Она не планирует:

• открывание дверей;
• плавание;
• полёт;
• лазание по лестницам;
• сложные паркур-прыжки.

Сложная цель может оставаться подсвеченной, даже если действительный маршрут не удаётся рассчитать.

Радиус поиска

Радиус поиска можно настроить от 1 до 8 чанков.

Максимальная дальность — строгий горизонтальный евклидов радиус в 128 блоков.

Мод никогда не заставляет чанки загружаться для поиска, подсветки или маршрутизации.