HySystemdNotifier

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=notify and WatchdogSec=10

Restart, that's it!

See the GitHub page (https://github.com/punkeel/HySystemdNotifier) for a complete systemd configuration example.