#===============================================================================
# * [ACE] Event Command Corrector
#===============================================================================
# * Made by: Sixth (www.rpgmakervxace.net, www.forums.rpgmakerweb.com)
# * Version: 1.0
# * Updated: 06/12/2016
# * Requires: --------
#-------------------------------------------------------------------------------
# * < Change Log >
#-------------------------------------------------------------------------------
# * Version 1.0 (06/12/2016)
# - Initial release.
#-------------------------------------------------------------------------------
# * < Description >
#-------------------------------------------------------------------------------
# * First thing first, this is NOT an eventing tool!
# This script can NOT be used in published games, only in unencrypted
# projects, and only for development corrections!
# Now that this is out of the way...
# * Ever got into a situation when you needed to change a face graphic,
# switch ID, BGM name, or anything else in tons of event commands?
# If you have, you certainly know how time consuming and tedious can that be.
# * This is a developer's tool to ease the amount of tediousness if you need
# to adjust some very common event commands in case you changed your mind
# about something or got new resources to implement, for example.
# With this script you can modify any event commands in any events on any maps
# you want based on your conditions with a single script call.
# Your changes will be saved in your physical map files, so you won't need to
# worry about them ever again after the change (unless you want to change
# them again, of course).
# * Map and event filters available in case you kinda know where are the event
# commands you want to modify located or where they aren't.
# * The console will show which event commands are changed with very precise
# information (map ID, event ID, page number, command line, parameter index,
# old and new values).
# * Note that this can NOT re-structure your events, it can only modify
# existing commands without deleting them or adding new ones. For example,
# you can not remove a choice from a Show Choices command, but you can change
# it's text.
# * As a bonus, this script will fix a bug in the default Game_Interpreter
# class. The "Shake Screen" event command reads the wrong parameters for the
# wait flag and it's duration, so that part of the command is not functional
# without a fix.
# Turns out that this is fixed already in later versions of VX Ace.
# Ohh, well, too lazy to remove it now, so it stays. :P
#-------------------------------------------------------------------------------
# * < Instructions >
#-------------------------------------------------------------------------------
# * Refer to the script's header for usage instructions!
#-------------------------------------------------------------------------------
# * < Compatibility Info >
#-------------------------------------------------------------------------------
# * No known incompatibilities.
#-------------------------------------------------------------------------------
# * < Known Issues >
#-------------------------------------------------------------------------------
# * No known issues.
#-------------------------------------------------------------------------------
# * < Terms of Use >
#-------------------------------------------------------------------------------
# * Free to use for whatever purposes you want.
# * Credit me (Sixth) in your game, pretty please! :P
# * Posting modified versions of this script is allowed as long as you notice me
# about it with a link to it!
#===============================================================================
- Script:
Linky: http://pastebin.com/Yp0jXM6U
Event Command Structure Details: http://pastebin.com/9Eks2fs3 (Warning! Extra long documentation! :P)
- Demo:
Nope, won't happen! o.o
- Author's Notes:
Sometimes I change my mind about the name of specific things or a graphic/audio file I used for something.
And more often than not, the things I want to change appear in tons of events.
Changing these one by one manually is... Not fun... at all. >.>
I always wanted to make this script because of this, but a few days ago someone actually commissioned me to do it.
Well, I think, this script could benefit more people as a free to use tool, because of the common occurrence of it's reason of existence, so I decided to post it instead.
Note that this tool will edit your physical map files on your PC directly!
For this reason, you should backup your map files found in the Data folder of your project before executing any event command changing script calls!
Yes, it is possible to mess your events up if you set a parameter to a wrong value, so be extra careful with what you do, and read that awfully long documentation I wrote about the structure of the specific event commands (or at least the details on the specific commands you want to edit)!
You will have to close and re-open your project after a modification to see your changes in the editor!
The changes made will appear in the game itself without a restart, but the editor won't refresh itself without re-opening it.
You can NOT remove or add new commands with this script, only the modification of an already existing command is possible with it!
You can NOT change the structure of your event commands either! For example, the number of choices in the "Show Choices" commands can NOT be modified. Doing so will mess your events up (the choice selections made in the game will not trigger the correct choice branches).
You can NOT modify "Set Move Route" event commands with this script! Those are way too complex, so I skipped them. If there is a demand for it, I may do it later.
You can NOT modify an event command with this script in an encrypted project! Attempting to do so will yield in... nothing, it will skip the script call if that happens. 
Well, I guess, I wrote down all the warnings and stuffs which needed to be said, so this should be it...