Empty Server Stopper

A Fabric mod that automatically shuts down the server when it’s empty or below a certain player threshold.
Ideal for use with hibernation scripts or the SleepingServerStarter tool (see below).

Usage

Version: Minecraft 26.1.2 or higher
Requirement: Fabric API
Best with: SleepingServerStarter

Commands

All commands require gamemaster permission level (OP level 2), except time and min_players, which can be opened to all players via config.

Command	Description
`/ess reload`	Reloads the configuration file and re-evaluates the shutdown state.
`/ess time`	Shows the remaining time before shutdown.
`/ess time set <minutes>`	Sets and persists a new shutdown delay, then restarts the timer with it.
`/ess enable`	Enables the mod logic and starts checking player count.
`/ess disable`	Disables the mod logic and stops any running timer.
`/ess restart`	Manually re-evaluates and restarts the shutdown countdown if applicable.
`/ess min_players`	Shows the current minimum player threshold.
`/ess min_players set <n>`	Sets and persists a new minimum player threshold, then re-evaluates immediately.
undefined

Configuration

The config file is located at ./config/emptyserverstopper/config.json.

Key	Default	Description
`enabled`	`true`	Globally enable or disable the mod.
`shutdownTimeMinutes`	`5`	Minutes to wait before shutdown once the threshold is crossed.
`minimumPlayersBeforeShutdown`	`1`	Server schedules a shutdown once the player count drops below this value.
`timerOnLaunch`	`true`	Start the timer immediately when the server boots.
`playersCanAskShutdownTime`	`true`	If `true`, non-OP players can use `/ess time`.
`playersCanAskMinPlayer`	`true`	If `true`, non-OP players can use `/ess min_players`.

Any value changed via a set command is written back to this file automatically — no manual editing or reload needed for it to persist across restarts.

Behavior

Announcements: the mod broadcasts a message when a shutdown is scheduled, another warning 1 minute before it fires, and a confirmation if the shutdown is canceled.
Auto-cancel: the timer is automatically canceled if enough players join to bring the count back above the threshold, and restarted automatically if it drops below again.

TODO

✅ Port to recent version: 26.1.2
❌ ~~Translations support?~~ Not practical — the mod is server-side only

Contributors

Original author: Martinkrk

Current author: Mat1212fr

Empty Server Stopper – Fabric

介绍