InfoBoardReborn - 信息面板

InfoBoard Reborn 是经典插件 InfoBoard 的延续版本，它允许你在游戏中为玩家创建动态、可自定义的计分板侧边栏。本插件功能强大，支持多世界、多权限组显示不同内容，并集成了丰富的变量与动画效果。

💡公告与更新

• V3 重制版预告：插件目前正处于 V3.0.0 版本的最终测试阶段。重制版将带来大量新特性，例如全版本支持、新动画、独立的计分板文件、基于权限的计分板等。正式发布前需要完成测试和文档更新，请保持关注！
• 旧版支持：如果你在旧版 InfoBoard Reborn 中发现任何漏洞，请及时反馈，以确保它们不会在重制版中重现。

✨功能特性

• 无闪烁更新：即使更新频率很高，也能确保计分板显示稳定无闪烁。
• 多世界控制：可以在指定的世界中禁用计分板显示。
• 按组显示：为不同的权限组设置不同的计分板内容。
• 颜色与格式：全面支持颜色代码（如 &a）和格式代码。
• 多计分板轮播：可配置多个计分板并设置各自的显示时长进行轮播，数量无限制。
• 变量支持：

-   支持 **PlaceholderAPI**，可使用海量变量。

-   支持 **UTF-8** 特殊字符变量。

-   支持 **自定义变量**，可创建关键词来显示特定信息。

• 动态文本：

-   **随机颜色与格式**：使用 `&x` 表示随机颜色，`&y` 表示随机格式。

-   **滚动文本**：让单行文字实现滚动效果。

-   **可切换文本**：设置一个变量作为行内容，并为其添加多行文本进行循环显示。

• 可配置消息：所有提示消息均可自定义。

🎮指令列表

• /ibr - 显示所有可用指令。
• /ibr hide - 对玩家隐藏计分板。
• /ibr show - 对玩家显示计分板。
• /ibr toggle - 切换计分板的显示/隐藏状态。
• /ibr set <page> - 将计分板切换到指定页面（<page> 为数字）。
• /ibr reload [file] - 重载配置文件。[file] 可为空（重载全部），或指定为 board、config、messages。
• /ibr info - 显示插件的额外运行信息。
• /ibr create <page> <showtime> - 创建一个新的计分板页面并设置其显示时间。
• /ibr add <title/line> <page> <world> <rank> <line> - 向指定页面、世界和/或权限组添加标题或行。

🔧权限节点

• ibr.Reload - 允许使用 /ibr reload 指令。
• ibr.Toggle - 允许使用 /ibr hide、/ibr show、/ibr toggle 指令（默认授予）。
• ibr.Set - 允许使用 /ibr set <page> 指令。
• ibr.Create - 允许使用 /ibr create 和 /ibr add 指令。
• ibr.View - 允许查看计分板（默认授予）。
• ibr.* - 授予所有以上权限。

❓常见问题 (FAQ)

问：我的变量（Placeholder）没有被替换！

答：PlaceholderAPI 已禁用扩展的自动下载。你需要手动下载所需的扩展。使用游戏内指令：/papi ecloud download <扩展名>。例如，要使用 %player_name%，则需要执行：/papi ecloud download player。

问：变量所在的行显示为空...

答：这可能是值冲突导致的。意味着变量已生效，但与其他内容冲突。在该变量后添加 &r 通常可以解决此问题。

⭐依赖与兼容性

必需依赖

• PlaceholderAPI
• Vault
• WorldGuard（用于区域控制）
• 任意 Vault 支持的经济插件

已知问题

• 滚动文本中的颜色代码可能存在显示问题。
• 无法直接显示两行完全相同的文本（可在重复行前添加 &r 解决）。
• V2.0.4 版本中滚动功能可能失效。
• 可能与其他修改标签、列表的插件存在兼容性问题。

统计数据收集声明

本插件会向 https://bstats.org 发送匿名统计数据，用于了解插件使用情况。收集的数据包括：

• 服务器随机生成的 UUID
• 在线玩家数量
• 服务器在线模式
• Bukkit 版本
• Java 版本
• 操作系统名称、版本和架构
• CPU 核心数
• 安装了 bStats 的插件版本

你可以在此查看数据：bstats.org/plugin/bukkit/InfoBoardRebrn

如需禁用，请修改 plugins/bStats/config.yml 中的 enabled: true 为 enabled: false。如果不同意此数据收集政策，请勿安装本插件。

🔧配置文件概览

config.yml

主要配置文件，包含以下核心设置

• Updater：启用/禁用更新检查。
• Debug：启用/调试模式，输出额外信息。
• give-onjoin：玩家加入时是否给予计分板。
• Custom Variables：定义你自己的变量，格式为 <变量名>: 替换文本。
• Disabled Worlds：禁用计分板显示的世界列表。
• WorldGuard.Prevent Showing In：禁用计分板显示的 WorldGuard 区域列表。
• Update Time：计分板内容更新的时间间隔（秒）。
• Scrolling Text：滚动文本功能的开关和滚动间隔设置。
• Changeable Text：可切换文本功能的开关和自定义变量设置，可定义多行文本及其切换间隔。
• Condition：（即将推出）条件判断功能。

board.yml

定义所有计分板页面、内容、显示对象和时长。

• 每个计分板页面有独立的 ShowTime（显示时长）。
• 可针对特定世界（global 表示所有世界）和特定权限组（default 表示所有玩家）设置不同的标题和行内容。
• 单行文本可使用 ; 进行分割。
• 使用 ~!%变量% 的格式，可以仅在变量值非空时显示该行。

variables.yml

列出了插件支持的 PlaceholderAPI 扩展（数量庞大），以及一些尚未被 PlaceholderAPI 官方支持的插件（如 PowerRanks、McCombatLevel）的扩展链接。

messages.yml

自定义插件所有指令的反馈消息和提示文本。

⭐待办事项 (TODO)

• 修复滚动文本移除颜色代码的问题。
• 为 PlaceholderAPI 不支持的插件添加变量支持。
• 欢迎通过私信或在讨论区发帖，提出你希望添加的新功能。