A Balanced Diet

О моде

A Balanced Diet — это форк мода Diet, который упрощает создание и управление диетическими группами продуктов в Minecraft. Diet поставляется со стандартной конфигурацией, создающей пять классических групп продуктов (фрукты, злаки, овощи, белки и сахара). Мод очень гибко настраивается; игроки и разработчики модпаков могут определять свои собственные группы продуктов, классификации, эффекты диеты, уведомления и т. д.

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

Загрузки

Возможности

Группы продуктов

Группы продуктов — это настраиваемые диетические группы, представляющие типы съеденной вами еды. Каждая группа имеет значение от 0% до 100% в зависимости от того, сколько продуктов этой категории съел игрок. Эти значения растут в зависимости от того, какие типы еды ест игрок, и каждая группа постепенно снижается, когда игрок расходует свою шкалу голода.

По умолчанию Diet поставляется с пятью классическими группами продуктов: фрукты, злаки, белки, овощи и сахара. Значения питательности обычно определяются тегами. Однако, если это включено в конфиге, их можно задать для каждого продукта.

Создавая файлы данных, игроки и разработчики модпаков могут создавать свои собственные группы продуктов. Файлы данных можно загружать как часть датапака или с помощью такого мода, как KubeJS или Open Loader. Настраиваемые параметры включают:

• Название
• Иконку предмета
• Цвет в hex-коде
• Порядок
• Значение по умолчанию
• Множитель прироста
• Множитель снижения
• Полезная или нет

Эффекты диеты

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

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

Отображение качества

Отображение качества показывает «качество» группы продуктов, которое указывает игрокам, какие пороги дадут положительные или отрицательные эффекты. Используя опцию qualityDisplayMode в клиентском конфиге, его можно настроить так, чтобы оно появлялось при наведении на полосу группы, при нажатии кнопки в углу экрана Diet, и то и другое, или ни то ни другое (по умолчанию).

Значения качества можно задать для любого эффекта в наборе диет с помощью поля quality, которое представляет собой строку с hex-кодом цвета (например, "#3FDF3F"). Этот цвет наносится поверх соответствующей области полосы, когда отображается вид качества.

Питательность для каждого продукта

Если в конфиге сервера включена опция enableDataFoodValues, значения питательности можно задавать для каждого продукта отдельно, а не генерировать на основе тегов. Diet будет обращаться к файлам данных в diet/food_values, чтобы получать значения для каждого продукта, которые используются вместо значений на основе тегов.

В стандартном датапаке настроены значения примерно для 20 модов. Список совместимых модов в этих файлах данных можно посмотреть здесь.

Уведомления

Уведомления — это опциональная система, которая оповещает игроков в чате, когда значения их пищевых групп пересекают порог. Они настраиваются внутри набора диет путём добавления объекта notification к эффекту диеты. Настраиваемые параметры включают:

• ID уведомления
• Сообщение (использует ключи перевода)
• Наборы уведомлений (используются для массового отключения)
• Триггер (определяет, что вызывает появление уведомления)

• Частота по умолчанию (сколько раз появится уведомление)

  • always, уведомление будет появляться каждый раз при срабатывании триггера
  • once, уведомление появится один раз, после чего установится в never
  • never, уведомление не будет появляться, если только не вызвано тестовыми командами

Если частота уведомления установлена в always, оно предложит игроку отключить его. При нажатии в чате открывается меню отключения с опциями: отключить это уведомление, все уведомления в том же наборе, все уведомления для той же пищевой группы или все уведомления Diet. Игроки также могут вручную настроить параметры уведомлений с помощью команд /diet notifications, а всю систему уведомлений можно отключить опцией notificationsEnabled в конфиге сервера.

Дополнительная информация

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

Команды

Diet регистрирует несколько команд для помощи в отладке и управлении сервером.

• /diet

  • `get `
  • `set `
  • `add `
  • `subtract `
  • `reset `
  • `suite []`
  • `pause `
  • `resume `
  • `export `
  • `notify <notification_id>`
  • notifications list
  • notifications all
  • notifications group <group_id>
  • notifications set <set_id>
  • notifications message <message_id>
  • notifications options <message_id>
  • notifications reset

Поддержка

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

Если предпочитаете, я активен в Discord сервере для моего текущего модпака Desolate Planet. Не стесняйтесь пинговать меня там, и я отвечу, когда смогу.

Лицензия

Весь исходный код и ресурсы распространяются под лицензией LGPL 3.0.

Пожертвования

Пожертвования автору оригинального мода можно отправить через Ko-fi.

Все доходы от рекламы в этом проекте будут переданы в GiveWell.

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

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

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

Если вы хотите запросить дополнительную поддержку этой системы, пожалуйста, откройте issue или отправьте pull request, чтобы внести вклад напрямую.