Iron Watch

IronWatch is a modular anti-cheat for Paper servers with ProtocolLib integration, per-player state tracking, and configurable thresholds. Designed for low false-positives and easy tuning.

Features

• 55+ detections across Combat, Movement, Player
• Combat: Aim (A–E), Kill Aura (A–F), Reach (A), Auto Clicker (A–B), Hitbox (stubs)
• Movement: Speed (A–D), Flight (A–E), Jesus (A), Step (A), VClip (A), Strafe (A), Wall Climb (A), Fast Climb (A), Entity Speed (A)
• Player: Bad Packets (A–D), No Slow (A), Timer (A–D), Inventory (A–B), Invalid (A–C), Ground Spoof (A–C), Scaffold (A)
• ProtocolLib packet processing (USE_ENTITY, POSITION, POSITION_LOOK, LOOK, ARM_ANIMATION, CLIENT_COMMAND, BLOCK_DIG/PLACE)
• Violation decay service to reduce false positives
• Configurable limits/thresholds via config.yml

Requirements

• Paper 1.20.1+ (Java 17)
• ProtocolLib 4.8.0 (recommended)

Installation

• Place IronWatch-1.0.0.jar in your server plugins/ folder
• Ensure ProtocolLib is installed
• Start the server to generate config.yml
• Run /ironwatch to view version and loaded detections

Configuration

violation:
  decay_per_second: 0.5
checks:
  flight:
    air_time_ms: 1500
  speed:
    base_limit: 0.35
    ice_bonus: 0.15
    liquid_bonus: 0.25

Usage

• Command: /ironwatch shows plugin version and detection count
• Tuning: adjust checks.* values to your server's movement/combat balance
• Logs: violations are logged with player name, check key, and current VL