Мод «Tooltiplib - Tooltip Framework for Modders» на Project Zomboid

TooltipLib – фреймворк для управления всплывающими подсказками, решающий проблему конфликтов между модами, изменяющими интерфейс предметов. Вместо перехвата функций рендеринга каждым модом по отдельности, TooltipLib предоставляет единую систему регистрации провайдеров контента. Это обеспечивает правильный порядок отображения, изоляцию ошибок, автоматическое выравнивание колонок и двухуровневое кэширование.

Для игроков:

• Установка требуется только если другой мод указывает TooltipLib как зависимость.
• Не требует настройки или изменения порядка загрузки.
• Безопасно добавлять и удалять в процессе игры (mid-save).
• Не записывает данные в файлы сохранений.

Поддерживаемые поверхности интерфейса:

• Предметы (Item): подсказки в инвентаре.
• Слоты предметов (Item Slot): слоты в панели крафта.
• Объекты мира (World Object): генераторы, холодильники, сборщики дождевой воды, контейнеры и другие объекты.
• Навыки (Skill): полосы навыков персонажа (с поддержкой форматированного текста).
• Транспорт (Vehicle): подсказки деталей в интерфейсе механика (с поддержкой форматированного текста).
• Рецепты (Recipe): боковая панель рецептов крафта (Build 42).

Для создателей модов:

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

• Изоляция ошибок: каждый провайдер выполняется в защищенном режиме. Сбой одного модуля не влияет на работу остальных. При повторяющихся ошибках срабатывает механизм ограничения вызовов.
• Фильтрация: доступны 14 фильтров для предметов и 3 для объектов мира, а также функции для создания пользовательских условий и логических комбинаторов.
• Методы контекста: универсальные методы для добавления меток, пар ключ-значение, прогресс-баров, чисел, разделителей и текста. Для поверхностей предметов поддерживается рендеринг текстур, для навыков и транспорта – форматирование строк.
• Жизненный цикл: состоит из 5 фаз: preTooltip → callback → textures → postRender → cleanup.

Мультиплеер:

• Интерфейсы предметов, навыков, транспорта и рецептов работают полностью на стороне клиента без сетевого трафика.
• Для объектов мира на выделенных серверах используется запрос-ответ: клиент отправляет запрос, сервер возвращает данные только через разрешенные методы-геттеры. Ответы кэшируются на клиенте.
• В одиночной игре и на listen-серверах чтение данных происходит напрямую без сетевых задержек.

Совместимость:

Работает совместно с модами, использующими прямой перехват ISToolTipInv.render (в режиме отложенного рендеринга контент добавляется ниже чужого перехвата). Совместим с Inventory Tetris, Equipment UI и другими модами, заменяющими интерфейс. Если несколько модов содержат библиотеку, загружается новейшая версия.

Требования:

• Project Zomboid Build 42.13.1+

Техническая информация:

• Workshop ID: 3694097672
• Mod ID: TooltipLib