Rpg Maker Developers Group

========================================================================
 Help
 ========================================================================

 This plugin enables the execution of custom javascript code during the
 item action performance. This will enable the creation of more complex
 game mechanics. Game variables and switches can be set and triggered
 upon the execution of a specific event stats can be changed, messages
 triggered, states applied, GabWindow controlled.... There's a whole new
 world of possibilities out there. Remember this plugin is meant for
 developers who have basic javascript knowledge.

 ========================================================================
 Plugin Properties
 ========================================================================

 System Enabled : As a performance tweak this lets the game begin with
 the system disable if you add/equip items automatically in game start,
 this can help improve performance. System can be latter enabled with an
 event through a plugin command.


 Skip Unnamed : ITEM/ARMOR/WEAPONS that don't have a name are skipped and
 their tags are not processed this can improve game startup load speed.

 ========================================================================
 Plugin Commands
 ========================================================================

 This couple of plugin commands will allow to disable or enable the eval
 process that occurs during the specified item action.

 ItemEvents Enable

 ItemEvents Disable

 ========================================================================
 Note Tag Data
 ========================================================================

 The note tag data used within this plugin applies to the ITEM, WEAPON
 and ARMOR tabs of the RPG Maker editor. You can use the following tags
 to execute code during the correct item changing moments.

 <Item Event Gained>
    code
    code
 </Item Event Gained>

 Place here the code to be executed every time the party gains an item or
 weapon or armor may it be by a treasure chest or by item drops or any
 other kind.
 ------------------------------------------------------------------------

 <Item Event Lost>
    code
    code
 </Item Event Lost>

 Place here the code to be executed every time the party loses an item or
 weapon or armor may it be by a treasure chest or by item using or any
 other kind.
 ------------------------------------------------------------------------

 <Item Event Drops>
    code
    code
 </Item Event Drops>

 Place here the code to be executed every time the party gains an item or
 weapon or armor by item drops ONLY.
 ------------------------------------------------------------------------

 <Item Event Equipped>
    code
    code
 </Item Event Equipped>

 Place here the code to be executed every time the player equips an armor
 or weapon.
 ------------------------------------------------------------------------

 <Item Event Removed>
    code
    code
 </Item Event Removed>

 Place here the code to be executed every time the player removes an armor
 or weapon.

 ========================================================================
 Code Builtin Variables
 ========================================================================

 isBattle : boolean to identify if the current scene is a battle.

 amount : the amount gained or lost (GAIN/LOST/YEARNED-ONLY, READ-ONLY).

 dbItem : is either of type dataItems, dataArmors or dataWeapons.

 actor : the Game_Actor equipping or removing the equipment.

 remove : if set to [true] this event is removed and will not run again.

 ========================================================================
 Extra Data
 ========================================================================

 $dataItems, $dataArmors, $dataWeapons are added a new property that is
 an object called [itemEvents] containing the following structure.

 {
    gained: "code",  lost: "code", drops: "code",
    equipped: "code", removed: "code"
 }

 Code evaluations are executed during the corresponding item action.

 ========================================================================
 Updates History
 ========================================================================

 1.0: Initial Release
 1.1: Added access to actor when equipping or removing equipments
 1.2: Corrected bugs related to the plugins' parameters reading.

 ========================================================================