Custom Scoreboard - 动态计分板

自定义动画

通过 Scoreboards 插件，你可以轻松创建动态变化的文本动画，用于计分板、Tab 列表或 Boss 血条。动画由一系列按顺序显示的文本帧构成，并支持使用 PlaceholderAPI 变量。

💡创建动画

动画在 Scoreboards.yml 配置文件中的 animations: 部分定义。每个动画都需要一个唯一的名称和一组配置参数。

配置示例

以下是一个名为 YourServerIP 的动画配置示例，它实现了“YourServerIP”一词的逐字出现与消失效果：

animations:
  YourServerIP: # 动画的名称
    change-interval: 200 # 文本切换的间隔时间，单位为毫秒 (ms)
    texts: # 动画的文本帧序列
    - "§7Y_"
    - "§7Yo_"
    - "§7You_"
    - "§7Your_"
    - "§7YourS_"
    - "§7YourSe_"
    - "§7YourSer_"
    - "§7YourServ_"
    - "§7YourServe_"
    - "§7YourServer_"
    - "§7YourServerI_"
    - "§7YourServerIP_"
    - "§7YourServerI_"
    - "§7YourServe_"
    - "§7YourServ_"
    - "§7YourSer_"
    - "§7YourSe_"
    - "§7YourS_"
    - "§7Your_"
    - "§7You_"
    - "§7Yo_"
    - "§7Y_"

参数说明

• 动画名称：例如 YourServerIP，用于在计分板等配置中调用。
• change-interval：每帧文本显示的持续时间。200 表示每 0.2 秒切换一次文本。
• texts：一个按顺序排列的文本列表。插件会循环播放这些文本帧。

🎮在计分板中使用动画

创建动画后，你可以在计分板的任意一行中使用它，调用格式为 %animation:动画名称%。

计分板配置示例

以下 Scoreboards.yml 中的计分板配置示例，展示了如何在侧边栏中集成玩家信息、服务器状态以及自定义动画。

ExampleSidebar: # 计分板ID，玩家加入服务器时默认获得此计分板
  title: "§7§lYour§6§lServer" # 计分板标题
  updatetime: 40 # 计分板整体刷新频率，20 tick = 1秒
  rows: # 计分板行内容
  - '§7§m+----------------+'
  - '§7» §6§lPlayer'
  - '    §7%player%'
  - ''
  - '§7» §6§lHealth'
  - '    §c%hearts%'
  - ''
  - '§7» §6§lWorld'
  - '    §7%world%'
  - ''
  - '§7» §6§lOnline Players'
  - '    §7%online% §6players'
  - ''
  - '§7» §6§lServer IP'
  - '    §7%animation:YourServerIP%' # 在此处调用自定义动画
  - '§7§m+----------------+'

✨支持的变量 (Placeholder)

你可以在动画文本 (texts) 或计分板行中直接使用以下 PlaceholderAPI 变量，使内容动态化：

• %gamemode% - 玩家游戏模式
• %level% - 玩家等级
• %hearts% - 玩家生命值（心形图标）
• %maxhealth% - 玩家最大生命值
• %health% - 玩家当前生命值（数值）
• %displayname% - 玩家显示名称
• %player% - 玩家名
• %maxplayers% - 服务器最大玩家数
• %world% - 玩家所在世界名称
• %onworld% - 玩家所在世界名称（另一种格式）
• %online% - 服务器在线玩家数

使用示例

在动画文本中结合变量

texts:
- "§a欢迎，%player%！"
- "§e你的等级：%level%"

🔧使用步骤

• 编辑 plugins/Scoreboards/Scoreboards.yml 文件。
• 在 animations: 部分下，按照格式创建你的动画。
• 在 scoreboards: 部分下的任意计分板配置中，通过 %animation:你的动画名% 调用它。
• 保存文件，并在游戏内使用 /sb reload 重载插件配置。