Plasmo Voice Nickname Addon
一个 Plasmo Voice 插件,用于在显示玩家昵称而非 Minecraft 用户名。
从 v2.0.0 开始,该插件作为一个 单个通用 jar 包 分发,可在 Plasmo Voice 支持的所有服务端平台上运行——将其放入 plugins/(Bukkit 系列)或 mods/(Fabric、NeoForge 通过 Sinytra Connector),无需单独下载。
示例

测试矩阵 (v2.1.0)
通过启动每个组合并观察成功的 PV 插件注册以及服务器线程输出的 Done (...) 来验证:
| 加载器 |
测试的 MC 版本 |
Plasmo Voice |
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 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 (原生 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 hybrid) |
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),不要使用带有 Sinytra Connector 的 Fabric jar。该插件提供了自动生成的 Forge / NeoForge 入口点,可针对原生 PV 构建版干净地加载——无需 Connector。
该插件本身不依赖任何平台内部 API,因此它应该可以在上述加载器的所有其他 Plasmo Voice 支持的 MC 版本(1.20.1 → 26.1.2)上运行;上面的表格只是实际启动并验证过的内容。
支持的平台
一个 jar 包涵盖所有这些:
- Bukkit / Spigot / Paper / Purpur / Folia(以及 Canvas 等 Folia fork)
- Fabric (1.20.1 → 26.1.x)
- Forge(使用 Plasmo Voice 的原生 Forge 构建版)
- NeoForge(使用 Plasmo Voice 的原生 NeoForge 构建版,无需 Connector)
- Velocity(代理)
- BungeeCord(代理)
占位符支持
config.toml 中的格式字符串由运行平台上可用的最佳解析器进行解析:
| 平台 |
解析器 |
备注 |
| Bukkit / Paper / Folia / Purpur / Spigot |
PlaceholderAPI |
可选。如果未安装,则回退到内置占位符。 |
| Fabric |
PB4 Text Placeholder API |
可选。如果未安装,则回退到内置占位符。 |
| NeoForge / Velocity / BungeeCord |
内置 |
使用以下内置占位符。 |
内置占位符
始终可用,与平台无关:
%player_name%
%player_uuid%
%player_displayname%
命令与权限
| 命令 |
权限 |
默认值 |
操作 |
/pvnreload |
pv.addon.nickname.reload |
op |
在运行时重新加载 config.toml。适用于 Bukkit 系列的 LuckPerms / Vault / PEX。 |
当 Plasmo Voice 自身的 /vreload 运行时,配置也会自动重新加载。
安装
- 在你的服务器或代理上安装 Plasmo Voice 2.1.9。Forge / NeoForge 用户:请使用原生 PV Forge 或 NeoForge jar(无需 Connector)。
- 将
pv-addon-nickname-<version>.jar 放入与 Plasmo Voice 相同的 plugins/ 或 mods/ 文件夹中。
- 启动服务器。将在
plugins/pv-addon-nickname/config.toml(Bukkit)或 config/pv-addon-nickname/config.toml(Fabric/代理)生成配置文件。
默认配置
# 内置占位符: %player_name%, %player_uuid%, %player_displayname%
# 在安装了 PlaceholderAPI 的 Bukkit/Paper 上,所有 PAPI 占位符均可用。
# 在安装了 PB4 placeholder-api 的 Fabric 上,%namespace:placeholder% 语法可用。
format = "%player_displayname%"
编辑后使用 /pvnreload(或 Plasmo Voice 的 /vreload)重新加载。
从 1.x 迁移
- 旧的
1.0.0(插件)和 1.1(NeoForge)分支在 2.0.0 起合并为单个 jar。
- 配置格式从 JSON 移至 TOML。请在新 TOML 配置中重新创建你的
format 值。
- 移除了仅 NeoForge 的
/pvn 命令;现在该插件在所有平台上都使用 Plasmo Voice 的玩家信息 路径,这正是客户端模组(如昵称模组)所期望的。
源码
GitHub:
贡献者
- AsamiKafune — 原始 NeoForge 移植版和内部昵称系统,启用了统一的内置解析器。
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

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
- 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).
- Drop
pv-addon-nickname-<version>.jar into the same plugins/ or mods/ folder as Plasmo Voice.
- 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:
Contributors
- AsamiKafune — original NeoForge port and internal nickname system that inspired the unified built-in resolver.
评论 0
登录后参与评分
还没有评论,来抢沙发吧