SimpleMOTD - 简易登录消息

💡SimpleMOTD —— 玩家加入消息插件

这是一个非常简单的插件，用于在玩家加入服务器时发送一条欢迎消息。你可以自定义消息内容、设置发送延迟，并允许特定玩家绕过此消息。

🎮配置说明

配置文件采用 YAML 格式，你可以自定义消息内容和插件设置。

消息内容 (motd)

消息内容是一个列表，每一行都是一条独立的消息。支持颜色代码和占位符。

motd:
  - '&7Welcome to the server, &a%player%&7.'
  - '&7Have fun while playing!'
  - '&a%currentPlayers%&8/&a%maxPlayers% &7players are online right now.'

插件设置 (settings)

settings:
  bypass:
    usePerm: false
    permission: SimpleMOTD.bypass
  delay:
    seconds: 0

✨功能特性

• 自定义欢迎消息：通过配置文件自由编辑多行欢迎语。
• 占位符支持：在消息中使用动态变量。
• 延迟发送：可设置消息在玩家加入后延迟多少秒发送。
• 权限绕过：允许拥有特定权限的玩家不看到此消息。
• 广泛兼容：支持多种服务端核心。

可用占位符

• %player%：替换为玩家名称。
• %currentPlayers%：替换为当前在线玩家数量。
• %maxPlayers%：替换为服务器最大玩家数量。

🔧使用指南

配置消息

• 编辑 config.yml 文件。
• 在 motd: 部分按格式编写你的消息。
• 使用 & 符号添加颜色代码（例如 &a 代表绿色）。
• 使用占位符（如 %player%）插入动态信息。

设置延迟

在 settings.delay.seconds 中设置延迟秒数。设为 0 表示立即发送。

启用权限绕过

• 将 settings.bypass.usePerm 设置为 true。
• 拥有 SimpleMOTD.bypass 权限（可在配置中自定义）的玩家将不会收到欢迎消息。

❓兼容性与要求

• 支持版本：插件应兼容 1.7 至 1.16 的 Minecraft 版本。
• 服务端核心：支持所有基于 Spigot 的核心，例如：
• Paper
• Thermos
• Magma
• 依赖：无需任何前置插件。

⭐开发者 API

插件提供了简单的 Java API 供开发者调用。

获取 API 实例

API motdApi = SimpleMOTD.getAPI();

可用方法

• sendMOTD(Player player, int delay)：向指定玩家发送 MOTD，可设置延迟（秒）。
• sendMOTD(Player player)：立即向指定玩家发送 MOTD。
• getMOTDList()：返回所有 MOTD 消息行的列表（未替换占位符和颜色代码）。
• getMOTD(Player player)：返回替换了占位符和颜色代码的完整 MOTD 消息。
• replacePlaceholders(String raw, Player player)：在原始字符串中替换所有占位符和颜色代码。

使用示例

// 获取 API
API motdApi = SimpleMOTD.getAPI();
// 向玩家发送 MOTD
motdApi.sendMOTD(player);