BookNews 1.8 - BookNews - 服务器新闻书

BookNews 是一款轻量级插件，允许服务器管理员通过书本向玩家展示服务器公告或更新日志。玩家加入服务器时，书本会自动打开，确保重要信息及时送达。

💡主要特性

• 自动展示：玩家加入服务器时，自动打开公告书本。
• 丰富格式：支持颜色代码（如 &c）和十六进制颜色（如 #ff8888，适用于 1.16+）。
• 变量支持：兼容 PlaceholderAPI，可在书本中使用 %player_name% 等变量。
• 交互文本：支持创建可点击、悬停、执行命令、打开链接或复制文本的交互式文字。
• 轻量高效：插件本身占用资源极少。
• 声音效果：可配置书本打开时的音效。

🎮命令与权限

命令

• /booknews - 主命令（需权限：booknews.admin）
• /booknews reload - 重载插件配置（需权限：booknews.admin.reload）
• /booknews clear - 清除玩家数据记录，使所有玩家下次进服时再次看到书本（需权限：booknews.admin.clear）
• /news - 手动打开公告书本（需权限：booknews.news）

权限

• booknews.admin - 使用 /booknews 主命令。
• booknews.admin.reload - 允许重载配置。
• booknews.admin.clear - 允许清除玩家数据。
• booknews.news - 允许使用 /news 命令手动打开书本。
• booknews.skip - 拥有此权限的玩家在加入服务器时不会自动打开书本。

🔧配置说明 (config.yml)

以下是默认配置文件的核心部分说明

基础设置

check-update: true
Prefix: '&e&l[BookNews] '
OpenBookDelaySecond: 5

• check-update：是否检查插件更新。
• Prefix：插件消息前缀。
• OpenBookDelaySecond：玩家进服后，延迟多少秒打开书本。

自动打开书本设置

Open-Book-Onjoin:
  enable: true
  always: true

• enable：是否启用进服自动打开书本功能。
• always：
• 若为 true，玩家每次加入服务器都会打开书本。
• 若为 false，则只会在管理员执行 /booknews clear 命令后，玩家下一次进服时打开一次。

交互式文字配置

在 Interactive-Word 部分，您可以定义多个交互式文字。每个条目包含：

• word：在配置中引用的文字标识。
• placeholder：在书本内容中使用的占位符，格式为 %booknews_placeholder%。
• 样式设置：bold（粗体）、color（颜色）、italic（斜体）等。
• clickevent：点击事件，可设置为：
• OPEN_URL：打开链接。
• RUN_COMMAND：执行命令。
• CHANGE_PAGE：跳转页面。
• COPY_TO_CLIPBOARD：复制文本到剪贴板。
• hoverevent：悬停时显示的文本。

书本页面内容

在 book 部分配置书本每一页的内容。使用 "1"、"2" 等键名表示页码。内容中可插入：

• 颜色代码和十六进制颜色。
• PlaceholderAPI 变量。
• 交互式文字占位符，例如 %booknews_gotopage2%。

注意：在书本内容中使用交互式文字占位符后，务必在后面加一个空格。

❓常见问题 (FAQ)

问：加入服务器时书本没有自动打开！

• 请确认配置中 Open-Book-Onjoin.enable 设置为 true。
• 检查玩家是否拥有 booknews.skip 权限，有此权限的玩家不会自动看到书本。

问：如何报告插件问题？

• 您可以到 Discord 服务器中反馈问题。由于开发者是学生，回复可能需要一些时间，感谢您的耐心。

✨依赖与兼容性

• 软依赖：PlaceholderAPI。如果安装了此插件，书本内容即可使用各种变量。
• 声音效果：插件支持各版本（1.8.x - 1.19.x）的 Minecraft 音效名称，例如 ENTITY_PLAYER_LEVELUP。

---

其他插件

• 免费插件：RepairGui | EnchantGui
• 付费插件：HopperSorter

💡创建新页面

要创建新页面，只需复制前一页，粘贴后更改页码即可。例如，当前有一页，想添加第二页。

代码 (YAML):

book :
  "1" :
    |-
    This is first page!

首先，复制前一页，粘贴在下方。

代码 (YAML):

book :
  "1" :
    |-
    This is first page!
  "1" : # <- 粘贴在此处
    |-
    This is first page!

之后，更改数字并编辑内容。

代码 (YAML):

book :
  "1" :
    |-
    This is first page!
  "2" : # <- 数字已改为 2
    |-
    This is second page!

最后，保存文件并执行 /booknews reload 命令，即可完成。

🎮交互文本

交互文本是一种特殊文本，允许玩家

• 查看悬停文本
• 打开链接
• 复制文本到剪贴板
• 执行命令
• 翻页

与其他需要编写 JSON 格式来创建可点击/悬停文本的插件不同，本插件提供了一种更友好的方式来创建交互文本。

示例配置

下方展示了一个交互文本的配置示例。

代码 (YAML):

Interactive-Word :
  1 :
    # 书中显示的文本
    word : "Example"
    # 此交互文本的占位符
    placeholder : "example"
    bold : true # true/false
    color : gold # red/blue/yellow/aqua/green/lime 等，若服务器版本高于 1.16 也支持十六进制颜色，例如白色为 '#ffffff'
    italic : false # true/false
    underlined : false # true/false
    obfuscated : false # true/false
    clickevent :
      enable : false
      action : OPEN_URL # [OPEN_URL / RUN_COMMAND / CHANGE_PAGE / COPY_TO_CLIPBOARD]
      value : ''
    hoverevent :
      enable : true
      text : 'Hello!'

在书中使用

在书页配置中，使用占位符来引用交互文本。

代码 (YAML):

book :
  "1" :
    |-
    %booknews_example%

在书中，它将呈现为可交互的样式。当您将鼠标悬停在文本上时，将显示悬停文本。

[功能开发中]