Fabric Custom Names

Пользовательские имена

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

При желании в моде также есть функция отображения произвольных имен в игре над головой игрока. Здесь также есть опции для настройки стиля (цвета фона и непрозрачности текста), а также настройки отображаемых строк текста.

Также поддерживает префиксы/суффиксы, установленные с помощью LuckPerms!

Не стесняйтесь сообщать о любых ошибках или предлагать новые функции в системе отслеживания проблем.

Лицензия

Этот мод распространяется под лицензией GNU LGPLv3.

Пожертвование

Если вам нравится этот мод, рассмотрите возможность пожертвования.

Дискорд

Чтобы получить поддержку и/или задать любые вопросы, присоединяйтесь к my discord.

Поддержка версий

| Версия Майнкрафта | Статус | |-------------------|--------------| | 26.3.х | ✅ Текущий | | 26.2.х | ✔️ В наличии | | 26.1.х | ✔️ В наличии | | 21.1.11 | ✔️ В наличии | | 1.21.9+10 | ✔️ В наличии | | 1.21.6+7+8 | ✔️ В наличии | | 1.21.5 | ✔️ В наличии | | 1.21.4 | ✔️ В наличии | | 1.21.2+3 | ✔️ В наличии | | 1,21+1 | ✔️ В наличии | | 1.20.5+6 | ✔️ В наличии | | 1.20.4 | ✔️ В наличии | | 1.20.1 | ✔️ В наличии | | 1.19.4 | ✔️ В наличии | | 1.19.2 | ✔️ В наличии |

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

Неподдерживаемые версии по-прежнему доступны для загрузки, но в них не будут добавлены новые функции или исправлены ошибки.

Порты NeoForge доступны для Minecraft 26.1 и более поздних версий.

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

Сборки модов можно найти на странице релизов, а также на Modrinth.

Этот мод ориентирован на серверы Fabric Minecraft, но работает и на клиенте. Для этого мода требуется Fabric API.

Команду /name можно использовать следующим образом:

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

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

Команду /itemname можно использовать для переименования предмета, который вы сейчас держите. Требуется оператор или разрешение customname.itemname.

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

Подобно командам /name, запуск этих команд без аргументов сбрасывает имя/знания предмета, который вы держите.

Коды форматирования] Minecraft можно использовать для форматирования вашего префикса, суффикса, псевдонима или названий/знаний предметов. Вместо символа § используйте & (чтобы использовать & в имени (элемента), введите &&). Помимо кодов форматирования Minecraft по умолчанию, также можно использовать формат &#<hex code>.

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

Помимо команды /name, этот мод также поддерживает чтение префиксов и суффиксов из мода LuckPerms.

API

Другие моды Fabric или NeoForge могут читать имена, управляемые Custom Names, через класс CustomNameApi:

import net.minecraft.network.chat.Component;
import net.minecraft.server.level.ServerPlayer;
import xyz.eclipseisoffline.eclipsescustomname.api.CustomNameApi;
import xyz.eclipseisoffline.eclipsescustomname.api.CustomNameType;

Component prefix = CustomNameApi.getName(player, CustomNameType.PREFIX);
Component nickname = CustomNameApi.getName(player, CustomNameType.NICKNAME);
Component displayNickname = CustomNameApi.getDisplayNickname(player);
Component suffix = CustomNameApi.getName(player, CustomNameType.SUFFIX);
Component fullName = CustomNameApi.getFullName(player);

getName возвращает null, если для этого типа имени не установлено значение. getDisplayNickname возвращается к стандартному имени игрока, а getFullName возвращает полное отображаемое имя, используемое пользовательскими именами.

В Fabric, если установлен API-заполнитель Patbox, Custom Names также регистрирует следующие заполнители проигрывателя: %eclipsescustomname:prefix%, %eclipsescustomname:nickname%, %eclipsescustomname:suffix%, %eclipsescustomname:luckperms_prefix%, %eclipsescustomname:luckperms_suffix% и %eclipsescustomname:full_name%.

Файл конфигурации

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

{
  "enable_formatting": true,
  "require_permissions": true,
  "blacklisted_names": [],
  "max_name_length": 16,
  "operators_bypass_restrictions": false,
  "display_above_player": {
    "enabled": false,
    "text_opacity": 255,
    "background_color": "#40000000",
    "lines": [
      "luckperms_prefix prefix nickname suffix luckperms_suffix"
    ]
  },
  "name_groups": {
    "prefix": {},
    "nickname": {},
    "suffix": {}
  }
}

• enable_formatting можно использовать для отключения использования кодов форматирования Minecraft в именах.

• require_permissions можно использовать для отключения требования разрешения. Если установлено значение false, команды /name, /itemname и /itemlore доступны всем.

• blacklisted_names — список регулярных выражений, занесенных в черный список. Если префикс, суффикс или псевдоним соответствуют одному из этих регулярных выражений, их нельзя будет использовать.

• max_name_length определяет длину префикса/никнейма/суффикса игрока, максимум 32.

• operators_bypass_restrictions можно использовать для отключения ограничений по имени для операторов. Когда эта функция включена, операторы и люди с разрешением customname.bypass_restrictions могут использовать пробелы в псевдонимах, обходить ограничение максимальной длины и многое другое.

• display_above_player определяет, должно ли собственное имя игрока отображаться над его головой в игре. В настоящее время это несовместимо со скрытием тегов имен с помощью команд. Внешний вид можно дополнительно настроить с помощью следующих опций:

  • text_opacity: управляет непрозрачностью текста. 255 полностью виден, 0 — прозрачный.
  • background_color: HEX-цвет фона имени. Это в формате ARGB, поэтому первые две цифры обозначают альфа-значение.

• lines: controls the lines shown above a player's head. You can use this option to customise on which lines which name types are displayed. By default, all name types are displayed on a single line. All possible name types are listed in the example above.

• name_groups can be used to create name groups for each name type. Name groups consist of a list of names, which follow the same format used in name commands. You can assign players to one or more name groups by giving them permissions to the respective groups. They will then be able to use names listed in those groups.

For example, consider this name groups config:

"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": {}
}

You can then give players the customname.group.prefix.vip permission to allow them to use prefixes from the vip group, and the customname.group.prefix.legendary permission to allow them to use prefixes from the legendary group. Players will see these prefixes suggested when entering the /name prefix command, and, when running /name prefix without any arguments, a chat menu will allow them to select a prefix.

Note that granting players the customname.prefix permission will still allow them to use any prefix. Everything said above also applies to nicknames and suffixes.