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 将回退到模组使用的内置默认值。
构建
要求
命令
- 构建所有目标:
.\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
- 构建
:paper:build
- 将
paper/build/libs/NickUdon-<version>.jar 放入 plugins/
- 如果需要外部占位符扩展,请安装 PlaceholderAPI
- 如果需要启用
payments.* 功能,请安装 Vault 及一个经济类插件
Fabric
要求:
- Fabric Loader
0.18.4 至 0.18.x
- 构建
:fabric:build
- 将
fabric/build/libs/NickUdon-fabric-<version>.jar 放入 mods/
- 还需安装:
fabric-api-0.141.3+1.21.11.jar
placeholder-api-2.8.2+1.21.10.jar 或更高版本
- LuckPerms 或其他 Fabric 权限提供者(如需非 OP 用户的权限管理)
- 启动一个 Minecraft
1.21.11 Fabric 服务器
- 如果残留了旧版 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 版本所支持的语法来调用它们。
NickUdon
NickUdon is a multi-target Minecraft nickname/prefix/subtitle project for Paper and Fabric.
Shared formatting, config, persistence, and localization logic lives in common, while platform-specific adapters live in paper and fabric.
Highlights
- Nicknames, prefixes, and a second nametag line (subtitle)
- Legacy
& colors and RGB hex #RRGGBB
- Configurable display/chat formats
- Alias uniqueness checks with configurable normalization rules
- Multi-language messages with bundled
en_US and ja_JP
- Join/quit display overrides and broadcast messages
- Shared config defaults across Paper and Fabric
Platform Notes
Paper
- Built as a Paper plugin for the 1.21 API line
- Optional PlaceholderAPI integration for external placeholders
- Optional Vault integration for economy-backed payments
- Config directory:
plugins/NickUdon/
Fabric
- Current target: Minecraft
1.21.11
- Supports Fabric Loader
0.18.4 through 0.18.x
- Requires
fabric-api and Patbox placeholder-api in the server mods/ directory
- No economy integration; payment-related settings and bypass permissions are Paper-only
- Supports external permission providers through
fabric-permissions-api-v0
- LuckPerms works as a permission provider on Fabric; without a provider, permission checks fall back to the built-in defaults (
true or operator level)
- Config directory:
config/nickudon/
Commands
/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 only, admin only, removes orphan subtitle armor stands from older builds)
/name ... (shorthand for /nickudon name ...)
Permissions
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, and their .others variants)
Paper exposes these permissions through plugin.yml.
Fabric uses fabric-permissions-api-v0. If a provider such as LuckPerms is installed, these permission nodes are checked there. Otherwise, Fabric falls back to the built-in defaults used by the mod.
Build
Requirements
Commands
- Build both targets:
.\gradlew build
- Build Paper only:
.\gradlew :paper:build
- Build Fabric only:
.\gradlew :fabric:build
Output
- Paper JAR:
paper/build/libs/NickUdon-<version>.jar
- Fabric JAR:
fabric/build/libs/NickUdon-fabric-<version>.jar
Installation
Paper
- Build
:paper:build
- Put
paper/build/libs/NickUdon-<version>.jar into plugins/
- Install PlaceholderAPI if you want external placeholder expansion
- Install Vault plus an economy plugin only if you want
payments.* to be active
Fabric
Requirements:
- Fabric Loader
0.18.4 through 0.18.x
- Build
:fabric:build
- Put
fabric/build/libs/NickUdon-fabric-<version>.jar into mods/
- Also install:
fabric-api-0.141.3+1.21.11.jar
placeholder-api-2.8.2+1.21.10.jar or newer
- LuckPerms or another Fabric permission provider if you want non-OP permission management
- Start a Minecraft
1.21.11 Fabric server
- If older Fabric subtitle armor stands are left behind, stand near them and run
/nickudon cleanupsubtitles
Config And Lang Files
- Shared default resources are packaged from
common/src/main/resources/
- Paper runtime files live under
plugins/NickUdon/
- Fabric runtime files live under
config/nickudon/
- External
lang/<locale>.yml files override bundled resources on both platforms
Placeholders
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 registers these placeholder identifiers:
nickudon:alias
nickudon:alias_stripped
nickudon:prefix
nickudon:chat
nickudon:display
nickudon:display_no_prefix
nickudon:name
Use them with the syntax supported by the installed Patbox Text Placeholder API version.
评论 0
登录后参与评分
还没有评论,来抢沙发吧