Description
What is HySystemdNotifier?
A lightweight plugin that integrates your Hytale server with systemd, the service manager used by most Linux distributions. This allows your server to behave as a proper system service with health monitoring.
Features
- Startup Notification — Tells systemd exactly when your server is fully loaded and ready to accept players (Type=notify)
- Watchdog Support — Sends periodic heartbeat signals so systemd can detect if your server freezes or hangs
- Automatic Recovery — When combined with systemd's restart policies, your server automatically restarts after crashes or hangs
- Status Reporting — Reports server state to systemd for monitoring tools
Why Use This?
If you're hosting a Hytale server on Linux, you're probably running it as a systemd service. Without this plugin, systemd has no way to know if your server is actually healthy. It can only see that the process is running.
With HySystemdNotifier, systemd knows when startup is complete and continuously monitors server health. If the server stops responding (even without crashing), systemd detects it and can automatically restart the service.
Installation
- Drop the JAR into your server's mods/ folder
- Configure your systemd service with
Type=notifyandWatchdogSec=10 - Restart, that's it!
See the GitHub page (https://github.com/punkeel/HySystemdNotifier) for a complete systemd configuration example.