LuckTAB

插件

· 作者 LucasTHCR

基于 LuckPerms 的标签页列表、聊天和记分板,带有动态渐变效果。

0 本站下载 0 关注 更新于 2 周前

需要前置:LuckPerms

最新 2.9.0-RELEASE · 26.3 · Bukkit / Folia

一键开服(送7天)

Built with Java 21 Available for Paper Available for Purpur Available for Folia Available for Spigot Available for Bukkit

Chat with us on Discord Available on Codeberg

LuckTAB

选项卡列表、名称标签、侧边栏和聊天格式,均由玩家所在的 LuckPerms 组驱动。一个 config.yml 决定每个等级的外观,插件会将该前缀同时应用到各个位置:头顶上方、选项卡列表中、聊天消息前方以及侧边栏中。

颜色支持旧版代码、十六进制色值或自动流动的渐变动画。页眉、页脚和侧边栏可根据世界和权限进行区分;玩家可以关闭自己的侧边栏;内容为空的行会自动隐藏。通过 Geyser 加入的基岩版玩家会获得稳定的侧边栏,而不会出现闪烁现象。在页眉、页脚和行中可以使用 :star: 等图标,这些图标也可以直接来自你的资源包。

完整文档请参阅 wiki。

要求

  • Minecraft 1.21+ 上的 Paper 或 Spigot
  • Java 21
  • LuckPerms(必需)
  • PlaceholderAPI(可选)
  • ProtocolLib(可选,仅用于选项卡列表中的静态信息行)
  • EssentialsX、CMI 或 Purpur(可选,用于 AFK 标签)
  • Geyser 或 Floodgate(可选,用于基岩版玩家)

在 Paper 上,侧边栏通过组件渲染,因此每一行都支持十六进制色值和渐变。在 Spigot 上,侧边栏回退到旧版颜色;其他功能完全相同。

基岩版与 Geyser

基岩版玩家通过 Floodgate 或 Geyser API 识别,无需额外配置。Geyser 会在每次收到更改时重建整个基岩版侧边栏,并且在每秒超过 20 个记分板数据包时会开始限流。因此,LuckTAB 仅发送实际发生变化的内容,并为基岩版玩家提供独立的、较慢的更新速率:

bedrock:
  enabled: true
  update-interval: 20
  animations: false
  fake-entries: false

当设置 animations: false 时,渐变色和 %anim_...% 对基岩版玩家而言将保持在第一帧。由于基岩版无法显示选项卡列表的页眉和页脚,因此不会向这些玩家发送相关内容。带有 platform: bedrock 的侧边栏或页眉/页脚设计仅针对基岩版玩家使用,这为更窄的基岩版侧边栏留出了更短行的空间。

图标

在任何 LuckTAB 行或 LuckPerms 的前缀/后缀中写入 :name:,它就会变成符号。在 LuckTAB 行内使用 %lucktab_icon_name% 也能实现相同效果。没有对应图标的名称保持原样。

icons:
  star: "&e★"
  crown: "&6♛"
  # rank_owner: "\uE001"   # 资源包字形

启用 icons-auto 后,LuckTAB 也会自动读取你资源包中的字形。图片名称即为图标名称,例如 rank_owner.png 变为 :rank_owner:。它使用 server.properties 中指定的资源包,或者你设置的 pack(URL、zip 文件或文件夹)。只有包含恰好一个字符的图片才有效。自定义 icons 部分中的图标优先级高于资源包中的图标。

安装 ItemsAdder 后,其字体图片可作为 :name: 使用;安装 Nexo 或 Oraxen 时,则使用其字形 ID。

命令

命令 描述 权限
/lucktab reload 重载 config.yml 并重建所有显示 lucktab.reload
/lucktab toggle, /sidebar, /sb 显示或隐藏你自己的侧边栏,重连后仍保留状态 lucktab.toggle
/lucktab setprefix <group> <prefix> 在游戏中修改等级前缀并重载 lucktab.edit
/lucktab setsuffix <group> <suffix> 在游戏中修改等级后缀并重载 lucktab.edit
/lucktab benchmark 查看各部分的更新耗时(微秒) lucktab.benchmark
/lucktab migrate to-luckperms 将配置的前缀写入 LuckPerms 组 lucktab.migrate
/lucktab migrate from-luckperms 将所有 LuckPerms 组的前缀读回配置文件 lucktab.migrate

所有权限默认授予 OP,除了 lucktab.toggle,所有玩家均拥有该权限。

setprefix 和 setsuffix 通过 Bukkit 保存 config.yml,这会丢失其中的注释。切换命令的别名是可配置的,并在启动时注册,因此更改它需要重启服务器而非重载。

配置

当新版本添加新选项时,它们会在下次启动时写入现有的 config.yml 中,并附带注释。您的原有值保持不变,旧文件会被保留为 config.yml.bak。

每个等级占一行,按照它们在标签页列表中应出现的顺序排列。最上面的是最高等级:

prefixes:
  - "owner;<gradient:#FF0000:#FF7700>[Owner] </gradient>;;&#FF7700"
  - "admin;&#FF5555[Admin] &7;;&#FF5555"
  - "vip;&6[VIP] &7;;&6"
  - "default;&7[Player] &7;;&7"

格式为 luckperms_group;prefix;suffix;namecolor。未列入任何组的玩家将获得最后一项的设置。

prefix-source 决定前缀的来源。设置为 lucktab 时,前缀从上述配置中读取;设置为 luckperms 时,前缀和后缀来自 LuckPerms 中的组元数据(group meta),仅排序顺序和名称颜色由配置决定。两个 migrate 命令用于在两者之间迁移数据,因此切换无需重新输入所有内容。

header-footer 和 scoreboard 各自包含一个 designs 部分。以世界命名的部分仅在该世界中生效,其他情况回退到 default。设计也可以通过权限选择自身,例如员工板(staff board)与玩家板(player board)并存时需要此功能,或通过 platform: bedrock / platform: java 进行选择:

scoreboard:
  designs:
    staff:
      permission: lucktab.staff
      priority: 10
      title: "&c&lStaff"
      lines:
        - "&7TPS: &f%server_tps_1%"

如果某行的所有占位符均返回空值、0 或 null,则该行为被删除而不是留下空白间隙,因此对于没有加入战队的玩家,&7Clan: &f%clan_name% 将完全不存在。空的间隔行始终保留。

animations 包含命名帧列表,%anim_<name>% 可在允许占位符的任何位置打印当前帧。标题和页脚设计可以使用 frames 代替固定的单一区块,并在其中循环播放。

颜色

语法 示例
传统色 &a, &l, &r
十六进制色 &#FF5555
渐变色 <gradient:#FF0000:#FF7700>text</gradient>

渐变色具有动画效果:每两刻钟颜色波浪会轻微偏移,从而使前缀在其范围内缓慢循环变化。

占位符

占位符 含义
%player% 玩家名称
%world% 当前世界
%server_online% 在线玩家数量
%server_max_players% 最大槽位数
%player_ping% 延迟数值(纯数字)
%lucktab_ping_colored% 延迟,根据 ping-colors 中的阈值显示绿色/黄色/红色
%lucktab_rank% / %lucktab_prefix% 等级前缀
%lucktab_suffix% 等级后缀
%lucktab_color% 等级的名称颜色
%lucktab_rank_display% 前缀、颜色、组名和后缀组合在一起
%lucktab_ping_icon% 来自 ping-icons 部分的延迟图标
%lucktab_icon_<name>% 来自 icons 部分或资源包的图标,仅限在 LuckTAB 的行和前缀中使用(:name: 也可用)
%lucktab_tps% 服务器 TPS,保留一位小数(Paper 支持,Spigot 上显示 -)
%lucktab_tps_colored% TPS,19 以上为绿色,15 以上为黄色,低于 15 为红色
%lucktab_mspt% 每刻平均毫秒数(Paper 支持)
%lucktab_afk% AFK 标记,玩家活跃时为空
%lucktab_badges% 玩家所在所有组的徽章
%lucktab_platform% Geyser/Floodgate 玩家显示 Bedrock,否则显示 Java
%anim_<name>% 动画的当前帧
%chatPrefix% / %chatSuffix% / %chatBadges% / %playerName% / %message% 仅限聊天格式使用

安装 PlaceholderAPI 后,其占位符也可在 LuckTAB 的所有文本中使用。作为回报,LuckTAB 注册了自己的扩展,以便其他插件可以读取 %lucktab_prefix%、%lucktab_rank_display%、%lucktab_badges% 等;追加 _plain 可获取无颜色的版本。这也是 DiscordSRV 获取等级信息用于其聊天桥接的方式:将该占位符放入 DiscordSRV 的消息格式中。

构建

mvn clean package

生成的 jar 包位于 target/LuckTAB-<version>.jar。bStats 已被阴影化并重定位至 de.empireblocks.luckTAB.metrics;paper-api、LuckPerms API 和 PlaceholderAPI 均为 provided 依赖,不会包含在 jar 包中。

许可证

GNU General Public License v3.0。详见 LICENSE。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源