CustomNameTags

CustomNameTags предоставляет инструменты для глубокой настройки отображения имен игроков, поддерживая динамические плейсхолдеры и форматирование текста.

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

Настройку тегов можно выполнять непосредственно в игре с помощью команды /nametag. Для использования требуются права уровня 2 или наличие права доступа custom-nametags.commands.nametag при использовании систем разрешений.

Команды поддерживают использование плейсхолдеров из Placeholder API и тегов форматирования (например, <rainbow>...</rainbow>).

/nametag create <id> <text>
/nametag edit <id> text <text>
/nametag edit <id> for <who>
/nametag edit <id> priority <priority>
/nametag delete <id>
/nametag list
/nametag player <players> give <id>
/nametag player <players> revoke <id>
/nametag player <players> set <id> <text>
/nametag player <players> reset <id?>
/nametag reload

Для создания радужного имени с использованием динамического плейсхолдера:

/nametag create rainbow_name <rainbow>%player:displayname_visual%</rainbow>

Чтобы ограничить видимость тега только для операторов:

/nametag edit rainbow_name for operators

Если нужно вручную назначить тег конкретному игроку (например, senseiwells):

/nametag player senseiwells give rainbow_name

Для установки уникального текста для конкретного игрока:

/nametag player senseiwells set rainbow_name <red>Special Red Name</red>

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

• text — текст, отображаемый в теге (поддерживает плейсхолдеры и форматирование)
• update_interval — интервал обновления тега в тиках (установите -1, если данные статичны)
• for — выбор игроков, которым предназначен тег (по умолчанию "everyone")
• visible_to — выбор игроков, которые могут видеть тег
• visible_radius / hidden_radius — радиус видимости (отрицательное значение отключает ограничение)
• visible_through_walls — видимость сквозь стены (по умолчанию true)
• visible_when_invisible — отображение тега в режиме невидимости (по умолчанию false)
• visible_with_passengers — отображение при наличии пассажиров (по умолчанию false)
• shift_height — вертикальный сдвиг тега (по умолчанию 0.275)
• priority — приоритет отображения (чем выше, тем выше в списке)

Для выбора игроков в полях for и visible_to можно использовать простые селекторы: everyone, nobody, operators. Для сложных условий используется объект с условиями:

• names — наличие в списке никнеймов
• uuids — наличие в списке UUID
• teams — нахождение в определенной команде
• tags — наличие тега в scoreboard
• permission_level — уровень доступа оператора (0-4)
• permission — наличие узла права доступа (требуется мод на права)
• not — исключение игроков, подходящих под селектор
• any — совпадение хотя бы с одним селектором из списка
• all — совпадение со всеми селекторами из списка
• predicate — соответствие предикату из Predicate API

Объект players в конфиге позволяет создавать уникальные теги для конкретных пользователей по никнейму или UUID. Переопределение может быть:

• true или false — включение или скрытие глобального тега
• строка — замена текста тега
• объект — замена любых полей тега (включая enabled: false для скрытия)

При нажатии клавиши F1 для скрытия интерфейса (HUD), кастомные теги имен остаются видимыми.
Если игрок состоит в команде, будет отображаться его стандартный тег команды. Чтобы это исправить, можно скрыть теги для всей команды командой: /team modify <team> nametagVisibility never.

Требования проверенного файла

• По манифесту для файла CustomNameTags-2.0.0+26.3.jar (Minecraft 26.3; Fabric) требуется fabric-api.
• По манифесту для файла CustomNameTags-2.0.0+26.3.jar (Minecraft 26.3; Fabric) требуется fabric-language-kotlin.
• По манифесту для файла CustomNameTags-2.0.0+26.3.jar (Minecraft 26.3; Fabric) требуется placeholder-api.