Skip to content

Hitmode

Claude edited this page Apr 15, 2026 · 1 revision

Hitmode

Jaymod features an entirely new hitbox architecture introduced in version 2.1.0 (credits to Zinx Verituse for player-animation tracking). It provides six hitbox modes, antilag for all bullet weapons, and visual debugging tools.


Overview

Feature Detail
Antilag Applied to all bullet weapons (not just rifles)
Modes 6 modes from a single box to 10 animation-tracked boxes
Hitsounds Distinct sounds for friendly/enemy and body part hit
Debug Visual overlay showing hit zones

Selecting a mode

set g_hitmode 0

Mode 0 (auto) is recommended -- it automatically selects the best mode.


Modes

Mode 0 -- Auto

Automatically selects the recommended mode based on server conditions.

Mode 1 -- Entity

A single bounding box covering the entire body. Reference baseline. Fastest, least accurate.

Mode 2 -- ETmain

Three boxes: head, torso, feet. Matches stock Enemy Territory behaviour.

Mode 3 -- Basic

Three boxes (head, torso, feet) with corrections for crouching, prone, and playdead stances.

Mode 4 -- Standard

Three boxes with animation-accurate head tracking. Good balance of accuracy and performance.

Mode 5 -- Advanced

Nine boxes: head, arms, hands, torso, feet -- all tracked per animation frame. High accuracy.

Mode 6 -- Oriented

Ten boxes: head, arms, hands, torso, legs, feet -- including full leg tracking. Highest accuracy.


Antilag

Antilag compensates for network latency by rewinding player positions to match the shooter view at the time of the shot.

Cvar Default Description
g_hitmodeAntilag 100 History buffer length in milliseconds
g_hitmodeAntilagLerp 1 Enable position interpolation between history frames

Fat torso box

The torso hitbox can be expanded to be more forgiving for close-range shots.

Cvar Default Description
g_hitmodeFat 0 Torso-box size multiplier (0 = default size)

Hit ghosting

Prevents double-counting a hit that spans two frames.

Cvar Default Description
g_hitmodeGhosting 200 Ghosting lifetime in milliseconds

Debug

Cvar Description
g_hitmodeDebug Bitmask enabling visual hitbox overlays and debug output
g_hitmodeZone Zone index to highlight in debug display
g_hitmodeReference Sets which mode is used as the reference baseline

Full cvar reference

Cvar Default Description
g_hitmode 0 Active hitbox mode (0 = auto)
g_hitmodeAntilag 100 Antilag history in milliseconds
g_hitmodeAntilagLerp 1 Enable antilag interpolation
g_hitmodeFat 0 Torso-box size multiplier
g_hitmodeGhosting 200 Hit-ghost lifetime in milliseconds
g_hitmodeReference 1 Reference mode for debug comparison
g_hitmodeDebug 0 Debug overlay bitmask
g_hitmodeZone 0 Debug zone index

Clone this wiki locally