Перейти к содержимому
Mineforgian

pv-addon-nickname

Plasmo Voice nickname addon. One universal jar - tested on Paper/Folia/Fabric/Forge/NeoForge/Velocity/Arclight (MC 1.20.1 to 26.1.2). PlaceholderAPI / PB4 supported.

Загрузки
2K
Подписчики
1
Обновлён
15 июня 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 28 ноября 2025 г.

Скачать 2.1.3(22 КБ)

Plasmo Voice Nickname Addon

A Plasmo Voice addon that displays player nicknames instead of their Minecraft usernames.

Starting with v2.0.0, the addon ships as a single universal jar that runs on every server-side platform Plasmo Voice supports — drop it into plugins/ (Bukkit-family) or mods/ (Fabric, NeoForge via Sinytra Connector), no separate downloads.

Example

Example Display Nickname

Tested matrix (v2.1.0)

Verified by booting each combination with the addon and observing both successful PV addon registration and Done (...) from the server thread:

Loader MC versions tested Plasmo Voice Java Install addon in Result
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 fork) 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 (native PV) 21.1.228 / 1.21.1 NeoForge 2.1.9 21 mods/ ✅
Forge (native PV) 47.4.20 / 1.20.1, 52.1.14 / 1.21.1 Forge 2.1.9 21 mods/ ✅
Arclight Fabric (Bukkit + Fabric hybrid) 1.0.2-SNAPSHOT / 1.21.1 Fabric 2.1.9 21 mods/ ✅

Note for Forge / NeoForge users: install Plasmo Voice's native Forge or NeoForge build (e.g. plasmovoice-forge-1.21.1-2.1.9.jar or plasmovoice-neoforge-1.21.1-2.1.9.jar), not the Fabric jar with Sinytra Connector. The addon ships auto-generated Forge / NeoForge entrypoints that load cleanly against the native PV builds — no Connector required.

The addon itself does not depend on any platform-internal API, so it should work on every other Plasmo-Voice-supported MC version (1.20.1 → 26.1.2) on the loaders listed above; the table above is just what was actually booted and verified.

Supported platforms

One jar covers all of these:

  • Bukkit / Spigot / Paper / Purpur / Folia (and Folia forks like Canvas)
  • Fabric (1.20.1 → 26.1.x)
  • Forge (uses Plasmo Voice's native Forge build)
  • NeoForge (uses Plasmo Voice's native NeoForge build, no Connector required)
  • Velocity (proxy)
  • BungeeCord (proxy)

Placeholder support

The format string in config.toml is parsed by the best resolver available on the running platform:

Platform Resolver Notes
Bukkit / Paper / Folia / Purpur / Spigot PlaceholderAPI Optional. Falls back to built-in placeholders if not installed.
Fabric PB4 Text Placeholder API Optional. Falls back to built-in placeholders if not installed.
NeoForge / Velocity / BungeeCord Built-in Use the built-in placeholders below.

Built-in placeholders

Always available, regardless of platform:

  • %player_name%
  • %player_uuid%
  • %player_displayname%

Commands & Permissions

Command Permission Default Action
/pvnreload pv.addon.nickname.reload op Reload config.toml at runtime. Works with LuckPerms / Vault / PEX on Bukkit-family.

The config also reloads automatically when Plasmo Voice's own /vreload runs.

Installation

  1. Install Plasmo Voice 2.1.9 on your server or proxy. Forge / NeoForge users: use the native PV Forge or NeoForge jar (no Connector needed).
  2. Drop pv-addon-nickname-<version>.jar into the same plugins/ or mods/ folder as Plasmo Voice.
  3. Start the server. A config will be generated at plugins/pv-addon-nickname/config.toml (Bukkit) or config/pv-addon-nickname/config.toml (Fabric/proxy).

Default config

# Built-in placeholders: %player_name%, %player_uuid%, %player_displayname%
# On Bukkit/Paper with PlaceholderAPI installed, all PAPI placeholders work.
# On Fabric with PB4 placeholder-api installed, %namespace:placeholder% syntax works.
format = "%player_displayname%"

Reload with /pvnreload (or Plasmo Voice's /vreload) after editing.

Migration from 1.x

  • Old 1.0.0 (plugin) and 1.1 (NeoForge) splits are merged into a single jar starting at 2.0.0.
  • Config format moved from JSON to TOML. Re-create your format value in the new TOML config.
  • The NeoForge-only /pvn command was removed; the addon now uses Plasmo Voice's player info path on every platform, which is what client-side mods (e.g. nickname mods) expect.

Source

GitHub: https://github.com/alice-magic/pv-addon-nickname

Contributors

Центр версий

3 из 9
Стабильная2.1.026.1.2 · 19 КБ
  • Релиз19 КБ
  • Релиз17 КБ
  • Релиз6 КБ

Ченджлог

2.1.3Релиз26.1, 26.1.1, 26.1.2 · 15 июня 2026 г.

Fix: nicknames no longer render as the literal placeholder text (e.g. %styled-nicknames:display_name%) on Fabric / PB4.

The server PB4 integration now builds its parse input with PB4's LiteralNode instead of reflecting Text.literal(String). Under intermediary mappings Text.literal and Text.translatable are indistinguishable static String->Text methods, so the old shape-based lookup could non-deterministically pick translatable and turn the placeholder into an unresolved translation key. LiteralNode + Placeholders.parseText(TextNode, PlaceholderContext) is deterministic and mapping / loader / version agnostic.

2.1.2Релиз26.1, 26.1.1, 26.1.2 · 29 мая 2026 г.

Bug Fixes

  • Fix PB4 (Fabric Text Placeholder API) placeholders not resolving on MC 1.20.1. Two root causes: (1) the resolver picked the wrong parseText overload (TextNode instead of Text), and (2) it looked up the text factory by the Yarn name literal, which does not exist in the intermediary namespace the addon runs in. Both are now resolved via shape-based reflection that is mapping-namespace agnostic. Verified against the real intermediary runtime classpath.

This completes the PB4 fix started in 2.1.1.

2.1.1Релиз26.1, 26.1.1, 26.1.2 · 28 мая 2026 г.

Bug Fixes

  • Fix Fabric Text Placeholder API (PB4) not resolving placeholders on MC 1.20.1. The resolver now derives Minecraft classes from PB4 method signatures instead of hardcoded Yarn-mapped class names.
  • Fix %player_displayname% built-in placeholder now resolves the actual player display name (from the platform player object) instead of falling back to the raw username.

Improvements

  • Added diagnostic logging for resolver selection and PB4 integration status.
2.1.0Релиз26.1, 26.1.1, 26.1.2 · 10 мая 2026 г.

2.1.0 — Reload command + verified test matrix

Added

  • /pvnreload — reload config.toml at runtime without restarting the server.
    • Permission: pv.addon.nickname.reload (default: op).
    • Cross-platform: Bukkit / Spigot / Paper / Purpur / Folia, Fabric, Forge, NeoForge.
    • On Bukkit-family servers, LuckPerms / Vault / PEX permissions work out of the box because the check goes through the platform's native permission supplier.
  • Reload also still triggers automatically on Plasmo Voice's own VoiceServerConfigReloadedEvent (i.e. when you run /vreload).

Verified test matrix

Loader MC versions tested Plasmo Voice Java Install addon in
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 fork) 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/
Forge (native PV) 47.4.20 / 1.20.1, 52.1.14 / 1.21.1 Forge 2.1.9 21 mods/
NeoForge (native PV) 21.1.228 / 1.21.1 NeoForge 2.1.9 21 mods/
Arclight Fabric (Bukkit + Fabric hybrid) 1.0.2-SNAPSHOT / 1.21.1 Fabric 2.1.9 21 mods/

Notes

  • For Forge / NeoForge, install Plasmo Voice's native Forge / NeoForge build. Sinytra Connector is not required.
  • Minimum Plasmo Voice: 2.1.9. Minimum Java: 17 (JDK 25+ required at runtime for MC 26.1.x). Minecraft: 1.20.1+.
2.0.0Релиз26.1, 26.1.1, 26.1.2 · 10 мая 2026 г.

2.0.0 — Universal addon rebuild

Highlights

  • One jar, every server-side platform. Bukkit / Spigot / Paper / Purpur / Folia, Fabric, NeoForge (via Sinytra Connector), Velocity, and BungeeCord all run from a single download.
  • Migrated to the official Plasmo Voice multi-module addon template, so future PV updates land instantly.

What changed since 1.x

  • Old 1.0.0 (plugin) and 1.1 (NeoForge) splits are merged.
  • Config moved from JSON to TOML (config.toml). Built-in placeholders work everywhere; PlaceholderAPI is auto-detected on Bukkit-family, PB4 placeholder-api on Fabric.
  • Forge-only /pvn command was removed; nickname now flows through Plasmo Voice's PlayerInfoCreateEvent so the value reaches every voice client identically.
  • Minimum Plasmo Voice: 2.1.9. Minimum Java: 17. Minecraft: 1.20.1+.

Upgrade notes

  • Delete the old jar(s) before installing this one.
  • Re-enter your format value in the new config.toml.
  • Reload Plasmo Voice (/vreload) after editing.
1.1Релиз1.21.1 · 22 января 2026 г.

Auto detect by Text Placeholder API

1.0.0Релиз1.21.1 · 23 декабря 2025 г.

Contributions

1.0.0Релиз26.1, 26.1.1, 26.1.2 · 28 ноября 2025 г.

Plugin Support

Комментарии

Загружаем…