NotifMod

NotifMod

Клиентский мод для Fabric, который присылает уведомления, когда происходит что-то определённое!
Уведомления могут быть в виде звука, сообщения (в чате/над хотбаром/на экране) или и того, и другого.

Мод очень гибко настраивается и на данный момент поддерживает следующие события:

• Низкая прочность снаряжения
• Неразрушимое снаряжение перестало работать (элитры)
• Снаряжение полностью починено (починка)
• Сообщение в чате
• Упоминание вашего ника в чате
• Возможность поспать
• Ваш поводок порвался
• Игрок зашёл на сервер
• Игрок вышел с сервера
• Игра загрузилась
• Мир загрузился (при первом подключении)

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

Зависимости

Мод зависит от:

• Fabric API
• Cloth Config API
• Mod Menu (необязательно)

Мод будет работать и без Mod Menu, но вы не сможете открыть экран
настроек прямо в игре, так что его рекомендуется установить.

Звуки уведомлений

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

Фильтры уведомлений

В настройках мода вы заметите, что можно указать, какие сообщения в чате вызывают уведомления, с помощью регулярных выражений (RegEx).
Если вы не знаете, что такое регулярное выражение, то это, по сути, набор символов, описывающий шаблон для поиска (совпадения).
Они очень мощные и могут описать кучу всего, а поскольку этот мод задуман как очень гибко настраиваемый, они идеально подходят для этой задачи.
Если вы действительно хотите их освоить и делать что-то посложнее, в интернете легко найти много информации или протестировать их онлайн (чтобы понять, о чём речь, посмотрите это и загляните на RegExr)!

Я расскажу о самых частых случаях использования regex в этом моде, чтобы дать вам представление, как делать простые вещи.

Получение уведомлений об упоминании для разных вариантов вашего имени

Если люди иногда обращаются ко мне по нику, а иногда называют меня "awex", "alex" или "baka", я могу использовать такое регулярное выражение: .*(\p|awex|alex|baka).*

Этот мод заменит все вхождения \p на ваш ник, прежде чем обрабатывать само регулярное выражение.
Мы можем добавить сколько угодно имён/слов внутри скобок, разделяя их символом |.

С этим есть небольшая потенциальная проблема: если кто-то скажет "alexa", я всё равно получу уведомление.
Чтобы упоминанием считалось только целое слово, без лишних букв, можно использовать такое: (.*\W)?(\p|awex|alex|baka)(\W.*)?

Это изменение говорит, что если вокруг есть другие символы, то те, что стоят вплотную, должны быть чем угодно, кроме букв или цифр.

Мод также может подсвечивать ваш ник, когда вас упоминают. Для этого снова понадобится шаблон regex, но, скорее всего, вы захотите сделать его похожим на фильтр выше.
Если вы хотите подсветить разные варианты вашего имени, можно просто убрать части .*, например: \p|awex|alex|baka

Получение уведомлений о личных сообщениях

Это может быть немного сложнее, так как личные сообщения работают через серверный плагин, и то, как это работает, будет отличаться в зависимости от плагина, используемого сервером, и т. д.
Плагин может использовать канал "system" вместо "chat", так что вам также придётся убедиться, что вы фильтруете нужный канал.
Остальное зависит от того, как выглядят входящие личные сообщения. Соответственно этому и нужно писать regex.
Например, если формат входящих сообщений такой: [Joe -> You] Hello!
Можно использовать что-то вроде этого: .*[.+ -> You] .*
Это также можно совмещать с другими вещами. Например, если это для канала "system", но вы также хотите получать уведомления о сообщениях из консоли сервера (они начинаются с [Server] и тоже используют канал "system"), можно объединить их так же, как мы делали с именами выше: ([Server] .*)|(.*[.+ -> You] .*)

Обновление: начиная с 1.19 сообщения чата, приходящие из консоли сервера, больше не используют канал "system", теперь они в канале "chat".
Обновление 2: начиная с 1.19.1 сообщения чата, приходящие из консоли сервера, снова используют канал "system" и не содержат часть "[server]".

Проблемы

Пожалуйста, сообщайте о любых проблемах на GitHub, спасибо!