Мод Polymorphic Tom's Simple Storag 1.0.4

Polymorphic Tom's Simple Storag — интеграционный мод для Minecraft, добавляющий поддержку Polymorph в Crafting Terminal и Pattern Encoding Terminal из Tom's Simple Storage Mod. В этих интерфейсах появляется кнопка Polymorph для переключения между конфликтующими рецептами.

Мод не является самостоятельной системой хранения. Обязательны Tom's Simple Storage Mod и Polymorph. Подтверждена Minecraft 1.20.1 на Fabric; установка требуется на клиенте и сервере. Проект распространяется по MIT (SPDX: MIT), в публичной команде указаны kltyton и LXHC. Категории: storage и management.

Назначение дополнения​

В сборках несколько модов могут регистрировать рецепты с одинаковыми входными компонентами, но разными результатами. Polymorph предоставляет механизм выбора, однако отдельный крафтовый интерфейс должен поддерживать его. Polymorphic Tom's Simple Storag обеспечивает такую интеграцию для двух терминалов:

• Crafting Terminal;
• Pattern Encoding Terminal.

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

Скриншоты и внешний вид​

Кому подходит мод​

Проект рассчитан на сборки с обеими зависимостями, где крафт выполняется через терминалы Tom's Simple Storage Mod. Он уместен, когда Polymorph видит варианты в другом интерфейсе, а терминал ограничивается одним рецептом.

Практические сценарии:

• в сборке есть подтверждённые конфликты рецептов;
• Crafting Terminal служит основным интерфейсом крафта;
• Pattern Encoding Terminal должен учитывать несколько вариантов;
• администратор может синхронизировать клиентский и серверный наборы;
• требуется узкое дополнение, а не изменение самих рецептов.

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

Совместимость и зависимости​

Подтверждённая среда:

• Minecraft 1.20.1;
• Fabric;
• обязательная установка на клиенте;
• обязательная установка на сервере;
• Tom's Simple Storage Mod, идентификатор XZNI4Cpy;
• Polymorph, идентификатор tagwiZkJ.

Forge, NeoForge, Quilt и другие версии Minecraft не указаны. Совместимые версии зависимостей также не приведены, поэтому связку проверяют отдельно, не перенося совместимость основных модов на интеграционный JAR.

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

Файл версии 1.0.4​

Подтверждённый выпуск:

• файл: polymorphic-tom-1.0.4.jar;
• версия: 1.0.4;
• размер: 17730 байт;
• SHA-1: f2fc2858bf36b3cde302e789d233e4f5b5179b2f;
• SHA-512: af2cdf097a8a786aaf8a911d0550a980a733e8c4926260c6876fe0121d9e5e67fca4236cc054f0aa566a2d3f024259181a892f38f916e37aef8d823925da1e71.

JAR получен по официальному HTTPS и локально сверен с опубликованными хешами. Архив прошёл статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому подтверждена целостность конкретного файла, но не его работа в любой произвольной сборке.

Подготовка и установка​

Перед установкой следует остановить игру и сервер, сохранить резервную копию мира и текущего каталога mods. При обновлении полезно записать версии всех трёх проектов.

Порядок действий:

• Подготовить Minecraft 1.20.1 на Fabric.
• Установить Tom's Simple Storage Mod и Polymorph.
• Поместить polymorphic-tom-1.0.4.jar в папку mods.
• Повторить одинаковую установку на сервере и клиентах.
• Исключить дубликаты и старые выпуски дополнения.
• Первый запуск выполнить на копии сборки.
• Проверить оба поддерживаемых терминала.

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

Как проверить результат​

Для проверки нужен заранее известный конфликт, который распознаётся Polymorph. Если доступен только один подходящий рецепт, отсутствие вариантов не доказывает неисправность.

Проверочный сценарий:

• сервер и клиент запускаются без ошибки зависимости;
• подключение проходит с одинаковым набором модов;
• Crafting Terminal открывается;
• в нём доступна кнопка выбора Polymorph;
• при конфликте можно переключить результат;
• выбранный рецепт используется в терминале;
• аналогичная кнопка доступна в Pattern Encoding Terminal;
• поведение воспроизводится после повторного открытия интерфейса.

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

Ограничения​

Интеграция подтверждена только для двух названных терминалов. Поддержка остальных блоков и сторонних интерфейсов из этого не следует.

Не заявлены:

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

Дополнение предоставляет выбор только там, где Polymorph распознаёт конфликт. Отсутствующий рецепт, ошибка предмета или проблема другого механизма требуют отдельной диагностики.

Безопасное обновление и откат​

Обновление нужно проверять как изменение связки из трёх проектов. Интеграционный JAR зависит от интерфейсов Tom's Simple Storage Mod и Polymorph.

Безопасный порядок:

• Остановить сервер и клиентов.
• Скопировать мир и каталог mods.
• Зафиксировать версии трёх компонентов.
• Заменить файлы в тестовой копии.
• Проверить запуск и оба терминала.
• Воспроизвести известный конфликт рецептов.
• Просмотреть журнал на ошибки.
• После проверки обновить рабочую сборку.

Для отката возвращают все изменённые JAR и резервную копию мира, созданную до нового запуска. Простое удаление дополнения не заменяет восстановление, если сборка уже была открыта и сохранена. Одновременное обновление множества несвязанных модов лучше исключить: оно усложняет поиск причины.

Диагностика​

Если игра не запускается, проверяют Minecraft 1.20.1, Fabric, наличие обеих зависимостей, дубликаты и соответствие клиентского и серверного наборов.

Если терминал открывается, но кнопки нет:

• убедитесь, что это Crafting Terminal или Pattern Encoding Terminal;
• проверьте наличие JAR в активной папке mods;
• исключите старые копии;
• сравните файлы клиента и сервера;
• воспроизведите известный конфликт;
• проверьте минимальную совместимую сборку;
• сохраните журнал запуска.

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

FAQ​

Это самостоятельный мод?​

Нет. Это дополнение, которому обязательны Tom's Simple Storage Mod и Polymorph.

Какие терминалы поддерживаются?​

Подтверждены Crafting Terminal и Pattern Encoding Terminal. Другие интерфейсы не заявлены.

Что добавляется в интерфейс?​

Кнопка Polymorph для переключения между конфликтующими рецептами.

Можно ли установить JAR только на сервер?​

Нет. Указана обязательная установка и на сервере, и на клиенте.

Почему доступен только один рецепт?​

Polymorph может не распознавать конфликт. Проверять нужно на заранее известном примере в поддерживаемом терминале.

Исправляет ли мод отсутствующие рецепты?​

Нет. Дополнение выбирает между существующими конфликтующими рецептами, а не создаёт и не восстанавливает их.

Поддерживается ли Quilt?​

Подтверждён только Fabric. Делать вывод о Quilt по совместимости других проектов нельзя.

Что означает статическая проверка JAR?​

Она подтверждает структуру архива, а хеши — совпадение с опубликованным файлом. Работу в игре проверяют отдельно.

Какая лицензия используется?​

MIT. При распространении изменённой или локализованной версии необходимо соблюдать её условия и сохранять сведения об авторстве.