# Redstone

This page explains every setting in the Redstone module for Nemesis.

---

# Overview

The Redstone module prevents lag caused by redstone contraptions, clocks, and other high-frequency redstone systems.
It introduces intelligent throttling, automatic circuit detection, and update limitations to protect server performance.

---

# Configuration Options

# enabled

• Description: Toggles the Redstone module on or off.
• Default: true
• Recommended: Keep enabled for stable TPS and smoother gameplay.

---

# max-updates

• Description: Defines the maximum number of redstone updates allowed per tick in a single chunk.
• Default: 200
• Notes: If exceeded, the plugin temporarily disables the circuit and sends a warning in console.

---

# piston-limiter

• Description: Limits how often pistons can extend/retract within a time window.
• Default: true
• Sub-settings:
  • max-extensions: Maximum piston movements allowed in 1 second.
    • Default: 20
  • cooldown: Time in seconds before piston resets its counter.
    • Default: 3

---

# repeater-limiter

• Description: Restricts the number of redstone repeaters updating simultaneously to prevent chain lag.
• Default: true
• Sub-settings:
  • max-chain: The maximum number of repeaters that can activate in one tick.
    • Default: 15
  • auto-delay: Automatically increases repeater delay when nearing the limit.
    • Default: true

---

# comparator-limiter

• Description: Prevents excessive comparator updates caused by storage or hopper systems.
• Default: true
• Sub-settings:
  • max-updates: Max comparator updates per tick per chunk.
    • Default: 50
  • auto-disable: Automatically disables a comparator circuit if it repeatedly exceeds the threshold.
    • Default: true

---

# redstone-clock-detection

• Description: Detects and disables infinite redstone clock loops that may cause lag.
• Default: true
• Sub-settings:
  • check-interval: How often (in ticks) the system checks for clock loops.
    • Default: 100
  • cooldown: Time (in seconds) a detected loop remains disabled before being re-evaluated.
    • Default: 10
  • log: Whether to log clock detections in console.
    • Default: true

---

# notify

• Description: Sends staff a notification when redstone lag protection is triggered.
• Default: true
• Sub-settings:
  • permission: The permission required to receive alerts.
    • Default: nemesis.redstone.notify
  • message: Custom message shown to staff.
    • Default: &c[Nemesis] Redstone limiter triggered in &f%chunk%!

---

# Permissions

---

# Debug Options

# debug

• Description: Enables verbose logging for redstone checks and limiter actions.
• Default: false
• Recommended: Only enable when diagnosing redstone performance issues.

---

# Tips

• Avoid disabling this module — redstone contraptions can severely impact performance on large servers.
• Increasing max-updates or max-chain values can reduce false positives but may slightly increase lag.
• Combine with the Vision module for best anti-exploit coverage.