RestartAnnouncer

# 重启公告 一个简单易用的 Minecraft 服务器重启公告插件，适用于 Paper 服务器。 **版本:** 1.0.1 ## 特性 - **服务器关机**: 在倒计时结束时关闭你的服务器（可配置） 注意：插件不处理重启，用户启动脚本或守护进程脚本必须处理重启！ - **重启公告**: 设置重启时间并发布剩余时间以警告服务器玩家 - **简单指令**: 易于使用的指令，具有自动补全功能 - **可自定义的消息**: 所有消息都可以编辑在 `messages.yml` 文件中 - **灵活的时间安排**: 设置重启时间和公告间隔 - **游戏内配置**: 所有内容都可以通过指令管理 - **这对于想要安排重启并警告玩家，让他们可以到达安全位置的服务器所有者非常有用** ## 指令 **`/announcer start [interval] [display]`** - 启动重启倒计时 - **time**: 重启剩余时间 (例如 `10m`, `30m`, `1h`) - **interval**: 发布公告的频率 (例如 `60s`, `2m`) - 可选，默认为 60 秒 - **display**: 在哪里显示公告 (`chat`, `bossbar`, `title`) - 可选，默认为 `chat` **`/announcer stop`** - 取消当前的重启倒计时 **`/announcer status`** - 检查当前是否正在运行重启，并查看剩余时间 **`/announcer reload`** - 重新加载插件配置和消息 **`/announcer toggle`** - 切换 execute-shutdown 设置。禁用时，插件仅发送公告而不会停止服务器 **`/announcer set message `** - 设置重启公告消息 **`/announcer help`** - 显示帮助信息 **示例:** - `/announcer start 10m` - 10 分钟后重启，每 60 秒在聊天中公告 - `/announcer start 30m 2m bossbar` - 30 分钟后重启，每 2 分钟在 boss bar 中公告 - `/announcer start 30s 2s title` - 30 秒后重启，每 2 秒以标题形式公告 ## 权限 - `announcer.start` - 启动重启的权限 - `announcer.stop` - 停止重启的权限 - `announcer.status` - 检查状态的权限 - `announcer.reload` - 重新加载插件的权限 ## 配置文件 ### config.yml ```yaml # 默认设置 defaults: # 如果未指定，则默认重启时间（以分钟为单位） restart-time: 10 # 如果未指定，则默认公告间隔（以秒为单位） announcement-interval: 60 # 关机方法 # 选项: "shutdown" (使用 Bukkit.shutdown()), "stop" (使用 /stop 命令), "restart" (使用 /restart 命令) shutdown-method: "shutdown" # 执行关机 # 设置为 false 仅发送公告而不停止服务器 # 如果设置为 false，你的批处理/bash 启动脚本或单独的守护进程脚本必须处理服务器重启 execute-shutdown: true # 权限 permissions: start: "announcer.start" stop: "announcer.stop" status: "announcer.status" reload: "announcer.reload" ``` ### messages.yml ```yaml # 主重启消息 - 使用 %time% 表示剩余时间 restart-message: "服务器将在 %time% 后重启！" # 指令消息 commands: no-permission: "您没有使用此命令的权限。" player-only: "此命令只能由玩家使用。" # start 命令 start: usage: "用法: /announcer start " example: "示例: /announcer start 10m 60s" already-running: "重启已经运行中！" success: "已计划在 %time% 重启，每 %interval% 发布公告" invalid-time: "无效的时间格式。使用: 5m, 10m, 30m, 1h, 等。" invalid-interval: "无效的间隔格式。使用: 30s, 60s, 2m, 等。" # stop 命令 stop: no-permission: "您没有停止重启的权限。" not-running: "当前没有运行重启。" success: "重启已取消。" # status 命令 status: running: "重启进行中：%time% 剩余时间" not-running: "当前没有运行重启。" # help 命令 help: header: "重启公告 命令:" start: " /announcer start - 启动重启倒计时" stop: " /announcer stop - 取消当前的重启" status: " /announcer status - 检查重启状态" help: " /announcer help - 显示此帮助" # reload 命令 reload: no-permission: "您没有重新加载插件的权限。" success: "插件已成功重新加载。" ``` ## 安装 1. 下载最新版 JAR 文件 2. 将其放置在服务器的 `plugins` 文件夹中 3. 启动/重启你的服务器 4. 插件将创建 `config.yml` 和 `messages.yml` 文件 5. 根据需要编辑配置文件 6. 使用 `/announcer help` 查看可用指令 ### ⚠️ 重要提示：配置文件更新 **更新插件到新版本时，建议：** 1. 停止你的服务器 2. 从你的 `plugins` 目录中删除 `RestartAnnouncer` 文件夹 3. 使用新 JAR 文件替换 `plugins` 文件夹中的 JAR 文件 4. 启动你的服务器以生成新的配置文件 5. 在新的 `config.yml` 和 `messages.yml` 文件中重新配置你的设置 这可确保正确添加任何新的配置选项，并避免与配置迁移相关的问题。保存你先前所做的任何更改的 `messages.yml` 的备份。 ## 时间格式 该插件支持各种时间格式： - **秒**: `30s`, `60s` - **分钟**: `5m`, `10m`, `30m` - **小时**: `1h`, `2h`, `6h` ## 关机方法 该插件支持停止服务器的不同方法： - **`shutdown`** (默认): 使用 `Bukkit.shutdown()` - 最可靠的方法 - **`stop`**: 使用 `/stop` 命令 - 标准的 Minecraft 命令（也使用 Bukkit.shutdown()，建议使用默认的 'shutdown'） - **`restart`**: 使用 `/restart` 命令 - 可能无法在所有服务器上使用，请谨慎使用 您可以在 `config.yml` 中配置此项： ```yaml shutdown-method: "shutdown" # 选项: shutdown, stop, restart ``` ## 仅公告模式 您可以配置插件仅发送公告而实际上不停止服务器，如果您想手动执行重启的话： ```yaml execute-shutdown: false # 设置为 false 以仅进行公告 ``` 当 `execute-shutdown` 设置为 `false` 时： - 插件会正常发送所有重启公告 - 当倒计时达到零时，它**不会**停止服务器 ## 颜色代码 插件支持消息中的 MiniMessage 颜色代码： - ``, ``, ``, `` 等 - ``, ``, `` - `` 以重置格式 ## 支持 如果您需要帮助或有建议，请在 GitHub 存储库中打开一个问题，或加入链接的 Discord 并导航到 #plugin-help