add disposable launcher framework

[commy2]

When merged this pull request will:

• ports the BWA3 and ACE disposable launcher frameworks to CBA

• close Feature request: Disposable launchers framework #1103

• doc

• example configs

• pick up loadable

• replace with used tube

• Arsenal

[commy2]

quick link for me: https://github.com/acemod/ACE3/tree/master/addons/disposable

[PabstMirror]

If we are starting over, I'd think we should require the fired event handler to be on the weapon

class nlaw 
class EventHandlers {
            fired = "call CBA_fnc_handleDisposable"

[commy2]

@PabstMirror You can't see it, but that is what I am doing in BWA3. Here is the WIP doc which is also the state of the parallel branch on the BWA3 repository (where I test all this):

Click to expand

Disposable Launchers

Config examples

#define LAUNCHER_MASS 80
#define LAUNCHER_MAGAZINE_MASS 40

class CBA_DisposableLaunchers {
    BWA3_PzF3[] = {"BWA3_PzF3_Loaded","BWA3_PzF3_Used"};
};

class CfgMagazines {
    class CA_LauncherMagazine;
    class BWA3_PzF3_Tandem: CA_LauncherMagazine {
        author = "$STR_BWA3_Author";
        scope = 1;

        mass = LAUNCHER_MAGAZINE_MASS;
        allowedSlots[] = {};
    };
};

class CfgWeapons {
    class Launcher;
    class Launcher_Base_F: Launcher {
        class WeaponSlotsInfo;
    };

    class BWA3_PzF3: Launcher_Base_F {
        author = "$STR_BWA3_Author";
        scope = 1;
        scopeArsenal = 1;
        baseWeapon = "BWA3_PzF3";

        magazines[] = {"BWA3_PzF3_Tandem"};
        magazineReloadTime = 0.1;

        class EventHandlers {
            fired = "_this call CBA_fnc_firedDisposable"; // this weapon eventhandler is required!
        };

        class WeaponSlotsInfo: WeaponSlotsInfo {
            mass = LAUNCHER_MASS;
        };
    };

    class BWA3_PzF3_Loaded: BWA3_PzF3 {
        author = "$STR_BWA3_Author";
        scope = 2;
        scopeArsenal = 2;
        baseWeapon = "BWA3_PzF3_Loaded";

        magazines[] = {"CBA_FakeLauncherMagazine"};

        class WeaponSlotsInfo: WeaponSlotsInfo {
            mass = LAUNCHER_MASS + LAUNCHER_MAGAZINE_MASS;
        };
    };

    class BWA3_PzF3_Used: BWA3_PzF3 {
        author = "$STR_BWA3_Author";
        scope = 1;
        scopeArsenal = 1;
        baseWeapon = "BWA3_PzF3_Used";

        magazines[] = {"CBA_FakeLauncherMagazine"};

        class WeaponSlotsInfo: WeaponSlotsInfo {
            mass = LAUNCHER_MASS;
        };
    };
};

[commy2]

Closes: acemod/ACE3#1335

[commy2]

Doc: https://github.com/CBATeam/CBA_A3/wiki/Disposable-Launchers

[PabstMirror]

These might be ace specific, not sure

put down "Launcher [Nato]" box, take nlaw and it is unloaded and cannot fire
nlaw mags don't show, might be because of

    class NLAW_F: CA_LauncherMagazine {
        scope = 1;

2 nalws show in ace arsenal, might want
scopeArsenal = 0; instead of 1

[PabstMirror]

can be done in a later release, but we should add some way of handling spotting rounds (LAW 80)

[commy2]

Yeah, this is why I don't like dropping the launcher. It needs addWeaponWithAttachmentsCargoGlobal to work.

[PabstMirror]

maybe

_wh = "GroundWeaponHolder_Scripted" createVehicle position _unit;
_unit action ["DropWeapon", _wh, _usedLauncher];

[commy2]

DropWeapon is broken. Always has been always will be.

[dedmen]

addWeaponWithAttachmentsCargo will be fully implemented in 1.96 (contact DLC is 1.94)

[commy2]

Ref acemod/ACE3#6955

[Dystopian]

There was a feature in ACE2 - replace also rockets with launchers in ammo crates. So if there are NLAW launcher and 3 its rockets in a box, they become 4 NLAW disposable tubes. Is it a good idea for this PR, maybe optional with setting?
Upd: can be 3-state setting: leave rockets alone, replace with launcher, remove from box.

[commy2]

Do we want this to be scripted though or just edit the configs in ACE?

See: acemod/ACE3@cfe40cc

[Dystopian]

Config doesn't look universal (and quite big), scripted version could handle all disposable launchers/rockets. So I for script.

[commy2]

Made it via script, but see no point in having a setting.

[Dystopian]

Personally I like replacing rockets with launchers. Setting would suit those who doesn't like.

[commy2]

• adds CBA_fnc_addWeaponWithoutItems, which is basically addWeapon without taking a magazine from inventory (has to be manually reloaded with addWeaponItem if needed) and without attachments (in case you use a class with pre-equipped attachments).