CustomNameTags - Кастомные Неймтеги

CustomNameTags - это серверный мод для Fabric, который решает извечную проблему ролевых и мини-игровых серверов. В ванильном Minecraft над головой игрока висит просто его ник. Скучно, неправильно, если у вас есть роли, ранги или кастомные статусы. Этот мод позволяет полностью переписать то, что видят другие игроки над вашей головой. И самое крутое - всё работает чисто серверно. Клиентам не нужно скачивать никаких модов, они просто заходят на сервер и сразу видят всю красоту.

Проект актуален и поддерживает свежие версии Minecraft 1.21.x, включая 1.21.6 и 1.21.7. Если вы держите свой сервер на BungeeHost (https://bungee.host), установить этот Фабрик-мод можно в один клик, он отлично ляжет в основную папку модов.

Команды и управление

Базовые действия делаются прямо из игры командой /nametag. Для этого нужен 2-й уровень оператора, либо (если у вас стоит пермишен-мод) право "custom-nametags.commands.nametag".

/nametag create <идентификатор> <текст>

Создает неймтег с заданным айдишником и текстом. Текст поддерживает Placeholder API, так что можно выводить динамические данные.

/nametag delete <идентификатор>

Удаляет указанный тег по его идентификатору.

/nametag reload

Перезагружает файл конфигурации. Удобно, если вы накидали новых тегов в JSON и не хотите перезагружать сервер.

Настройка через JSON

Мод дает огромный простор для кастомизации. Вы можете менять сам текст, условия отображения, радиус видимости и то, кому именно показывать тег. Вся настройка крутится вокруг файла config/custom-nametags/config..

Вот пример того, как можно настроить теги. Например, админам даем радужный префикс, обычным игрокам - префикс [Player], а если игрок что-то держит в руке - выводим название предмета:

{ "nametags": [ { "id": "example:admin_name", "update_interval": -1, "literal": "[Admin] <✨>%player:displayname_visual%<✨> ", "observee_predicate": { "type": "operator", "operator": 4 } }, { "id": "example:name", "update_interval": -1, "literal": "[Player] %player:displayname_visual%", "observee_predicate": { "type": "negate", "value": { "type": "operator", "operator": 4 } } }, { "id": "example:held_item", "update_interval": 1, "literal": "Holding: %player:equipment_slot mainhand%", "observee_predicate": { "type": "negate", "value": { "type": "entity", "value": { "equipment": { "mainhand": { "items": [ "minecraft:air" ] } } } } } }, { "id": "example:data", "update_interval": 1, "literal": "%player:health%♥ %player:hunger%🍖 %player:statistic minecraft:killed minecraft:player%⚔ %player:statistic minecraft:deaths%\uFFFD\uFFFD" } ] }

Разбор полей конфига

В JSON есть массив nametags, где каждый тег - это отдельный объект. Вот что можно настроить:

"id"

Уникальный идентификатор тега. Обязательно в формате "namespace:name", например "server:admin".

"update_interval"

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

"literal"

Текст, который будет висеть над игроком. Сюда можно втыкать плейсхолдеры. Например, %player:displayname_visual% подставит текущее отображаемое имя. Если нужен цвет - используем теги вроде <green> или <✨>.

"visible_radius" и "hidden_radius"

Радиус видимости тегов. Полезно, если вы хотите, чтобы имена появлялись только при сближении. Например, чтобы игроки видели неймтеги друг друга только на расстоянии от 5.3 до 10.7 блоков: 5 { "hidden_radius": 5.3, "visible_radius": 10.7 }

Если значения отрицательные - радиус отключен (тег виден всегда).

"observee_predicate"

Предикат для самого игрока. Определяет, кому из игроков давать этот тег. Например, в конфиге выше тег [Admin] дается только операторам (operator 4), а тег [Player] - всем остальным. Тут работает стандартный Predicate API из Майнкрафта.

В свежем релизе 1.0.0 разработчик добавил пару удобных кастомных предикатов. Теперь можно фильтровать по UUID: 5 { "type": "uuid", "uuid": "d4fca8c4-e083-4300-9a73-bf438847861c" }

Или по нику: 5 { "type": "player_name", "name": "senseiwells" }

"observer_predicate"

А это предикат для наблюдателя. Он решает, сможет ли конкретный игрок увидеть этот тег. Тоже работает через Predicate API.

Важные нюансы и баги

Как и любой серверный костыль поверх ванильного рендера, мод имеет свои ограничения. По факту, в 99% случаев всё работает идеально, но есть пара неочевидных моментов:

• Если игрок жмет F1, чтобы скрыть интерфейс, кастомные неймтеги останутся видимыми. Ванильный интерфейс скрывается, а наши теги - нет.
• Если игрок состоит в команде (team), будет рендериться обычный ванильный тег поверх кастомного. Решается одной командой: /team modify <team> nametagVisibility never.

Скачать CustomNameTags имеет смысл любому админу, который хочет навести порядок в ролях и визуале своего сервера. Это must-have для ролевых проектов и просто хороший инструмент для вывода статов прямо над головой.