Redstone Manager v1.0

Redstone Manager
Intelligent Oversight. Zero Lag. Complete Control.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Real-Time Monitoring ◆ 3 Protection Modes ◆ Folia Ready ◆ Web Dashboard ◆ 6 Languages ◆ Paper 1.21

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



What Redstone Manager Solves​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


How Protection Works

Every redstone event flows through a single optimized listener.
Chunk counters and block counters run on fastutil primitive maps with zero boxing overhead.

◆ Chunk Threshold Total redstone events per chunk per cycle. Exceed it and the chunk is actioned.
◆ Block Threshold Events per individual component. Catches clock circuits at the source.
◆ Clock Detection Dedicated rapid-fire detector. Freezes offending blocks for a configurable duration.
◆ Entity Limits Cap entities per chunk. CLEAR or DROP mode. Works alongside redstone protection.
◆ Per-Player Limits Track who placed what. Cap events per player. Pair with per-group limits for ranked tiers.
◆ Per-Group Limits Grant higher thresholds via permission nodes. VIPs get more redstone freedom.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


Three Protection Modes


◆ CLEAR Silently removes the offending block. Fastest path. No item drops. No player notification.
◆ FREEZE Disables redstone output from the component. Temporary. Unfreezes after the reset cycle.
◆ DROP Breaks the block and drops the item. Lets players recover their components.

Every action is logged. CoreProtect and Prism integration records removals under user #RedstoneManager. Roll back any action with a single command.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


TPS Auto-Disable with Hysteresis


Redstone Manager monitors server TPS independently. If TPS drops below your configured floor, all redstone protection pauses automatically to eliminate any processing overhead. When TPS recovers above your ceiling threshold, protection resumes. This happens without admin intervention. The system uses proper hysteresis so it never flip-flops on borderline values.

This is not a gimmick. It is the difference between a lag spike and a crash loop.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


Premium Purple GUI


Every setting is accessible through a polished in-game panel. No config file editing required. No restarts. No console commands.

◆ Hub Central menu with live TPS and uptime. One click to any settings page.
◆ Limits Adjustable sliders for chunk, block, clock, entity, per-player, and per-group thresholds. Left-click to decrease, right-click to increase. Changes save and apply instantly.
◆ Protection Cycle protection modes with one click. Toggle player warnings, TPS auto-disable, and chunk whitelists.
◆ Notifications Staff alerts, console logging, debug mode, and Discord webhook. All toggleable in one place.
◆ Advanced Reset interval, monitoring toggle, web dashboard, config export to base64, and heatmap viewer.
◆ Live Stats Real-time TPS, chunk count, block count, events per cycle, total removals, and daily stats. Refreshes on click.
◆ Active Chunks Paginated view of every chunk with active redstone. Left-click to teleport. Right-click to freeze for 10 seconds. Frozen and whitelisted chunks shown with distinct icons.

Purple glass borders, amber accents, and grouped layouts. The GUI looks as premium as the protection it provides.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


Core Systems


◆ Performance Engine

• fastutil Object2IntOpenHashMap for chunk and block counters. Zero Integer boxing. Zero GC pressure.
• Single EventPriority.LOW listener processes every redstone event in one pass.
• Alert cooldowns prevent notification spam during cascading failures.
• Configurable reset interval. Counters flush on cycle, not continuously.

◆ Folia Support

• Auto-detects Paper Folia at startup. Switches to region-aware schedulers transparently.
• Same codebase. Same config. No separate download.
• Standard Bukkit scheduler used when Folia is not detected.

◆ Alert System

• Clickable chat alerts with teleport to chunk, freeze chunk, and ignore chunk actions.
• Player warnings at configurable percentage of threshold. Cooldown per player.
• Discord webhook integration with embed fields: location, component, chunk load, block load, placed by.
• Console log with world, coordinates, material, and chunk/block counter values.

◆ Chunk Whitelist

• Permanently exempt specific chunks from all redstone monitoring.
• Add entries via GUI, console, or in-game command. Format: world-uuid:chunkX:chunkZ.
• Persists across restarts in config.yml. Survives reloads.

◆ Scheduled Restrictions

• Define time windows with different limits for peak and off-peak hours.
• Separate chunk, block, and clock thresholds per window. Per-day granularity.
• First match wins. Configure once, runs automatically.

◆ Web Dashboard

• Built-in HTTP server on configurable port. No external dependencies.
• Live counter data, heatmap visualization, and system status.
• Toggle on or off in config.yml. Does not start unless enabled.

◆ Heatmap

• Accumulates chunk activity data across monitoring cycles.
• Viewable via GUI or /rm heatmap command.
• Top 10 most active chunks shown in ranked output.

◆ Rollback Integration

• All CLEAR and DROP actions logged under user #RedstoneManager.
• Full CoreProtect and Prism support. Auto-detected, no configuration needed.
• Rollback any removal with /co rollback user:#RedstoneManager t:1h r:100.

◆ Multi-Language

• 6 built-in languages: English, Polish, German, Spanish, French, Russian.
• All messages use MiniMessage with full hex color support. Purple theme throughout.
• Language switch is a single line in config.yml. English fallback for any missing keys.
• Every GUI label, chat alert, warning, and console message is localized.

◆ Config Export and Import

• Export your entire config as a base64 string from the GUI or /rm export.
• Import on another server with /rm import <base64>. Automatic backup of previous config.
• Perfect for network owners managing multiple servers with identical settings.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


How Redstone Manager Compares


​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


Who This Is For

• Survival and SMP servers Protect your world from accidental clock circuits and mega-farms without punishing creative builders. Warn before acting. Whitelist trusted chunks.
• Factions and Towny Per-player and per-group limits let you give donators higher redstone allowances. Scheduled restrictions enforce stricter limits during peak hours.
• Anarchy and semi-anarchy Silent CLEAR mode removes lag machines without a trace. No alerts. No warnings. Just stable TPS.
• Network owners Export your config once, import across every server. Same limits, same protections, same language. One command per server.
• Performance-focused admins If you care about your server's tick rate, this plugin is built for you. fastutil primitives, zero boxing, single listener, configurable cycles.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


Technical Specs


​

◆ Commands

​

◆ Permissions

​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



Get Redstone Manager

Your server is running redstone right now. You just cannot see which chunk is about to crash it.

Real-time monitoring. Three protection modes. Premium GUI. One plugin.

Download. Drop in. Your TPS will thank you.

Questions? Join our Discord. Feature requests and language contributions are welcome.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
​