pv-addon-nickname

插件

· 作者 aomkoyo

Plasmo Voice 昵称插件。一个通用 JAR 包——已在 Paper/Folia/Fabric/Forge/NeoForge/Velocity/Arclight(MC 1.20.1 至 26.1.2)上测试通过。支持 PlaceholderAPI / PB4。

0 本站下载 0 关注 更新于 5 个月前

需要前置:Plasmo Voice

最新 2.1.3 · 26.1.2 · BungeeCord / Fabric

一键开服(送7天)

Plasmo Voice Nickname Addon

一个 Plasmo Voice 插件,用于在显示玩家昵称而非 Minecraft 用户名。

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

示例

Example Display Nickname


测试矩阵 (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 运行时,配置也会自动重新加载。


安装

  1. 在你的服务器或代理上安装 Plasmo Voice 2.1.9。Forge / NeoForge 用户:请使用原生 PV Forge 或 NeoForge jar(无需 Connector)。
  2. 将 pv-addon-nickname-<version>.jar 放入与 Plasmo Voice 相同的 plugins/ 或 mods/ 文件夹中。
  3. 启动服务器。将在 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 移植版和内部昵称系统,启用了统一的内置解析器。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源