CrowBar

CrowBar — клиентский мод для Minecraft 1.21-1.21.11, 26.1.x, 26.2 и 26.3, который расширяет панель локатора читаемыми никами игроков, маркерами скинов, текстом дистанции, точками в цветах команды и режимом захвата собственного вида. На версиях 1.21-1.21.5, где панели локатора нет, он рисует те же маркеры над полосой опыта. Доступен для Fabric и NeoForge.

Возможности

• Отображает ники игроков над маркерами панели локатора.
• Может заменять точки локатора на лица скинов игроков.
• Показывает необязательный текст дистанции рядом с никами игроков.
• Сохраняет цвета команды, когда цвет команды доступен.
• Добавляет режим собственного вида для чистых скриншотов панели локатора.
• Скрывает сердца, голод, броню и ванильную панель локатора, пока активен режим собственного вида.
• Приносит маркеры игроков в Minecraft 1.21-1.21.5, рисуя их над полосой опыта.
• Экран настроек на клавише \, в Mod Menu на Fabric и в списке модов на NeoForge.
• Каждая клавиша функции может переключаться или работать только при удержании.
• Необязательные настройки внешнего вида: тёмный фон подписей, плавно приподнятый HUD, скрытие перекрытий, рамки скинов в цветах команды, настраиваемые цвета точек и затухание дистанции. «Dim other labels» включено по умолчанию; остальные настройки внешнего вида по умолчанию выключены.
• Работает как клиентский мод: ни серверу, ни другим игрокам не нужно устанавливать CrowBar.
• Каждый jar также является необязательным плагином для Paper, Spigot и Folia, который отправляет позиции игроков с CrowBar и маркеры территорий GriefPrevention. См. Серверный плагин.

Minecraft 1.21-1.21.5

Minecraft добавил панель локатора в 1.21.6. На 1.21-1.21.5 CrowBar вместо этого рисует свои маркеры над полосой опыта, с теми же никами, лицами, дистанциями, цветами и настройками. В креативе, где полосы опыта нет, он рисует тонкую полосу, на которой располагаются маркеры. CrowBar нужен только вам; другим игрокам клиентский мод не требуется. Серверный плагин необязателен. Поскольку в Minecraft 1.21-1.21.5 нет панели локатора, которую заполняет сервер, CrowBar получает позиции так:

• Одиночная игра и хосты LAN: все игроки в вашем мире, на любой дистанции.
• Серверы с плагином CrowBar или Allium: все игроки, которых передаёт сервер, на любой дистанции.
• Любой другой сервер: только игроки, которых ваш клиент уже загрузил. Это ограничивается дальностью отслеживания игроков на сервере — 48 блоков по умолчанию на Paper и Spigot, поэтому более далёкие игроки не появляются. Игроки скрываются с панели так же, как с ванильной панели локатора в 1.21.6 и новее: приседая, становясь невидимыми, надевая вырезанную тыкву или голову моба либо находясь в режиме наблюдателя.

Серверный плагин

Каждый jar CrowBar также является серверным плагином. Поместите jar для версии Minecraft вашего сервера в папку plugins сервера Paper, Spigot, Purpur или Folia; тот же файл, который на клиенте является модом Fabric или NeoForge, на сервере является плагином Bukkit. `CrowBar-plugin-.jar` в релизе на GitHub — это плагин отдельно. Плагин необязателен, и игроки без CrowBar им не затронуты. У него две части. Локатор игроков. Отправляет игрокам с CrowBar позиции всех в их мире, чтобы панель показывала игроков далеко за пределами дальности отслеживания сервера. Это особенно важно на 1.21-1.21.5, где CrowBar иначе видит только ближайших игроков. Скрытые игроки полностью исключаются из данных, поэтому их позиция никогда не попадает на чей-либо клиент. Он переносит серверные настройки из Player Locator Plus:

Маркеры территорий. При установленном GriefPrevention или GriefPrevention3D территории появляются на панели локатора в виде маркеров-бабочек для их владельца и всех, кому на них доверено, — те же маркеры, что публикует GPExpansion. Игроки с CrowBar видят каждую территорию, к которой у них есть доступ, на любой дистанции. На Paper 1.21.6 и новее игроки без CrowBar тоже получают маркеры на своей ванильной панели локатора в пределах claim-waypoints.vanilla-marker-range (1000 блоков по умолчанию). Подразделения и админские территории по умолчанию выключены.

Если установлен Allium или GPExpansion, соответствующий компонент уступает дорогу, чтобы ничего не отправлялось дважды. Маркеры участков GPExpansion добавляют пользовательские названия, цвета, точки появления участков и опубликованные участки; этот плагин называет участки по их владельцу и привязывает их к центру.

Плагин работает на любом сервере от Minecraft 1.21 до 26.3 независимо от того, какой jar CrowBar его несёт. Ванильные маркеры участков требуют Paper 1.21.6 или новее; в остальных случаях участки видят только игроки CrowBar.

Серверы Allium

GPX-CrowBar

Когда на сервере установлен GPExpansion, путевые точки участков отображают название участка и маркер-бабочку на панели локатора для владельца участка и доверенных игроков. CrowBar читает те же данные локатора и отрисовывает табличку с названием над путевой точкой, давая вам читаемые подписи участков прямо на панели локатора.

Требования

Используйте jar, соответствующий вашей линейке Minecraft и загрузчику:

Fabric

• CrowBar-1.21-1.21.1: Minecraft 1.21-1.21.1, Java 21, Fabric Loader 0.18.4 или новее, Fabric API 0.100.1 или новее.
• CrowBar-1.21.2-1.21.5: Minecraft 1.21.2-1.21.5, Java 21, Fabric Loader 0.18.4 или новее, Fabric API 0.102.2 или новее.
• CrowBar-1.21.6-1.21.8: Minecraft 1.21.6-1.21.8, Java 21, Fabric Loader 0.18.4 или новее, Fabric API 0.125.0 или новее.
• CrowBar-1.21.x: Minecraft 1.21.9-1.21.11, Java 21, Fabric Loader 0.18.4 или новее, Fabric API 0.134.0 или новее.
• CrowBar-26.1.x: Minecraft 26.1.x, Java 25, Fabric Loader 0.19.2 или новее, Fabric API 0.145.1 или новее.
• CrowBar-26.x: Minecraft 26.2, Java 25, Fabric Loader 0.19.3 или новее, Fabric API 0.152.2 или новее.
• CrowBar-26.3.x: Minecraft 26.3, Java 25, Fabric Loader 0.19.5 или новее, Fabric API 0.160.7 или новее.

NeoForge

• CrowBar-1.21-1.21.1-neoforge: Minecraft 1.21-1.21.1, Java 21, NeoForge 21.0 или новее.
• CrowBar-1.21.3-1.21.5-neoforge: Minecraft 1.21.3-1.21.5, Java 21, NeoForge 21.3 или новее. У NeoForge никогда не было стабильного релиза 1.21.2.
• CrowBar-1.21.6-1.21.8-neoforge: Minecraft 1.21.6-1.21.8, Java 21, NeoForge 21.6 или новее.
• CrowBar-1.21.9-1.21.10-neoforge: Minecraft 1.21.9-1.21.10, Java 21, NeoForge 21.9 или новее.
• CrowBar-1.21.x-neoforge: Minecraft 1.21.11, Java 21, NeoForge 21.11 или новее.
• CrowBar-26.1.x-neoforge: Minecraft 26.1.x, Java 25, NeoForge 26.1 или новее.
• CrowBar-26.2.x-neoforge: Minecraft 26.2, Java 25, NeoForge 26.2 или новее.
• CrowBar-26.3.x-neoforge: Minecraft 26.3, Java 25, NeoForge 26.3 (beta) или новее. Mod Menu необязателен на Fabric. Экран настроек всегда доступен по клавише \, а на NeoForge — через кнопку Config в списке модов.

Управление

Клавиши по умолчанию:

• N: Переключить таблички с именами на локаторе
• B: Переключить скины на локаторе
• Z: Переключить путевые точки участков
• X: Показать расстояние
• \: Открыть настройки CrowBar
• View self: не назначено Клавиши можно изменить в меню управления Minecraft в категории CrowBar или через кнопку Key Binds на вкладке Controls экрана настроек. Каждую клавишу функции (таблички с именами, скины, расстояние, view self) можно задать как Toggle или Hold на вкладке Controls. Toggle переключает функцию при каждом нажатии и запоминает выбор. Hold показывает функцию только пока клавиша зажата, например удержание X для проверки расстояний.

Настройки

Экран настроек имеет три вкладки. Значения по умолчанию сохраняют исходный вид CrowBar: параметры внешнего вида выключены по умолчанию, кроме Dim other labels, который остаётся включённым. General: таблички с именами, скины, расстояние, view self и стрелки высоты. Appearance:

| Цвета точек | Команда | Цвет команды, или уникальный цвет для каждого игрока, или цвет на игрока без учёта команд, или один цвет для всех. | | Один цвет | Белый | Цвет, используемый в режиме «Один цвет». | | Цвет вашей точки | Автоматически | Цвет вашего собственного маркера в режиме просмотра себя. На экраны других игроков это не влияет. | Управление: Переключение или удержание для каждой функции, а также привязка к клавишам Minecraft. Настройки сохраняются в config/crowbar.json. Несколько значений живут только в файле: fadeStart, fadeEnd и fadeEndOpacity задают диапазон затухания, а customDotColor и selfDotColor принимают любой цвет #RRGGBB, не только те, что перебираются на экране. На серверах без Allium Minecraft 1.21.6 и новее сам рисует точки полосы локатора. CrowBar всё равно применяет там цвета точек, перекрашивая ванильные точки, но эти точки не могут затухать, поэтому затухают только лица и метки, а ванильные стрелки высоты всегда видны.

Установка

Fabric

1. Установите Fabric Loader для вашей версии Minecraft.
2. Установите Fabric API.
3. Поместите подходящий jar CrowBar в папку mods.
4. Запустите игру.

NeoForge

1. Установите NeoForge для вашей версии Minecraft.
2. Поместите подходящий jar CrowBar NeoForge в папку mods.
3. Запустите игру.

Сборка

./gradlew build
# или для конкретной версии/загрузчика:
./gradlew :version21_0:fabric:build :version21_2:neoforge:build :version21_6:fabric:build

У каждой поддерживаемой линейки Minecraft есть подпроекты fabric и neoforge:

bukkit/ содержит серверный плагин. Каждый jar загрузчика включает его (см. gradle/universal-jar.gradle), а `bukkit/build/libs/CrowBar-plugin-.jar— это плагин сам по себе. Собранные jar-файлы записываются вversionXX//build/libs/. Логика, не зависящая от загрузчика и общая для всех jar, находится в common/и включается в каждый jar: модель настроек и её файл, обработка клавиш удержания/переключения, анимация подъёма HUD, правила перекрытия меток, цвета точек и затухание. Каждый jar поставляет свою копиюassets/crowbar/lang/en_us.json; общие тесты падают, если копии расходятся или в них отсутствует ключ, используемый экраном настроек. Примечания по NeoForge: jar-файлы NeoForge используют ModDevGradle и компилируются под официальные маппинги; подпроекты NeoForge для 26.x нацелены на Java 25 (их линейка Minecraft этого требует), всё остальное нацелено на Java 21. Сборки NeoForge разделены по линейкам Minecraft, потому что переименования классов от Mojang (например, ResourceLocation→Identifierв 1.21.11) меняют поверхность API. В 26.3 также заменили GLFW на SDL3, поэтому его привязки клавиш и проверки модификаторов идут черезInputConstants`, а не через привязки GLFW из LWJGL.

Ссылки

• Сайт: https://castled.codes
• Проблемы: https://github.com/castledking/CrowBar/issues
• Вдохновение: https://github.com/MCRcortex/headlocatorbar
• Маркеры на полосе опыта, таблички с метками, подъём HUD и затухание по расстоянию были вдохновлены Player Locator Plus: https://github.com/timas130/PlayerLocatorPlus