# ✨ RedstoneAntiLag ✨ [![Paper 1.21+](https://img.shields.io/badge/Paper-1.21+-blue.svg)](https://papermc.io/) [![Paper 1.20+](https://img.shields.io/badge/Paper-1.20+-blue.svg)](https://papermc.io/) [![Java 21+](https://img.shields.io/badge/Java-21+-orange.svg)](https://www.oracle.com/java/) > **The most complete redstone lag prevention toolkit for Paper servers.** > Stop server meltdowns before they happen — with zero compromise on player experience.

--- ## Why RedstoneAntiLag? Most "anti-lag" plugins are reactive: they kick in *after* your TPS is already destroyed. **RedstoneAntiLag** is proactive. It monitors your server's redstone activity at the chunk level in real time, giving you surgical precision to restrict exactly what's causing lag — without a blanket ban on all redstone. Got a mega-farm that's totally fine? **Whitelist that chunk.** Got a grief machine spinning up in a hidden basement? **Auto-detect it, teleport there, and shut it down — all from chat.** --- ## Features ### Global Redstone Toggle - Enable/disable all redstone server-wide via command - Instant effect, no restart required - Optional broadcast to all players ### TPS-Based Auto Disable - Monitors server TPS every few seconds - Auto-disables redstone when TPS drops below your threshold - Auto-re-enables when TPS recovers - Hysteresis thresholds prevent on/off flapping - Fully configurable broadcasts ### Per-Chunk Piston Limiter - Cap piston activations per chunk per second - Silently cancels excess activations — no explosions, no errors ### Redstone Signal Rate Limiter - Cap redstone updates per chunk per second - If exceeded: chunk redstone is **frozen** for a configurable time - Players inside frozen chunks are informed why their redstone stopped ### Entity Limits Per Chunk - Max armor stands per chunk - Max minecarts per chunk — counting **all 6 types**: - Normal, Chest, Hopper, TNT, Furnace, Command Block ### Manual Chunk Block - Block redstone in any chunk with one command - Supports temporary blocks (e.g., `/ra block 3600` = 1 hour) - Or permanent blocks ### Suspicious Chunk Detection - Automatically flags chunks that exceed activity thresholds - Two notification modes: **instant** or **interval** (e.g., every 800 seconds) - Each detection is numbered and actionable from chat: - Clickable **[TP]** button to teleport safely to chunk surface - Clickable **[BLOCK]** to block redstone immediately - Clickable **[IGNORE]** to dismiss the detection - Auto-expires after a configured time if no action is taken ### Permanent Chunk Ignore - Mark important chunks as permanently exempt from **all** restrictions - These chunks work normally even when global redstone is disabled - Perfect for vital farms you never want restricted ### Restricted Chunk List - One command to see all blocked, frozen, and ignored chunks - Shows world, coordinates, type, and expiry timestamp ### Player Status Command - `/ra status` — any player can check the redstone status of their chunk - Shows current TPS, freeze state, block state, or global disable state --- ## Configuration Preview ```yaml tps-auto-disable: enabled: true threshold: 15.0 restore-threshold: 18.0 broadcast: true signal-limit: enabled: true max-updates-per-second: 150 freeze-duration: 15 suspicious-detection: enabled: true updates-threshold: 200 notification-mode: "instant" auto-expire: 3600 ``` --- ## Commands | Command | Description | |---------|-------------| | `/ra status` | Check redstone status in your current chunk | | `/ra toggle` | Toggle global redstone on/off | | `/ra block [seconds]` | Block redstone in current chunk | | `/ra unblock` | Unblock current chunk | | `/ra ignore` | Permanently ignore current chunk | | `/ra list` | List all restricted chunks | | `/ra suspicious` | View suspicious chunk detections | | `/ras block ` | Block a suspicious chunk | | `/ras ignore ` | Ignore a suspicious detection | | `/ras tp ` | Teleport to suspicious chunk | | `/ra reload` | Reload configuration | | `/ra help` | Show all commands | --- ## Permissions | Permission | Description | |-----------|-------------| | `redstonelag.use` | Use `/ra status` (default: everyone) | | `redstonelag.admin` | All admin commands | | `redstonelag.bypass` | Bypass all restrictions | --- ## Performance RedstoneAntiLag is engineered for minimal footprint: - **No per-tick loops** — all processing is event-driven or uses scheduled tasks at long intervals - **O(1) chunk lookups** using ConcurrentHashMap - **Lazy expiry** — expired entries are cleaned on access, with a periodic sweep every 5 minutes - **No database** — everything lives in memory, instant response - **No reflection** — uses stable Paper API only --- ## Compatibility | Version | Status | |---------|--------| | Paper 1.21.x | Fully Supported | | Paper 1.20.x | Compatible | | Spigot | Not Supported | | Folia | Not Supported | **Java 21+ required.** --- ## Support - contact me on discord nickname: **we_rt**, only with important bug related things --- ## 📜 License - The source code is not publicly available, contact me on discord nickname: we_rt if you want something ---

**Made with ❤️ for the Minecraft community**

FlashyReese

Badges