QuickBoard - Free Scoreboard Plugin - QuickBoard - 动态记分板插件

QuickBoard 是一款独特的计分板插件，它能在单行内显示最多 32 个字符（Spigot 1.13 及以上版本支持最多 128 个字符），并支持颜色代码，且完全无闪烁。它运行流畅，资源占用极低，并提供了滚动文本、可变文本、动画标题等强大功能。

💡核心特性

• 无闪烁显示：即使在 1 刻（tick）的更新频率下也能实现无闪烁更新。
• 单行长字符：支持单行最多 32 个字符（Spigot 1.13+ 支持 128 个字符）。
• 滚动文本：支持创建水平滚动的动态文字。
• 可变文本：支持在计分板中轮换显示多组文本。
• 动画标题：支持标题的动画效果。
• 按权限分配：可为不同权限组的玩家显示不同的计分板。
• 按世界启用：可指定计分板在哪些世界显示。
• 自定义更新频率：可为每个计分板单独设置标题和文本的更新速度。
• 低资源消耗：启用所有功能时 CPU 占用率仅约 0.5%。
• 开源：插件代码完全开源。
• 简易 API：提供简单易用的开发者 API。

占位符支持

• 支持 PlaceholderAPI（超过 1500 个占位符）。
• 支持 MVdWPlaceholderAPI。

❓兼容性说明

版本与字符限制

• 对于 1.13 及以上版本的服务器（原生或通过 ViaVersion 等实现），单行最多支持 128 个字符。
• 对于 低于 1.13 的版本，由于 Minecraft 本身的限制，单行最多只能显示 32 个字符。

重要提示

如果你的计分板行内容超过 32 个字符（包含所有颜色代码和占位符），并且有玩家通过 ViaVersion 以低于 1.13 的客户端版本加入服务器，他们的计分板显示将被截断。这是低版本客户端的硬性限制，无法修复。

占位符故障排除

如果 PlaceholderAPI 的占位符不工作，请尝试在服务器控制台执行以下命令下载并安装对应的扩展：

/papi ecloud download <扩展名>

例如，安装 Vault 扩展

/papi ecloud download vault

安装后请重启服务器。

🔧快速开始教程

创建权限计分板

• 在服务器插件目录的 /QuickBoard/scoreboards/ 文件夹内创建一个新的 YAML 文件。
• 文件命名格式为 scoreboard.权限名.yml。例如，创建一个默认计分板：scoreboard.default.yml。
• 在文件中配置你的计分板内容（标题、文本、滚动效果等）。下方提供了一个详细的配置示例。
• 保存文件，并在游戏内或控制台执行 /qb reload 重载插件。
• 给予玩家对应的权限（例如 scoreboard.default），当玩家处于配置中指定的世界时，计分板就会显示。

配置示例说明

以下是一个配置文件的精简示例，展示了主要结构

# 计分板动画标题列表，插件会按顺序轮播
title:
- '&f&l-= &c&lFree scoreboard system&f&l =-'
- '&f&l-= &c&lFree scoreboard syste&f&l =-'
# ... 更多标题帧

# 计分板显示的文本行
text:
- ''
- '&eMay the force be with'
- '&6&l{PLAYER}!'
- ''
- '&2Edit this scoreboard in'
- '&2scoreboards folder!'
- ''
- '{SC_info}' # 滚动文本占位符
- ''
- '&aPermission for this scoreboard:'
- '{CH_perm_info}' # 可变文本占位符
- ''
- '&aRunning on &6&lQuickBoard'

# 更新速度（单位：刻，20刻=1秒）
updater:
  title: 3
  text: 5

# 计分板生效的世界列表
enabledWorlds:
- world
- Lobby

# 可变文本定义
changeableText:
  perm_info:
    text:
    - '&cscoreboard.default'
    - '&7scoreboard.default'
    interval: 10 # 文本轮换间隔（刻）

# 滚动文本定义
scroller:
  info:
    text: '&eThis server is running on &e&lQuickBoard! &c&lbest free scoreboard system!'
    width: 28    # 显示窗口宽度（字符数）
    spaceBetween: 4 # 文本循环间的空格数
    update: 2    # 滚动更新速度（刻）

如何添加可变文本

可变文本允许几行文字在同一个位置轮流显示。

• 在 changeableText: 部分下添加一个新的 ID，例如 healthloc:。
• 在 text: 列表下填写要轮换显示的文本行，支持使用占位符。
• 设置 interval: 来定义轮换间隔（单位：刻）。
• 在计分板的 text: 部分中，使用 {CH_ID} 格式（例如 {CH_healthloc}）来引用这个可变文本。

示例配置片段

changeableText:
  healthloc:
    text:
    - '&aHealth: &c%player_health% &lHP'
    - '&aLoc: &e%player_x% %player_y% %player_z%'
    - '&aJoined &e%player_first_join_date%'
    interval: 60

🎮命令列表

• /quickboard 或 /qb - 显示主帮助信息。
• /quickboard cmds - 查看所有命令。
• /quickboard toggle - 开关你自己的计分板显示。
• /quickboard reload - 重载插件配置（需权限 quickboard.reload）。
• /quickboard set <玩家名> <权限名> - 为指定玩家设置特定的计分板（需权限 quickboard.set）。例如：/qb set Notch scoreboard.vip

⭐开发者 API

QuickBoard 提供了简单的事件和 API 供其他插件集成。

PlayerReceiveBoardEvent

当玩家即将收到计分板时触发，可用于动态修改内容或取消发送。

@EventHandler
public void onBoard(PlayerReceiveBoardEvent e){
    Player p = e.getPlayer();
    e.isCancelled(); // 检查操作是否被取消
    e.setCancelled(true); // 取消发送计分板
    e.getText(); // 获取当前文本列表
    e.getTitle(); // 获取当前标题列表
    e.setText(List<String> text); // 动态设置文本
    e.setTitle(List<String> title); // 动态设置标题
    e.getBoard(); // 获取 Board 对象
    // 动态创建一个新的计分板并设置
    e.setBoard(QuickBoardAPI.createBoard(p, textList, titleList));
}

WhenPluginUpdateTextEvent

当插件更新计分板文本时触发。

可用方法：setText, getText, getPlayer。

QuickBoardAPI 工具类

// 创建一个计分板
QuickBoardAPI.createBoard(Player, String name);
QuickBoardAPI.createBoard(Player, List<String> text, List<String> title, int updateTitle, int updateText);

// 获取所有已存在的计分板
QuickBoardAPI.getBoards();

// 移除指定玩家的计分板
QuickBoardAPI.removeBoard(Player);

// 更新指定玩家的计分板文本、标题或全部
QuickBoardAPI.updateText(Player);
QuickBoardAPI.updateTitle(Player);
QuickBoardAPI.updateAll(Player);

✨支持与捐赠

如果你喜欢这个插件，可以考虑通过 [点击这里] 进行捐赠以支持开发者。

捐赠者名单：

• @gmalone - 15 EUR
• @unsivilaudio - 15 EUR

需要帮助？

请通过 Discord 联系开发者。