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>.jarinto the sameplugins/ormods/folder as Plasmo Voice. - Start the server. A config will be generated at
plugins/pv-addon-nickname/config.toml(Bukkit) orconfig/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) and1.1(NeoForge) splits are merged into a single jar starting at2.0.0. - Config format moved from JSON to TOML. Re-create your
formatvalue in the new TOML config. - The NeoForge-only
/pvncommand 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.
下载 pv-addon-nickname
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 pv-addon-nickname
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 pv-addon-nickname
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 pv-addon-nickname
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 pv-addon-nickname
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 pv-addon-nickname
下载 pv-addon-nickname
下载 pv-addon-nickname
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 pv-addon-nickname
修复:在 Fabric / PB4 上,昵称不再显示为字面占位符文本(例如 %styled-nicknames:display_name%)。
服务器端的 PB4 集成现在使用 PB4 的 LiteralNode 来构建解析输入,而不是通过反射调用 Text.literal(String)。在中立映射(intermediary mappings)下,Text.literal 和 Text.translatable 是无法区分的静态 String->Text 方法,因此旧的基于形状查找可能会非确定性地选择 translatable,从而将占位符变成未解析的翻译键。使用 LiteralNode + Placeholders.parseText(TextNode, PlaceholderContext) 是确定性的,且与映射、加载器或版本无关。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧