Party System VisuStella MZ

From Wiki
Revision as of 02:48, 27 September 2020 by Yanfly (talk | contribs) (Changelog)
Jump to navigation Jump to search

Welcome to the wiki! This is where you can find resources from, Æ,
VisuStella, Caz Wolf, Fallen Angel Olivia, Atelier Irina, and other affiliated content creators.



This is a plugin created for RPG Maker MZ.




Click here for help on how to install plugins and an explanation on the Tier Hierarchy System.

Click here to learn how to update plugins.

Click here for how to troubleshoot plugins if you get an error.

PartySystemMenu1.png PartySystemBattle1.png
PartySystemScene1.png PartySystemScene2.png

VisuStella MZ

This plugin is a part of the VisuStella MZ Plugin Library.

Click here if you want to help support VisuStella on Patreon.


RPG Maker MZ only gives game projects the ability to switch party members within the main menu and nothing more. There's no inherent functionality to lock party members, make party members required, and/or give players the ability to switch party members mid-battle.

This plugin will add in all of those functions as well as a dedicated scene for switching party members. Party switching will allow party members to be removed, swapped, and sorted. Through the usage of Plugin Commands, party members can also be locked and/or required for party presence.

Those using the VisuStella MZ Battle Core will also have access to features in this plugin that aren't available otherwise. These features give players the functionality to switch out the whole party lineup mid-battle and/or individual party member switching.

Features include all (but not limited to) the following:

  • Custom scene dedicated to party management.
  • Change the maximum number of party members that can participate in battle.
  • Plugin Commands to lock party members.
  • Plugin Commands to make certain party members required.
  • Added functionality with Battle Core to switch party members mid-battle.
  • This comes in the form of changing either the whole party at once.
  • Or switching individual members out one at a time.


This plugin is made for RPG Maker MZ. This will not work in other iterations of RPG Maker.

Tier 2

This plugin is a Tier 2 plugin. Place it under other plugins of lower tier value on your Plugin Manager list (ie: 0, 1, 2, 3, 4, 5).

This is to ensure that your plugins will have the best compatibility with the rest of the VisuStella MZ Plugin library.

Major Changes


This plugin adds some new hard-coded features to RPG Maker MZ's functions. The following is a list of them.


Main Menu Formation Command

This command is now changed to send the player to Scene_Party for the player to have a dedicated scene for changing the party.


Battle Members Array

Previously, the battle members are decided by which actors are lined up first in the party roster. This has been changed to give players the freedom to have a party size less than the maximum. This change is made by changing the way the battle members are determined by using a new array. However, any and all functions utilize the $gameParty.battleMembers() function will still behave as normal.


Formation Change OK Function

RPG Maker MZ did not do anything with the Game_Actor.isFormationChangeOk function so this plugin overwrote it completely to allow for the new lock and require features to work.


Extra Features

There are some extra features found if other VisuStella MZ plugins are found present in the Plugin Manager list.



Battle Core VisuStella MZ

If the VisuStella MZ Battle Core plugin is present, players are able to access party switching functionality mid-battle at will. This can be in the form of switching out the entire active party roster at once or individually for each actor.

Switching Entire Rosters: This can be done by going into this plugin's Plugin Parameters => General => Party Command Window => Add Party Command. If the Party Command Window is accessible, the player will be able to see the option between 'Auto Battle' and 'Options'.

Individual Member Switching: This requires going to VisuMZ_1_BattleCore's Plugin Parameters => Actor Command Window => Battle Commands => Command List and add in the "party" option. The "party" option can also be added to the <Battle Commands> notetag.


Plugin Commands


Plugin Commands are event commands that are used to call upon functions added by a plugin that aren't inherently a part of RPG Maker MZ.

Here is a list of Plugin Command(s) that you may use:


The following are Plugin Commands that come with this plugin. They can be accessed through the Plugin Command event command.


Party Plugin Commands




Party: Call Party Scene
- Calls the party changing scene.




Party: Change Max Battle Members
- Changes the number of max battle members possible.
- Cannot be use mid-battle.

  Max Members:
  - Changes the number of max battle members possible.
  - Use 0 for the game's default number.




Party: Lock/Unlock Member(s)
- Allows you to lock/unlock a party member.
- Locked actors cannot change their party position.

  Actor ID(s):
  - Select which actor(s) to lock/unlock.
  - Locked actors cannot change their party position.

  - Lock the selected actor(s)?


PartySystem Update24 Command1.png

Party: Move Actor(s) to Active
- Map Only.
- Moves an actor to the active party if there is room.
- The actor needs to have joined the party.

  Actor ID(s):
  - Select which actor(s) to move to the active party if there is room.


PartySystem Update24 Command2.png

Party: Move Actor(s) to Reserve
- Map Only.
- Moves an actor to the reserve party.
- Must be 1 actor left.
- The actor needs to have joined the party.

  Actor ID(s):
  - Select which actor(s) to move to the reserve party.


PartySystem Update25 Command1.png

Party: Move Party Index to Reserve
- Map only.
- Moves an actor in a specific party index to reserve.
- Must be 1 actor left.

  - Type in which index to move.
  - Index values start at 0.
  - You may use JavaScript code.


PartySystem Update25 Command2.png

Party: Move Random Reserve to Active
- Map only.
- Moves a random actor from the reserve party to active.
- Must be enough space in active party.




Party: Require Member(s)
- Allows you to require/free a party member.
- Required actors must be in the party to exit the scene.

  Actor ID(s):
  - Select which actor(s) to require/free.
  - Required actors must be in the party to exit the scene.

  - Make the selected actor(s) required?


Plugin Parameters

General Settings


These Plugin Parameters control the overall behaviors pertaining to the Party System added with this plugin. These behaviors range from the maximum number of members that can participate in battle to the availability of the party switching mechanics.





 Max Battle Members:
 - Maximum number of battle members.



Party Scene

 Add Remove Command:
 - Add the 'Remove' command to the party scene?
 Locked Member Icon:
 - Icon used for a locked party member.
 Requiured Member Icon:
 - Icon used for a required party member.
 Show Back Rectangles?:
 - Show back rectangles of darker colors to display information better?
   Back Rectangle Color:
   - Use #rrggbb for custom colors or regular numbers for text colors
     from the Window Skin.



Party Command Window - These require VisuMZ_1_BattleCore!

 Add Party Command:
 - Add the 'Party' command to the Party Command Window?
 Command Cooldown:
 - Cooldown (in turns) for this command to be available again.



Actor Command Window - These require VisuMZ_1_BattleCore!

 Add Switch Command:
 - Add the 'Switch' command to the Actor Command Window?
 Command Cooldown:
 - Cooldown (in turns) for this command to be available again.
 Switch Out Animation?:
 - Show the sprites switching out when using individual party
   member switching?


Vocabulary Settings


These Plugin Parameters control the text that you see in-game related to the Party System plugin.



 Active Party:
 - Vocabulary used to represent the Active Party.
 Reserve Party:
 - Vocabulary used to represent the Reserve Party.
 - Vocabulary used to represent the Status Window.


Party Scene > Windows

 - For the party and status windows when no actor is selected.
 - For the remove option.


Party Scene > Button Assist

 Swap Positions:
 - Button assist text for the page up/down commands.
 - Requires VisuMZ_0_CoreEngine!
 - Button assist text for the removal command.
 - Requires VisuMZ_0_CoreEngine!
 - Button assist text for the sort command.
 - Requires VisuMZ_0_CoreEngine!
 Swap In:
 - Button assist text for swapping in actors.
 - Requires VisuMZ_0_CoreEngine!
 Swap Out:
 - Button assist text for swapping out actors.
 - Requires VisuMZ_0_CoreEngine!


Battle Scene

 Party Command:
 - Command text for entering Party Scene.
 - Requires VisuMZ_1_BattleCore!
 Help: Formation:
 - Help text for Formation command.
 - Requires VisuMZ_1_BattleCore!
 Queue Message:
 - Message to say the Party Scene is queued.
 - Requires VisuMZ_1_BattleCore!
 Switch Command:
 - Command text for switching out members.
 - Requires VisuMZ_1_BattleCore!
 Help: Switch:
 - Help text for Switch command.
 - Requires VisuMZ_1_BattleCore!


Background Settings


Background settings for Scene_Party.


Background Settings

 Snapshop Opacity:
 - Snapshot opacity for the scene.
 Background 1:
 - Filename used for the bottom background image.
 - Leave empty if you don't wish to use one.
 Background 2:
 - Filename used for the upper background image.
 - Leave empty if you don't wish to use one.


Window Settings


If you don't like the locations of the windows in Scene_Party, change them up with these Plugin Parameters, provided that you have an understanding of JavaScript code.


Active Party Label

Active Party Window

Reserve Party Label

Reserve Party Window

Status Label

Status Window

Battle Switch Window

 Background Type:
 - Select background type for this window.
 - Available only for the Reserve Party Window.
 - How many columns do you want there to be for the window?
 Actor Graphic:
 - Available only for Active Party Window and Reserve Party Window.
 - Choose how the actor graphics appear in the specific windows.
   - Face
   - Map Sprite
   - Sideview Battler (Requires VisuMZ_1_MainMenuCore)
   Map Sprite:
   Sideview Battler:
     Offset X:
     Offset Y:
     - If showing map sprites, offset the x or y coordinates.
 JS: X, Y, W, H:
 - Code used to determine the dimensions for this window.


Terms of Use

1. These plugins may be used in free or commercial games provided that they have been acquired through legitimate means at and/or any other official approved VisuStella sources. Exceptions and special circumstances that may prohibit usage will be listed on

2. All of the listed coders found in the Credits section of this plugin must be given credit in your games or credited as a collective under the name: "VisuStella".

3. You may edit the source code to suit your needs, so long as you do not claim the source code belongs to you. VisuStella also does not take responsibility for the plugin if any changes have been made to the plugin's code, nor does VisuStella take responsibility for user-provided custom code used for custom control effects including advanced JavaScript notetags and/or plugin parameters that allow custom JavaScript code.

4. You may NOT redistribute these plugins nor take code from this plugin to use as your own. These plugins and their code are only to be downloaded from and other official/approved VisuStella sources. A list of official/approved sources can also be found on

5. VisuStella is not responsible for problems found in your game due to unintended usage, incompatibility problems with plugins outside of the VisuStella MZ library, plugin versions that aren't up to date, nor responsible for the proper working of compatibility patches made by any third parties. VisuStella is not responsible for errors caused by any user-provided custom code used for custom control effects including advanced JavaScript notetags and/or plugin parameters that allow JavaScript code.

6. If a compatibility patch needs to be made through a third party that is unaffiliated with VisuStella that involves using code from the VisuStella MZ library, contact must be made with a member from VisuStella and have it approved. The patch would be placed on as a free download to the public. Such patches cannot be sold for monetary gain, including commissions, crowdfunding, and/or donations.

7. If this VisuStella MZ plugin is a paid product, all project team members must purchase their own individual copies of the paid product if they are to use it. Usage includes working on related game mechanics, managing related code, and/or using related Plugin Commands and features. Redistribution of the plugin and/or its code to other members of the team is NOT allowed unless they own the plugin itself as that conflicts with Article 4.

8. Any extensions and/or addendums made to this plugin's Terms of Use can be found on and must be followed.

Terms of Use: Japanese

『VisuStella MZ』利用規約

1. これらのプラグインは、VisuStella.comおよび/または公式に承認されたVisuStellaのソースから合法的な手段で入手したものである限り、フリーゲームや商用ゲームに使用することができます。例外的に使用が禁止される場合については、VisuStella.comの記載をご確認ください。

2. 本プラグインの「クレジット」部分に記載されているすべてのコーダーの名前は、ゲーム内にクレジット表記を行うか、もしくは「VisuStella」という名前の下にまとめて表記する必要があります。

3. ソースコードを自分のものだと主張しない限りは、必要に応じて編集することが可能です。ただしプラグインのコードに変更が加えられた場合、VisuStellaはそのプラグインに対して一切の責任を負いません。高度なJavaScriptのノートタグやJavaScriptコードを許可するプラグインのパラメータを含む、カスタムコントロールエフェクトに使用される、ユーザー提供のカスタムコードについても、VisuStellaは一切の責任を負いません。

4. これらのプラグインやプラグイン内のコードを、「自分のもの」として再配布したり使用したりすることはできません。これらのプラグインとそのコードは、VisuStella.comおよび、その他の公式/承認済みVisuStellaソースからのみダウンロードすることができます。公式/承認済みのソースのリストは、VisuStella.comでご確認いただけます。

5. VisuStellaは、意図しない使用方法による問題、VisuStella MZライブラリ以外のプラグインとの非互換性の問題、プラグインのバージョンが最新でないことによる問題、第三者による互換性パッチが適切に動作していないことなどが原因でゲーム内で発生した問題については、一切の責任を負いません。VisuStellaは、高度なJavaScriptのノートタグやJavaScriptコードを許可するプラグインのパラメータを含む、カスタムコントロールエフェクトに使用される、ユーザー提供のカスタムコードに起因するエラーについても、一切の責任を負いません。

6. VisuStella MZライブラリのコードを使用した互換性パッチをVisuStellaとは関係のない第三者を通じて作成する必要がある場合は、まずVisuStellaのメンバーと連絡を取り、承認を得る必要があります。パッチはVisuStella.comに公開され、誰でも無料でダウンロードすることができるようになります。このようなパッチを、制作発注やクラウドファンディングの対象にしたり、寄付などの金銭的な利益を得るために販売することはできません。

7. このVisuStella MZプラグインが商用製品である場合、プロジェクトチームのすべてのメンバーは、それを使用するため、それぞれ製品を購入しなければなりません。使用方法には、関連するゲームメカニクスの作業、関連するコードの管理、および/または関連するプラグインコマンドや機能の使用、が含まれます。プラグインそのものやそのコードをチームの他のメンバーに再配布することは第4項に抵触するため、そのメンバーがプラグインそのものを所有していない限りは許可されません。

8. このプラグインの利用規約の追加項目や補足については、VisuStella.comに掲載されていますので、それを参照し従ってください。


If you are using this plugin, credit the following people in your game:

Team VisuStella


Version 1.01: September 27, 2020

  • Bug Fixes!
    • When switching actors with states, buffs, and/or debuffs already applied, the state icons found in the status window will now switch over properly, too. Fix made by Arisu.

Version 1.00: September 7, 2020

  • Finished Plugin!

Help File