Iustitia / Docs / Combat / Triggerbot

Triggerbot

[!] Inferential
Triggerbot — deliberately LAX, only flags really blatant sub-reaction auto-attackers. The cheat auto-attacks the instant the crosshair reaches a victim's hitbox. Unlike KillAura/HitFlick, a triggerbot DOES face the target, so the only inhuman signal is timing.
id: triggerbot  ·  class: TriggerbotCheck  ·  group: Combat

What it detects

Triggerbot — deliberately LAX, only flags really blatant sub-reaction auto-attackers. The cheat auto-attacks the instant the crosshair reaches a victim's hitbox. Unlike KillAura/HitFlick, a triggerbot DOES face the target, so the only inhuman signal is timing.

Observer signature

Every tick raycasts eye-to-look against each nearby victim's pose-aware hitbox (within 3.0 reach), recording the tick the crosshair FIRST reaches each victim's hitbox (rising edge). onAttack classes a hit as 'fast' when ev.tick - engagementStart is in 0..3. A 24-hit rolling window flags at level 1.0 only when fastCount >= 4 AND total >= 5 AND fastCount/total >= 0.75.

False-positive guards

  • Attacker-in-vehicle exempt
  • Victim must be tracked; victim-dead exempt
  • Cheap distance pre-check (range^2 25.0)
  • Pose-aware hitbox (avoid early rising edge on crouched victims)
  • Chunk-unloaded-safe (no world query; near-origin pos never in reach -> skipped)
  • MAX_REACTION_TICKS=3 absorbs 0-2-tick reaction on both protocols; consistency gate absorbs the 3-4 tick ambiguous zone

Configuration

Defaults (editable in-game via the YACL config screen or /ius config):

FieldDefault
enabledtrue
setbackVL5.0
decay0.05
threshold4.0
look reach3.0
max reaction3 ticks
min samples5
window24 hits
ratio0.75

Source

src/main/kotlin/dev/iustitia/checks/combat/TriggerbotCheck.kt  ↗