Installation

Installation Guide

Use the build that matches your server platform. Do not mix Bukkit, Folia, Fabric, Forge, or NeoForge artifacts.

Platform Matrix

Platform	Artifact	Minecraft	Runtime Java
Bukkit / Spigot / Paper / Purpur and compatible forks	RedstoneReboot-Bukkit-<version>.jar	1.9 to 1.21.1	Java 8+ on legacy, Java 17+ on modern
Folia	RedstoneReboot-Folia-<version>.jar	1.20+	Java 17+
Fabric	RedstoneReboot-Fabric-<version>.jar	1.20.1+	Java 17+
Forge	RedstoneReboot-Forge-<version>.jar	1.20.4+	Java 17+
NeoForge	RedstoneReboot-NeoForge-<version>.jar	1.20.4+	Java 17+

Bukkit, Spigot, Paper, and Similar Servers

1. Download the Bukkit-family jar from the release page.
2. Stop the server.
3. Place the jar in plugins/.
4. Start the server once so RedstoneReboot can generate its files.
5. Edit plugins/RedstoneReboot/config.yml.
6. If you want managed restart handoff, edit plugins/RedstoneReboot/restart-backends.properties.
7. Run /reboot status.
8. Run /reboot doctor if you are configuring a backend.

Folia

1. Download the Folia jar.
2. Place it in plugins/.
3. Start the server once.
4. Edit plugins/RedstoneReboot/config.yml.
5. Edit plugins/RedstoneReboot/restart-backends.properties if you need backend handoff.
6. Run /reboot status and /reboot doctor.

Folia uses its own scheduler adapter internally. You do not need a separate Folia-specific config file.

Fabric

1. Download the Fabric jar.
2. Place it in mods/.
3. Install Fabric API if your server setup requires it.
4. Start the server once.
5. Edit the loader-generated RedstoneReboot config.
6. Configure backend handoff if you want restart ownership beyond a normal stop.

Forge

1. Download the Forge jar.
2. Place it in mods/.
3. Start the server once.
4. Edit the loader-generated RedstoneReboot config.
5. Configure backend handoff if needed.

NeoForge

1. Download the NeoForge jar.
2. Place it in mods/.
3. Start the server once.
4. Edit the loader-generated RedstoneReboot config.
5. Configure backend handoff if needed.

First Startup Checklist

• the platform-specific RedstoneReboot config file exists
• the backend config file exists if you plan to use restart handoff
• /reboot status reports the expected timezone and schedule
• /reboot doctor shows the backend you intended to use

Common Mistakes

Wrong artifact for the server

Use the Bukkit-family jar for Bukkit-compatible servers, the Folia jar for Folia, and the loader-specific mod jar for Fabric, Forge, or NeoForge.

Commands missing

• On plugin builds, verify the plugin enabled cleanly and plugin.yml registered the command.
• On mod builds, verify the dedicated server finished startup and the loader registered the command tree.

Restart backend not taking ownership

Run /reboot doctor and compare the active backend with the environment RedstoneReboot detected. Backend state and mismatch warnings are explained in Backends.md.