- Документация
- https://modrinth.com/mod/nutritionz
Что представляет собой NutritionZ
NutritionZ добавляет игровую систему питания с пятью показателями. Рацион персонажа становится отдельной частью выживания: значение имеет не только утоление голода, но и распределение питательных свойств еды. В подтверждённых данных названы углеводы, белок, жиры, витамины и минералы.
Проект относится к категориям food, game-mechanics, management, cursed и utility. Лицензия — MIT; публично указаны xR4YM0ND и Globox1997. Подтверждены Fabric и Minecraft 1.20.1, 1.21.1. Мод требуется на клиенте и сервере.
Скриншоты и внешний вид
Для кого предназначен мод
NutritionZ подходит сборкам, где питание должно влиять на состояние персонажа. Возможные сценарии:
• усложнённое выживание с разнообразным рационом;
• модпак с большим количеством новой еды;
• сервер, где управление запасами входит в прогрессию;
• настройка бонусов и штрафов через datapack;
• создание совместимости с пищевыми модами;
• собственный баланс питательных значений.
Её показатели и пороги относятся только к конкретной сборке Minecraft.
Как устроены показатели
В пищевых datapack-файлах используются поля carbohydrates, protein, fat, vitamins и minerals. Продукту можно назначить числовые значения по каждому направлению. Пример с приготовленной треской показывает нулевые углеводы и витамины, а также ненулевые белок, жир и минералы. Это иллюстрация формата, а не универсальная характеристика всей еды.
Система предусматривает максимум, отрицательный порог и положительный порог. В опубликованном примере nutritionz.json5 указаны максимум 100, отрицательная зона от 0 до 10 и положительная от 90 до 100. Перед использованием нужно сверить фактически созданный файл выбранной версии: неизменность этих чисел между выпусками не подтверждена.
Положительные и отрицательные эффекты
Nutrition Manager позволяет через datapack заменять положительные и отрицательные эффекты или атрибуты для всех пяти показателей. В примере для минералов показаны положительное изменение стойкости брони и ускорение, а в отрицательной части — обратное изменение атрибута и усталость от добычи.
Совместимость с едой из других модов
NutritionZ включает стандартные datapacks для совместимости с некоторыми проектами; их можно включать и отключать через настройки. Собственная совместимость описывается по пути вида data/<namespace>/nutrition/<name>.json, где задаются значения продуктов.
Для замены положительных и отрицательных последствий используется отдельная структура data/<namespace>/nutrition_manager/<name>.json. Пространство имён и идентификаторы должны соответствовать реальным объектам сборки. Ошибочная запись может просто не примениться, поэтому каждое правило лучше проверять отдельно.
Подтверждённая несовместимость
Tough As Nails прямо указан как несовместимый мод. Совместную установку нельзя считать поддерживаемой даже при успешном открытии главного меню.
Если Tough As Nails уже используется, сочетание лучше не переносить в рабочую сборку: подтверждённого обходного решения нет.
Платформа и зависимости
NutritionZ создан для Fabric. Обязательны:
• Fabric API;
• Cloth Config API.
Номера совместимых выпусков не приведены. Их подбирают по версии Minecraft и метаданным конкретного JAR. Forge и NeoForge не подтверждены.
Статусы client=required и server=required требуют согласованного набора на обеих сторонах. В сетевой игре основной мод и зависимости должны соответствовать серверной сборке.
Как выбрать файл
Подтверждены:
• nutritionz-1.1.2.jar, версия 1.1.2+1.21.1, 120642 байта;
• nutritionz-1.0.12.jar, версия 1.0.12+1.20.1, 149705 байт.
Первый файл относится к Minecraft 1.21.1, второй — к 1.20.1. Версия игры указана в метаданных, хотя не полностью отражена в имени JAR. Поэтому выбирать только по номеру NutritionZ нельзя. Разница размеров не доказывает превосходство одной ветки.
Подготовка и установка
Перед установкой следует:
• Проверить версию Minecraft и Fabric.
• Выбрать подходящий JAR.
• Подобрать Fabric API и Cloth Config API.
• Скопировать мир, mods, config и datapacks.
• Удалить старые копии заменяемых файлов.
• Убедиться в отсутствии Tough As Nails.
• Не совмещать первый запуск с массовым обновлением еды.
NutritionZ и обязательные зависимости помещают в папку mods, не распаковывая. Для сервера те же совместимые компоненты устанавливают в серверный экземпляр, а клиенты используют согласованный комплект.
Проверка файла
Для nutritionz-1.1.2.jar опубликован SHA-1 569999aca3091eb5139759824f6a42c4b3530c44. Для nutritionz-1.0.12.jar — a55a163df323c21e4cb0e12a7b2960bbc7f1c11c. Также опубликованы SHA-512.
Файлы получены по официальному HTTPS, сверены по хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся, поэтому интерфейс, эффекты и пользовательские datapacks нужно проверять в своей сборке.
Как проверить результат
Проверку проводят в новом мире или копии сохранения:
• убедиться, что Fabric загрузил NutritionZ и обе зависимости;
• проверить отсутствие Tough As Nails;
• употребить несколько известных продуктов по отдельности;
• наблюдать изменение показателей доступным в сборке способом;
• проверить отрицательную и положительную зоны на тестовом профиле;
• подтвердить применение предусмотренных эффектов;
• повторить тест после перезапуска;
• на сервере сравнить поведение клиента и сервера.
Исходные данные не описывают точный экран, клавишу или команду просмотра значений. Наличие конкретного интерфейса без запуска обещать нельзя.
Ограничения и баланс
Исходные данные не дают полной таблицы продуктов и не описывают скорость изменения каждого показателя. Не подтверждена автоматическая поддержка еды из любого стороннего мода без datapack.
При настройке нужно оценить:
• доступность источников всех пяти показателей;
• риск длительного пребывания в отрицательной зоне;
• частоту положительных бонусов;
• обработку новой еды;
• дублирование эффектов других систем выживания;
• совпадение настроек клиента и сервера.
Категория cursed присутствует в метаданных, но сама по себе не описывает отдельную функцию.
Безопасное обновление
Перед обновлением сохраняют мир, данные игроков, текущий JAR, зависимости, nutritionz.json5 и пользовательские datapacks. Компоненты заменяют по одному с проверкой журнала.
На копии мира нужно проверить значения старых продуктов, пороги, эффекты и загрузку собственных файлов совместимости. Новую версию не переносят на основной сервер, пока клиент с тем же набором не проходит проверку.
Откат
При неудачном обновлении игру или сервер останавливают, возвращают прежние NutritionZ, Fabric API, Cloth Config API, конфигурацию и datapacks. При необходимости восстанавливают мир и данные игроков. Отдельной миграционной процедуры нет, поэтому возврат только одного JAR не всегда достаточен.
Диагностика
Если игра не запускается, проверяют Fabric, обе зависимости, версию Minecraft, дубликаты и наличие Tough As Nails. Если питание не меняется:
• проверить активность стандартного или пользовательского datapack;
• сопоставить идентификатор продукта;
• временно вернуть исходную конфигурацию;
• протестировать ванильную еду без других пищевых модов;
• сверить файлы клиента и сервера;
• просмотреть журнал на ошибки JSON или JSON5.
Если эффекты отличаются от ожидаемых, пищевые значения и Nutrition Manager проверяют раздельно.
Лицензия и авторство
NutritionZ распространяется по MIT. Публично указаны xR4YM0ND и Globox1997. При локализации, изменении или включении в модпак следует сохранять название, авторство и сведения о лицензии, не приписывая авторам редакционные выводы.
FAQ
Сколько показателей добавляет мод?
Пять: углеводы, белок, жиры, витамины и минералы.
Нужны ли Fabric API и Cloth Config API?
Да. Обе зависимости указаны как required.
Можно ли использовать NutritionZ с Tough As Nails?
Проект прямо отмечен как несовместимый. Подтверждённого обходного решения нет.
Поддерживается ли еда из других модов?
Для части проектов есть стандартные datapacks, а дополнительную совместимость можно описать собственными файлами. Автоматическая поддержка любой еды не заявлена.
Где меняются максимумы и пороги?
В nutritionz.json5. Перед редактированием нужно сохранить копию и сверить структуру файла выбранной версии.
