CustomNameTags

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

Управление через команды

Для работы с модом используется команда /nametag, доступная игрокам с уровнем разрешений 2 или с правом "customnametags.command.nametag" при использовании систем управления правами.

Создание именной таблички

/nametag create <идентификатор> <текст> — создаёт именную табличку с указанным идентификатором и текстом. Поддерживает API плейсхолдеров.

Удаление именной таблички

/nametag delete <идентификатор> — удаляет именную табличку по идентификатору.

Перезагрузка конфигурации

/nametag reload — перезагружает файл конфигурации.

Гибкая настройка конфигурации

Мод предлагает широкие возможности кастомизации: от отображаемого текста до условий показа табличек определённым игрокам. Всё настраивается через JSON-файл config/CustomNameTags/config.json.

Пример конфигурации:

{
  "nametags": [
    {
      "id": "example:admin_name",
      "update_interval": -1,
      "literal": "[Admin] <rainbow>%player:displayname_visual%</rainbow> ",
      "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: <green>%player:equipment_slot mainhand%</green>",
      "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%💀"
    }
  ]
}

Структура именной таблички

Каждая именная табличка настраивается через отдельный объект в массиве конфигурации.

Идентификатор ("id")

Уникальный идентификатор таблички в формате "пространство_имён:название".

Интервал обновления ("update_interval")

Частота обновления таблички в игровых тиках. Значение -1 отключает автоматическое обновление.

Текст таблички ("literal")

Отображаемый текст, поддерживающий API плейсхолдеров для вставки контекстных данных (например, %player:displayname% для имени игрока).

Радиус видимости

Параметры "visible_radius" и "hidden_radius" определяют дистанцию, на которой табличка будет видна другим игрокам. Отрицательные значения отключают ограничения по расстоянию.

Пример настройки видимости в радиусе от 5.3 до 10.7 блоков:

{
  // ...
  "hidden_radius": 5.3,
  "visible_radius": 10.7,
  // ...
}

Условия показа

Необязательные параметры "observee_predicate" и "observer_predicate" определяют, каким игрокам показывать табличку и кто может её видеть. Используется API предикатов для тонкой настройки условий.

Особенности работы

CustomNameTags работает стабильно в большинстве случаев, но имеет некоторые ограничения:

• Пользовательские именные таблички остаются видимыми при скрытии интерфейса (F1)
• Принадлежность игрока к команде может вызывать конфликты с обычными именными табличками
• Решение: скрыть стандартные таблички для команды командой /team modify <команда> nametagVisibility never