Gentle Reminders

Gentle Reminders — это мод, который время от времени отправляет игроку ненавязчивые сообщения на основе настраиваемого конфиг-файла.
Доступен для скачивания на Curseforge и Modrinth. Спасибо за более чем 1800 скачиваний!

Поддержка версий

Gentle Reminders поддерживает несколько версий Minecraft и загрузчиков модов:

Возможности

• Поддержка нескольких версий и загрузчиков: работает на Fabric и NeoForge в нескольких версиях Minecraft (см. таблицу поддержки версий выше)
• Создаёт конфиг-файл при запуске клиента, если его ещё нет
• Проверяет версию конфиг-файла, чтобы гарантировать актуальность обновлений сообщений
• Клиент читает настройки из конфиг-файла
• При входе в мир отправляет начальное сообщение, если мод включён
• Каждые X тиков, согласно конфигу, отправляет ненавязчивое сообщение
• Когда все сообщения отправлены (в случайном порядке без повторов), список сбрасывается и начинается заново
• Настраиваемые всплывающие уведомления с текстурами блоков в качестве фона и рамки!
• Сохранение конфига: настройки пользовательского стиля отображения (текстура фона, текстура рамки, иконка) автоматически сохраняются в конфиг-файл при изменении через команды
• Все значения конфига автоматически сохраняются при изменении через команды
• Руководство по конфигу ниже
• Руководство по командам ниже

Совместимость версий и известные ограничения

Поддержка иконок

• Fabric 1.20.1: пользовательские иконки стиля отображения (восклицательный знак) не поддерживаются из-за ограничений API в этой версии Minecraft. Иконки не будут отображаться, даже если customIncludeIcon установлен в true.
• Fabric 1.21.1+: иконки полностью поддерживаются.
• NeoForge (все версии): иконки полностью поддерживаются.

Паритет возможностей

• Fabric против NeoForge: оба загрузчика имеют полный паритет возможностей, за исключением ограничения с иконками в Fabric 1.20.1. Все команды, стили отображения и функции конфига работают одинаково на обоих загрузчиках.

Планируемые возможности

• Добавить значительно больше сообщений

  • Текущее число простых сообщений: 34
  • Текущее число уникальных/особых сообщений: 62
• Добавить поддержку модовых блоков в качестве фона/рамки
• Добавить пользовательские иконки сообщений (не только восклицательный знак!)
• Сделать удобный GUI для редактирования пользовательских всплывающих уведомлений

Примеры сообщений

Простое сообщение (стиль по умолчанию)

Уникальное сообщение (тёмный стиль)

Уникальное сообщение (светлый стиль)

Уникальное сообщение (стиль чата)

Пользовательский фон из тёмных дубовых досок и рамка из блока аметиста

Пользовательский фон из чёрного камня и рамка из смоляного кирпича

Пользовательский фон из блока Redstone и рамка из диорита

Пользовательский фон из слизневого блока и рамка из песка

Как это выглядит в игре

Руководство по конфигу

Файл конфига находится по пути config/gentlereminders-config.toml (после первого запуска игры), его можно редактировать любым текстовым редактором. Вы можете изменить значения интервала между сообщениями, добавить или удалить сообщения, а также включить или отключить мод.

Добавлять сообщения следует в таком формате:

  {id=#, title="String", message="String", enabled=boolean, titleColor="String", messageColor="String"},

• id — целое число, которое должно быть уникальным среди сообщений

• title — заголовок сообщения, который будет отображаться в верхней части всплывающего уведомления

  • Важное замечание: этот заголовок не может содержать запятую (,), иначе файл конфига сломается

• message — сообщение, которое будет отображаться в теле всплывающего уведомления

  • Важное замечание: это сообщение не может содержать запятую (,), иначе файл конфига сломается
• enabled — булево значение, определяющее, может ли быть отправлено сообщение — если вы всё равно ставите false, можете просто удалить сообщение, если только не думаете, что захотите включить его позже
• titleColor — строка, представляющая цвет текста заголовка, который может быть любым из цветов ниже:
• messageColor — строка, представляющая цвет текста сообщения, который может быть любым из цветов ниже:

 "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", "white"

Руководство по командам

Обязательные аргументы заключены в [квадратные скобки]

/gentlereminders и /gentlereminders help

• Показывает справочное сообщение

/gentlereminders get TimeRemaining

• Показывает время, оставшееся до отправки следующего сообщения

/gentlereminders get ConfigPath

• Показывает путь к файлу конфига

/gentlereminders get ConfigVersion

• Показывает версию файла конфига

/gentlereminders get DisplayStyle

• Показывает текущий стиль отображения

/gentlereminders get TicksBetweenMessages

• Показывает количество тиков между сообщениями, а также минуты и секунды

/gentlereminders get Messages [pageNumber]

• Показывает по 5 сообщений за раз, начиная с указанного номера страницы

/gentlereminders set DisplayStyle [style]

• Устанавливает стиль отображения на "default", "light", "dark" или "chat" (для custom используйте команду ниже)

/gentlereminders set CustomDisplayStyle [bgTexture] [borderTexture] [includeIcon]

• Устанавливает стиль отображения на custom, затем задаёт текстуры фона и рамки, а также то, включать ли иконку восклицательного знака
• bgTexture и borderTexture принимают названия блоков (например, oak_planks, stone) — для допустимых названий блоков доступно автодополнение
• includeIcon — булево значение (true или false), определяющее, отображается ли иконка восклицательного знака
• Примечание: иконки не работают в Fabric 1.20.1 (см. раздел «Совместимость версий» выше)
• Настройки автоматически сохраняются в файл конфига

/gentlereminders set TicksBetweenMessages [ticks]

• Задаёт количество тиков между сообщениями

/gentlereminders set Message [id] [title] [message] [enabled] [titleColor] [messageColor]

• Перезаписывает заголовок, сообщение, статус включения и цвета сообщения по ID
• titleColor и messageColor принимают названия цветов — доступен автоподбор для допустимых цветов (список см. в руководстве по конфигурации)

/gentlereminders add Message [title] [message] [enabled] [titleColor] [messageColor]

• Добавляет новое сообщение с указанным заголовком, сообщением, статусом включения и цветами
• titleColor и messageColor принимают названия цветов — доступен автоподбор для допустимых цветов (список см. в руководстве по конфигурации)

/gentlereminders remove Message [id]

• Удаляет сообщение по ID

/gentlereminders enable GentleReminders

• Включает мод

/gentlereminders enable Message [id]

• Включает сообщение по ID

/gentlereminders disable GentleReminders

• Отключает мод

/gentlereminders disable Message [id]

• Отключает сообщение по ID