[WOTC] Iridar’s Scatter Mod

This mod makes it possible to add Scatter mechanics to weapons and abilities. In other words, things that normally guarantee a pixel-perfect hit, such as Grenades, can now be set up to miss the targeted area and hit elsewhere.

This is the core mod that contains all of the necessary code, but without additional configuration provided by yourself or another mod, it will do absolutely nothing.

If an ability is configured for scatter, it will now be able to "Hit" or "Miss".

The chance to hit can be configured to depend on distance and/or the Aim stat of the unit using the ability. Alternatively, you could set just a fixed chance that remains the same under all circumstances.

Each configured ability can have up to three scatter values:
* Hit Scatter – the base amount of scatter the ability will be subjected to before Range Table modifiers in case of a "Hit". This is effectively scatter radius, in Tiles.
* Miss Scatter – same, but used for "Misses".
* Min Scatter – the absolute minimum amount of scatter the ability will be subjected to, even after Range Table modifiers.
* Range Table – just like most weapons change their accuracy depending on range, the same can be set up for the Scatter. Range Table will adjust both soldier’s Aim, which will affect Hit and Miss chances, and it will also scale the scatter itself, unless configured otherwise.

For example, if a range table is configured to provide a +30 bonus at a certain distance, it will increase the "Hit" chance by 30, and it will also reduce Hit Scatter and Miss Scatter by 30%.

The in-game targeting UI will display two circles. The green circle will show the area the ability can potentially affect in case of a "Hit", while the red circle will mark the area that can be potentially affected by a "miss".

You will also see three values under the cursor: Hit Chance / Hit Scatter / Miss Scatter.

These mods are plugins that will add Scatter to specific items/abilities:

• [WOTC] Grenade Scatter

These mods add new items/weapons/abilities that already contain configuration for Scatter:

• [WOTC] Iridar’s SPARK Arsenal

Can be safely added or removed mid-campaign, even mid-tactical.

X2 WOTC Community Highlander v1.22 or higher is required.

No known compatibility issues.

The mod is *intended* to be configured for abilities that use cursor targeting, such as grenade throws and rocket launches.

It might potentially also work with single-target abilities that only apply multi-target effects on an area around the target.

• If the Scatter-configured ability fires its projectiles on a ballistic trajectory (e.g. grenade), and the scatter makes the grenade hit a wall before reaching its destination, the grenade will detonate the moment it hits the wall. It will still properly deal damage around the scatter location, so this issue is purely cosmetic, but it can look pretty weird.

The mod is entirely configurable through:

If you make any config entries, make sure to also save a backup of this file in case it resets due to a mod update.
The mod’s ReadMe.txt contains examples on how to make scatter config entries.

Huge thanks to Xymanek (Astral Descend) for his invaluable help with setting up systems for in-game scatter display.
Thanks to Beaglerush[www.twitch.tv] for commissioning, producing and live testing this mod.

Please support me on Patreon[www.patreon.com] if you require tech support, have a suggestion for a feature, or simply wish to help me create more awesome mods.