DoubleX RMMZ Plugin Command Lines

じ☆ve冰风

Purpose
Lets you use plugin commands in the RMMV styles by typing them as scripts

Introduction
                Code:       

1. *      1. The RMMZ editor has changed the plugin command from entering a
2. *         single line of string command to selecting plugin commands among
3. *         all plugins having plugin commands
4. *      2. With this plugin, those preferring the RMMV plugin command can
5. *         replicate this style in RMMZ by typing plugin command as a script

复制代码

Video

https://www.youtube.com/embed/9Cro1e_uQBI

https://www.youtube.com/embed/r9g4S8yuiRU

Games using this plugin
None so far

Spoiler: Todo

                Code:       

1. *      1. Lets you type plugin commands with names having spaces

复制代码

Spoiler: Parameters

                Code:       

1. * @param pluginFileCmds
2. * @type struct<PluginFileCmd>[]
3. * @desc Sets the list of plugin commands to be called in RMMV ways
4. * This being empty means all plugin commands to be that way
5. * @default []
6. *
7. * @param newPluginFileCmds
8. * @type struct<NewPluginFileCmd>[]
9. * @desc Sets list of new plugin commands to be called in RMMV way
10. * They're existing ones with some argument value already set
11. * @default []

复制代码

Spoiler: RMMV Style Plugin Command Lines Info

                Code:       

1. *    1. General form
2. *       cmdName argName1 argName2 argName3 argNameI argNameN
3. *       E.g.:
4. *       - If the plugin command has its command name as abcdefg and arguments
5. *         as h, i, j and k, then the RMMV style plugin command line is
6. *         abcdefg h i j k
7. *    2. (v1.02a+)pluginFileCmds
8. *       - If there's only a small number of plugin commands among all enabled
9. *         plugins, then whether the parameter pluginFileCmds should be filled
10. *         doesn't matter much
11. *       - If there's a large number of plugin commands among all enabled
12. *         plugins, but only a small number of them being used in the RMMV
13. *         styles, then pluginFileCmds should be filled with all those plugin
14. *         commands, or the time needed for this plugin to load such a large
15. *         number of plugin commands automatically upon game start can lead to
16. *         a long game starting time
17. *       - If there's a large number of plugin commands among all enabled
18. *         plugins, and most of them being used in the RMMV styles, then I'm
19. *         afraid that this plugin won't be able to give you a nice option
20. *    3.(v1.02a+) newPluginFileCmds
21. *       - Its 1st application is to let you type less, thus making using
22. *         plugin commands in the RMMV styles to be even more effective and
23. *         efficient
24. *       - Its 2nd application is to let you use plugin commands with
25. *         different argument values given on 2 different timings, without the
26. *         need of game variables to store them, even though you'll have to
27. *         redefine the new plugin commands on the 1st timing
28. *       - Its 3rd application is to resolve plugin command name collisions
29. *         among different plugins

复制代码

Spoiler: Script Calls

                Code:       

1. *      1. $gameSystem.setNewPluginCmd(pluginFilename, newCmdName, origCmdName, argNameVals)
2. *         - Sets the new plugin command with name newCmdName as that with
3. *           name origCmdName but with argument values already set by
4. *           argNameVals, and origCmdName is the one in plugin with filename
5. *           pluginFilename
6. *         - argNameVals is an Object with argument names as keys and values
7. *           of those arguments already set in newCmdName as values
8. *         - E.g.:
9. *           $gameSystem.setNewPluginCmd("DoubleX RMMZ Skill Item Cooldown", "ssicA1", "setSkillItemCooldown", {
10. *               side: "actor",
11. *               label: 1
12. *           }) sets the new plugin command with name ssicA1 as that with name
13. *           setSkillItemCooldown of plugin with filename
14. *           DoubleX RMMZ Skill Item Cooldown but with the side and label
15. *           argument values already set as "actor" and 1 respectively

复制代码

Spoiler: Author Notes

                Code:       

1. *      1. If a plugin command's inputted as a script call, it must only take
2. *         exactly 1 line for that plugin command
3. *      2. Multiple plugin commands, each taking 1 line, can be inputted into
4. *         the same script box in the editor, but do note that the size of
5. *         that script box's limited so don't type too many plugin commands in
6. *         the same script box in the editor
7. *      3. If multiple plugin commands have the same name, the one having a
8. *         highest ordering in pluginFileCmds will be used(or if
9. *         pluginFileCmds is empty, the one from the plugin with the highest
10. *         ordering will be used)
11. *         (Search tag: First_In_Duplicate_Plugin_Cmds)
12. *      4. If script calls and plugin commands are mixed in the same script
13. *         box in the editor, script calls separated by plugin commands there
14. *         will be called separately
15. *         E.g.:
16. *         - The following contents in the same script box in the editor
17. *           scriptLine1
18. *           scriptLine2
19. *           pluginCommandLine1
20. *           scriptLine3
21. *           scriptLine4
22. *           Will cause the scripts combined from scriptLine1 and scriptLine2
23. *           to be a separate script call from the script call of the scripts
24. *           combined from scriptLine3 and scriptLine4

复制代码

Spoiler: Prerequisites

Plugins:
1. DoubleX RMMZ Enhanced Codebase
Abilities:
1. Basic knowledge on what RMMV plugin command does in general on the user level

Spoiler: Terms Of Use

                Code:       

1. *      1. Commercial use's always allowed and crediting me's always optional.
2. *      2. You shall keep this plugin's Plugin Info part's contents intact.
3. *      3. You shalln't claim that this plugin's written by anyone other than
4. *         DoubleX or my aliases. I always reserve the right to deny you from
5. *         using any of my plugins anymore if you've violated this.
6. *      4. If you repost this plugin directly(rather than just linking back),
7. *         you shall inform me of these direct repostings. I always reserve
8. *         the right to request you to edit those direct repostings.
9. *      5. CC BY 4.0, except those conflicting with any of the above, applies
10. *         to this plugin, unless you've my permissions not needing follow so.
11. *      6. I always reserve the right to deny you from using this plugin
12. *         anymore if you've violated any of the above.

复制代码

Spoiler: Contributors

                Code:       

1. *      Authors:
2. *      1. DoubleX
3. *      Plugin Development Collaborators:
4. *      - None So Far
5. *      Bug Reporters:
6. *      - None So Far
7. *      Compatibility Issue Raisers:
8. *      - None So Far
9. *      Feature Requesters:
10. *      - None So Far

复制代码

Spoiler: Changelog

                Code:       

1. *      { codebase: "1.1.0", plugin: "v1.03b" }(2020 Nov 27 GMT 0400):
2. *      1. You no longer have to edit the value of
3. *         DoubleX_RMMZ.Plugin_Command_Lines.PLUGIN_NAME when changing this
4. *         plugin file name
5. *      { codebase: "1.0.2", plugin: "v1.02a" }(2020 Sep 14 GMT 0700):
6. *      1. Lets you use text instead of command for plugin command names
7. *      2. Lets you use text instead of arg for plugin command argument names
8. *      3. Plugin command name collisions across plugins will no longer exist
9. *         if newPluginFileCmds is used wisely
10. *      4. Explained some applications of newPluginFileCmds
11. *      5. Renamed pluginCmds into pluginFileCmds
12. *      6. Renamed newPluginCmds into newPluginFileCmds
13. *      7. Increased the effectiveness and efficiency when reading plugin
14. *         commands from the plugin file contents
15. *      8. THIS UPDATE IS A BREAKING CHANGE ON THE PARAMETERS IN THE PLUGIN
16. *         MANAGER
17. *      { codebase: "1.0.0", plugin: "v1.01a" }(2020 Sep 11 GMT 1400):
18. *      1. Lets you make some new plugin commands as existing ones with some
19. *         argument values already set
20. *      2. Fixed the bug to load even inactive plugins and those not in the
21. *         plugin manager when the parameter pluginCmds is empty
22. *      { codebase: "1.0.0", plugin: "v1.00a" }(2020 Sep 4 GMT 0600):
23. *      1. 1st version of this plugin finished

复制代码

Download Link
Demo Link


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