---

🔥 Why RedstoneReboot?

RedstoneReboot is a production-grade server lifecycle engine that provides precise control over when, why, and how your server restarts. Backed by real-time health monitoring, intelligent scheduling, and a pluggable backend handoff system.

From a single survival server to a fleet behind Pterodactyl — it delivers reliability, intelligence, and elegance.

Key Capabilities

• 🕐 Intelligent Scheduling — Multiple daily restart windows with global timezone support and day-of-week filters
• 📊 Health Monitoring — Real-time TPS and memory tracking with consecutive-check false-positive protection
• 🚑 Emergency Fail-safes — Automatic restart triggers on critical TPS or memory breach
• 🔔 Rich Alerts — Chat, title, action bar, and configurable sound notifications
• 🔌 Backend Handoff — Delegate to Pterodactyl, Systemd, Docker, or local wrapper scripts
• 🔄 Hot-Reload — Change backend config and /reboot reload — no full server restart needed
• 🧩 PlaceholderAPI — 8 placeholders for scoreboards, tab lists, and MOTD plugins (Bukkit builds)
• 📈 bStats Metrics — Anonymous usage telemetry (view live stats)

---

⚡ The Backend System & Startup Loops

RedstoneReboot divides "when to restart" from "how to restart" by supporting multiple backends:

• SHUTDOWN_ONLY — Graceful shutdown (letting your external wrapper restart the process)
• LOCALSCRIPT — Auto-generated shell script handles process restarts
• SYSTEMD — Service integration on Linux
• DOCKER — Container-native restart policies
• PTERODACTYL — Direct panel API integration

💡 Do I need to set up a custom backend?

If your server is already wrapped in a startup loop script (like a .sh or .bat file with a while true loop, a Docker container set to restart: always, or a systemd service), SHUTDOWN_ONLY works out of the box! When the restart timer runs out, the engine gracefully stops the server, and your script starts it back up automatically.

Why configure a custom backend then?

1. Intelligent Handoff (Pterodactyl / Panels): Avoid panel desyncs or false offline indicators. Instead of just shutting down, the plugin talks to your panel's API to request a clean power cycle.
2. Self-Healing Bootups: If you don't run a startup loop script, the LOCALSCRIPT backend spawns a new process to boot the server back up automatically.
3. Crash Lockout Safety: Simple loops can get stuck in infinite crash loops if a file gets corrupted. Custom backends implement safety lockout timers to prevent endless boot hammering.

---

📦 File Selection

Choose the file that matches your server platform:

🌍 Platform Compatibility

• Bukkit / Spigot / Paper / Purpur: 1.9.x to 1.21.x+
• Folia: 1.20.1+
• Fabric: 1.20.1+
• Forge: 1.20.4+
• NeoForge: 1.20.4+

---

🖥️ Platform	Distribution Type	📄 File
Bukkit / Spigot / Paper / Purpur	Plugin	RedstoneReboot-Bukkit-<version>.jar
Folia	Plugin	RedstoneReboot-Folia-<version>.jar
Fabric	Mod	RedstoneReboot-Fabric-<version>.jar
Forge	Mod	RedstoneReboot-Forge-<version>.jar
NeoForge	Mod	RedstoneReboot-NeoForge-<version>.jar

---

📋 Supported Versions

Platform	Minecraft Versions	Notes
Bukkit-family servers	1.9 through 26.x	Java 8+ (legacy), Java 17+ (modern), Java 25 (26.x+)
Folia	1.20+ through 26.x	Dedicated region-threaded build
Fabric	1.20.1+ through 26.x	Requires Fabric API
Forge	1.20.4+ through 26.x	Dedicated server-side mod build
NeoForge	1.21.1+ through 26.x	Dedicated server-side mod build

---

⚙️ Installation

Plugin Install (Bukkit/Folia)

1. Download the correct plugin file.
2. Place it in plugins/.
3. Start the server — config files are generated automatically.
4. Configure plugins/RedstoneReboot/config.yml and restart-backends.properties.
5. Run /reboot reload to apply.

Mod Install (Fabric/Forge/NeoForge)

1. Download the correct mod file.
2. Place it in mods/ (Fabric requires Fabric API).
3. Start the server.
4. Configure config/redstonereboot.properties and config/restart-backends.properties.
5. Run /reboot reload to apply.

---

🎮 Commands

Command	Description
/reboot	View status and help
/reboot now [delay]	Trigger a restart countdown
/reboot schedule <seconds>	Schedule a future restart
/reboot cancel	Cancel a pending restart
/reboot status	Show restart schedule status
/reboot info	Show health information
/reboot doctor	Run backend & environment diagnostics
/reboot reload	Hot-reload all configuration

---

🔗 PlaceholderAPI (Bukkit Builds)

Placeholder	Example Output
%redstonereboot_next_restart%	2026-04-15 06:00:00 Europe/London
%redstonereboot_time_until%	2h 30m
%redstonereboot_status%	Normal operation
%redstonereboot_reason%	Scheduled Restart
%redstonereboot_tps%	19.8
%redstonereboot_memory%	62.4%
%redstonereboot_version%	1.4.2
%redstonereboot_timezone%	Europe/London

MOTD compatible as of v1.3.3+.

---

🔗 Quick Links

• 📖 Complete Wiki
• 💻 GitHub Repository
• 🛠️ Developer API Docs
• 📊 bStats
• 🐛 Bug Reports & Issues
• 💬 Discord Support

---

Crafted with ❤️ by DemonZ Development

Premium Minecraft infrastructure, engineered for scale.