Restart Scripts#

Note: UltimateAutoRestart does not directly restart your server or machine. Instead, it executes the configured commands at the scheduled times and provides a notification before these actions occur. After a shutdown (triggered by commands such as /stop or /restart), you must further configure your server to complete the autorestart process.

Dedicated Hosting / Self-Hosting#

If you have access to modify the startup script for your server instance (commonly in dedicated or self-hosted environments), please generate the startup script using the tool below. Be sure to enable the Auto-Restart option:

PaperMC Start Script Generator

Linux Hosting with Tools Such as Tmux or Screen#

For Linux systems using session management tools like Tmux or Screen, the process requires the creation of two separate scripts:

1. Launcher Script#

Create a script (e.g., launcher.sh) with the following contents. Adjust the server path as necessary, and configure this script to run from within your spigot.yml:

#!/bin/sh
cd /path/to/your/server/root
screen -AmdS server sh -i start.sh

2. Server Start Script#

Create another script (e.g., start.sh) with the following command, making sure to customize the Java options (such as memory allocation) and the JAR file name:

#!/bin/sh
java -Xmx12G -Xms12G -jar `<jar>.jar` nogui

In this configuration, the launcher script creates a Screen (or Tmux) session and executes the server start script. The hierarchical chain ensures that the restart context is preserved—the launcher provides the necessary restart environment, while the start script simply initiates the server. After editing, update the file permissions as required:

sudo chmod 777 [script name]

You can verify the file permissions with:

ls [script name]

Restart Time Offset#

If your local timezone differs from that of your server's physical location, you might observe discrepancies in the scheduled restart times. This behavior occurs because the plugin uses the server’s local time settings. For example, if you are based in the US and your server is hosted in the UK, the time difference may affect the restart schedule.

Please note that this is not an issue with UltimateAutoRestart and that you would have to calculate the offset.

Webhooks: New Line Characters#

When configuring webhook messages, use \\n instead of \n to represent new line characters.

Webhooks: HTTP 400 Error#

If you encounter an HTTP 400 error, it indicates that Discord is rejecting your webhook configuration. In this case, please review and retrace your changes. To assist with troubleshooting, use the command:

/ar debug webhooks

This command will resend all webhooks, allowing you to verify their functionality.

Troubleshooting Guide