Data/Abilities/Transport

# Transport

(Editor Screenshot) needs picture showing a partially filled bunker

### Description

Gives the unit with this ability a cargo container capable of loading and unloading units

### Hint

* Units in the cargo can be unloaded by units other than the transporting unit via the Use Calldown effect
* Units in the cargo can attack and use abilities via the Redirect abilities on the transporting unit
* Units inside the transport container have the Attack ability disabled automatically. Use a Buff behaviour to enable the **Attack** ability on transported units to allow bunker like firing while units are moving.
* For Actor events, do not use "Ability", rather use "Transport".
* A unit inside a transport can launch an effect from any source at location "Outer", which concerns the transport.

#### Unload animation

For new modders, you have to know that what makes a unit animate a drop animation comes from a Macro in their Unit actor, called "Unload Drop Anim". Most units made by Blizzard have the animations proprieties : Unload and Unload End

## Example Usage

### Hercules - Hercules Transport

The transport ability used by the Hercules transport from the campaign for ferrying units around. On death it unloads all transported units after a delay and deals damage to them via the Effect - Death Unload Effect field.

#### URL

As the Hercules and all it's abilities are already in the campaign mods, no URL is needed

### Bunker - Load-Unload (Bunker)

The transport ability of the bunker that increases the range of all units inside it. The attacking/using stimpack/using healing of units inside the container is mediated via the Redirect abilities eg. Attack Redirect

#### URL

As the Bunker and it's abilities are already in the editor, no URL is needed

## Fields Description

### Ability: Commands

As common commands are explained in abilities, here's the explanation for specific commands that only transport abilities have:

* **Load Target:** Like an effect - target ability, the transport can aim to a target and call it for a load.
* **Unload All:** As most transports, unload everything. This only needs 1 click for its full use.
* **Unload Target:** (Unsure)
* **Unload Unit:** (Unsure)
* **Load All:** Using the search radius and search filters of the ability, seeks and load every target that are inside the radius. Command Center uses it.

### Ability: Load Cargo Behavior

The behavior applied to units while loaded inside the Transport

* The cargo units are known as the caster of the behavior and not the container unit. Even the "Outer" location is not powerful enough to find the transport unit.
* Used by Bunkers to increase the range of garissoned units
* (Unknown) what behaviors can be applied other than Buff
	+ Almost any valid buff type, including Power User
* Use this to apply a buff that re-enables the Attack ability of loaded units to make mobile bunkers

### Ability: Load Transport Behavior

* Behavior applied to the Transport unit when loading units
* The cargo units are known as the caster of the behavior and not the container unit
* Untested if a behavior can be stacked in this way.

### Ability - Load Validators

The validators that must return true for the unit to be loaded into the cargo of this ability.

### Ability - Target Filters

* Filters that determine which unit attributes the ability can target/be loaded as cargo.

### Ability - Target Sorts - Request Count

* For the Load All command, how many targets to pick after all potential targets went through the sorting filters.

### Ability - Target Sorts - Request Percentage

* For the Load All command, what percentage of targets to pick after all potential targets went through the sorting filters.

### Ability - Target Sorts - Sorts

* For the Load All command, sort filters.

### Ability - Unload Cargo Behavior

* Behavior applied to the Cargo unit(s) when unloaded.
* (Unknown) what behaviours can be applied other than buff
* Can use almost any valid buff type, including Power User

### Ability - Unload Transport Behavior

* Behavior applied to the Transport unit when unloading units.
* Untested if a behavior can be stacked in this way.

### Ability - Unload Validators

* The validators that must return true for the unit to be unloaded from the cargo of this ability

### Effect - Calldown Effect

The Use Calldown effect that other units can use to unload from this abilities cargo anywhere on the map

* Require an Effect-Target or Effect-Instant ability to successfully use the calldown.

### Effect - Death Unload Effect

* If the transporting unit with this ability is killed and the Cargo Death flag is not enabled, then all units in the cargo are unloaded with this effect being applied to them
* Used by the Hercules transport

### Stats - Cargo Count Maximum

* The maximum number of units able to be transported in the cargo

### Stats - Cargo Size Maximum

* The largest size unit able to be transported
* Size is set under the Stats - Cargo Size field of the Units data type

### Stats - Cargo Space

* The number of cargo slots available
* If units with a Stats - Cargo Size of greater than 1 are loaded, a lower number of units can be loaded should this become the limiting factor

### Stats - Flags

* **Allow Corpse:** With this flag on, transport abilities will be able to carry corpses in their cargo.

* **Allow Passenger Smart Command:** Allows a unit to be loaded into a transport unit by way of right clicking (Ie: selecting a unit and right clicking on a transport unit, such as a dropship, will allow the unit to be loaded without having to use the "load" button on the transport's command card)
* **Allow Smart Command:** Allows the transport unit to load units by way of right clicking on them
* **Cargo Death:** Means that all units in the cargo die if the transporter dies
* **Ignore Blockers:** (Unknown)
* **Player Hold:** All units of the player with the same Transport ability share a common cargo hold eg. Nydus network
* **Show Cargo Size:** Shows the number of cargo slots taken up by each unit
* **Show Status:** Shows the current vitals status of units inside the transport

### Stats - Initial Load Delay

* The time taken to begin loading units within range into the cargo

### Stats - Initial Unload Delay

* Time taken before the transport begins unloading units from the cargo

### Stats - Load Period

* Rate at which several units are loaded into the transport

### Stats - Maximum Unload Range

* Range at which units can be unloaded from the cargo
* Also range of the Unload Target command

### Stats - Range

* Range at which units can be loaded into the cargo

### Stats - Search Radius

Area around the transport that it will search for load targets if the Load All command is given. Command Center uses it when loading nearby scvs.

* Radius that the Load All command uses to order valid targets within the radius to load into the cargo

### Stats - Unload Period

* Rate at which several units are unloaded from the cargo

## Related

Needs links to Behaviors (data type), effects (data type), Use Calldown (effect), Unit Compare Cargo (Validator) and the three Redirect abilities (abilities)