ACE3/documentation/feature/weaponselect.md

---
layout: wiki
title: Weapon Select
group: feature
parent: wiki
---

## 1. Overview

### 1.1 Holster weapon
Adds the ability to holster a weapon on the back.

### 1.2 Quick weapon select
Adds key bindings to quickly switch weapons while on foot or in a vehicle. (Unbound by default).

### 1.3 Quick vehicle engine on/off
Adds key bindings to quickly turn a vehicle engine on or off.

### 1.4 Grenade select
Changes the grenade selection key bindings to help prevent accidents.

## 2. Usage

### 2.1 Weapons

- Press <kbd>0</kbd> to holster and unholster a weapon. 
- When a weapon is holstered, the weapon fire button will not pull the weapon out. This can be used as an additional level of safety or as a role-playing feature.

Quick weapon selection is not bound by default, but can be bound in the controls menu under `ACE3 Weapons`.

Quick vehicle weapon selection is not bound by default, but can be bound in the controls menu under `ACE3 Vehicles`.

## 3. Dependencies

`ace_common`
Create missing documentation placeholders Creates placeholder documentation for modules which did not previously have any. If a module had the same name and apparent purpose as a module from AGM, AGM's documentation was imported into the placeholder. These documentation are useful to users for explaining what ACE3 changes. They are also useful to community admins who want to create a custom distribution of ACE3 and need to know which modules to disable. The documentation needs to be significantly fleshed out before it's ready for public consumption, but this should be a helpful start. 2015-05-13 00:28:18 +00:00			`---`
			`layout: wiki`
			`title: Weapon Select`
			`group: feature`
			`parent: wiki`
			`---`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`## 1. Overview`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`### 1.1 Holster weapon`
			`Adds the ability to holster a weapon on the back.`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`### 1.2 Quick weapon select`
			`Adds key bindings to quickly switch weapons while on foot or in a vehicle. (Unbound by default).`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`### 1.3 Quick vehicle engine on/off`
			`Adds key bindings to quickly turn a vehicle engine on or off.`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`### 1.4 Grenade select`
			`Changes the grenade selection key bindings to help prevent accidents.`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`## 2. Usage`
Create missing documentation placeholders Creates placeholder documentation for modules which did not previously have any. If a module had the same name and apparent purpose as a module from AGM, AGM's documentation was imported into the placeholder. These documentation are useful to users for explaining what ACE3 changes. They are also useful to community admins who want to create a custom distribution of ACE3 and need to know which modules to disable. The documentation needs to be significantly fleshed out before it's ready for public consumption, but this should be a helpful start. 2015-05-13 00:28:18 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`### 2.1 Weapons`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`- Press <kbd>0</kbd> to holster and unholster a weapon.`
			`- When a weapon is holstered, the weapon fire button will not pull the weapon out. This can be used as an additional level of safety or as a role-playing feature.`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			Quick weapon selection is not bound by default, but can be bound in the controls menu under `ACE3 Weapons`.
Create missing documentation placeholders Creates placeholder documentation for modules which did not previously have any. If a module had the same name and apparent purpose as a module from AGM, AGM's documentation was imported into the placeholder. These documentation are useful to users for explaining what ACE3 changes. They are also useful to community admins who want to create a custom distribution of ACE3 and need to know which modules to disable. The documentation needs to be significantly fleshed out before it's ready for public consumption, but this should be a helpful start. 2015-05-13 00:28:18 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			Quick vehicle weapon selection is not bound by default, but can be bound in the controls menu under `ACE3 Vehicles`.
Insert additional newlines 2015-05-14 14:02:01 +00:00
Documentation pass 5 - Documentation done except (medical, AtragMX, MicroDAGR, Vector, Kestrel 4500) - Typos fixed - enjoy the review MOWHAHAHAHAH. 2015-05-28 15:22:45 +00:00			`## 3. Dependencies`
Insert additional newlines 2015-05-14 14:02:01 +00:00
Document module dependencies Add a list of dependencies to each module's documentation. Also add a note to the documenation of modules which are a dependency for many other modules. Dependency lists are pulled from each module's config.cpp. 2015-05-13 19:31:53 +00:00			`ace_common`