SignBoard - 无限文本告示牌

SignBoard 是一款功能强大的插件，允许你将无限量的文本附加到告示牌或生物实体上，并通过计分板区域或书本的形式展示给玩家。它还支持为不同玩家组显示特定内容，并能在玩家查看、点击或攻击时执行命令，极大地丰富了服务器的交互与信息展示方式。

💡核心特性

• 无限文本：突破告示牌四行的限制，每个“板子”最多可容纳15行文本（总计600字符）。
• 实体支持：可将文本板附加到任何生物实体上，包括村民、怪物、盔甲架，甚至Citizens2 NPC。
• 分组内容：通过“类别”功能，可根据玩家权限或分组（如语言、职业、等级）显示不同的文本内容。
• 命令触发：可在玩家查看、移开视线、点击告示牌或攻击/击杀实体时运行自定义命令序列。
• 书本发放：可选择将板子文本以书本形式直接给予玩家。
• 板子集合：可将多个板子组合成“集合”，玩家可通过右键/左键点击来翻页浏览。

🎮版本支持

• SignBoard v1.6.3 及以上：支持 Bukkit/Spigot/Paper 1.13.3 至 1.19.3。
• SignBoard v1.6.2：支持 Bukkit/Spigot/Paper 1.8.7 至 1.16.1。

✨安装与快速开始

安装

将下载的 .jar 文件放入服务器的 plugins 文件夹，然后重启服务器。

基础使用步骤

• 创建板子：使用 /sb board new <板子名称> 创建一个新板子。
• 放置并附加：放置一个告示牌，看着它并执行 /sb sign attach <板子名称>。对于生物实体，则看着实体并执行 /sb entity attach <板子名称>。
• 查看效果：看向附加了板子的告示牌或实体，默认文本会显示在计分板区域。
• 编辑内容：使用 /sb board <板子名称> lineX <文本> 编辑板子的特定行。
• 创建集合：使用 /sb set 相关命令将多个板子组合成集合，然后像附加单个板子一样将集合附加到目标上。

🔧命令大全

根命令与别名

插件默认响应 /sb 命令。可在 config.yml 中配置 active_aliases 来启用其他别名：/signboard, /sbd, /sbrd, /signbd。

玩家常用命令

• 信息类

- `/sb help` - 显示插件描述和命令列表。

- `/sb howto` - 显示逐步使用指南。

- `/sb variables` - 列出所有可用变量。

• 板子管理

- `/sb board new <名称>` - 创建新板子。

- `/sb board list` - 列出你所有的板子。

- `/sb board <名称> lineX <文本>` - 编辑板子第X行。

- `/sb board <名称> lineX-Y <文本>` - 批量编辑第X到Y行（用`\n`分隔多行文本）。

- `/sb board <名称> linepushX <文本>` - 从第X行插入文本，并将原有行下推。

- `/sb board give_as_book <板子名> <玩家名>` - 将板子内容以书本形式给予指定玩家。

• 集合管理

- `/sb set new <集合名>=<板子1> <板子2> ...` - 创建新集合。

- `/sb set list` - 列出你的集合。

• 告示牌操作

- `/sb sign lineX <文本>` - 编辑你正在看的告示牌的第X行。

- `/sb sign attach/detach <板子或集合名>` - 附加/分离板子或集合。

- `/sb sign show_board` / `give_book` - 切换是否在屏幕显示或给予书本。

- `/sb sign before/after/onclick... <命令>` - 设置在不同时机触发的命令。

• 实体操作

- `/sb entity attach/detach <板子或集合名>` - 附加/分离板子或集合到实体。

- `/sb entity show_board` / `give_book` / `nametag` - 控制显示、书本和名称标签。

- `/sb entity before/after/onattack/onkill <命令>` - 设置实体相关触发命令。

• 语言设置

- `/sb locale list` - 显示可用的界面语言。

- `/sb locale set <语言代码>` - 设置你的首选语言。

- `/sb locale clear` - 清除语言偏好，恢复默认。

管理员命令

• /sb board list all - 列出所有玩家的板子。
• /sb set list all - 列出所有玩家的集合。
• /sb reload - 重载 config.yml 配置。
• /sb version <版本号> - 显示当前版本或指定版本的更新历史。
• /sb cleanup - 清理因插件未运行时删除告示牌而产生的残留数据（使用前请备份）。

⭐高级功能详解

类别系统

类别功能允许你为不同群体的玩家显示不同的板子内容。

如果服务器使用权限系统

• 每个现有的权限节点（如 lang.ptbr）自动被视为一个类别。
• 要创建属于某类别的板子，只需在创建（通过new、copy或rename）时，在原板子名后加上 ^ 和类别名。例如：signboard^lang.ptbr。
• 当拥有 lang.ptbr 权限的玩家查看附加了 signboard 板子的目标时，将看到 signboard^lang.ptbr 的内容。

如果服务器不使用权限系统

• 使用 /sb cat new <类别名> 创建类别。
• 使用 /sb cat assignplr <类别名> <玩家名> 将类别分配给玩家。
• 同样通过添加 ^类别名 的方式创建类别板子。

类别重要说明

• OP玩家默认拥有所有权限，因此总会看到匹配的类别板子。测试时建议使用非OP账号。
• 附加到目标上的是“根板子”（如 signboard），而非具体的类别板子。
• 可以在 config.yml 中修改 category_separator 来更改分隔符（默认为^）。
• 支持多类别板子（如 welcome^lang.ptbr^class.fighter），但玩家需要同时拥有所有对应类别/权限才能看到。
• 避免在同一板子名中重复同一类型的类别（例如 ^lang.ptbr^lang.en），这可能导致逻辑混乱。

命令执行

可以为告示牌或实体设置在各种时机自动执行命令序列。

• 命令格式：命令间用竖线 | 分隔，例如：tell {PName} 你好 | give {PName} diamond 1。
• 延迟执行：使用 [时间值+单位] 插入延迟，如 [5s] | say 5秒后。支持单位：s（秒）、m（分）、h（时）。
• 控制台执行：在命令前添加 _rfc_ 前缀，让命令以服务器控制台身份执行。
• 相关命令：

- `/sb sign before/after/onclick/onrightclick/onshiftclick/onrightshiftclick`

- `/sb entity before/after/onattack/onkill`

变量与PlaceholderAPI

• 内置变量：可在板子文本中使用花括号 {} 包裹的变量，如 {PName}（玩家名）、{ServerTime}（服务器时间）、{PMoney}（玩家金钱，需Vault）。完整列表使用 /sb variables 查看。
• PlaceholderAPI支持：安装 PlaceholderAPI 后，可在板子文本中使用 %placeholder% 格式的占位符，极大地扩展了变量来源。

与FeatherBoard兼容

• 自 v1.4.9 起，SignBoard 内置了 FeatherBoard API 兼容性支持。
• 在 config.yml 中设置 featherboard_aware: true 可让插件自动协调显示，避免冲突。
• 如果其他计分板插件有类似的“开启/关闭”命令，可以通过 config.yml 中的 cmd_before 和 cmd_after 选项手动配置兼容方案。

❓配置与权限

配置文件 (config.yml)

主要配置选项包括

• updates：自动更新设置（auto/check/off）。
• default_locale：默认语言。
• players_use_locales：是否允许玩家自定义界面语言。
• category_separator：类别分隔符。
• view_distance / entity_view_distance：触发查看的距离。
• active_aliases：启用的根命令别名。
• featherboard_aware：是否启用FeatherBoard感知。

权限节点

默认所有玩家可使用基础命令，OP可使用管理命令。可使用权限管理插件进行细化控制。

主要权限节点

• signboard.*：所有非管理命令。
• signboard.sign / signboard.entity：操作告示牌/实体。
• signboard.board：创建编辑板子。
• signboard.set：操作集合。
• signboard.book：发放书本。
• signboard.admin：所有管理命令。
• signboard.cmdrun.* 及子节点：控制各类触发命令是否运行。

🔧提示与注意

• 计分板兼容：SignBoard 显示时会临时占用计分板区域，玩家移开视线后其原有计分板会恢复。
• 编辑权限：只能编辑自己有权破坏的告示牌。只能编辑自己创建的板子，但可以附加任何人创建的板子到你的告示牌上。
• 空白行：将行内容设置为 &r 可创建空白行。
• 行字符限制：每行最多40个字符，超出的部分会被截断。
• 内容重复：板子内不能有两行完全相同的文本，可通过添加不可见的 &r 字符来区分。
• 实体与集合：当实体附加了集合时，第一次右键用于翻看板子，快速双击第二次右键才会触发实体原交互（如打开村民交易界面）。左键点击实体用于翻页，SignBoard 会取消此次攻击伤害。