---
name: "BIS_fnc_boatRack01Init"
type: function
status: ok
groups: ["Boat Recovery"]
arma3_since: "1.84"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_boatRack01Init
revid: 379548
updated: 2026-10-31T13:44:08Z
---

# BIS_fnc_boatRack01Init

*Function · Boat Recovery · Arma 3 v1.84*

## Description

Main function of the boat recovery system, which lets a player drive a boat onto a boat rack and load it with a hold action. The boat rack must support [Vehicle in Vehicle transport](../topics/Vehicle_in_Vehicle_Transport.md).
The function is called by the `init` event handler of the boat rack's class. It does nothing in the Eden Editor or when the boat rack is [objNull](../commands/objNull.md).

It reads these entries of the rack's `CfgVehicles >> class >> BoatRecoverySystem` config class:

- `triggerAreaSizeX`, `triggerAreaSizeY`, `triggerAreaSizeZ` - size of the area around each recovery point in which the boat must be
- every subclass is a recovery point; its `memoryPointPosLoad` is the name of the rack's memory point at the centre of that area

It then creates a local, repeatedly activated trigger (`"ANYPLAYER"`, `"PRESENT"`) around the rack, large enough to cover all recovery areas, and stores the rack on it in the variable `"BIS_linkedBoatRack"`. The trigger uses:

- `BIS_fnc_boatRack01ActionCondition` as condition: the player drives a boat under 25 km/h inside a recovery area, the rack is empty and can carry the boat
- [BIS_fnc_boatRack01ActionAdd](../functions/BIS_fnc_boatRack01ActionAdd.md) on activation, which gives the boat the "Recover Boat" hold action
- [BIS_fnc_boatRack01ActionRemove](../functions/BIS_fnc_boatRack01ActionRemove.md) on deactivation

Finally it spawns [BIS_fnc_boatRack01InitAdjustZOffsets](../functions/BIS_fnc_boatRack01InitAdjustZOffsets.md) to adjust the rack to a boat that is already loaded at mission start.

## Syntax

```sqf
[boatRack] call BIS_fnc_boatRack01Init
```

**Parameters:**

- `boatRack`: [Object](../topics/Object.md) - the boat rack (the init event handler passes it as `_this`)

**Returns:** [Script Handle](../topics/Script_Handle.md) - handle of the spawned [BIS_fnc_boatRack01InitAdjustZOffsets](../functions/BIS_fnc_boatRack01InitAdjustZOffsets.md); [Nothing](../topics/Nothing.md) in the Eden Editor or if the boat rack is [objNull](../commands/objNull.md)

## Examples

### Example 1

Event handler of the boat rack's class:

```cpp
class EventHandlers
{
    init = "_this call BIS_fnc_BoatRack01Init;";
};
```

## See also

[BIS_fnc_boatRack01ActionAdd](../functions/BIS_fnc_boatRack01ActionAdd.md) · [BIS_fnc_boatRack01ActionRemove](../functions/BIS_fnc_boatRack01ActionRemove.md) · [BIS_fnc_boatRack01AdjustZOffset](../functions/BIS_fnc_boatRack01AdjustZOffset.md) · [BIS_fnc_boatRack01InitAdjustZOffsets](../functions/BIS_fnc_boatRack01InitAdjustZOffsets.md) · [Arma 3: Vehicle in Vehicle Transport](../topics/Vehicle_in_Vehicle_Transport.md)

<sub>Source: [BI Community Wiki — BIS fnc boatRack01Init](https://community.bistudio.com/wiki/BIS_fnc_boatRack01Init) (revision 379548).</sub>