grad-vehiclespawner v0.8.1

GRAD Vehicle Spawner

Dependencies

• CBA_A3

Installation

Manually

1. Create a folder in your mission root folder and name it modules. Then create one inside there and call it grad-vehicleSpawner.
2. Download the contents of this repository ( there's a download link at the side ) and put it into the directory you just created.
3. Append the following lines of code to the description.ext:

#include "modules\grad-vehicleSpawner\grad_vehicleSpawner.hpp"

class CfgFunctions {
    #include "modules\grad-vehicleSpawner\cfgFunctions.hpp"
};

Via npm

for details about what npm is and how to use it, look it up on npmjs.com

1. Install package grad-vehicleSpawner : npm install --save grad-vehicleSpawner
2. Append the following lines of code to the description.ext:

#define MODULES_DIRECTORY node_modules
#include "node_modules\grad-vehicleSpawner\grad_vehicleSpawner.hpp"

class CfgFunctions {
    #include "node_modules\grad-vehicleSpawner\cfgFunctions.hpp"
};

Config

Add the class cfgGradVehicleSpawner to your description.ext. This is entirely optional. Default values will be used unless set by config. Use the following attributes to configure the module:

Attributes

Example

class cfgGradVehicleSpawner {
    abandonedTime = 1500;
    maxVehicles = 100;
    maxVehiclesUser = 10;
    eventParams[] = {};
    onDisplayOpen = "systemChat 'hi!'";
    onDisplayClose = "systemChat 'bye bye!'";
    onSpawn = "(_this select 0) disableTIEquipment true";
};

Implementation

Add an ACE-Interaction to an object to open the vehicle spawner dialog.

[object,actionName,condition,vehicleTypes,spawnPositions,onDisplayOpen,onDisplayClose,eventParams,onSpawn] call grad_vehicleSpawner_fnc_addInteraction

Spawnpositions Array

Spawnpositions have to be in order: Wheeled,Tracked,Rotary Wing,Fixed Wing,Naval
Allowed data types are:

• String - markername - direction of marker determines spawn direction
• Object - vehicles will spawn on or around given object - object direction determines spawn direction
• Array - format Pos2D, Pos3D, x,y,z,direction,searchRadius,increment or array of multiple position in that format (will be prioritized in the same order as given)
  • x,y - x and y coordinates
  • z (optional) - z above terrain (default: 0)
  • direction (optional) - direction in which vehicles will spawn here, 0 is most reliable (default: 0)
  • searchRadius (optional) - radius around this position which will be searched for available empty spawn positions (make this small to force exact position; default: 20)
  • increment (optional) - the smaller this is, the slower the function, but the more likely the vehicle will spawn close to center (default: 5)
• Code - Has to return Pos3d,Direction. Position 0,0,0 will mean no valid position was found. Params passed are class of vehicle.
  • if you want to use list _trigger to check for any objects which might block a spawn, make sure to filter objNull as well as grad_vehicleSpawner_target and grad_vehicleSpawner_localVeh, which are a helper object and the local vehicle preview

Example

_spawnLand = [3200,1200,0];
_spawnTracked = [[2500,1200,0,0,5,1],[2600,1200,0,0,5,1]];  // tracked vehicles will spawn max 5m from the first position - if first position is full, second position will be used
_spawnAir = [3500,1600,0,128];  // spawndirection is 128 >> in direction of my imaginary runway

[
    _laptop,
    "GRAD Vehicle Spawner",
    {true},
    [],
    [_spawnLand,_spawnLand,helipad_1,_spawnAir,"spawnmarker_water_1"],
    {diag_log ["Vehiclespawner opened. Display:",_this select 0]},
    {diag_log format ["Vehiclespawner closed. Was open for %1s seconds.",CBA_missionTime - (_this select 1 select 0)]},
    [CBA_missionTime],
    {(_this select 0) disableTIEquipment true}
] call grad_vehicleSpawner_fnc_addInteraction;

Usage

• select a vehicle from the left sidebar to preview it (local to your client)
• see preview information on the information tab on the right sidebar
• select vehicle components and textures from the variants and textures tabs on the right sidebar
• spawn a vehicle with the spawn button below the left sidebar (this will spawn the vehicle on the server)

• manage your spawned vehicles in the my vehicles section on the right sidebar

• drag the camera by holding RMB and moving your mouse

• zoom in and out with mouse wheel
• hide the UI with backspace
• close the spawner with escape