Add new native functions for calling abilities with the possibility of passing arguments to them

[naydef]

Since FF2r's new ability invoking forward passes a StringMap with the ability arguments, I think it'll be extremely useful If plugins/abilities can call other abilities with the option of passing arguments. (maybe as well as returning arguments).

Example: rage_cloneattack could accept a players parameter, which will contain a list of players to become minions. That way it'll be possible to use rage_cloneattack to spawn players immediately which got killed. The list as well as the invocation of the ability is done by another plugin which hooks player_death and calls rage_cloneattack.

My proposals:

• a new native called FF2R_DoAbility(int boss, char[] pluginName, char[] abilityName, AbilityData cfg). Using BossData.GetAbility() the ability section will be returned, where plugins call then add their own keyvalues. Preferably all arguments should be put inside subsection, probably named Arguments.
• adding new argument to FF2R_DoBossSlot of type AbilityData, where you put arguments to the abilit(ies) you call. I wonder if there should be a way to pass different arguments to the different abilities

A mechanism for abilities to return data to the caller will also be nice. Maybe the abilities will write to the AbilityData which the calling ability can read the return value from.

I'm open for ideas here.

[naydef]

So basically what the callee should see in cfg argument:

"rage_cloneattack"
{
    "slot"                "0"    
    "amount"            "n/3 + 1"
    //...
    //...
    "plugin_name"        "ff2r_default_abilities"
    
    "Arguments"
    {
        "players"
        {
            "1"    "4" //index of player 1
            "2"    "12" //index of player 2
            //...
        }
        
        "param2" "some value"
        "param3" "some other value"
        //...
    }
}

If FF2R_DoBossSlot is changed so that it accepts Arguments section, then I guess it'd be nice if it's possible to pass individual arguments to abilities (and at the same time it's possible to pass the cfg of the callee to other plugins).

[naydef]

Will it be beneficial if it's possible to pass arguments to specific ability or it's unnecessary complex?
Like this:

"rage_cloneattack"
{
    "slot"                "0"    
    "amount"            "n/3 + 1"
    //...
    //...
    "plugin_name"        "ff2r_default_abilities"
    
    "Arguments"
    {
        "ff2r_default_abilities.rage_cloneattack"
        {
            "players"
            {
                "1"    "4" //index of player 1
                "2"    "12" //index of player 2
                //...
            }
        }
        
        "param2" "some value"
        "param3" "some other value"
        //...
    }
}

Also I didn't add ability to return arguments.

[naydef]

I've come to the conclusion that we'll potentially need FF2R_DoAbility, since it can target single ability and It'll be possible to return values, in the following format:

"rage_cloneattack"
{
    "slot"                "0"    
    "amount"            "n/3 + 1"
    //...
    //...
    "plugin_name"        "ff2r_default_abilities"
    
    "Return"
    {
        "param2" "some value"
        "param3" "some other value"
        //...
    }
}

So expect FF2R_DoAbility soon.