- Документация
- https://modrinth.com/plugin/nametageditx
NametagEditX — серверный плагин для Paper и Folia, созданный как ответвление NametagEdit с поддержкой Folia и рядом дополнительных функций. Он добавляет произвольный текст перед именем игрока и после него, позволяя оформлять индивидуальные и групповые теги без изменения настоящего имени учётной записи.
Плагин относится к категориям управления и служебных инструментов. Клиентская установка не поддерживается: компонент требуется только серверу. Подтверждены версии 5.0.1 и 5.0.0, распространяемые по GPL-3.0-only.
NametagEditX отделяет визуальное оформление имени от профиля игрока. Префиксы и суффиксы могут обозначать группу, роль, статус или другую серверную категорию. Плагин не меняет скин и не переименовывает пользователя: он лишь управляет тем, как имя отображается в поддерживаемых элементах интерфейса.
Теги создаются для отдельных игроков либо для групп, вступление в которые определяется разрешениями. Готовая иерархия ролей в исходных данных не задана, поэтому администратор самостоятельно решает, какие группы показывать и как избежать пересекающихся правил.
Официальное описание перечисляет следующие функции:
• поддержка Folia и MiniMessage;
• практически неограниченная длина префикса и суффикса;
• улучшенная интеграция с LuckPerms;
• индивидуальные и групповые теги;
• сортировка тегов игроков и групп в таб-листе;
• поддержка PlaceholderAPI;
• FlatFile и MySQL;
• преобразование данных между FlatFile и MySQL;
• пул соединений MySQL.
Это заявленный набор проекта.
NametagEditX создаёт виртуальные команды scoreboard и передаёт связанные данные пакетами. Клиент получает префикс и суффикс, хотя исходное имя остаётся прежним. Такой механизм объясняет и возможности плагина, и его основные ограничения.
Игрок не может одновременно состоять в двух scoreboard-командах. Если другой плагин также управляет командными префиксами, суффиксами или цветами, обе системы могут конфликтовать. Это следует учитывать при одновременном использовании таб-листов, sidebar, NPC и других средств оформления.
Индивидуальный тег закрепляется за конкретным пользователем. Групповой вариант связывает оформление с набором разрешений и подходит для единообразного обозначения ролей. Для рабочей схемы полезно заранее определить:
• какие роли должны быть видимыми;
• какие теги относятся к группам, а какие — к отдельным игрокам;
• в каком порядке они должны сортироваться;
• какие плагины уже изменяют scoreboard;
• как будет проверяться обновление после смены прав.
Источник не задаёт обязательные названия, цвета или структуру групп. Поэтому такие параметры нельзя считать частью стандартной поставки.
NametagEditX поддерживает LuckPerms. При изменении группы или разрешений пользователя его тег может обновляться автоматически. LuckPerms при этом отвечает за права, а NametagEditX — за их визуальное представление.
Также заявлена поддержка PlaceholderAPI. В выбранных метаданных обязательные project dependencies отсутствуют, поэтому LuckPerms и PlaceholderAPI нельзя называть необходимыми для базовой загрузки. Это поддерживаемые интеграции, востребованность которых зависит от архитектуры конкретного сервера.
Официальный перечень включает FlatFile и MySQL, преобразование между ними и пул соединений для MySQL. Фактическая основа не определяет, какой вариант предпочтительнее, и не содержит универсальных параметров подключения.
При переносе данных разумно:
• сохранить резервную копию;
• зафиксировать текущую версию плагина;
• не совмещать миграцию с массовым изменением групп;
• сначала проверить небольшой набор записей;
• оставить возможность возврата к исходному хранилищу.
Конкретный формат файлов и параметры базы в предоставленных данных не раскрыты.
Поддерживаемые платформы — Paper и Folia. Подтверждены Minecraft 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2.
Стороны указаны как server=required и client=unsupported. Игрокам не нужен отдельный мод или JAR. Совпадение версии Minecraft со списком поддержки не гарантирует совместимость со всеми сторонними плагинами, особенно если они используют те же scoreboard-команды.
Подтверждённая процедура стандартна для серверного плагина:
• остановить совместимый сервер;
• выбрать нужный JAR;
• поместить его в папку plugins;
• запустить сервер;
• проверить журнал загрузки;
• протестировать тег на отдельном игроке и группе.
Обязательные project dependencies в выбранных метаданных не указаны. Перед вводом на рабочем сервере следует сохранить резервную копию.
Официальное описание предупреждает о конфликтах с NPC-плагинами, создающими персонажей под теми же именами, что и реальные игроки с тегами. Несовместимыми могут быть и решения, использующие цветные sidebar-команды без специальной поддержки NametagEdit.
Проверки требуют:
• плагины таб-листа;
• scoreboard и sidebar;
• NPC-системы;
• средства, меняющие team prefix, suffix или цвет;
• пакетные инструменты с аналогичной функцией.
При пересечении возможны ошибки отображения и клиентская ошибка, связанная с удалением участника из scoreboard-команды. Универсальный обход этого ограничения в исходном тексте не заявлен.
Актуальный из представленных файлов — NametagEditX-5.0.1.jar, версия 5.0.1, размер 276082 байта. SHA-512: 7e44c1ae54da2dff82069098b1a126c72c26997b0a0fb557938519fb218f453096d6ec39d459aec077039cffa1b7838017a54075c0f557b681f2801336dacee4. SHA-1: f0fc5b5f7dc16afd6d8d804338a5fbe4d580cbba.
Предыдущий файл — NametagEditX-5.0.0.jar, версия 5.0.0, размер 270509 байт. SHA-512: 36f8deeba240e58d1b0d128ed8b93146a97af2c7372050ed19e93b66cd2d59906101d9d281231a9861ab4b748d6ce3d004b747cedc7a120903352440cd8943fe. SHA-1: cd04a8fe6500d1c860b5878424826ec20ea9e736.
Лицензия проекта — GPL-3.0-only. При изменении или распространении нужно учитывать условия этой лицензии.
Файлы получены по официальному HTTPS и локально сверены с опубликованными хешами. Архивная структура и пути прошли статическую проверку. Динамический запуск не выполнялся, поэтому эти действия не подтверждают фактическое поведение плагина и не заменяют аудит кода.
Перед развёртыванием рекомендуется:
• проверить платформу и версию Minecraft;
• сохранить резервную копию;
• исключить второй менеджер scoreboard-команд;
• проверить индивидуальный и групповой тег;
• изменить группу тестового пользователя в LuckPerms;
• проверить таб-лист, имя над игроком, sidebar и NPC;
• сохранить хеш установленного JAR.
Нет. Плагин формирует визуальный префикс и суффикс через виртуальные scoreboard-команды и пакеты. Профиль игрока не переименовывается.
Нет обязательной зависимости, указанной в выбранных метаданных. LuckPerms является поддерживаемой интеграцией для связи тегов с группами и разрешениями.
Игрок не может одновременно принадлежать двум scoreboard-командам. Несколько систем, меняющих одни и те же поля, способны мешать друг другу.
Нет. NametagEditX работает на сервере; клиентская сторона обозначена как неподдерживаемая.
Обе версии подтверждены. Предоставленная основа не содержит полного сравнительного журнала изменений, поэтому выбор следует основывать на совместимости и собственной проверке.
Плагин относится к категориям управления и служебных инструментов. Клиентская установка не поддерживается: компонент требуется только серверу. Подтверждены версии 5.0.1 и 5.0.0, распространяемые по GPL-3.0-only.
Назначение плагина
NametagEditX отделяет визуальное оформление имени от профиля игрока. Префиксы и суффиксы могут обозначать группу, роль, статус или другую серверную категорию. Плагин не меняет скин и не переименовывает пользователя: он лишь управляет тем, как имя отображается в поддерживаемых элементах интерфейса.
Теги создаются для отдельных игроков либо для групп, вступление в которые определяется разрешениями. Готовая иерархия ролей в исходных данных не задана, поэтому администратор самостоятельно решает, какие группы показывать и как избежать пересекающихся правил.
Скриншоты и внешний вид
Подтверждённые возможности
Официальное описание перечисляет следующие функции:
• поддержка Folia и MiniMessage;
• практически неограниченная длина префикса и суффикса;
• улучшенная интеграция с LuckPerms;
• индивидуальные и групповые теги;
• сортировка тегов игроков и групп в таб-листе;
• поддержка PlaceholderAPI;
• FlatFile и MySQL;
• преобразование данных между FlatFile и MySQL;
• пул соединений MySQL.
Это заявленный набор проекта.
Принцип отображения тегов
NametagEditX создаёт виртуальные команды scoreboard и передаёт связанные данные пакетами. Клиент получает префикс и суффикс, хотя исходное имя остаётся прежним. Такой механизм объясняет и возможности плагина, и его основные ограничения.
Игрок не может одновременно состоять в двух scoreboard-командах. Если другой плагин также управляет командными префиксами, суффиксами или цветами, обе системы могут конфликтовать. Это следует учитывать при одновременном использовании таб-листов, sidebar, NPC и других средств оформления.
Индивидуальные и групповые теги
Индивидуальный тег закрепляется за конкретным пользователем. Групповой вариант связывает оформление с набором разрешений и подходит для единообразного обозначения ролей. Для рабочей схемы полезно заранее определить:
• какие роли должны быть видимыми;
• какие теги относятся к группам, а какие — к отдельным игрокам;
• в каком порядке они должны сортироваться;
• какие плагины уже изменяют scoreboard;
• как будет проверяться обновление после смены прав.
Источник не задаёт обязательные названия, цвета или структуру групп. Поэтому такие параметры нельзя считать частью стандартной поставки.
LuckPerms и другие интеграции
NametagEditX поддерживает LuckPerms. При изменении группы или разрешений пользователя его тег может обновляться автоматически. LuckPerms при этом отвечает за права, а NametagEditX — за их визуальное представление.
Также заявлена поддержка PlaceholderAPI. В выбранных метаданных обязательные project dependencies отсутствуют, поэтому LuckPerms и PlaceholderAPI нельзя называть необходимыми для базовой загрузки. Это поддерживаемые интеграции, востребованность которых зависит от архитектуры конкретного сервера.
Хранение данных
Официальный перечень включает FlatFile и MySQL, преобразование между ними и пул соединений для MySQL. Фактическая основа не определяет, какой вариант предпочтительнее, и не содержит универсальных параметров подключения.
При переносе данных разумно:
• сохранить резервную копию;
• зафиксировать текущую версию плагина;
• не совмещать миграцию с массовым изменением групп;
• сначала проверить небольшой набор записей;
• оставить возможность возврата к исходному хранилищу.
Конкретный формат файлов и параметры базы в предоставленных данных не раскрыты.
Совместимость
Поддерживаемые платформы — Paper и Folia. Подтверждены Minecraft 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2.
Стороны указаны как server=required и client=unsupported. Игрокам не нужен отдельный мод или JAR. Совпадение версии Minecraft со списком поддержки не гарантирует совместимость со всеми сторонними плагинами, особенно если они используют те же scoreboard-команды.
Установка
Подтверждённая процедура стандартна для серверного плагина:
• остановить совместимый сервер;
• выбрать нужный JAR;
• поместить его в папку plugins;
• запустить сервер;
• проверить журнал загрузки;
• протестировать тег на отдельном игроке и группе.
Обязательные project dependencies в выбранных метаданных не указаны. Перед вводом на рабочем сервере следует сохранить резервную копию.
Конфликты и ограничения
Официальное описание предупреждает о конфликтах с NPC-плагинами, создающими персонажей под теми же именами, что и реальные игроки с тегами. Несовместимыми могут быть и решения, использующие цветные sidebar-команды без специальной поддержки NametagEdit.
Проверки требуют:
• плагины таб-листа;
• scoreboard и sidebar;
• NPC-системы;
• средства, меняющие team prefix, suffix или цвет;
• пакетные инструменты с аналогичной функцией.
При пересечении возможны ошибки отображения и клиентская ошибка, связанная с удалением участника из scoreboard-команды. Универсальный обход этого ограничения в исходном тексте не заявлен.
Файлы и контрольные суммы
Актуальный из представленных файлов — NametagEditX-5.0.1.jar, версия 5.0.1, размер 276082 байта. SHA-512: 7e44c1ae54da2dff82069098b1a126c72c26997b0a0fb557938519fb218f453096d6ec39d459aec077039cffa1b7838017a54075c0f557b681f2801336dacee4. SHA-1: f0fc5b5f7dc16afd6d8d804338a5fbe4d580cbba.
Предыдущий файл — NametagEditX-5.0.0.jar, версия 5.0.0, размер 270509 байт. SHA-512: 36f8deeba240e58d1b0d128ed8b93146a97af2c7372050ed19e93b66cd2d59906101d9d281231a9861ab4b748d6ce3d004b747cedc7a120903352440cd8943fe. SHA-1: cd04a8fe6500d1c860b5878424826ec20ea9e736.
Лицензия и безопасность
Лицензия проекта — GPL-3.0-only. При изменении или распространении нужно учитывать условия этой лицензии.
Файлы получены по официальному HTTPS и локально сверены с опубликованными хешами. Архивная структура и пути прошли статическую проверку. Динамический запуск не выполнялся, поэтому эти действия не подтверждают фактическое поведение плагина и не заменяют аудит кода.
Практический чек-лист
Перед развёртыванием рекомендуется:
• проверить платформу и версию Minecraft;
• сохранить резервную копию;
• исключить второй менеджер scoreboard-команд;
• проверить индивидуальный и групповой тег;
• изменить группу тестового пользователя в LuckPerms;
• проверить таб-лист, имя над игроком, sidebar и NPC;
• сохранить хеш установленного JAR.
FAQ
Меняет ли NametagEditX имя или скин?
Нет. Плагин формирует визуальный префикс и суффикс через виртуальные scoreboard-команды и пакеты. Профиль игрока не переименовывается.
Обязателен ли LuckPerms?
Нет обязательной зависимости, указанной в выбранных метаданных. LuckPerms является поддерживаемой интеграцией для связи тегов с группами и разрешениями.
Почему плагин может конфликтовать с таб-листом или sidebar?
Игрок не может одновременно принадлежать двум scoreboard-командам. Несколько систем, меняющих одни и те же поля, способны мешать друг другу.
Нужно ли устанавливать компонент игрокам?
Нет. NametagEditX работает на сервере; клиентская сторона обозначена как неподдерживаемая.
Как выбрать между 5.0.1 и 5.0.0?
Обе версии подтверждены. Предоставленная основа не содержит полного сравнительного журнала изменений, поэтому выбор следует основывать на совместимости и собственной проверке.
