⚡ RedstoneReboot

A Multi-Platform Minecraft Server Restart Engine

Bukkit · Paper · Purpur · Folia · Fabric · Forge · NeoForge

---

🔥 Overview

RedstoneReboot is a production-grade server lifecycle engine that gives server administrators complete control over restart scheduling, health-based automation, and multi-platform backend handoff.

Whether you're running a single Paper server, a Folia network, or a fleet of modded Fabric/Forge servers behind Pterodactyl — RedstoneReboot provides the reliability, intelligence, and configurability you need.

Key Capabilities

Feature	Description
🕐 Intelligent Scheduling	Multiple daily restart windows with timezone awareness and day-of-week filters
📊 Health Monitoring	Real-time TPS and memory tracking with consecutive-check protection against false positives
🚑 Emergency Fail-safes	Automatic emergency restarts when critical TPS or memory thresholds are breached
🔔 Rich Alerts	Chat messages, titles, action bar, and configurable sounds with countdown warnings
🔌 Backend Handoff	Delegate restart execution to Pterodactyl, Systemd, Docker, or local scripts
🔄 Hot-Reload	Change backend config and /reboot reload — no full server restart needed
📈 bStats Metrics	Anonymous usage telemetry via bStats
🧩 PlaceholderAPI	8 placeholders for scoreboards, tab lists, and MOTD plugins

---

📦 Quick Start

Plugin Install (Bukkit / Paper / Folia)

1. Download the correct JAR from Releases.
2. Place it in your plugins/ folder.
3. Start the server — config files are generated automatically.
4. Edit plugins/RedstoneReboot/config.yml and plugins/RedstoneReboot/restart-backends.properties.
5. Run /reboot reload to apply changes.

Mod Install (Fabric / Forge / NeoForge)

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

---

🖥️ Supported Platforms

Platform	Type	Minecraft Versions	Java
Bukkit / Spigot / Paper / Purpur	Plugin	MC 1.9 to 26.x	8+ (legacy), 17+ (modern), 25 (26.x+)
Folia	Plugin	MC 1.20.1+ to 26.x	17+, 25 (26.x+)
Fabric	Mod	MC 1.20.1+ to 26.x	17+ (Fabric API required)
Forge	Mod	MC 1.20.4+ to 26.x	17+
NeoForge	Mod	MC 1.21.1+ to 26.x	21+

---

🎮 Commands

Command	Permission	Description
/reboot	redstonereboot.use	Show plugin status and help
/reboot status	redstonereboot.status	View restart schedule and countdown
/reboot info	redstonereboot.status	Show server health diagnostics
/reboot now [delay]	redstonereboot.restart.now	Trigger a restart with optional countdown
/reboot schedule <seconds>	redstonereboot.restart.schedule	Schedule a future restart
/reboot cancel	redstonereboot.restart.cancel	Cancel a pending restart
/reboot doctor	redstonereboot.doctor	Run backend and environment diagnostics
/reboot reload	redstonereboot.config.reload	Hot-reload all configuration files

---

🔗 PlaceholderAPI Integration

RedstoneReboot integrates with PlaceholderAPI on Bukkit-family servers.

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

MOTD Compatible — v1.3.3+ includes null-safety fixes for server-list MOTD plugins.

---

⚙️ Backend System

RedstoneReboot separates the "when to restart" from the "how to restart" through its backend handoff system. Configure restart-backends.properties to choose:

Backend	Use Case
SHUTDOWN_ONLY	Default — graceful shutdown, external process manager restarts
LOCALSCRIPT	Auto-generated wrapper script handles restart loop
SYSTEMD	Linux servers managed by systemd services
DOCKER	Docker containers with restart policies
PTERODACTYL	Pterodactyl panel API sends restart signals

Hot-reload: Edit the backend config and run /reboot reload — no full server restart required.

---

📖 Documentation

• 📚 Wiki — Installation, configuration, backends, and troubleshooting
• 🛠️ Developer API — Bukkit API for plugin developers
• 📊 bStats — Server usage statistics
• 💬 Discord — Support and community
• 📸 Instagram — Updates and announcements

---

🏗️ Building from Source

git clone https://github.com/sdemonzdevelopment-spec/RedstoneReboot.git
cd RedstoneReboot
./gradlew build

Requires Java 21+ for building (NeoForge toolchain requirement).

Output JARs are located in <module>/build/libs/.

---

🤝 Contributing

See CONTRIBUTING.md for development setup, coding standards, and PR guidelines.

---

📄 License

This project is licensed under the terms in the LICENSE file.

---

Crafted with ❤️ by DemonZ Development