---
name: "BIS_fnc_target"
type: function
status: ok
groups: ["Interaction"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_target
revid: 337301
updated: 2023-01-13T10:27:53Z
---
# BIS_fnc_target
*Function · Interaction · Arma 3 v1.00*
## Description
Handles the shooting targets in the Bootcamp DLC, statistics, animation, etc. (targets such as `TargetBootcampHuman_f`)
| | | |
|---|---|---|
| + Action/Parameter Table | Action ([String](../topics/String.md)) | Parameters ([Array](../topics/Array.md)) arguments |
| **initialize**
Initializes the target and sets it to the "up" position | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F" | |
| **terminate**
Doesn't do anything | N/A | |
| **animate**
Animate the object to the given position ("up" or "down") | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- position: [String](../topics/String.md) - "up" or "down" (default) | |
| **getAnimationPhase**
**Return Value:** [Number](../topics/Number.md) - 0 (up) or 1 (down) depending on current state | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F" | |
| **getAnimationPhaseString**
**Return Value:** [String](../topics/String.md) - "up" or "down" depending on current state | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F" | |
| **getAnimatedSelection**
**Return Value:** [String](../topics/String.md) - the name of the "animatedSelection" from object config | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F" | |
| **hit**
Handles the hit event to animate the target down and up again | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- unit: [Object](../topics/Object.md) - Unit which shot the target
- damage: [Number](../topics/Number.md) - Amount of damage done to the target | |
| **hitPart**
Handles the hit event and stores the data | - partsList: [Array](../topics/Array.md) - Contains list of all parts which got hit (see [HitPart EH](../topics/Event_Handlers.md#hitpart) format) to format [target, shooter]:
- target: [Object](../topics/Object.md) - Target object of type 'TargetBootcamp_base_F'
- shooter: [Object](../topics/Object.md) - Unit which shot the target | |
| **getShooterDataIndex**
**Return Value:** [Number](../topics/Number.md) - index from Shooter Data for specific unit | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- uid: [String](../topics/String.md) - Player UID of unit who shot the target | |
| **getShooterData**
**Return Value:** [Array](../topics/Array.md) - all data from Shooter Data for specific unit
Format: `[["uid", ""], ["name", ""], ["shots", [[["time", 0], ["distance", 0], ["weapon", ""], ["direct", 0]]]]]` | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- uid: [String](../topics/String.md) - Player UID of unit who shot the target | |
| **setShooterData**
Set Shooter Data for specific unit | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- uid: [String](../topics/String.md) - Player UID of unit who shot the target
- data: [Array](../topics/Array.md) - Shooter Data | |
| **getShotsData**
**Return Value:** [Array](../topics/Array.md) - Shots Data for specific unit | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- uid: [String](../topics/String.md) - Player UID of unit who shot the target | |
| **getShotsDataFromTargets**
**Return Value:** [Number](../topics/Number.md) - total amount of shots hit | - targets: [Array](../topics/Array.md) of [Object](../topics/Object.md) - List of target objects of type "TargetBootcamp_base_F"
- uid: [String](../topics/String.md) - Player UID of unit who shot the target | |
| **getShotsDataWithFilter**
**Return Value:** [Array](../topics/Array.md) - Shot Data after custom filter | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- uid: [String](../topics/String.md) - Player UID of unit who shot the target
- filter: [String](../topics/String.md) - One of "time", "distance", "weapon" or "direct"
- code: [Code](../topics/Code.md) - Custom code to validate the shot. _this is the value of filtered data | |
| **setShotsData**
Set Shots Data for specific unit | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- uid: [String](../topics/String.md) - Player UID of unit who shot the target
- data: [Array](../topics/Array.md) - Shots Data | |
| **getShootersData**
**Return Value:** [Array](../topics/Array.md) - full Shooters Data | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F" | |
| **setShootersData**
Set full Shooters Data | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- data: [Array](../topics/Array.md) - Shooter Data | |
| **resetShootersData**
Remove all data from Shooters Data array | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F" | |
| **getShooterTemplate**
**Return Value:** [Array](../topics/Array.md) - template for Shooter Data | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- uid: [String](../topics/String.md) - Player UID of unit who shot the target | |
| **getShotTemplate**
**Return Value:** [Array](../topics/Array.md) - template for Shot Data (see [HitPart EH](../topics/Event_Handlers.md#hitpart) format) | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- shooter: [Object](../topics/Object.md) - Unit who shot the target
- projectile: [Object](../topics/Object.md) - ("_bullet" not used)
- position: [Array](../topics/Array.md) format [Position](../topics/Position.md) - ("_position" not used)
- velocity: [Array](../topics/Array.md) - ("_velocity" not used)
- selection: [Array](../topics/Array.md) - ("_selection" not used)
- ammo: [Array](../topics/Array.md) - ("_ammo" not used)
- vector: [Array](../topics/Array.md) - ("_direction" not used)
- radius: [Array](../topics/Array.md) - ("_radius" not used)
- surfaceType: [String](../topics/String.md) - ("_surface" not used)
- isDirect: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) if object was directly hit, [false](../commands/false.md) if it was hit by indirect/splash damage. | |
| **getShooterByUid**
**Return Value:** [Object](../topics/Object.md) - corresponding shooter unit | - uid: [String](../topics/String.md) - Player UID of unit who shot the target | |
| **uiOpen**
Opens the Target Board display | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F" | |
| **uiOpenToAll**
Opens the Target Board display for all connected players | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F" | |
| **uiOnLoad**
Triggered when display is opened (internal) | - display: [Display](../topics/Display.md) | |
| **uiFillTable**
Triggered when display is opened, fills UI with Shooters Data (internal) | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- control: [Control](../topics/Control.md) - "_listBox" | |
| **uiFillTableRow**
Triggered when display is opened, fills UI with Shooter Data (internal) | - target: [Object](../topics/Object.md) - Target object of type "TargetBootcamp_base_F"
- control: [Control](../topics/Control.md) - "_listBox"
- data: [Array](../topics/Array.md) - Shooter Data | |
## Syntax
```sqf
[action, parameters] call BIS_fnc_target
```
**Parameters:**
- `action`: [String](../topics/String.md)
- `parameters`: [Array](../topics/Array.md)
**Returns:** See [above table](../functions/BIS_fnc_target.md#description)
## Examples
### Example 1
```sqf
// open the Score Board
["uiOpen", [myTarget]] call BIS_fnc_target;
```
### Example 2
```sqf
// open the Score Board for all players in MP
["uiOpenToAll", [myTarget]] call BIS_fnc_target;
```
### Example 3
```sqf
// clear all data from Score Board
["resetShootersData", [myTarget]] call BIS_fnc_target;
```
## See also
[doTarget](../commands/doTarget.md)
Source: [BI Community Wiki — BIS fnc target](https://community.bistudio.com/wiki/BIS_fnc_target) (revision 337301).