Side Effects Control

[Lecode]

Version History


Version 1.0


/*
# - 0.0 : Bêta
# - 1.0 : Initial release
# : Deep code reorganization
# : News occasions: "after this skill invoked"
# "after this attack invoked"
# "after this item invoked"
# : Occasions can be fusioned: <leffect: x,y,z>
# : Effects can be read from an external file
# : Effects are now preloaded, instant of being read in real time
*/




Introduction


This plugin allows the user to set advanced effects for battlers, states and equipments.
These effects' logics are done through script call in the note box on defined occasions:


When Something
Do that (scriptcall)
Do that (scriptcall)
...
End


The purpose of this plugin is to allow the user to achieve complex effects. Nowadays skills in RPGs aren't just for dealing damage, healing and altering states. They can trigger complex effects for the sake of gameplay.
In short, you can achieve mostly complex passive skills and abilities for battlers. Or active skills with side effects.


Examples


This video shows some examples of what you can do with this plugin.


There are mostly passive skills or special abilities intrinsic to actors and enemies.










How to use


Defining an effect can be done in two ways:

1- Through the note box of actors, classes, enemies, states and equipments.
​

The pattern is the following:


<leffect: [OCCASION]>
[SCRIPT CALL];
[SCRIPT CALL];
...
</leffect>


[OCCASION] is the moment to trigger the effect.


[sCRIPT CALL] are...simply script calls. They are evaluated as Javascript code.


You can see below the list of occasions and script calls.


In addition, you can add a requirment for the effect to be triggered;


<leffect: [OCCASION]>
req: [CONDITION 1]
req: [CONDITION 2]
...
[SCRIPT CALL];
[SCRIPT CALL];
...
</leffect>


Code example:


The poisonous skin effect at the end of the video:


<leffect: after attack invoked on me>
b.addState(4);
</leffect>


Inside slime's note box.


Note that any tags to states, equipments and skills are in reality applied to their carrier.

2- Through a data file.
​

Create a json file named SideEffects.json inside your data folder.


The pattern is the following:


{
"object": [
"occasion1",
[
"code_line1",
"code_line2"
],
"occasion2",
[
"code_line1",
ect.
],
"occasion3,occasion4,occasion...ect",
[
ect.
]
],

"another_obj": [
"occasion",
[
code
]
]
}


It's nearly the same way with tags, just pay attention to commas.


Objects are in fact a type followed by an ID. If for exemple you want to create an effect for a skill with ID 16, set: "skill_16".


Code example:


{
"skill_12": [
"after any obj invoked",
[
"req: action.isSkill()",
"var cost = a.skillMpCost(obj);",
"var value = a.mhp*0.005*cost;",
"if(value > 0){",
"anim(a,126);",
"hpDmgWpopup(a,-value);",
"}"
]
]
}




Occasions & keys list:


Sheet.


Script call list:


Default list of script call.


Plugin-related script call.


Demo:


Link.


Require:


LeUtilites.


MVCommons.


See demo.


Important note:


This plugin is compatible with Yanfly's Battle Engine Core and his CTB. But cast script calls doesn't work so well with his ATB.

 

[pikotan]

good

 

[moldy]

Yay its released! Does this version address the multi targeted autocasts? I remember when I wanted to trigger a character to use a multi healing spell, but they would only target themselves. Wasn't sure if it was a bug or if I was using the wrong setup in my tag.

 

[longlivejuggs]

Brilliant my friend!

 

[Porcelain]

I really want to use this plugin, but what are the terms of use?

 

[Karindanslav]

Hi! Sorry to revive an old thread, but I've run into a compatibility bug with YEP_Item Core whenever I use your script's tags on a weapon, whether it's in the database or in the JSON file. It results into a "Object Too Deep" error.

Tried it with the script above and below, neither works. Haven't really tested if it's just weapons or any equipment.

Is there any chance you can patch that?
Thanks.

 

[Frostorm]

Does anyone still have a copy of this? The link is locked now...