Empty Server Stopper - Fabric

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