CoverMod-DE 1.0.2
Controller cover system for GTA San Andreas - The Definitive Edition (PC)

FEATURES
Standing and crouched wall/parked-vehicle cover, sidling, distant approaches,
reversible corner peeks, over-cover aiming, blind fire, gap transfers,
low-cover vaults and optional directional manual dodge rolls.
Roll collisions stop travel while the animation finishes and blends out.
Low-cover approaches and transfers preserve crouched movement.

REQUIREMENTS AND COMPATIBILITY
Tested setup: San Andreas DE 1.0.112.6680 with CLEO Redux 1.4.2 (64-bit).
Install CLEO Redux separately. This archive does not include the game or CLEO.
The script uses CLEO memory/DLL access. Keep the script filename intact.
Native blind fire and duck cleanup are guarded for the tested executable;
other game builds are not verified. Cover works during missions; loss of player control still releases it.
The bridge includes this project's ImprovedMove integration. Keep any existing
ImprovedMove script/INI if using that mod; they are not included here.
Other xinput1_3.dll loaders cannot simply be overwritten and used together.
The animation PAK overrides anim.uasset/anim.uexp; other overrides may conflict.

INSTALL / UPGRADE
1. Fully close the game.
2. Back up any existing files at the four destinations below. When upgrading,
   keep a copy of your CoverMod-DE.ini preferences before merging the archive.
3. Merge the included Gameface folder into the San Andreas DE game directory.
4. Ensure only one copy of the CoverMod-DE CLEO script is active.
5. Start the game. A full restart is required after installing or configuring.

INSTALLED FILES
Gameface/Binaries/Win64/CLEO/CoverMod-DE[mem][dll].js
Gameface/Binaries/Win64/xinput1_3.dll
Gameface/Binaries/Win64/CoverMod-DE.ini
Gameface/Content/Paks/~mods/900-CoverMod-DE-Animations_P.pak

DEFAULT CONTROLS (XBOX LABELS)
RB / F7: acquire nearby cover; press again to leave/cancel.
LS: sidle; pull away to leave with a blended exit.
L3: switch standing/crouched cover stance.
LT: peek and aim. Release to return; brief presses allow feints.
LS direction + LT: choose a side peek when an opening is available.
LT + RT: normal aimed fire.
RT without LT: blind fire. LS chooses side versus over-top on low cover.
A + LS direction in cover: transfer across an eligible gap, or roll out.
LT + A outside cover: manual dodge roll in the LS direction.
Centered LS during a manual roll uses the camera's forward direction.
Release A before another roll. Holding LT does not cancel a manual roll.
X in low cover: native vault/climb if the game finds a usable ledge.
F8: emergency release. F / Y: exit. RB also cancels owned actions.

CONFIGURATION
Edit Gameface/Binaries/Win64/CoverMod-DE.ini, then fully restart the game.
EnableManualDodgeRoll=0 disables only outside-cover manual rolls and restores
normal LT + selected-button input. Cover rolls and transfers remain available.
ManualRollButton=4096 selects A for outside-cover LT + A rolls.
CoverActionButton=4096 independently selects A for cover rolls/transfers.
ForwardCoverActionVaults=1 makes the cover action vault when LS points toward
low cover. Set it to 0 to disable that shortcut. X remains the vault button.
If CoverActionButton is X, sideways/away input selects roll/transfer, inward
input selects vault when enabled, and centered LS + X always selects vault.
Use one decimal code: A=4096, B=8192, X=16384, LB=256, R3=128,
D-pad Up=1, Down=2, Left=4, Right=8.
Reserved: RB=512, L3=64, Y=32768, Start=16, Back=32. Invalid codes use A.
LT/RT are analog triggers. The INI includes spaced explanations and examples.
Older RollButton values are fallback defaults only when new keys are absent.

NOTES
Cover acquisition range is six game metres. Gap transfers require reachable,
roughly aligned cover; car-to-car transfers are not included.
Rolls require a clear, level route to start. If a new obstacle or physical
collision stops travel, the roll completes in place with its normal soft exit.
Blind fire uses real weapon ammo/collision and intentionally adds no crosshair.
Supported blind-fire weapons: game IDs 22-33. No custom reload animation.
Diving approaches are not included in 1.0.

UNINSTALL
Close the game. Remove the script, INI and animation PAK. Keep the shared xinput1_3.dll if
ImprovedMove, Manual Driveby or Gasoline remains installed. Otherwise restore
YOUR backed-up files, especially any previous xinput1_3.dll. Do not substitute
a DLL from someone else's installation. CLEO Redux can remain installed.

CREDITS
Original cover animation bank: ArtemQa146 / Artem.1.9.9.6.
DE adaptation, controller bridge and custom peek/blind-fire animation variants:
developed in this project with Codex. Original stock animation banks are
preserved in the replacement animation asset. No ownership of third-party
animations or game assets is claimed.

VALIDATION
Gameplay tested by the project owner through the current development cycle.
This packaging refresh keeps the 1.0.2 gameplay files and updates the shared
bridge to the current Manual Driveby build. Mission-enabled cover is included.
See SHARED-BRIDGE.txt before upgrading or uninstalling.
