服务器关闭警报

服务器关闭警报

在正常专用服务器停止前,通过聊天和原版提示音警告玩家,并给予短暂宽限期。

服务器关闭预警

在普通的专用服务器停止之前,通过聊天消息和原版提示音警告在线玩家,然后让原始关闭流程继续执行。默认宽限期为五秒。

功能

  • 自动覆盖原版 /stop 所使用的常规服务器线程 halt(false) 路径。
  • 仅发送一次警告。重复的停止请求不会重放警告,也不会延长倒计时。
  • 可配置宽限期、纯文本聊天消息、现有音效事件、音量和音调。
  • 仅需在服务器端安装。默认音效和聊天使用原版数据包;客户端无需附加组件或资源包。
  • 空服务器停止、集成单人服务器、外部或等待中的关闭路径、崩溃以及强制终止均不进入延迟流程。

这是一个小型管理工具。它不会安排重启、重启进程、更改操作系统电源设置或添加替代停止命令。现有 /stop 权限保持不变。

使用方法

将 JAR 安装到专用服务器的 mods 文件夹中。使用常规的 /stop 命令。当该请求被处理时在线的玩家将收到预警;宽限期结束后,原始停止方法继续执行。

配置文件会生成在世界文件夹内的 serverconfig/server-shutdown-alert-server.toml:

  • gracePeriodSeconds:默认 5,范围 0–30。设为 0 可禁用此附加组件。
  • soundEnabled:默认 true。
  • sound:默认 minecraft:block.note_block.bell。自定义选项必须已存在于客户端上。
  • volume:0.65,范围 0–1;pitch:1.0,范围 0.5–2。
  • message:Server stopping in {seconds} seconds. 空消息将禁用聊天。

宽限期内服务器必须持续运行 tick。此附加组件无法在崩溃、强制终止进程或托管服务立即终止进程之前发出警告。如果无法发送任何通知,普通停止将立即执行。

兼容性

  • Minecraft 1.21.1,Java 21。
  • NeoForge 21.1.235 为确切的已验证开发目标;元数据接受后续的 21.1.x。
  • 仅在专用服务器上安装。无需 Create、Sable、地图模组或客户端附加组件。
  • 请勿与较旧的 Steam & Steel 关闭音效附加组件(模组 ID steamsteel_shutdown)一同安装;两者会拦截相同的停止路径。

原生 Mixin 应用和回归检查针对上述确切库版本。其他 Minecraft 版本和第三方关闭覆盖未声明经过测试。单独的重启调度器可能提供自己的倒计时;请为你的服务器配置一种预警策略。

来自 Steam & Steel

此附加组件源自 Steam & Steel SMP,即我们自定义的 Minecraft 1.21.1 NeoForge 服务器整合包。它可以独立于完整整合包使用,且不需要 SteamSteelCore 或私有服务器配置。

原有的服务器专用音效已被替换为对现有原版音效事件的引用。此附加组件不附带任何音频录音。

致谢

Minecraft 和 NeoForge 保留其各自的许可证。此附加组件使用其现有的专用服务器和数据包 API。不捆绑任何原始游戏或第三方模组的类、纹理或音效。

这是一个独立的社区附加组件。项目图标为原创哑光像素艺术作品,通过我们的 V3 图标管线渲染;它代表一种预警,并不会向游戏中添加铃铛方块。

Beta / 反馈

这是一个 beta 版本,源自为某个特定 Steam & Steel SMP 服务器整合包开发的实用工具。该源工具在那个环境中具有启动和分发证据;但这并不构成此新独立包的播放或兼容性证明。

本地检查在无头测试环境中执行了实际附加组件、原生和 Sponge 转换后的停止方法,以及 Minecraft 的音效数据包编解码器。它们确认了限定范围内的停止行为、客户端无操作和仅服务器端分类。它们不能证明可听见的预警、真实玩家连接或完整的世界保存周期。发布时未启动任何客户端或服务器。

如果你遇到崩溃、错误或意外行为,请留言并提供你的 Minecraft、NeoForge 和附加组件版本、其他关闭工具以及复现问题的步骤。我们将调查所报告的 bug 并着手修复。

许可证

附加组件代码和原创项目艺术作品采用 BSD 3-Clause 许可。版权所有 (c) 2026,DanielBasov (Steam & Steel)。允许分支、修复和再分发;请在源码分发以及二进制分发随附材料中保留作者署名、许可条件和免责声明。分支不得暗示原作者背书。