原创 开源 工具 TabNamePrefix - 一款轻量的Tab栏名称前后缀自定义插件 v2.0.1

[MD] # TabNamePrefix [](https://github.com/CGSuperNova/TabNamePrefix/releases) [](LICENSE) [](https://papermc.io/) 在 Tab（玩家列表）中为不同权限组 / 权限节点的玩家显示可配置的前缀与后缀。 本插件在Github上开源：[TabNamePrefix Github](https://github.com/CGSuperNova/TabNamePrefix) ## 具体功能 当装载本插件后，你将可以配置玩家在Tab栏中显示的名称的前缀和后缀，支持分权限组和变量显示。 ## 安装 1. 将 `TabNamePrefix-x.x.x.jar` 放入服务端的 `plugins/` 目录。 2. 启动服务器,插件会生成 `plugins/TabNamePrefix/config.yml`。 3. 修改配置后执行 `/tabnameprefix reload` 重载。 ## 可选依赖(均为软依赖,未安装时会自动降级): - [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/): 解析 `%变量%`; - [LuckPerms](https://luckperms.net/): 按权限组匹配。 ## 配置 ```yaml # ============================================================ # TabNamePrefix 配置文件 # # 功能: 为 Tab 列表中的玩家名添加「前缀 + 玩家名 + 后缀」 # 示例: # 原版显示: PlayerName # 配置后: [VIP] PlayerName # ============================================================ # 总开关,设为 false 时插件不会修改任何玩家的 Tab 名称 enabled: true settings: # Tab 名称刷新间隔(单位:tick,20 tick = 1 秒) # 用于定期更新 PlaceholderAPI 变量(例如动画变量)以及权限组变动 # 若设为 0,则只在玩家进服 / 执行 reload 时刷新一次 refresh-interval-ticks: 20 # 当无法通过 LuckPerms 获取权限组(未安装 LuckPerms)时, # 插件会检测玩家是否拥有「此前缀 + 条目里填写的权限组名」的权限节点, # 例如将 tabnameprefix.group.vip 权限授予 VIP 组即可命中下方 vip 条目。 # 这样即使不装 LuckPerms,也能通过任意权限插件按组区分。 group-node-prefix: "tabnameprefix.group." # ============================================================ # 条目列表(从上到下依次解析) # # 每个条目的「匹配方式」(满足任一即视为匹配): # group: 玩家在 LuckPerms 中的权限组名(含继承的组,需安装 LuckPerms) # groups: 同 group,支持同时填写多个权限组名(列表) # permission: 玩家拥有该权限节点 # -> 如果以上都不填写,该条目作为「默认/兜底」条目,对所有未匹配玩家生效 # # 当多个条目同时匹配时: # 1. priority 数值越大越优先(可选,默认 0) # 2. 数值相同时,配置文件中位置越靠上越优先 # 因此建议把最高级的组放在最上面,默认条目放在最下面。 # # prefix / suffix 支持: # 颜色代码: &0-&9 &a-&f &k &l &m &n &o &r # 十六进制: &#RRGGBB (如 &#FF5555),也兼容 &x&F&F&5&5&5&5 写法 # 变量: PlaceholderAPI 占位符,如 %player_name% %luckperms_prefix% # (需安装 PlaceholderAPI,未安装时占位符会原样显示) # # 注意: prefix / suffix 与玩家名之间不会自动添加空格,需要时请自行在末尾/开头加空格。 # ============================================================ entries: # ---------- 示例:服主 ---------- owner: group: owner prefix: "&#FF5555[服主] &f" suffix: "" # ---------- 示例:管理员 ---------- admin: groups: - admin - helper prefix: "&c[管理] &f" suffix: "&7" # ---------- 示例:VIP(多个组 + 权限节点混用) ---------- vip: groups: - vip - mvip permission: "tabnameprefix.vip" prefix: "&#55FF55[VIP] &f" suffix: "" # ---------- 示例:纯权限节点匹配(不依赖 LuckPerms) ---------- donor: permission: "tabnameprefix.donor" prefix: "&b[赞助] &f" suffix: "" # ---------- 默认:任何条目都未匹配时生效 ---------- default: prefix: "&7" suffix: "&r" ``` - 匹配条件:`group` / `groups` / `permission`,满足任意一个即可命中; - 多个条目同时命中时,`priority` 大者优先,相同时配置靠前者优先; - 不填写任何匹配条件的条目作为默认显示内容; - `prefix` / `suffix` 支持 `&0`~`&f`、`&k`~`&r` 颜色代码、`&#RRGGBB` 十六进制颜色, 以及 PlaceholderAPI 变量。 ## 命令与权限 | 命令 | 说明 | 权限 | | --- | --- | --- | | `/tabnameprefix`(`/tabp`、`/tnp`) | 查看插件信息 | - | | `/tabnameprefix reload` | 重载配置并重新应用 | `tabnameprefix.reload`(默认 OP) |  [/MD]