pubg_derecoil

Establish what actually fits on what — which attachment slots a weapon has, and which attachments each slot accepts — by fitting parts in the training range and reading them back. Use when a drag lands nothing and it is unclear whether the slot is missing or the part is rejected, when a weapon is new or unverified, after a patch changes loadouts, or to replace a wiki-sourced guess in detector/attachment_catalog.py with a measurement. Not for what an attachment icon looks like (calibrate-template) or where the slots are drawn (calibrate-screen).

Measure a weapon's real recoil off the screen and rebuild its compensation curve from it, in the training range. Use when a gun sprays despite compensation, after a game patch changes recoil, to extend coverage to a weapon that has no measured curve, or to test what an attachment actually does. Also the entry point for diagnosing a calibration run that failed — most failures are state, not measurement. Not for mouse-to-view scale (K), which is calibrate_k.py.

Calibrate a game UI screen's interactive layout — where its rows, slots, list entries and weapon positions are, and how to tell the screen is even up. Use when a new screen or tab needs to be driven by clicks/drags (spawner panel, Tab inventory, a settings tab), or when an existing layout stopped matching after a game update. Produces a detector/<screen>_layout.py, an anchor check, and a docs/<screen>/README.md of the measurements. Not for what a single icon, string or digit looks like and where it is composited — that is calibrate-template.

Give a detector a picture it can match, and prove it matches the right thing — icon glyphs, rendered UI text and HUD digits alike (attachment icons, weapon name plates, Type/类型, the ammo counter, button icons used as landmarks). Also covers where an icon is drawn and how it is composited (position, scale, alpha, blend formula). Use when a detector stops recognising something, after a game update or language switch, when a new weapon or attachment reads as unknown, to add a template variant, or to work out an icon's blend parameters. For a screen's row/slot geometry use calibrate-screen.