Side Effects Control

じ☆ve冰风

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.


本贴来自国际rpgmaker官方论坛作者:Lecode处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/side-effects-control.63604/