ScrollBoard - 滚动记分板

💡重要声明

本插件已停止维护，不再提供支持或错误修复。代码已在 GitHub 开源，可供参考。插件本身功能依然完整可用，但请注意：请勿安装 PyrCore 6.0.0 及以上版本。感谢大家一直以来的支持！

厌倦了传统记分板只有15行的限制吗？是否曾因空间不足而不得不切换多个记分板或精简信息？ScrollBoard 正是为你而来。只需一个简单的滚轮、一次点击或一个按键，记分板的内容即可滚动显示。你可以创建任意数量的行，按需定制，为不同世界或玩家设置不同的滚动板，支持 MySQL 数据库……欢迎随时提出改进建议！

🎮核心特性

• 无限行数：为每个滚动板创建任意数量的行。
• 长内容支持：每行最多可容纳 48 个字符。
• 多种滚动方式（均可配置）：

- 使用鼠标滚轮滚动。

- 使用跳跃/潜行键滚动。

- 使用左键/右键点击滚动。

• 高度可配置：

- 可设置服务器默认的滚动板。

- 可为每个世界单独配置滚动板（将覆盖默认设置）。

- 可为玩家单独分配滚动板（支持 MySQL 或本地存储）。

• 占位符支持：兼容 PyrCore 和 PlaceholderAPI 的占位符。
• 版本兼容：支持 Spigot 1.8.8 至 1.11 版本（1.12.2 与 1.13.2 也可能兼容，但未经完全保证）。

🔧安装与要求

运行环境

• 服务端：Spigot 1.8.8, 1.9.4, 1.10.2, 1.11.2, 1.12.2 或 1.13.2（其他版本如 Paper 等可能可用，但不保证）。
• Java：Java 7 或更高版本。
• 依赖：需要安装最新版本的 PyrCore。

注意事项

• 如果你卸载了本插件后，记分板显示异常，请在游戏内执行命令：/scoreboard objectives setdisplay sidebar 来重置显示。

✨命令与权限

• /scrollboard reload

- **权限**：`scrollboard.admin`

- **描述**：重载插件配置。

• /scrollboard assign|set --player|p [玩家名] --scrollboard [滚动板ID]

- **权限**：`scrollboard.admin`

- **描述**：为指定玩家分配一个滚动板。

- **参数说明**：

- `[玩家名]`：目标玩家的游戏ID。

- `[滚动板ID]`：配置文件中定义的滚动板ID。可替换为 `{default}` 以使用默认滚动板，或替换为 `{none}` 以禁用该玩家的滚动板。

- **命令别名**：`/scrollboard`

⭐配置详解 (`scrollboard_config.yml`)

MySQL 设置

mysql_enable: false # 设为 true 以启用 MySQL 存储玩家滚动板数据

常规设置

default-scrollboard: sample-default # 默认滚动板的ID
update-delay: 5 # 滚动板更新间隔（秒），每隔X秒为在线玩家更新一次

世界专属滚动板

此设置将覆盖默认滚动板。

worlds:
  info-world: sample-general-info # 在“info-world”世界中使用的滚动板ID
  static-world: sample-static # 在“static-world”世界中使用的滚动板ID

滚动行数设置

可设置每次操作滚动的行数，设为 -1 可立即跳至顶部/底部。

scrolled-lines:
  scroll: # 鼠标滚轮模式
    up: 2 # 向上滚动行数
    down: 2 # 向下滚动行数
  jump: # 跳跃/潜行模式
    up: 5
    down: 2
  click: # 点击模式
    up: 2
    down: 2

滚动板定义

支持三种类型

• SCROLL：使用滚轮触发滚动。
• JUMP：使用跳跃/潜行动作触发滚动。
• CLICK：使用左键/右键点击触发滚动。

配置示例

scrollboards:
  sample-default: # 滚动板ID
    type: SCROLL # 类型
    title: '&a&lA sample scoreboard !' # 标题
    separator: # 分隔符行（固定显示，不参与滚动）
      - '&7                &o(scroll to go down)'
      - '&r    &7---------------------------'
      - &r
    content: # 内容行（可滚动部分）
      - &6This is a very simple scoreboard.
      - 
      - &6There are a lot of characters
      - &6on one line, it goes up to 48 !

❓使用条款

使用本插件即表示你同意以下条款

• 本插件遵循此开源许可证：http://www.pyrrh4.be/files/licenses/open-source.txt（修改或重新分发需获得作者许可）。
• 插件页面的评论区用于发表对插件的看法，并非获取技术支持或提交建议的渠道。请通过页面顶部的链接（如 Discord）获取帮助。