Triggers

Enter map-specific custom script code below. This text will be included in the map script after variables are declared and before any trigger code.

1. Object Data
1.1 - Attack ability
Create a new ability, preferably based off channel. It should have no manacost, no cooldown, a very long range (as long as the longest ranged artillery unit you intend to use), and be able to target a point.
Give it an order string that won't conflict with any abilities or attacks that the units using this system might have.
I used "channel".

1.2 - Unit Setup
1.2.1 - Attack ability icon
This ability is different from the attack ability created earlier. This ability should be unique for every unit, but you can use the same one for all units.
Its order string must not conflict with any other ability, especially the attack ability created earlier.
Range should be equal to the unit's attack range, and area of effect equal to the unit's attack's area of effect.
This ability should not *do* anything.
1.2.2 - The actual unit
This is the physical unit that players will use in the game.
Change its attack type to not be artillery. Missile (splash) is preferable.
Give it both abilities you've created: the attack ability and the attack ability icon. The attack ability icon should be unique for each unit, but you can use the same one for all units.
Set Art - Animation - Cast Point to the unit's Combat - Attack - Animation Damage Point (this is mainly aesthetic)
1.2.3 - The dummy attack unit
This unit will be the "attack" of the unit.
Set its damage and area of effect - this unit will be dealing the damage.
Add the Locust ability.
Art - Model to ".mdl" (remove it)
Combat - Animation Damage Point to 0.000
Movement - Type to Flying
Death Type - No raise, no decay

2. Triggers
2.1 Copy the "Attack Ground Event System" folder into your map, making sure that "Automatically created unknown variables" is enabled in your editor's preferances.
2.2 Set the options you want in the AGES Config trigger. Options are explained in the Options readme.
2.3 Set the AGES_AttackAbility and AGES_AttackAbilityOrder to the ability created in (1.1).
2.4 See Unit Config readme

Set AGES_GroupAttackEnabled If enabled, when an attackground is ordered, all units selected by the player will
attackground the same location.
Set AGES_GroupAttackSpacingEnabled If enabled, when using a group attackground, each unit will target a location
offset from the center the same distance as its offset from the center of the group.
Set AGES_ArtilleryTargetingEnabled If enabled, units in the system that attempt to attack a unit will attackground the
unit's location. (normally the missile, with homing disabled, will land where the
target will be)

At the bottom of the config trigger, you will see this:

Set AGES_SaveUnitType = Mortar Team
Set AGES_SaveDummyType = Mortar Team (Attack Ground)
Set AGES_SaveAbility = Attack Ground (Icon) (Mortar Team)
Set AGES_SaveOrderString = cloudoffog
Set AGES_SaveAccuracy = 0.00
Set AGES_SaveCooldown = 2.50
Set AGES_SaveMaxRange = 1150
Trigger - Run AGES Register <gen> (ignoring conditions)

This is how a unit type is added to the system. Every unit that you want to use this system must be added in this trigger in this way.

AGES_SaveUnitType - The unit created in (1.2.2)
AGES_SaveDummyType - The unit created in (1.2.3)
AGES_SaveAbility - The ability created in (1.2.1)
AGES_SaveOrderString - The order string of this ability
AGES_SaveAccuracy - The maximum distance that attacks can vary from the target location. Set to 0 to disable this feature for the unit.
AGES_SaveCooldown - The unit's attack cooldown.
AGES_SaveMaxRange - The unit's max range. For calculation purposes with variable accuracy.

Copy these lines, including the "Trigger - Run AGES Register <gen> (ignoring conditions)" for every unit you intend to use.

Events:
AGES_Event = 1.00 Projectile is launched.
AGES_Event = 2.00 Attack is started.
AGES_Event = 3.00 Unit is ordered.
AGES_Event = 4.00 Attack finishes. (only captures AGES_EventUnit)

Associated variables:
AGES_EventUnit The unit that is attacking.
AGES_EventTarget The target position of the attack.

To use these events, make a trigger with event:
Game - Value of real variable (AGES_Event) becomes equal to something
where "something" is one of the event values as listed above.

So e.g. if you want to move the attacking unit to the location it launched its attack at:
----------
Events
Game - AGES_Event becomes Equal to 1.00
Conditions
None
Actions
Unit - Move AGES_EventUnit instantly to AGES_EventTargetPoint
----------

System made by rulerofiron99

Indexed by unit's unittypeid
0 = dummy type
1 = ability id
2 = uses system
3 = ability order
4 = accuracy
5 = cooldown
6 = max range