Redstone Monitor Documentation
Overview
Redstone Monitor is a lightweight Minecraft plugin built for Paper 1.21+ that tracks and analyzes redstone activity across your server. It is designed to help server administrators identify performance issues caused by redstone without interfering with gameplay.
The plugin does not block, cancel, or modify redstone behavior. Its purpose is purely monitoring, analysis, and reporting.
Installation
Download the plugin .jar file
Place it in your server’s /plugins folder
Start or restart your server
A configuration file will be generated automatically
Edit the config if needed, then run:
/redstonemonitor reload
Core Concept
Redstone Monitor works by analyzing redstone updates on a per-chunk basis. Instead of tracking every single block globally, it groups activity into chunks, making it significantly more efficient.
This allows the plugin to:
Detect high-activity areas
Identify lag sources
Provide accurate statistics without heavy performance cost
Commands
/redstonemonitor
Opens the main command menu
/redstonemonitor help
Displays all commands
/redstonemonitor toggle
Enables or disables monitoring
/redstonemonitor stats
Shows server-wide redstone stats
/redstonemonitor top
Displays most active chunks
/redstonemonitor reload
Reloads configuration
Permissions
redstonemonitor.admin
Full access to all commands
redstonemonitor.view
View stats and reports
redstonemonitor.notify
Receive alerts
Configuration
File location:
/plugins/RedstoneMonitor/config.yml
Example:
monitoring: enabled: true interval-ticks: 20
thresholds: high-activity: 500 warning-level: 300
alerts: enabled: true notify-permission: redstonemonitor.notify
performance: use-chunk-analysis: true max-tracked-chunks: 500
Configuration Explanation
enabled
Turns monitoring on or off
interval-ticks
How often data is collected (20 ticks = 1 second)
high-activity
Activity level that triggers alerts
warning-level
Lower threshold for early warnings
alerts.enabled
Enables or disables alert system
max-tracked-chunks
Limits memory usage by restricting tracked chunks
Alerts System
When redstone activity exceeds configured thresholds, the plugin sends alerts to players with the permission:
redstonemonitor.notify
Alerts include:
Chunk location
Activity level
Severity (warning or high)
Performance Impact
Redstone Monitor is designed to be lightweight:
Uses chunk-based tracking instead of per-block tracking
Runs on configurable intervals
Avoids heavy computations on the main thread
This ensures minimal impact even on large servers.
Best Practices
Adjust thresholds based on your server size
Use /redstonemonitor top regularly to identify problem areas
Combine with performance tools like timings or profiling plugins
Avoid setting very low thresholds to prevent spam
Troubleshooting
Plugin not working:
Ensure you are using Paper 1.21+
Check console for errors
Verify the plugin is enabled
No alerts showing:
Check if alerts are enabled in config
Ensure you have the correct permission
High memory usage:
Reduce max-tracked-chunks
Increase monitoring interval
Compatibility
Paper 1.21+
Compatible with most plugins
Does not interfere with redstone mechanics
Overview
Redstone Monitor is a lightweight Minecraft plugin built for Paper 1.21+ that tracks and analyzes redstone activity across your server. It is designed to help server administrators identify performance issues caused by redstone without interfering with gameplay.
The plugin does not block, cancel, or modify redstone behavior. Its purpose is purely monitoring, analysis, and reporting.
Installation
Download the plugin .jar file
Place it in your server’s /plugins folder
Start or restart your server
A configuration file will be generated automatically
Edit the config if needed, then run:
/redstonemonitor reload
Core Concept
Redstone Monitor works by analyzing redstone updates on a per-chunk basis. Instead of tracking every single block globally, it groups activity into chunks, making it significantly more efficient.
This allows the plugin to:
Detect high-activity areas
Identify lag sources
Provide accurate statistics without heavy performance cost
Commands
/redstonemonitor
Opens the main command menu
/redstonemonitor help
Displays all commands
/redstonemonitor toggle
Enables or disables monitoring
/redstonemonitor stats
Shows server-wide redstone stats
/redstonemonitor top
Displays most active chunks
/redstonemonitor reload
Reloads configuration
Permissions
redstonemonitor.admin
Full access to all commands
redstonemonitor.view
View stats and reports
redstonemonitor.notify
Receive alerts
Configuration
File location:
/plugins/RedstoneMonitor/config.yml
Example:
monitoring: enabled: true interval-ticks: 20
thresholds: high-activity: 500 warning-level: 300
alerts: enabled: true notify-permission: redstonemonitor.notify
performance: use-chunk-analysis: true max-tracked-chunks: 500
Configuration Explanation
enabled
Turns monitoring on or off
interval-ticks
How often data is collected (20 ticks = 1 second)
high-activity
Activity level that triggers alerts
warning-level
Lower threshold for early warnings
alerts.enabled
Enables or disables alert system
max-tracked-chunks
Limits memory usage by restricting tracked chunks
Alerts System
When redstone activity exceeds configured thresholds, the plugin sends alerts to players with the permission:
redstonemonitor.notify
Alerts include:
Chunk location
Activity level
Severity (warning or high)
Performance Impact
Redstone Monitor is designed to be lightweight:
Uses chunk-based tracking instead of per-block tracking
Runs on configurable intervals
Avoids heavy computations on the main thread
This ensures minimal impact even on large servers.
Best Practices
Adjust thresholds based on your server size
Use /redstonemonitor top regularly to identify problem areas
Combine with performance tools like timings or profiling plugins
Avoid setting very low thresholds to prevent spam
Troubleshooting
Plugin not working:
Ensure you are using Paper 1.21+
Check console for errors
Verify the plugin is enabled
No alerts showing:
Check if alerts are enabled in config
Ensure you have the correct permission
High memory usage:
Reduce max-tracked-chunks
Increase monitoring interval
Compatibility
Paper 1.21+
Compatible with most plugins
Does not interfere with redstone mechanics
Resource Information
Author:
----------
Total Downloads: 13
First Release: May 5, 2026
Last Update: May 5, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings