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, or DISABLE.
• 📊 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

1. Download the latest release from Modrinth or GitHub.
2. Place the .jar in your server's plugins/ folder.
3. Restart your server.
4. Configure limits in plugins/AntiRedstoneLag/config.yml.

Important

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.

Tip

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).

---

❓ Support

---

📜 License

MIT License - Copyright © 2025 AyoSynk. Developed with ❤️ for the Minecraft High-Performance Community.