An open library of RPG Maker MZ plugins, powered by the community.

PGMZ - The Community-Driven Plugin Library for RPG Maker MZ

MZ plugins

MPP Self Variable - MPP_SelfVariable.js

Plugin desc : Add a self variable to each event.

License : MIT License

Author : Mokusei Penguin

Website : http://woodpenguin.blog.fc2.com/

Desc page : https://woodpenguin.web.fc2.com/MV_Plugin/SelfVariable.html

File name : MPP_SelfVariable.js

Help of plugin :

* @target MV MZ
 * @plugindesc Add a self variable to each event.
 * @author Mokusei Penguin
 * @url 
 *
 * @help [version 2.0.1]
 * This plugin is for RPG Maker MV and MZ.
 * 
 * ▼ Overview
 *  - The variable with the number set in the plug-in parameter will refer to
 *    the self variable for each event.
 *  - If you operate the variable with the number set from [Control Variables]
 *    of the event command, the self-variable of the running event will be
 *    changed.
 *  - The self variable is referenced in the [Condition] of the event.
 *  - When [Common Event] is performed from an event, the self-variable of
 *    each event is referenced.
 *  - When the trigger of the common event is ”autorun” or ”parallel”,
 *    the self-variable for each common event is referenced.
 *  - Self variables do not apply to Troop battle events.
 *  - Even for normal events, the following commands cannot be used for
 *    parallel processing.
 *      >Show Text (control characters)
 *      >Show Choices (control characters)
 *      >Input Number
 *      >Select Item
 *      >Show Scrolling Text (control characters)
 * 
 * ▼ Plugin command details
 *  - In MV, the variable N is referred to by writing v [N] in the item for
 *    inputting a numerical value.
 *  - In MZ, in the item to enter a numerical value, select the text and
 *    write v [N] to refer to the variable N.
 *  
 *  〇 MV / MZ
 *  
 *  〇 DeleteSelfVariable mapIds indexes  / delete
 *      mapIds  : Range can be specified
 *      indexes : Self variable number / Range can be specified
 *   - Set all the specified self variables of the specified map ID to 0.
 *   - When specifying the range, do not put a space between them. (MV only)
 *       Example: DeleteSelfVariable 1 3
 *                   => Change self variable No. 3 of map ID No. 1 to 0
 *                 DeleteSelfVariable v[13] 1-5
 *                   => Change the self-variables 1 to 5 of the map ID of
 *                      variable 13 to 0
 *                 DeleteSelfVariable 1-5,8 1,2
 *                   => Change self variables 1 and 2 of map IDs 1-5 and 8 to 0
 * 
 *  〇 SetSelfVariable mapIds evIds indexes n  / set
 *      mapIds  : Range can be specified
 *      evIds   : Event ID / Range can be specified
 *      indexes : Self variable number / Range can be specified
 *      n       : Value
 *   - Set the value n by specifying the map ID, event ID,
 *     and self-variable number.
 *   - When specifying the range, do not put a space between them. (MV only)
 *       Example: SetSelfVariable 1 2 3 5
 *                   => Change the self variable No. 3 of the event ID No. 2
 *                      of the map ID No. 1 to 5.
 *                 SetSelfVariable 1-3 1,3,5 2-5 v[5]
 *                   => Change the self variables 2 to 5 of map IDs 1 to 3 and
 *                      event IDs 1 and 3 to the value of variable 5
 *       
 * ▼ About range specification
 *  - When setting numbers in an array, you can specify numbers from n to m by
 *    writing n-m.
 *      Example: 1-4,8,10-12
 * 
 * ================================
 * Mail : wood_penguin@yahoo.co.jp (@ is half-width)
 * Blog : http://woodpenguin.blog.fc2.com/
 * License : MIT license
 * 
 *  @command delete
 *      @desc 
 *      @arg mapIds
 *          @desc 0:Current map / Range can be specified
 *          @default 0
 *      @arg indexes
 *          @desc Range can be specified
 *          @default 0
 * 
 *  @command set
 *      @desc 
 *      @arg mapIds
 *          @desc 0:Current map / Range can be specified
 *          @default 0
 *      @arg eventIds
 *          @desc Range can be specified
 *          @default 0
 *      @arg indexes
 *          @desc Range can be specified
 *          @default 0
 *      @arg value
 *          @desc 
 *          @type number
 *              @min -99999999
 *              @max 99999999
 *          @default 0
 * 
 * @----------------
 * 
 *  @param Variables
 *      @desc Number of variable to be self-variable
 * (Range can be specified)
 *      @default 
 *

スポンサードリンク

-MZ plugins

Copyright© PGMZ - The Community-Driven Plugin Library for RPG Maker MZ , 2025 All Rights Reserved.