Как использовать и устранять ошибки Recipe Browser в Terraria

Что такое Recipe Browser

Recipe Browser — это мод для Terraria, который добавляет удобный интерфейс поиска и фильтрации крафтов и ингредиентов. Коротко: он показывает рецепты, подсвечивает то, что можно скрафтить, и позволяет быстро находить нужные предметы.

Ключевые преимущества:

• Быстрый поиск по названию рецепта.
• Фильтрация по ингредиентам и предметам в инвентаре.
• Подсветка крафтов, которые можно выполнить прямо сейчас.

Быстрый гайд: установка и базовое использование

Установка и запуск

1. Скачайте мод Recipe Browser через tModLoader или с надёжного репозитория модов.
2. Установите мод через tModLoader (или поместите .tmod в папку Mods при необходимости).
3. Запустите игру и назначьте горячую клавишу для открытия Recipe Browser в настройках управления.

Основные действия внутри мода:

• Положите предмет в слот для фильтрации.
• Кликните по рецепту, чтобы увидеть детали и ингредиенты.
• Ищите по названию рецепта через поле поиска.
• Двойной клик на ингредиенте — дополнительная фильтрация.
• Подсветка крафтов, которые уже доступны.
• Закрепляйте избранные рецепты для быстрого доступа.
• Фильтрация по наличию ингредиентов и подсветка недавно полученных предметов.

Частые ошибки и как их исправить

Застрял на Rebuilding Loot Cache

Что происходит: мод долго отображает «Rebuilding Loot Cache» или зависает на этом этапе.

Пошаговое решение:

1. Закройте игру.
2. Запустите Terraria и удерживайте клавишу Shift до появления главного меню.
3. Перейдите в меню Mods и отключите все моды, кроме Recipe Browser.
4. Перезапустите игру.
5. Включайте моды по одному, пока не найдёте конфликтующий мод.

Важно: таким образом вы изолируете конфликт между модами.

Сообщение об ошибке Could not convert

Причина: повреждённый JSON в кеше модов.

Шаги для исправления:

1. Откройте папку с модами:

\Documents\My Games\Terraria\ModLoader\Mods\Cache\

2. Удалите файл LootCache.json.
3. Запустите игру снова и проверьте работу Recipe Browser.

Примечание: удаление этого файла заставляет мод пересоздать кеш из актуальных данных.

OutOfMemoryException

Симптом: игра вылетает с ошибкой нехватки памяти.

Варианты решения:

• Добавьте оперативной памяти в систему, если это возможно.
• Отключите тяжёлые моды, которые потребляют много памяти.
• Переключитесь на неофициальный 64‑битный tModLoader — он может лучше использовать память на современных системах.

Когда это происходит: обычно при большом наборе модов или при использовании модов с большим количеством контента.

Мод не работает вовсе

Симптом: назначенная клавиша не открывает окно, или мод вообще не реагирует.

Проверки и шаги:

1. Проверьте настройки клавиатуры в Terraria, убедитесь, что горячая клавиша назначена на Recipe Browser.
2. Попробуйте перезагрузить все моды (в меню Mods выберите Reload).
3. Отключите все моды, затем включите только Recipe Browser — проверьте, открывается ли он.
4. Если работает только при отключённых других модах — ищите конфликтующий мод.

Примечание: для корректной работы обязательно назначьте клавишу открытия Recipe Browser.

План действий, если стандартные решения не помогли

1. Создайте резервную копию папки Mods и сохранений.
2. Удалите кеши (папка Cache).
3. Устанавливайте моды по одному и проверяйте стабильность.
4. Если ошибка повторяется, соберите лог (tModLoader лог файлы) и ищите совпадающие исключения.

Mermaid-дерево диагностики:

flowchart TD
  A[Запуск Recipe Browser] --> B{Открывается?}
  B -- Да --> C{Показывает корректные рецепты?}
  B -- Нет --> D[Проверьте горячие клавиши и перезагрузите моды]
  D --> E{Работает после перезагрузки?}
  E -- Да --> F[Включайте моды по одному]
  E -- Нет --> G[Удалите кеш и LootCache.json]
  C -- Да --> H[Готово]
  C -- Нет --> I[Отключите другие моды — ищите конфликт]

Альтернативы и совместимость

• Альтернатива: другие обозреватели рецептов или сборники ГУИ‑модов, но чаще всего Recipe Browser — самый полнофункциональный.
• Совместимость: обратите внимание на версию tModLoader (он должен соответствовать версии Terraria).
• 32‑битный tModLoader может ограничивать объём доступной памяти; при проблемах с памятью переход на 64‑битную сборку часто помогает.

Чеклисты по ролям

Игрок:

• Назначить горячую клавишу.
• Если вылеты — уменьшить набор активных модов.
• Если проблема — удалить LootCache.json и перезапустить.

Моддер / тестировщик:

• Проверить совместимость с API tModLoader.
• Логировать исключения и тестировать на чистой сборке.

Администратор сервера / хостер:

• Ограничить активные моды на сервере.
• Предоставить игрокам инструкции по кешу и горячим клавишам.

Краткая методология устранения проблем (мини‑метод)

1. Изолируйте проблему: отключите все моды, оставьте только Recipe Browser.
2. Восстановите конфигурации шаг за шагом (включайте моды по одному).
3. Очищайте кеши и перезапускайте игру при обнаружении ошибок.
4. При ошибках памяти рассмотрите 64‑битную сборку.

Когда Recipe Browser не подойдёт

• Если вы запускаете Terraria на очень старом железе с ограниченной памятью и не можете установить 64‑битный tModLoader.
• Если вам нужна узкая функциональность от другого мода с идеологически отличной логикой крафтов.

Критерии приёмки

• Recipe Browser открывается по назначенной клавише.
• Все рецепты корректно отображаются и фильтруются.
• При удалении LootCache.json кеш корректно восстанавливается.
• Нет повторяющихся исключений OutOfMemoryException при типичной нагрузке.

Глоссарий (одной строкой)

• tModLoader — оболочка для моддинга Terraria, через которую устанавливаются моды.
• LootCache.json — файл кеша, используемый модами для хранения данных о дропах.
• OutOfMemoryException — ошибка, вызванная нехваткой оперативной памяти.

Социальные варианты превью

OG-заголовок: Recipe Browser в Terraria — быстрое руководство
Краткое описание для соцсетей: Установка, частые ошибки и проверенные решения для модa Recipe Browser в Terraria.

Итог: Recipe Browser существенно облегчает работу с рецептами в Terraria, а большинство проблем решаются последовательной диагностикой: отключением модов, удалением кеша и переходом на 64‑битную сборку при необходимости. Если нужен шаблон для отчёта об ошибке — используйте чеклист из раздела «Чеклисты по ролям».