pv-addon-nickname

Plasmo Voice Nickname Addon: никакие ники в голосовом чате

Если ты когда-нибудь играл на серверах с голосовым чатом через Plasmo Voice, то знаешь - рядом с никами игроков обычно отображается их оригинальное имя из Minecraft. Но что, если хочется видеть псевдонимы, которые задали сами игроки? Именно для этого и существует Plasmo Voice Nickname Addon.

Этот аддон для ПлазмоВойс заменяет отображаемые имена на никнеймы - те самые, что задаются через плагины вроде PlaceholderAPI или другие моды. Больше никакой путаницы: если игрок поставил себе ник "Drake", ты увидишь именно его, а не "DarkKnight123". Идеально для ролевых серверов, проектов с кастомными рангами или просто чтобы было красиво.

Что изменится в игре

В обычном Майнкрафт при голосовом общении через Plasmo Voice у каждого игрока висит стандартный юзернейм. Аддон перехватывает этот момент и подставляет то имя, которое задано на сервере через PlaceholderAPI или PB4. Всё работает автоматически - не нужно ничего настраивать на стороне клиента.

Один JAR на все случаи

Начиная с версии v2.0.0, аддон поставляется как один универсальный JAR-файл, который работает на всех платформах поддерживаемых Plasmo Voice. Просто кидаешь его в plugins/ (если у тебя Bukkit/Paper/Folia) или в mods/ (если Fabric/Forge/NeoForge) - и всё. Больше не нужно качать отдельные версии для каждого загрузчика. Аддон сам определит, на чём запущен.

Протестированные платформы и версии

Разработчики проверили работу аддона на куче связок. Вот подтверждённые комбинации:

Загрузчик	Версии Майнкрафт	ПлазмоВойс	Java	Место установки	Результат
Paper	1.20.1, 1.21.1, 1.21.11	Paper 2.1.9	21	plugins/	✅
Folia	1.20.1, 1.21.4, 1.21.11	Paper 2.1.9	21	plugins/	✅
Canvas (форк Folia)	26.1.2	Paper 2.1.9	25	plugins/	✅
Fabric	1.20.1, 1.21.1, 1.21.4, 1.21.6, 1.21.11, 26.1.2	Fabric 2.1.9	21 / 25	mods/	✅
Velocity	3.4.0-SNAPSHOT	Velocity 2.1.9	21	plugins/	✅
NeoForge (нативный PV)	21.1.228 / 1.21.1	NeoForge 2.1.9	21	mods/	✅
Forge (нативный PV)	47.4.20 / 1.20.1, 52.1.14 / 1.21.1	Forge 2.1.9	21	mods/	✅
Arclight Fabric (Bukkit + Fabric гибрид)	1.0.2-SNAPSHOT / 1.21.1	Fabric 2.1.9	21	mods/	✅

Важно для Forge / NeoForge: используй нативные сборки Plasmo Voice для Forge/NeoForge (например, plasmovoice-forge-1.21.1-2.1.9.jar или plasmovoice-neoforge-1.21.1-2.1.9.jar), а не Fabric с Sinytra Connector. Аддон умеет сам подхватывать нативные запускаемые точки - никакой возни с коннектором.

Плагины и плейсхолдеры

Формат строки в конфиге config.toml обрабатывается в зависимости от того, что стоит на сервере:

Платформа	Обработчик	Особенности
Bukkit / Paper / Folia / Purpur / Spigot	PlaceholderAPI	Не обязателен. Если нет - используются встроенные плейсхолдеры.
Fabric	PB4 Text Placeholder API	Не обязателен. Если нет - встроенные.
NeoForge / Velocity / BungeeCord	Встроенные	Используй стандартные плейсхолдеры ниже.

Встроенные плейсхолдеры

Работают всегда, независимо от платформы:

• %player_name% - стандартный ник
• %player_uuid% - UUID игрока
• %player_displayname% - отображаемое имя

Команды и права

Команда	Право	По умолчанию	Действие
/pvnreload	pv.addon.nickname.reload	op	Перезагружает конфиг config.toml на лету. Работает с LuckPerms, Vault, PEX на Bukkit.

Кстати, конфиг автоматически перезагружается при выполнении /vreload от самого Plasmo Voice - удобно.

Установка: быстро и без боли

1. Установи Plasmo Voice 2.1.9 на сервер или прокси. Для Forge / NeoForge - бери нативные JAR-файлы (без Sinytra Connector).
2. Кинь pv-addon-nickname-<версия>.jar в ту же папку plugins/ или mods/, где лежит Plasmo Voice.
3. Запусти сервер. Конфиг создастся автоматически:
   • На Bukkit: plugins/pv-addon-nickname/config.toml
   • На Fabric/прокси: config/pv-addon-nickname/config.toml

Дефолтный конфиг

# Встроенные плейсхолдеры: %player_name%, %player_uuid%, %player_displayname%
# На Bukkit/Paper с PlaceholderAPI работают все плейсхолдеры PAPI.
# На Fabric с PB4 placeholder-api работает синтаксис %namespace:placeholder%.
format = "%player_displayname%"

После редактирования перезагрузи конфиг через /pvnreload или /vreload.

Миграция с 1.x

Если ты раньше использовал старые версии:

• Версии 1.0.0 (старый плагин) и 1.1 (NeoForge) объединены в один JAR начиная с 2.0.0.
• Формат конфига сменился с JSON на TOML. Просто пересоздай значение format в новом конфиге.
• Команда /pvn (только для NeoForge) удалена - теперь аддон использует стандартный путь информации о игроке из Plasmo Voice, что полностью совместимо с клиентскими модами для никнеймов.

Для кого этот аддон

Идеально подходит для:

• Ролевых серверов, где важны кастомные имена
• Проектов с системой рангов и никнеймов через PlaceholderAPI
• Любых серверов на Plasmo Voice, где хочется видеть псевдонимы, а не стандартные ники

Если ты собираешь сервер с голосовым чатом и хочешь, чтобы игроки видели друг друга под своими никами - pv-addon-nickname то, что нужно. Просто установи, настрой пару строк в конфиге и забудь о проблемах с отображением имён.