Fabric Custom Names

Этот мод добавляет в Minecraft три полезные команды: /name, /itemname и /itemlore, которые позволяют игрокам настраивать префиксы, суффиксы и никнеймы, а также давать предметам цветные названия и описания. Разработан в первую очередь для небольших приватных серверов, но с помощью системы групп имен можно ограничивать, какие игроки могут использовать определенные префиксы, суффиксы и никнеймы.

Мод также поддерживает префиксы и суффиксы, установленные через LuckPerms!

Поддерживаемые версии

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

Использование

Мод ориентирован на Fabric серверы, но также работает на клиенте. Требуется Fabric API.

Команда /name

• /name prefix - устанавливает префикс для вашего имени, или очищает его если префикс не указан
  • Требует оператора или разрешения customname.prefix
• /name suffix - устанавливает суффикс для вашего имени, или очищает его если суффикс не указан
  • Требует оператора или разрешения customname.suffix
• /name nickname - устанавливает никнейм, который будет отображаться вместо вашего оригинального имени, или очищает его если никнейм не указан
  • Требует оператора или разрешения customname.nick
• /name other <prefix|suffix|nickname> <игрок> - аналогично соответствующим командам, но для установки префикса/суффикса/никнейма другого игрока
  • Требует оператора или разрешения customname.other в дополнение к соответствующему разрешению

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

Команды для предметов

• /itemname - переименовывает предмет в руке
  • Требует оператора или разрешения customname.itemname
• /itemlore - устанавливает описание для предмета в руке
  • Требует оператора или разрешения customname.itemlore
  • \n используется для создания новых строк, \ для экранирования обратного слеша

Запуск команд без аргументов сбрасывает название/описание предмета.

Форматирование

Можно использовать коды форматирования Minecraft для оформления префиксов, суффиксов, никнеймов и названий предметов. Вместо символа § используйте & (для использования & в названии введите &&). Также поддерживается формат &#<hex код> для цветов.

Использование кодов форматирования в именах можно отключить в конфигурационном файле.

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

Файл конфигурации находится по пути {root config directory}/eclipsescustomname.json. По умолчанию выглядит так:

{
  "enable_formatting": true,
  "require_permissions": true,
  "blacklisted_names": [],
  "max_name_length": 16,
  "operators_bypass_restrictions": false,
  "display_above_player": false,
  "name_groups": {
    "prefix": {},
    "nickname": {},
    "suffix": {}
  }
}

• enable_formatting - отключает использование кодов форматирования в именах
• require_permissions - отключает требование разрешений
• blacklisted_names - список регулярных выражений для запрещенных имен
• max_name_length - максимальная длина префикса/никнейма/суффикса (максимум 32)
• operators_bypass_restrictions - отключает ограничения для операторов
• display_above_player - отображает кастомное имя над головой игрока
• name_groups - создает группы имен для каждого типа

Пример групп имен

"name_groups": {
  "prefix": {
    "vip": [
      "&f&l[&7VIP&f&l]",
      "&f&l[&9VIP&f&l]",
      "&f&l[&aVIP&f&l]",
      "&f&l[&bVIP&f&l]",
      "&f&l[&cVIP&f&l]"
    ],
    "legendary": [
      "&f&l[&7Legendary&f&l]",
      "&f&l[&9Legendary&f&l]",
      "&f&l[&aLegendary&f&l]",
      "&f&l[&bLegendary&f&l]",
      "&f&l[&cLegendary&f&l]"
    ]
  },
  "nickname": {},
  "suffix": {}
}

Вы можете дать игрокам разрешение customname.group.prefix.vip для использования префиксов из группы vip и customname.group.prefix.legendary для префиксов из группы legendary. Игроки увидят эти префиксы в подсказках при вводе команды /name prefix, а при запуске команды без аргументов появится меню для выбора префикса.

Обратите внимание, что выдача игрокам разрешения customname.prefix все равно позволит им использовать любой префикс. Все вышесказанное также относится к никнеймам и суффиксам.