⚡ FrozenRedstone

📦 Plugin Info

FrozenRedstone protects your server from redstone-based lag machines by detecting and throttling abusive contraptions — high-frequency clocks, observer ping-pong loops, spam-piston machines, and cascading block-update storms — in real time, while leaving normal farms, doors, and elevators completely untouched. Download it if griefers or accidental "lag machines" have ever brought your server's TPS to a crawl and you want automatic protection without manually policing redstone builds.

• Name: FrozenRedstone
• Version: 2.0.0
• Description (plugin.yml): Advanced redstone lag prevention for Paper 1.21 - 1.21.11

👤 Author Info

• Author: DrFrozenXD

✅ Versions / Compatibility / Software Support

• API Version: 1.21
• Supports: Paper 1.21 – 1.21.11
• Server software: Paper and forks
• Dependencies: None — fully standalone

🔐 Permissions

Permission	Default	Purpose
frozenrc.admin	op	Access to all /frozenrc admin commands

⌨️ Commands

Command	Aliases	Permission	Usage
/frozenrc	/frc, /frozenredstone	frozenrc.admin	/frozenrc <status|stats|reload|reset|debug|help>

• status — shows current configuration and which protections are enabled
• stats — shows throttle/suppression statistics since last reset
• reload — reloads config.yml live
• reset — resets accumulated statistics back to zero
• debug — toggles debug/verbose console logging in-session
• help — shows the command list

🎯 Uses

• 🕒 Clock Detection — catches repeaters, comparators, torches, and observers firing faster than a configurable threshold (default 20/sec) and briefly freezes them. Normal 2–10 Hz farm clocks are never touched.
• 🔁 Observer Loop Prevention — cancels infinite observer-vs-observer ping-pong loops, a common lag-machine exploit.
• 🧱 Piston Control — rate-limits piston extend/retract cycles to stop piston-spam lag machines, and can block the sticky-piston "flying machine" exploit pattern. Normal doors, farms, and elevators (1–3 activations/sec) are unaffected.
• 🛑 Update Suppressor — a hard per-tick cap on block physics events as a last-resort safety net against massive update cascades. Buttons, levers, and pressure plates are always exempt so player interaction never breaks.
• 🗺️ Chunk Redstone Limiter — caps total redstone updates per chunk per second, catching large distributed lag machines that spread across many blocks.
• 📢 Optional admin notifications whenever a lag source gets throttled, so you know exactly what triggered it and where.
• 🐛 Built-in debug logging for diagnosing false positives or tuning thresholds to your server's builds.

⚙️ Key Config Areas (config.yml)

• debug — toggle verbose console logging
• clock-detection.* — enable/disable, activations-per-second threshold, freeze cooldown, admin notifications
• observer-loop.* — enable/disable observer ping-pong loop cancellation
• piston-control.* — enable/disable, max extensions/sec, sticky-piston flying-machine blocking
• update-suppressor.* — enable/disable, max block-physics updates processed per tick
• chunk-limiter.* — enable/disable, max redstone updates per chunk per second
• prefix — chat message prefix shown in plugin messages