WiFlow的记分板 | 动画与条件

 

动态计分板，对所有事件做出反应。 页面轮播、按配置文件的标志、自动调整大小、条件渲染、动画文本，以及深度 WiFlowPlaceholderAPI 集成。基于区域、基于等级、基于派系，或你能想象的任何其他方式。

---

杀手级功能：WiFlow 的 PlaceholderAPI 集成

任何拥有 WiFlowPlaceholderAPI 扩展的插件都可以控制玩家看到的计分板。

安装一个扩展，将其作为条件使用即可。

/wpapi ecloud download orbisguard
/wpapi ecloud download luckperms
/wpapi ecloud download hyfaction

现在，你的计分板可以对所有事件做出反应：

• 玩家进入出生点 → 显示带有欢迎信息和出生点标志的出生点计分板
• 玩家加入一个派系 → 显示带有能量/成员信息的派系计分板
• 玩家升级到 VIP → 显示带有独占标志和特权的 VIP 计分板
• 玩家进入战斗 → 显示带有计时器的战斗计分板
• 玩家进入矿场 → 显示带有重置计时器的采矿计分板

{
  "profiles": [
    {
      "condition": "orbisguard_region",
      "equals": "spawn",
      "logo": { "image": "spawn_logo.png" },
      "title": { "text": "[#55ff55]SPAWN" },
      "lines": { "content": ["Welcome to Spawn!", "You are safe here!"] }
    },
    {
      "condition": "luckperms_primary_group",
      "equals": "vip",
      "logo": { "image": "vip_logo.png" },
      "lines": { "content": ["[#ffaa00]VIP Member", "Exclusive perks active!"] }
    },
    {
      "condition": "hyfaction_name",
      "notEquals": "",
      "lines": { "content": ["Faction: {hyfaction_name}", "Power: {hyfaction_power}"] }
    },
    {
      "isDefault": true,
      "pages": [
        { "duration": 5.0, "lines": { "content": ["Player: {player}", "Online: {online}"] } },
        { "duration": 4.0, "title": { "text": "Stats" }, "lines": { "content": ["Playtime: {playtime}", "TPS: {tps}"] } }
      ]
    }
  ]
}

整个扩展生态系统都可以作为条件使用：

扩展	示例条件	用例
OrbisGuard	orbisguard_region	区域特定的计分板
LuckPerms	luckperms_primary_group	基于等级的计分板
HyFaction	hyfaction_name	派系成员计分板
CombatLog	combatlog_active	战斗警告计分板
OrbisMines	orbismines_name	采矿计分板
SimpleClaims	simpleclaims_is_claimed	已认领 vs 野外
Economy	economy_balance	基于财富的计分板

如果存在占位符，你就可以用它来切换计分板。

---

功能

• 页面轮播 - 每个配置文件可有多个页面，自动循环，时长和每页标题可配置。
• 按配置文件的标志 - 每个配置文件使用不同的标志，放置在 mods/WiFlowScoreboard/images/ 目录中。
• 自动调整大小 - 宽度和高度根据可见内容自动调整。
• 游戏内编辑器 - 使用 /sb edit 命令编辑世界、配置文件、页面和文本行。
• 条件配置文件 - 根据任意占位符的值切换计分板。
• 条件文本 - 使用 9 种比较运算符显示/隐藏单行文本。
• 动画文本 - 彩虹、渐变、脉冲、闪烁、呼吸、发光、频闪以及自定义动画。
• 位置预设 - 9 个位置：中右、左上、底部居中等等。
• 世界特定计分板 - 每个世界可使用不同的计分板。
• 权限变体 - 当没有占位符匹配时，回退到权限检查。
• 内置占位符 - 玩家信息、服务器状态、游玩时间、TPS。
• 游玩时间追踪 - 会话游玩时间和总游玩时间（重启后持续存在）。
• 热重载 - 无需重启即可更改配置（使用 /sb reload）。

---

页面轮播

为任意配置文件添加多个页面。每个页面有自己的内容，并可以覆盖标题：

"pages": [
  {
    "duration": 5.0,
    "lines": { "content": ["Player: {player}", "World: {world}"] }
  },
  {
    "duration": 4.0,
    "title": { "show": true, "text": "Stats" },
    "lines": { "content": ["Playtime: {playtime}", "TPS: {tps}"] }
 }
]

页面会自动轮播。当存在 pages 字段时，它会替换配置文件的 lines 字段。

---

自定义标志

将图片放置在 mods/WiFlowScoreboard/images/ 目录中，并通过文件名引用：

"logo": {
  "show": true,
  "image": "my_logo.png",
  "width": 240,
  "height": 137
}

每个配置文件可以通过自己的 "logo": { "image": "vip_logo.png" } 字段覆盖标志。按配置文件的字段会与顶层字段合并 —— 你只需要设置想要更改的部分。

---

条件文本

根据单个计分板内的占位符值显示不同的内容：

{
  "condition": "{orbisguard_flag_pvp}",
  "equals": "allow",
  "then": "[#ff5555]PVP ENABLED",
  "else": "[#55ff55]Safe Zone"
}

提示： 省略 else 字段可以在条件为假时完全隐藏该行。与自动高度调整配合使用效果极佳。

支持的比较运算符：equals, notEquals, contains, startsWith, endsWith, greaterThan, lessThan, greaterThanOrEquals, lessThanOrEquals

---

自动调整大小

计分板会根据可见内容自动调整其宽度和高度：

"size": {
  "autoHeight": true,
  "autoWidth": true,
  "minWidth": 200,
  "maxWidth": 500
}

当条件行隐藏时，面板会缩小。当长占位符展开时，宽度会增加。完全可配置，具有最小/最大界限。

---

内置占位符

以下占位符无需 WiFlowPlaceholderAPI 即可直接使用：

占位符	描述
{player}	玩家显示名称
{world}	当前世界名称
{online}	在线玩家数量
{max_players}	服务器最大玩家数
{server}	服务器名称
{tps}	服务器 TPS
{playtime}	本次会话游玩时间
{playtime_total}	总游玩时间（全部会话）

---

动画

为任意文本行添加动画效果：

[anim:rainbow]Welcome to the server!
[anim:gradient:#ff0000:#0000ff]Red to Blue
[anim:pulse:#ffffff:#ffaa00]Pulsing gold

动画	描述
rainbow	全光谱颜色循环
gradient	颜色间的平滑过渡
pulse	两种颜色间淡入淡出
colors	自定义颜色序列
shimmer	随机闪烁效果
breathe	缓慢的亮度淡入淡出
glow	脉动光芒效果
strobe	快速闪烁效果
typewriter	逐个字符显示
scroll	水平滚动字幕
custom:name	从 animations/name.json 文件加载

---

快速开始

1. 将 JAR 文件放入你的 mods/ 文件夹。
2. 安装 WiFlowPlaceholderAPI（可选，用于扩展占位符）。
3. 下载扩展：/wpapi ecloud download <名称>。
4. 编辑 mods/WiFlowScoreboard/scoreboards/ 中的文件。
5. 将标志放置在 mods/WiFlowScoreboard/images/ 中。
6. 使用 /sb reload 应用更改。

mods/WiFlowScoreboard/
├── config.json              # 全局设置
├── playtime.json            # 持久化游玩时间数据
├── scoreboards/
│   └── default.json         # 计分板配置文件
├── images/                  # 自定义标志 (PNG, JPG)
└── animations/
    └── custom.json          # 自定义动画

---

命令

命令	描述
/sb reload	重新加载所有配置
/sb hide	隐藏你的计分板
/sb show	显示你的计分板
/sb edit	打开游戏内编辑器
/sb set <索引> <文本>	设置一行文本
/sb add <文本>	添加一行文本
/sb remove <索引>	移除一行文本
/sb save	将更改保存到磁盘
/sb list worlds	列出已加载的配置
/sb list profiles	列出配置文件
/sb list lines	列出文本行
/sb list pages	列出页面

别名：/scoreboard, /wsb

---

需要帮助？

加入 Discord 服务器 以便：

• 获得设置帮助和解答疑问
• 获取配置示例
• 提出功能请求
• 报告 Bug

联系方式：w1fl0w （Discord 上）