---

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

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 <id>	Block a suspicious chunk
/ras ignore <id>	Ignore a suspicious detection
/ras tp <id>	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

---