
README 语言 [ 中文 | English ]
UserPrefix 插件
轻量、高效且实时的用户前缀系统。
本插件基于 Spigot 实现,理论上支持所有 Minecraft 版本。
本插件的开发初衷是以中文为基础,旨在帮助中文开发者学习 Bukkit 插件开发。
本插件已发布在 SpigotMC 。
本插件已在 MCBBS 上发布,欢迎中文用户来这里下载。
示例

依赖
- [必需] 基于 Spigot-API 和 BukkitAPI 开发的插件。
- [必需] 插件数据存储基于 LuckPerms。
- [推荐] 占位符基于 PlaceholderAPI。
关于开发依赖项,请参阅 Dependencies 。
功能
- 理论上支持所有 Minecraft 版本。
- 重新加载配置将自动刷新所有玩家的前缀。
- 权限变更时实时判断并反馈给玩家。
- 可配置音效和消息。
- 前缀图标可配置为“已选择”、“拥有权限”和“无权限”。
- TabList 根据前缀权重自动排序(如有冲突,可关闭此功能)。
- 玩家名称上的前缀显示(如有冲突,可关闭此功能)。
- 支持简易聊天格式占位符。(不推荐)
- 带有自动排序和翻页功能的 GUI!
- 支持 PlaceholderAPI 变量!
- 支持 Hex Color!(1.16 及以上版本)
&(#Color)- 示例:LightSlateBlue
&(#8470FF)、 DarkSlateBlue&(#483D8B)
- 示例:LightSlateBlue
注意事项
1. 版本支持问题
该插件理论上支持所有版本。
如果图标未加载、声音无法播放等,请检查配置文件中的物品类型和声音类型在当前版本中是否存在。
以 SOUND 为例,村民说“好的”的声音在低版本中是 "VILLAGER_YES",而在高版本中变为 "ENTITY_VILLAGER_YES"。
2. Scoreboard 异常问题
头部的前缀显示和 TabList 的排序均使用 scoreboard API。
如果存在冲突,请在配置文件中关闭 functions.on-name-prefix。
命令
本插件的命令基于中文! 未来可能支持多语言。
/UserPrefix 或 /prefix # 打开前缀 GUI
/UserPrefixAdmin # 查看管理员命令帮助
/UserPrefixAdmin reload # 重新加载配置
/UserPrefixAdmin list # 列出所有配置的前缀。
占位符 (PlaceholderAPI)
安装 PlaceholderAPI 后,你可以输入 /papi info UserPrefix 查看所有占位符。
# %UserPrefix_prefix%
- 获取当前前缀的内容
# %UserPrefix_weight%
- 获取当前前缀的权重。
# %UserPrefix_identifier%
- 获取当前前缀的标识符。
# %UserPrefix_name%
- 获取当前前缀的名称。
# %UserPrefix_has_<Identifier>%
- 判断玩家是否拥有某个前缀(true/false)
配置文件
插件配置 (config.yml .
首次启动时将生成。
消息配置 (messages.yml)
首次启动时将生成。
前缀配置(prefixes/*.yml)
所有前缀均为独立的配置文件,存储于 <数据文件夹>/prefixes/ 中,便于管理。
文件名中的某些符号可能会影响读取,请避免使用它们。
支持与捐赠
本项目由 YourCraft(你的世界) 提供支持。

开源协议
本项目的源代码采用 GNU 通用公共许可证 v3.0。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧