

The Ultimate High-Performance Redstone Lag Prevention for Modern Minecraft Servers
Features • Performance Specs • Installation • Commands • Developer Builds
⚡ About AntiRedstoneLag
AntiRedstoneLag is a lightweight yet extremely powerful plugin designed to safeguard your server from redstone-based lag machines and accidental over-engineering. Unlike basic limiters, AntiRedstoneLag uses asynchronous logging and O(1) tracking structures to monitor redstone activity with zero impact on your server's tick rate.
✨ Features
- 🚀 Asynchronous Foundation: Logging and timestamp generation are offloaded to background threads.
- 🎯 O(1) Chunk Cleanup: Refactored tracking logic for instant cleanup during chunk unloading.
- ✨ Modern UI: Full migration to Adventure API and MiniMessage for beautiful, hex-color alerts.
- 🛡️ Lag Guard 1.21: Specifically optimized for Paper 1.21+ physics and redstone handling.
- ⚙️ Smart Actions: Choose between
REMOVE(with physics notifications),DROP, orDISABLE. - 📊 Persistent Analytics: Statistics tracking that survives server restarts.
- 🔄 Automated CI/CD: Development builds published automatically via GitHub Actions.
🚀 Performance Specs
| Optimization | Method | Impact |
|---|---|---|
| Tracking | Nested Concurrent Maps | O(1) Chunk Cleanup |
| Messaging | Adventure API | Hex & Gradient Support |
| Logging | Async Timestamping | Zero Main-Thread Overhead |
| Memory | Fastutil Collections | Reduced Boxing/GC Pressure |
📦 Installation
- Download the latest release from Modrinth or GitHub.
- Place the
.jarin your server'splugins/folder. - Restart your server.
- Configure limits in
plugins/AntiRedstoneLag/config.yml.
Requirements: Paper, Spigot, or Purpur 1.21.1+ and Java 21.
🛠️ Configuration
Modern power and simplicity. AntiRedstoneLag supports MiniMessage hex codes (<gold>, <#ffcc00>, etc.) in all messages.
View Optimized config.yml
# Thresholds
chunk-threshold: 500 # Max redstone updates per chunk per resetting interval
block-threshold: 15 # Max updates per individual block before action
# Reset interval in ticks (20 = 1 second)
reset-interval-ticks: 20
# Action when threshold exceeded: REMOVE, DISABLE, or DROP
# REMOVE: Clears block (Recommended)
# DISABLE: Cancels active signals
# DROP: Breaks block and drops items
removal-action: REMOVE
# Warning system
warning:
enabled: true
threshold-percent: 80 # Warn at 80% of threshold
# Alerts
alerts:
enabled: true
log-to-console: true
# Logging
logging:
enabled: true
performance-stats: true
💻 Commands & Permissions
| Command | Description | Permission |
|---|---|---|
/arl help | View command help | antiredstonelag.use |
/arl reload | Hot-reload config | antiredstonelag.reload |
/arl stats | Real-time performance stats | antiredstonelag.stats |
/arl logs | View removal history | antiredstonelag.logs |
🏗️ Automated Builds
We use GitHub Actions to ensure code quality and instant delivery. Every push to master triggers a development build.
Beta Testing: Want the latest fixes before a stable release? Download the latest Development Pre-release from the Repository Actions or the Releases tab (labeled with
dev-bX).
