Watchdog Essentials
Watchdog Essentials (WE) 是 Operate My Server (OMS) 的服务端插件,用于添加自动服务器监控和基于条件的生命周期操作。
如果你希望你的模组化 Minecraft 服务器能够自动应对诸如长时间低 TPS、内存严重不足或服务器空载等问题,请使用 Watchdog Essentials。
每个 Watchdog 都是独立的功能模块,并直接集成到 OMS 的重启和关闭处理中。
轻量级、模块化,专注于服务器健康监控。
功能说明
- 检测长时间的 低 TPS
- 监控 可用内存
- 检测 服务器处于空载状态
- 可通过 OMS 请求重启或关闭操作
- 提供内存监控和诊断命令
- 允许每个 Watchdog 功能独立配置、启用或禁用
Watchdog Essentials 通过基于条件的触发器扩展了 OMS 的功能,而 OMS 仍负责集中式的生命周期管理。
特性
在可配置的时段内监控服务器的平均 TPS。
如果 TPS 低于配置的阈值持续时间足够长,Watchdog Essentials 可以通过 OMS 请求服务器重启。
适用于自动检测长期的服务器性能下降。
监控可用的 JVM 内存并检测持续的内存不足状况。
当内存达到临界水平时,Watchdog 可以:
它还包含可选的诊断功能,如堆转储(heap dumps)和内存报告。
跟踪服务器在无玩家状态下运行的时长。
在配置的超时时间后,Watchdog Essentials 可以自动关闭服务器或请求重启。
适用于私人服务器、开发服务器以及其他不需要保持未使用服务器运行状态的设置。
要求
服务端模组(客户端无需安装)
安装
下载:
Watchdog Essentials
Operate My Server
Kotlin For Forge 4.11.0
所需文件:
oms-x.y.z.jar
watchdogessentials-x.y.z.jar
kotlinforforge-4.11.0.jar
将它们放入服务器的 mods/ 文件夹中。
正常启动服务器 —— Watchdog Essentials 将通过 OMS 自动注册其功能。
若要启用自动重启功能,请通过提供的 OMS 重启脚本 运行服务器。OMS 处理受控的关闭和重启请求,而脚本则重新启动 Java 进程。
请参阅 Restart Script Setup
基本用法
查看可用的 OMS 功能:
/oms feature
启用或禁用 Watchdog Essentials 功能:
/oms feature <feature> enable
/oms feature <feature> disable
Watchdog Essentials 还提供了用于内存监控和诊断的命令。
配置
Watchdog Essentials 配置文件路径:
world/serverconfig/watchdogessentials-server.toml
每个 Watchdog 都有自己独立的配置部分,包含阈值、计时、操作、警告及其他特定功能的选项。
文档
完整的配置参考、命令、示例和功能文档可在 OMS Wiki 上获取
Watchdog Essentials
Watchdog Essentials (WE) is a server-side addon for Operate My Server (OMS) that adds automatic server monitoring and condition-based lifecycle actions.
Use Watchdog Essentials if you want your modded Minecraft server to react automatically to problems such as prolonged low TPS, critically low memory, or an empty server.
Each watchdog works as an independent feature and integrates directly with OMS restart and shutdown handling.
Lightweight, modular, and focused on server health monitoring.
What it does
- Detects prolonged low TPS
- Monitors available memory
- Detects when the server stays empty
- Can request restart or shutdown actions through OMS
- Provides memory monitoring and diagnostic commands
- Allows every watchdog feature to be configured, enabled, or disabled independently
Watchdog Essentials extends OMS with condition-based triggers while OMS remains responsible for centralized lifecycle handling.
Features
Monitors the server's average TPS over a configurable period.
If TPS remains below the configured threshold long enough, Watchdog Essentials can request a server restart through OMS.
Useful for detecting prolonged server performance degradation automatically.
Monitors available JVM memory and detects sustained low-memory conditions.
When memory reaches a critical level, the watchdog can:
- restart the server
- shut it down
- take no automatic action
It also includes optional diagnostics such as heap dumps and memory reports.
Tracks how long the server has been running without players.
After the configured timeout, Watchdog Essentials can automatically shut down the server or request a restart.
Useful for private servers, development servers, and other setups where keeping an unused server running is unnecessary.
Requirements
Server-side mod (client not required)
Installation
Download:
Watchdog Essentials
Operate My Server
Kotlin For Forge 4.11.0
Required files:
oms-x.y.z.jar
watchdogessentials-x.y.z.jar
kotlinforforge-4.11.0.jar
Place them into your server's mods/ folder.
Start the server normally - Watchdog Essentials will register its features automatically through OMS.
For automatic restart functionality, run the server through the provided OMS restart script. OMS handles the controlled shutdown and restart request, while the script starts the Java process again.
See the Restart Script Setup
Basic usage
View available OMS features:
/oms feature
Enable or disable a Watchdog Essentials feature:
/oms feature <feature> enable
/oms feature <feature> disable
Watchdog Essentials also provides commands for memory monitoring and diagnostics.
Config
Watchdog Essentials config:
world/serverconfig/watchdogessentials-server.toml
Each watchdog has its own configuration section with thresholds, timing, actions, warnings, and other feature-specific options.
Documentation
Full configuration reference, commands, examples, and feature documentation are available on the OMS Wiki
评论 0
登录后参与评分
还没有评论,来抢沙发吧