ACE3/docs/wiki/framework/switchunits-framework.md

---
layout: wiki
title: Switch Units Framework
description: Explains how to set-up switch units.
group: framework
order: 5
parent: wiki
mod: ace
version:
  major: 3
  minor: 0
  patch: 0
---

## 1. Overview


Once this player spawns and [can switch units](#enable-player-ai-control), all controllable AI will be marked on his map and he'll be able to click on the map to switch to this unit. The initial unit will be prone to damage, but has no equipment and can't run. So it would be wise to hide or move this unit far from other players.

The module settings define which side a player can control or how big the radius of the safe zone is. The safe zone is a circular zone around AI units that must be clear from players of an opposing side to be able to switch to.


## 2. Scripting

### 2.1 Enable Player AI Control

To enable a player to control AI execute the following on it:

```sqf
this setVariable ["ACE_CanSwitchUnits", true];
```
Add wiki ACEX sections and merge Mission Makers and Framework sections (#4307) * Update documentation guidelines * Add version info part 1 * Add version info part 2 * Add removed in version to frontmatter and tag testmissions as removed * Add version info part 3 * Seaparate ACE3 and ACEX Features/Framework menus, Add ACEX Headless documentation * Add ACEX support to extract_dependencies.py * Merge useful-functions into frameworks * Move class-names to main menu * Prettify class-names table titles * Fix table of contents on documentation guidelines and tips * Merge mission-tools into frameworks * Merge modules into frameworks * Rename to Frameworks (plural) * Fix capitalization in class-names * Improve wiki menu positioning * Add 'mod' to documentation guidelines * Update frameworks sections description for new content * Update wiki menu descriptions * Fix class-names 4 digit versions * More places for descriptions * Include documentation in PRs if applicable note * Add short ACE3 and ACEX description page, outlining the difference 2016-09-08 19:19:07 +00:00			`---`
			`layout: wiki`
			`title: Switch Units Framework`
			`description: Explains how to set-up switch units.`
			`group: framework`
			`order: 5`
			`parent: wiki`
			`mod: ace`
			`version:`
			`major: 3`
			`minor: 0`
			`patch: 0`
			`---`

			`## 1. Overview`


			`Once this player spawns and [can switch units](#enable-player-ai-control), all controllable AI will be marked on his map and he'll be able to click on the map to switch to this unit. The initial unit will be prone to damage, but has no equipment and can't run. So it would be wise to hide or move this unit far from other players.`

			`The module settings define which side a player can control or how big the radius of the safe zone is. The safe zone is a circular zone around AI units that must be clear from players of an opposing side to be able to switch to.`


			`## 2. Scripting`

			`### 2.1 Enable Player AI Control`

			`To enable a player to control AI execute the following on it:`

Replace CPP highlighting with SQF highlighting (#8656) 2021-10-31 19:48:47 +00:00			```sqf
Add wiki ACEX sections and merge Mission Makers and Framework sections (#4307) * Update documentation guidelines * Add version info part 1 * Add version info part 2 * Add removed in version to frontmatter and tag testmissions as removed * Add version info part 3 * Seaparate ACE3 and ACEX Features/Framework menus, Add ACEX Headless documentation * Add ACEX support to extract_dependencies.py * Merge useful-functions into frameworks * Move class-names to main menu * Prettify class-names table titles * Fix table of contents on documentation guidelines and tips * Merge mission-tools into frameworks * Merge modules into frameworks * Rename to Frameworks (plural) * Fix capitalization in class-names * Improve wiki menu positioning * Add 'mod' to documentation guidelines * Update frameworks sections description for new content * Update wiki menu descriptions * Fix class-names 4 digit versions * More places for descriptions * Include documentation in PRs if applicable note * Add short ACE3 and ACEX description page, outlining the difference 2016-09-08 19:19:07 +00:00			`this setVariable ["ACE_CanSwitchUnits", true];`
			```