Skip to content

Installation

Jump to bottom
github-actions[bot] edited this page Jul 25, 2026 · 5 revisions

Installation Guide

RedstoneReboot Logo

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 26.2+ Java 8+ (legacy), 17+ (modern), 25 (26.x+)
Folia RedstoneReboot-Folia-<version>.jar 1.20.1 to 26.2+ Java 17+, 25 (26.x+)
Fabric RedstoneReboot-Fabric-<version>.jar 1.20.1 to 26.2+ Java 17+, 25 (26.x+)
Forge RedstoneReboot-Forge-<version>.jar 1.20.4 to 26.2+ Java 17+, 25 (26.x+)
NeoForge RedstoneReboot-NeoForge-<version>.jar 1.21.1 to 26.2+ Java 21+, 25 (26.x+)

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.

Clone this wiki locally