Gear Weapons Main

This addon bundles the everyday, moment-to-moment weapon-handling features in TF999: how it feels to lean around cover, how your weapon handles when you aim and fire, how you throw grenades, and how you swap attachments in the field. It also adds a few small ACE screen indicators. Below is what each part does, in plain terms — for the exact settings and their defaults, see docs/settings_users.md ("TF999 Weapons" section); for keybinds, see docs/keybinds_users.md.

Corner Shooting

Lean your rifle out from cover without exposing your whole body: Shift + Q leans left, Shift + E leans right, and Ctrl + Right Mouse raises the weapon up over cover (that last one shares its default with TSP Cant Weapon — rebind one if they clash). Can be set to keep the third-person camera locked in place while you lean, or let it follow the weapon out.

Aim Sway

A light, short weapon is quick and natural to bring up — your eye, the sights, and the target line up almost instantly, and you settle on aim right away. A heavy or long weapon takes real effort to steady: it takes a noticeably longer moment to find your target and never sits quite as still while you're aimed in, especially the more tired you get — this gap is pronounced, not subtle, so a loaded-out machine gun feels dramatically harder to hold on target than a bare pistol. Everything hanging off the weapon adds up too — a scope, foregrip, or bipod all add their own weight, so a rifle decked out with attachments sways noticeably more than the same rifle bare. What's mounted on the muzzle changes this as well — a compensator or suppressor can make holding a steady sight picture easier or harder, just like it would in real life. This applies to any sight — iron sights or a scope, it doesn't matter which.

Weapon Sway

Separately from the aim-in settle above, the general side-to-side wander of your sights while holding a weapon steady also scales with what you're carrying — a light, short weapon is easier to keep pointed where you want, a heavy or long one drifts more. This stacks on top of (doesn't replace) however tired you are — a tired soldier with a light weapon still sways less than a fresh one carrying a heavy machine gun, but both get worse the more exhausted they are.

Recoil

Every shot pushes the weapon off target, and how much depends on what you're holding. A pistol or SMG is light and snappy — it barely moves and you're back on target almost instantly. A heavy machine gun or a long rifle fights back much harder, climbing sharply off target and taking a lot longer to settle back down between shots — the difference between a light and heavy weapon is dramatic, not a minor tweak. Attachments add their own weight to that too, so a rifle loaded with a scope, foregrip, and bipod kicks noticeably harder than the same rifle stripped down. A muzzle device changes this as well — a compensator tames the kick, while some suppressors can make it noticeably worse, the same trade-off you'd feel with the real hardware. AI shooters feel the same weight and length differences in how their aim reacts, and their overall skill with a weapon can be tuned separately if you want them to shoot noticeably better or worse.

Grenade Throwing

A more deliberate, animated grenade throw with an on-screen aiming preview, replacing the plain vanilla toss (this can be turned off to keep the animation but leave the actual throw to vanilla/ACE). Includes a reverse (backward) throw, planting tripwire grenades, extra spin on certain anti-tank grenades, and custom effects for specific grenade types (flash, smoke, incendiary, airburst, etc). A grenade can also be lobbed directly into an open vehicle hatch to damage the vehicle and injure or kill the crew inside.

Weapon Attachment Swapping

Through the ACE self-interaction menu, you can mount, dismount, or swap muzzle devices, optics, rail attachments, and bipods on your weapon in the field, without needing to visit an arsenal. This isn't instant — your character has to crouch and physically work the weapon: taking the old attachment off is its own animation, and putting the new one on is another one after that, each taking several seconds, with your hands full and your weapon unusable to change again until it's done. Treat it like real fieldwork, not a menu toggle — start a swap in the open or mid-firefight and you'll be exposed and unable to react while your character's hands are busy.

Screen Indicators

Physically inspecting your weapon or a grenade (checking it over by hand, not just glancing at your gear) briefly brings up a quick readout — your remaining ammo, how hot your barrel is running, or, if you're checking a grenade, which type it is and how many you're carrying. It's tied to that inspection action, not a permanent on-screen display.