NickUdon

插件

· 作者 FriedOUDON

支持 Paper 和 Fabric 服务器的昵称与前缀管理器,具备第二行名称标签、聊天/显示格式设置、PlaceholderAPI 支持以及多语言消息功能。

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

需要前置:文本占位符 API、Fabric API

最新 2.0.2 · 1.21.11 · Fabric

一键开服(送7天)

NickUdon

NickUdon 是一个面向 Paper 和 Fabric 的多目标 Minecraft 昵称/前缀/副标题项目。 共享的格式化、配置、持久化和本地化逻辑位于 common,而平台特定的适配器分别位于 paper 和 fabric。

亮点

  • 昵称、前缀和第二行 nametag(副标题)
  • 传统的 & 颜色代码和 RGB 十六进制 #RRGGBB
  • 可配置的显示/聊天格式
  • 别名唯一性检查,支持可配置的规范化规则
  • 多语言消息,内置 en_US 和 ja_JP
  • 加入/离开时的显示覆盖及广播消息
  • Paper 和 Fabric 共享配置默认值

平台说明

Paper

  • 基于 1.21 API 系列构建为 Paper 插件
  • 可选 PlaceholderAPI 集成以支持外部占位符
  • 可选 Vault 集成以支持基于经济的支付功能
  • 配置目录:plugins/NickUdon/

Fabric

  • 当前目标版本:Minecraft 1.21.11
  • 支持 Fabric Loader 0.18.4 至 0.18.x
  • 需要在服务器 mods/ 目录中安装 fabric-api 和 Patbox placeholder-api
  • 不支持经济集成;支付相关设置和绕过权限仅限 Paper
  • 通过 fabric-permissions-api-v0 支持外部权限提供者
  • LuckPerms 可在 Fabric 上作为权限提供者使用;若无权限提供者,权限检查将回退到模组内置的默认值(true 或操作员级别)
  • 配置目录:config/nickudon/

命令

  • /nickudon name|nick|alias|rename [player] <alias|clear>
  • /nickudon prefix [player] <prefix|clear>
  • /nickudon subtitle [player] <text|clear|on|off>
  • /nickudon reload
  • /nickudon lang <code>
  • /nickudon cleanupsubtitles(仅 Fabric,仅限管理员,用于移除旧版本遗留的孤立副标题盔甲架)
  • /name ...(/nickudon name ... 的简写)

权限

  • nickudon.use
  • nickudon.admin
  • nickudon.broadcast.*(包含 alias、prefix、subtitle)
  • nickudon.nickname、nickudon.nickname.others
  • nickudon.prefix、nickudon.prefix.others
  • nickudon.subtitle、nickudon.subtitle.others
  • nickudon.payments.bypass.*(包含 alias、prefix、subtitle 及其 .others 变体)

Paper 通过 plugin.yml 暴露这些权限。 Fabric 使用 fabric-permissions-api-v0。如果安装了如 LuckPerms 之类的权限提供者,这些权限节点将在其中进行检查。否则,Fabric 将回退到模组使用的内置默认值。

构建

要求

  • Java 21

命令

  • 构建所有目标:.\gradlew build
  • 仅构建 Paper:.\gradlew :paper:build
  • 仅构建 Fabric:.\gradlew :fabric:build

输出

  • Paper JAR:paper/build/libs/NickUdon-<version>.jar
  • Fabric JAR:fabric/build/libs/NickUdon-fabric-<version>.jar

安装

Paper

  1. 构建 :paper:build
  2. 将 paper/build/libs/NickUdon-<version>.jar 放入 plugins/
  3. 如果需要外部占位符扩展,请安装 PlaceholderAPI
  4. 如果需要启用 payments.* 功能,请安装 Vault 及一个经济类插件

Fabric

要求:

  • Fabric Loader 0.18.4 至 0.18.x
  1. 构建 :fabric:build
  2. 将 fabric/build/libs/NickUdon-fabric-<version>.jar 放入 mods/
  3. 还需安装:
    • fabric-api-0.141.3+1.21.11.jar
    • placeholder-api-2.8.2+1.21.10.jar 或更高版本
    • LuckPerms 或其他 Fabric 权限提供者(如需非 OP 用户的权限管理)
  4. 启动一个 Minecraft 1.21.11 Fabric 服务器
  5. 如果残留了旧版 Fabric 副标题盔甲架,站在它们附近并运行 /nickudon cleanupsubtitles

配置文件与语言文件

  • 共享的默认资源打包自 common/src/main/resources/
  • Paper 运行时文件位于 plugins/NickUdon/
  • Fabric 运行时文件位于 config/nickudon/
  • 外部 lang/<locale>.yml 文件可在两个平台上覆盖内置资源

占位符

Paper PlaceholderAPI

  • %nickudon_alias%、%nickudon_alias_stripped%
  • %nickudon_prefix%
  • %nickudon_chat%
  • %nickudon_display%、%nickudon_display_no_prefix%
  • %nickudon_name%

Fabric Patbox Text Placeholder API

NickUdon 注册了以下占位符标识符:

  • nickudon:alias
  • nickudon:alias_stripped
  • nickudon:prefix
  • nickudon:chat
  • nickudon:display
  • nickudon:display_no_prefix
  • nickudon:name

请使用已安装的 Patbox Text Placeholder API 版本所支持的语法来调用它们。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源