RedOut

RedOut maps server metrics like mspt to item frame comparator outputs. Giving a non-invasive way to players to shut off their redstone contraptions and farms when the server gets too laggy or before shutdown. Made for Minecraft 1.21.11 and above. The name RedOut is a portmanteau of "Redstone" and "read out" because you read out server values with redstone :)

How it works

Rename an item in an anvil to one of the trackers available and place it in an item frame.
The frame's rotation (and therefore its comparator output, signals 1–8) will update automatically.

Built-in trackers:

Item name	Metric
mspt	By default 10ms per redstone level
daily restart	Countdown to next shutdown (daily or one-time). By default 1m per redstone level.

---

Commands

All subcommands require the matching permission listed below.

/redout reload

Reloads config.yml without restarting the server.

/redout status

Shows one-time shutdown countdown (if scheduled) and daily restart time with countdown.

/redout trackers list <#all|trackerId>

Lists all currently loaded tracked item frames for a specific tracker or all trackers.
Output includes world name and block coordinates. Frames in unloaded chunks are not shown.

/redout schedule shutdown set <time> [--force]

Schedules a one-time server shutdown. RedOut will run the configured pre-shutdown commands and then call shutdown.
Do not persist trough restarts.

/redout schedule shutdown unset

Cancels the current one-time shutdown schedule.

/redout schedule shutdown status

Shows time remaining until the next shutdown (one-time or daily).

/redout schedule shutdown daily <HH:mm|disable>

Updates the daily restart time in config.yml. Use disable to turn off the daily restart entirely. The tracker will still function as expected for one-time shutdowns.

Accepted time formats for set:

Format	Example	Meaning
Ns	90s	N seconds from now
Nm	10m	N minutes from now
Nh	2h	N hours from now
HH:mm	23:00	Wall-clock time (next occurrence)
HH:mm:ss	23:00:00	Wall-clock time with seconds

Minimum allowed time = max(signal-interval-seconds × 8, largest pre-shutdown command key).
Use --force to bypass the minimum. The minimum exists to ensure that the shutdown signal can reach 8 before shutdown, giving players a chance to react and shut off their contraptions.

---

Permissions

Permission	Default	Description
redout.reload	op	/redout reload
redout.status	op	/redout status
redout.trackers	op	/redout trackers list
redout.schedule	op	/redout schedule shutdown *

---

Configuration

config.yml is created automatically on first run.

Key	Default	Description
update-interval-ticks	20	How often frames are updated (ticks). 20 = 1 s.
signal-interval-seconds	60	Seconds per comparator signal step for the daily restart tracker.
trackers.mspt.max-value	50.0	MSPT value that maps to signal 8.
trackers.daily restart.time	03:00	Daily restart time (24-hour HH:mm, server local time). Set to "disabled" to disable the daily countdown.
shutdown-commands	see below	Commands run before a one-time shutdown. Keys are time offsets before shutdown.
daily-restart-commands	see below	Commands run before the daily restart time. No shutdown is issued by RedOut.

%player% in a command value causes it to run once per online player with the player name substituted.

Example config.yml:

update-interval-ticks: 20
signal-interval-seconds: 60

trackers:
  mspt:
    max-value: 50.0
  daily restart:
    time: "03:00"

shutdown-commands:
  5m: "say Server shutting down in 5 minutes!"
  1m: "say Server shutting down in 1 minute!"
  10s: "kick %player% Server is shutting down for maintenance."

daily-restart-commands:
  5m: "say Daily restart in 5 minutes!"
  1m: "say Daily restart in 1 minute!"