About Auto Restart
From ModrinthAdds auto restarting to Minecraft servers.
Version 3.X.X
For older versions of the mod, check the wiki.
This mod restarts the Minecraft server by itself or with an external restart script. The mod can only be used on the server side and won't work on the client side.
You need a server to play with friends? You don't know how to set up one? Just rent an already configured server!
Click on the picture above, select a plan (with recommended at least 6 GB), use my code agent to get 25% off your first month and enjoy playing with your friends!
Support
Minecraft versions, for which the mod is not released, are not supported. You can find a text version here.
Features
- Restarting the server at specified times
- Restarting the server with a delay, if it is empty
- Restarting the server, if the TPS are below a specified level for a specified time
Server Config
The config file can be found in the "serverconfig" folder in the "world" folder and is named "auto_restart-server.toml". The name of the world folder is set for servers in the "server.properties" file.
- restart – Options for restarting:
- use_external_restart_script – Is the server started by an external restart script?
- restart_command – Path of the script, that is executed on Server stopped to restart the server. Only called if "use_external_restart_script" is false. It must only contain the path of the script, without any other commands or arguments (i.e. "/opt/minecraft/start.sh", not "bash start.sh" or "start.sh nogui").
- auto_restart – Option for auto restarting:
- enabled – Should the Server do automatic restarts?
- times – Times in 24-hour format on which the server will automatically restart. Examples: "14:00", "16:32"
- on_crash – Should the server be automatically restarted when it crashes. Only used with "restart_command". An external restart script restarts the server after a crash anyway.
- warning_times – Times before an auto restart of the server, a restart warning should be shown. Examples:
5s– For a message 5 seconds before a restart7m– For a message 7 minutes before a restart2h– For a message 2 hours before a restart- on_empty_restart – Options for restart, if the server is empty:
- enabled – Should the server restart, if no players are online?
- delay – Delay after the server should restart, if it is empty. Examples:
5s– For a delay 5 seconds7m– For a delay 7 minutes2h– For a delay 2 hours- low_tps_restart – Options for restart, if the TPS of server or its dimensions are low:
- enabled – Should the server restart, if it is below a TPS level for a specified time?
- minium_tps_level – TPS level below which the server is restarted, if it lasts for the specified time.
- delay – Delay, that the server must be below the defined TPS level, in order for it to be restarted. Examples:
5s– For a delay 5 seconds7m– For a delay 7 minutes2h– For a delay 2 hours
Commands
/restart– Restarts the server
How to set up the mod?
To use the mod, one or more shell (sh or Linux) or batch (bat or cmd on Windows) scripts/files are needed. To set up everything to use this mod, please check the Setup Guide. If you have problems with the scripts, check the Troubleshooting page.
Rented servers: If your server is started by a server panel and you can't use own scripts, enable the restart on stop/crash option of your server panel and set "use_external_restart_script" to true. The mod then only stops the server and the server panel starts it again. Details: Troubleshooting.
Thanks for the logo to Muse31. You can use this mod in non-commercial modpacks without asking. You can find more mods from me on CurseForge or Modrinth.

Highlights
From source dataGame versions
Supports 25 Minecraft versions, the newest being 26.3.
Loaders
Runs on Forge and NeoForge.
Footprint
Rated a light load on a server.
Auto Restart on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Forge, NeoForge
- Server load
- light
- Smallest plan we suggest
- Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 26.3-3.0.3, released 2026-10-19
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| NeoForge | 1.21.1 to 26.3 (16 versions) | 26.3 |
| Forge | 1.20.1 to 1.21.1 (2 versions) | 1.21.1 |
From 11 recorded builds of Auto Restart.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 26.3-3.0.3 | 2026-10-19 | 26.3 | NeoForge |
| 26.1-3.0.3 | 2026-10-13 | 26.1 to 26.2 (4 versions) | NeoForge |
| 1.21.11-3.0.3 | 2026-10-13 | 1.21.11 | NeoForge |
| 1.21.1-3.0.3 | 2026-10-13 | 1.21.1 to 1.21.10 (10 versions) | NeoForge |
| 1.20.1-2.0.4 | 2026-10-13 | 1.20.1 | Forge |
| 26.1-3.0.2 | 2026-10-10 | 26.1 to 26.3 (5 versions) | NeoForge |
Run Auto Restart on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogQuality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Runs on your server
From source side supportModrinth lists Auto Restart as required on the server. Check its Modrinth page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- ForgeNeoForge
- Runs on
- Serverrequired on the server
- Game versions
- 26.3 and 24 earlier
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-20Open ↗
- ✓AuthorGeheimagentNr1, as published on Modrinth
- ✓LicenseLicenseRef-All-Rights-ReservedFree












