/ACF-3

ACF

Primary LanguageLuaMIT LicenseMIT

Armored Combat Framework

A standardized combat and damage addon for Garry's Mod

Discord Invite Steam Group Linting Status Test Suite Repository Size Commit Activity

Armored Combat Framework (ACF) is an addon for Garry's Mod that implements a damage system for props and players, while also providing entities and tools to build fairly realistic armored combat vehicles. Players may choose from an array of guns, ammo types, crates for fuel and ammo, engines, transmissions and more while armoring their contraptions for combat.

Ammunition is customizable with varying ballistic performance along with armor being customizable for protection against various threats. ACF is intended to be balanced for multiplayer and competitive use but there is, of course, nothing wrong with blasting some NPCs.

ACF Logo

Installation

Dependencies

ACF Requires these to work

Wiremod (Workshop or Github) Contraption Framework (Workshop or Github)

Prop Protection with CPPI is not required, but highly recommended. We'd recommend Nadmod PP (Workshop or Github).

ACF works best when used with thin plate models and SProps (Workshop) provides a more complete selection over the vanilla PHX plates.

Git Client (Recommended)

Install a Git client, such as the Github client or GitKraken, then clone ACF to your addons folder. With the Github client installed you can click the green button at the top of the ACF repo page and select clone. Updating ACF on your server or client after install simply requires clicking the pull button in your respective Git client.

Manually

  1. Click the green button at the top of the ACF repo and select zip.
  2. Extract the ACF folder.
  3. Inside you will find another ACF folder.
  4. Move the inner ACF folder to garrysmod/garrysmod/addons

Contributing

Found an annoying bug in the addon? Want to suggest a brand new feature? Think something should be changed? Make sure to check out Contributing to ACF, where we have a full guide on how to properly contribute to this project.