CustomNameTags

CustomNameTags

Этот мод даёт вам возможность полностью настраивать никнеймы игроков на стороне сервера, без необходимости в клиентских модах.

Эта документация описывает *последнюю* версию мода, для версий до 2.0.0 смотрите старую документацию

Команды

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

Текстовые аргументы поддерживают the placeholders api, а также formatting tags.

• `/nametag create ` Создаёт никнейм с указанным id и текстом, отображаемый у всех игроков.
• `/nametag edit text ` Изменяет текст существующего никнейма.
• `/nametag edit for ` Изменяет селектор for существующего никнейма.
• `/nametag edit priority ` Изменяет приоритет существующего никнейма (чем выше приоритет, тем выше отображается).
• `/nametag delete ` Удаляет никнейм с указанным id.
• /nametag list Показывает список всех заданных никнеймов.
• `/nametag player give ` Выдаёт игрокам никнейм, даже если обычно он им не полагается.
• `/nametag player revoke ` Скрывает никнейм от игроков, даже если обычно он им полагается.
• `/nametag player set ` Задаёт текст никнейма только для этих игроков. Если никнейма с таким id не существует, создаётся такой, который есть только у этих игроков.
• `/nametag player reset <id?>` Убирает переопределения игроков для указанного никнейма или все их переопределения.
• /nametag reload Перезагружает файл конфигурации.

Примеры

Если вы хотите создать никнейм, который отображает имена игроков, но в радужном цвете, можно выполнить следующую команду:

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

Указанный здесь id — rainbow_name — может быть любой строкой символов. Теги ` ... означают, что всё, что находится между ними, должно быть окрашено в радужный цвет, это [formatting tag](https://placeholders.pb4.eu/user/quicktext/). А %player:displayname_visual%` означает, что сюда должно быть подставлено имя игрока, это placeholder. Есть ещё много других тегов форматирования и плейсхолдеров, которые вы можете использовать.

По умолчанию никнеймы привязаны ко всем, если вы хотите, чтобы этот никнейм отображался только у операторов, можно выполнить

/nametag edit rainbow_name for operators

В случае, если вы хотите вручную назначать, кому выдаётся никнейм, можно выполнить

/nametag edit rainbow_name for nobody

Это значит, что по умолчанию никто не будет иметь этот никнейм, после чего вы можете переопределить это так:

/nametag player senseiwells give rainbow_name

Указанному игроку, в данном случае senseiwells, никнейм будет выдаваться всегда.

Если вы хотите переопределить текст конкретного никнейма или выдать игроку никнейм только для него, можно использовать:

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

Если никнейм с id rainbow_name существует, то у указанного игрока никнейм теперь будет отображать переопределённый текст "Special Red Name", который красный. Если никнейма с таким id не существует, он будет создан только для указанного игрока.

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

Конфигурация

Файл конфигурации этого мода находится в config/custom-nametags/config.json. На изображении выше использовалась следующая конфигурация:

{
  "version": 2,
  "nametags": {
    "admin_name": {
      "text": "[Admin] <rainbow>%player:displayname_visual%</rainbow>",
      "update_interval": -1,
      "for": "operators"
    },
    "name": {
      "text": "[Player] %player:displayname_visual%",
      "update_interval": -1,
      "for": { "not": "operators" }
    },
    "held_item": {
      "text": "Holding: <green>%player:equipment_slot mainhand%</green>",
      "update_interval": 1
    },
    "data": {
      "text": "%player:health%♥ %player:hunger%🍖 %player:statistic minecraft:killed minecraft:player%⚔ %player:statistic minecraft:deaths%\uD83D\uDC80",
      "update_interval": 1
    }
  },
  "players": {}
}

Конфиги версий мода до 2.0.0 будут автоматически обновлены до нового формата. Ваш исходный конфиг будет сохранён как config.old.json.

Неймтеги

Объект "nametags" содержит все неймтеги, которые будут отображаться у ваших игроков, с ключами по их id. Они располагаются в том порядке, в котором перечислены, первый — сверху.

• "text" Это текст, который будет отображаться на вашем неймтеге. Как упоминалось ранее, он поддерживает the placeholders api, а также formatting tags.
• "update_interval" Это интервал, с которым неймтег будет обновляться, в тиках. Установите -1, если ваш неймтег не нуждается в обновлении. Это актуально, если ваш неймтег содержит плейсхолдер с изменяющимися данными, например %player:health%.
• "for" Определяет, у каких игроков будет этот неймтег, см. Player Selectors ниже. По умолчанию "everyone".
• "visible_to" Определяет, какие игроки могут видеть этот неймтег, см. Player Selectors ниже. По умолчанию "everyone".
• "visible_radius", "hidden_radius" Эти две настройки задают диапазон, в котором неймтег будет виден другим игрокам. Установите отрицательное значение, чтобы отключить их.
• "visible_through_walls" Виден ли неймтег сквозь стены, по умолчанию true.
• "visible_when_invisible" Показывается ли неймтег, пока игрок невидим, по умолчанию false.
• "visible_with_passengers" Показывается ли неймтег, пока у игрока есть пассажиры, по умолчанию false.
• "shift_height" Вертикальное пространство, которое занимает неймтег, по умолчанию 0.275, достаточно для одной строки текста.
• "priority" Неймтеги с более высоким приоритетом отображаются выше неймтегов с более низким, по умолчанию 0.

Player Selectors

Селекторы используются в "for" и "visible_to" для выбора игроков.

Простейшие селекторы — "everyone", "nobody" и "operators":

{
  "for": "operators"
}

Для всего остального используйте объект с одним или несколькими из следующих условий, все из которых должны совпадать:

Любое условие, принимающее список, также принимает и одиночное значение.

{
  // Игроки с ником senseiwells или SuperSanta
  "for": { "names": ["senseiwells", "SuperSanta"] },

  // Операторы в команде red
  "for": { "permission_level": 2, "teams": "red" },

  // Все, кто является либо оператором, либо vip
  "visible_to": { "any": [ "operators", { "permission": "group.vip" } ] },

  // Все, кроме наблюдателей
  "visible_to": { "not": { "teams": "spectators" } }
}

Игроки

Объект "players" позволяет настраивать неймтеги для конкретных игроков, с ключом по их нику или uuid. Каждая запись сопоставляет id неймтега с переопределением:

{
  "nametags": {
    "rank": { "text": "<red>[Admin]</red>", "for": "operators" },
    "name": { "text": "%player:displayname_visual%" }
  },
  "players": {
    // Также можно использовать uuid вместо ников
    "senseiwells": {
      // Заменяет текст неймтега "rank" только для этого игрока
      "rank": "<gold>[Owner]</gold>"
    },
    "SuperSanta": {
      // Мы выдаём неймтег "rank" независимо от того, оператор SuperSanta или нет
      "rank": true,
      // Скрыть неймтег "name"
      "name": false,
      // Только у этого игрока есть такой неймтег
      "hearts": { "text": "%player:hearts%♥", "update_interval": 1 }
    }
  }
}

Переопределение может быть:

• true или false, чтобы выдать или скрыть неймтег,
• строкой, чтобы заменить текст неймтега,
• объектом с любыми полями из Nametags, чтобы заменить эти поля, плюс "enabled": false, чтобы скрыть его.

Переопределение неймтега выдаёт игроку этот неймтег независимо от его селектора "for", если только переопределение не указывает собственный "for". Id, не совпадающие с глобальным неймтегом, определяют такой, который есть только у этого игрока.

Ограничения

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

• Когда игроки нажимают F1, чтобы скрыть HUD, кастомные неймтеги игроков остаются видимыми.

• Если игрок состоит в команде, будет отрисовываться его обычный неймтег.

  • Это можно решить, скрыв все неймтеги для данной команды:
  • `/team modify nametagVisibility never`