LuckTAB

插件

· 作者 LucasTHCR

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

0 本站下载 0 关注 更新于 20 小时前

需要前置:LuckPerms

最新 3.0.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。

侧边栏分页

侧边栏设计可以依次显示多个页面。每个页面替换相应的行,并可以设置自己的标题和编号。page-interval(以刻为单位)决定每个页面的停留时间。

lobby:
  title: "&6&lMyServer"
  page-interval: 200
  pages:
    - lines: ["", "&7Rank: %lucktab_rank%", "&7Online: &f%server_online%", ""]
    - title: "&b&lStats"
      lines: ["", "&7Ping: %lucktab_ping_colored%", "&7TPS: %lucktab_tps_colored%", ""]

在 Folia 上,如果安装了 ProtocolLib,侧边栏会通过数据包发送,使用相同的设计、分页以及 /sidebar 切换命令。在 Folia 上,名称标签及名称下方的文本处于禁用状态。

更新

配置中的 auto-update: true 会将新版本下载至更新文件夹,并在下次重启时应用。默认情况下此功能处于关闭状态。发布版构建仅跟随正式版本更新。

命令

命令 描述 权限
/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 icons 列出可用的图标 lucktab.icons
/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 中的组元数据,仅排序顺序和名称颜色保留在配置中。两个 migrate 命令可以在两者之间迁移数据,因此切换来源不需要重新输入所有内容。

header-footer 和 scoreboard 各自包含一个 designs 部分。以世界命名的部分仅在该世界中生效,其他情况则回退到 default。设计也可以通过权限来选择自身,这是员工板与玩家板并存时所需的功能,或者通过 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
Hex 色码 &#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 以上为黄色,以下为红色
%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
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源