CraftPresence

Мод CraftPresence для Minecraft — полная кастомизация отображения игры в Discord

CraftPresence — это утилита для Minecraft, позволяющая полностью контролировать то, как ваша игра отображается в Discord. Мод использует API Rich Presence и DiscordIPC для вывода детальной информации: от названия биомы и текущей сущности до координат игрока и состояния инвентаря. Поддерживает множество версий игры и загрузчиков, включая актуальные сборки 1.21.11, а также предоставляет мощную систему плацехолдеров и функций для создания сложных шаблонов отображения.

Полная кастомизация статуса в Discord

CraftPresence — это утилита, позволяющая полностью изменить то, как другие игроки видят вашу активность в Minecraft через Discord. Вместо стандартного статуса «Играет в Minecraft» мод предоставляет доступ к API Rich Presence и DiscordIPC, открывая возможности для детального отображения игрового состояния. Вы можете настроить отображение текущего биомы, измерения, сервера, координат игрока, режима игры и множества других параметров. Границы кастомизации практически отсутствуют, ограничиваясь лишь вашей фантазией и творческим подходом к оформлению статуса.

Интеграция с лаунчерами и пакетами

Мод автоматически определяет используемый лаунчер, проверяя наличие специфических файлов конфигурации в директории запуска. Поддерживаются ATLauncher, Twitch, Overwolf, CurseForge, GDLauncher, MCUpdater, Modrinth и MultiMC. При обнаружении совместимого лаунчера CraftPresence может отображать название и иконку установленного пакета (Pack).

История изменений в обработке данных пакетов следующая: до версии 1.6.0 название пакета выводилось напрямую в статусе. В версиях от 1.6.0 до 2.0.0 оно заменялось на плейсхолдер &PACK&. Начиная с версии 2.0, информация о пакете выводится через структурированные плейсхолдеры pack.name и pack.icon, которые можно использовать в шаблонах Rich Presence. Для MultiMC используется нативное свойство Icon Key, минуя конвертацию названия пакета.

Система плейсхолдеров и функций

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

Особое внимание стоит уделить данным о мире: мод выводит название и идентификатор биомы, а также текущей сущности (цели) или сущности, на которой вы едете. Также доступны данные о мире: тип, название, время суток (в 12- или 24-часовом формате).

Для продвинутого использования в версии 2.0.0 плейсхолдеры были переписаны для совместимости со Starscript. Теперь выражения должны быть обернуты в фигурные скобки {foo.bar}. Доступны вспомогательные функции для работы со строками, числами, датами и временем, например clampDouble, convertTime, format и getResult для комбинирования данных.

Команды управления и настройки привязок

Для управления модом доступны команды, которые можно вводить через консоль или интерфейс конфигурации (в версиях 1.5.0 и выше). Основной префикс — /craftpresence или сокращенно /cp. Команды позволяют тестировать выражения плейсхолдеров (/cp compile), искать доступные переменные (/cp search), перезагружать данные (/cp reload), просматривать текущие данные статуса (/cp view currentData), управлять серверами и экранами, а также полностью перезапускать или выключать отправка статуса (/cp reboot, /cp shutdown).

Настройки клавиатурных привязок (KeyBinds) позволяют открывать интерфейс конфигурации. По умолчанию используется клавиша Grave (Tilde). В новых версиях привязки можно настраивать как в специальном меню, так и в общих настройках управления игры.

Ограничения и проблемы совместимости

Несмотря на широкую поддержку, мод имеет ограничения, связанные с архитектурой Minecraft. Начиная с версии 1.16, часть данных (биомы и измерения) стала работать только на основе данных, полученных из мира. Если вы не зашли в конкретный биом или измерение, мод может отображать только их базовые значения по умолчанию.

Для версий 1.15 и ниже существуют известные баги: проблемы с отображением предметов в ванильном рендере и ошибки z-level на экранах. В очень старых версиях (Alpha 1.1.2 и ниже) модули биомов и измерений не работают корректно из-за отсутствия соответствующей логики в коде игры.

Также мод требует обязательную зависимость UniLib для версий 2.5.0 и новее. Без неё или при использовании несовместимой версии мод не запустится.

Лицензирование и поддержка

CraftPresence распространяется под лицензией MIT, что позволяет свободно использовать и модифицировать код. Автор проекта — CDAGaming. Поддержка осуществляется через Discord-сервер, CurseForge и по электронной почте. Также доступна документация и вики с дополнительными руководствами.

При создании собственных иконок для статусов (например, для новых измерений) необходимо указывать ссылку на мод, из которого берется измерение, и использовать изображения размером от 512x512 до 1024x1024 пикселей для обеспечения качества.

Дополнительные сведения о плейсхолдерах

В дополнение к основным категориям данных, CraftPresence предоставляет расширенные плейсхолдеры для интеграции с Replay Mod, позволяющие получать данные о времени рендеринга видео. Также доступны плейсхолдеры для доступа к экземплярам модулей (биом, измерение, сущность, экран, сервер) и их классов, что позволяет выполнять сложные операции с объектами игры через рефлексию. Для работы с данными MOTD сервера можно извлекать конкретные строки сообщения. Все эти инструменты позволяют создавать уникальные и информативные статусы, отражающие текущее состояние игры с максимальной точностью.

Функционал для работы с данными

Помимо плейсхолдеров, мод предоставляет обширный набор функций для обработки данных внутри шаблонов Rich Presence. Функции позволяют конвертировать строки в формат иконок Discord, преобразовывать идентификаторы в читаемые названия, работать с датами и временем (конвертация форматов, часовых поясов, получение временных меток), выполнять математические операции (округление, линейная интерполяция, ограничение значений) и форматирование текста. Также доступны функции для работы с JSON, NBT-тегами и отражением классов Java, что делает мод мощным инструментом для разработчиков, желающих создать кастомные отображения.

Запросы на иконки и сообщество

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

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Just Enough Items (JEI) — похожий мод
• More Culling — похожий мод
• Bookshelf — похожий мод

Автор: CDAGaming · Лицензия: MIT