Yanfly.moe Wiki - User contributions [en]

Template:VisuMZ Battle Core Notetags

2026-05-27T11:51:18Z

Irina: /* Battle Command-Related Notetags */

<noinclude>[[Category:Display templates|VisuMZ Battle Core Notetags]]</noinclude>

The following are notetags that have been added through this plugin. These
notetags will not work with your game if this plugin is OFF or not present.

=== HP Gauge-Related Notetags ===

[[File:BattleCoreHpGauge.png|400px]]

The following notetags allow you to set whether or not HP Gauges can be
displayed by enemies regardless of Plugin Parameter settings.

---

<pre>
<Show HP Gauge>

- Used for: Enemy Notetags
- Will always show the HP Gauge for the enemy regardless of the defeat
requirement setting.
- This does not bypass the player's Options preferences.
- This does not bypass disabling enemy HP Gauges as a whole.
</pre>

---

<pre>
<Hide HP Gauge>

- Used for: Enemy Notetags
- Will always hide the HP Gauge for the enemy regardless of the defeat
requirement setting.
- This does not bypass the player's Options preferences.
</pre>

---

<pre>
<Battle UI Offset: +x, +y>
<Battle UI Offset: -x, -y>

<Battle UI Offset X: +x>
<Battle UI Offset X: -x>

<Battle UI Offset Y: +y>
<Battle UI Offset Y: -y>

- Used for: Actor and Enemy Notetags
- Adjusts the offset of HP Gauges and State Icons above the heads of actors
and enemies.
- Replace 'x' with a number value that offsets the x coordinate.
- Negative x values offset left. Positive x values offset right.
- Replace 'y' with a number value that offsets the y coordinate.
- Negative y values offset up. Positive x values offset down.
</pre>

---

=== Animation-Related Notetags ===

[[File:BattleCoreCastAni.gif]]

The following notetags allow you to set animations to play at certain
instances and/or conditions.

---

<pre>
<Slip Animation: x>

- Requires VisuMZ_0_CoreEngine!
- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- During the phase at which the user regenerates HP, MP, or TP, this
animation will play as long as the user is alive and visible.
- Replace 'x' with a number value representing the Animation ID to play.
</pre>

---

<pre>
<Cast Animation: x>

- Used for: Skill Notetags
- Plays a battle animation at the start of the skill.
- Replace 'x' with a number value representing the Animation ID to play.
</pre>

---

<pre>
<Attack Animation: x>

- Used for: Enemy Notetags
- Gives an enemy an attack animation to play for its basic attack.
- Replace 'x' with a number value representing the Animation ID to play.
</pre>

---

<pre>
<Under>

- Used for: Animation Name Tags
- If this tag is found in an animation's name, the animation will appear
under battlers while in battle.
- This effect only applies to battlers in the battle scene.
- Under effect is NOT applied to status window portraits.
- Under effect is NOT applied to projectile animations.
</pre>

---

=== Battleback-Related Notetags ===

[[File:BattleCoreBattleBack.png|400px]]

You can apply these notetags to have some control over the battlebacks that
appear in different regions of the map for random or touch encounters.

---

<pre>
<Region x Battleback1: filename>
<Region x Battleback2: filename>

- Used for: Map Notetags
- If the player starts a battle while standing on 'x' region, then the
'filename' battleback will be used.
- Replace 'x' with a number representing the region ID you wish to use.
- Replace 'filename' with the filename of the graphic to use. Do not insert
any extensions. This means the file 'Castle1.png' will be only inserted
as 'Castle1' without the '.png' at the end.
- *NOTE: This will override any specified battleback settings.
</pre>

---

=== Battle Command-Related Notetags ===

[[File:BattleCoreBattleCommands.png]]

You can use notetags to change how the battle commands of playable
characters appear in battle as well as whether or not they can be used.

---

<pre>
<Seal Attack>
<Seal Guard>
<Seal Item>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Prevents specific battle commands from being able to be used.
</pre>

---

<pre>
<Battle Commands>
Attack
Skills
SType: x
SType: name
All Skills
Skill: x
Skill: name
Guard
Item
Party
Escape
Auto Battle
Boost
Unboost
Combat Log
Talk
Weapon Swap
</Battle Commands>

- Used for: Class Notetags
- Changes which commands appear in the Actor Command Window in battle.
If this notetag is not used, then the default commands determined in
Plugin Parameters => Actor Command Window => Command List will be used.
- Add/remove/modify entries as needed.

- Attack
- Adds the basic attack command.

- Skills
- Displays all the skill types available to the actor.

- SType: x
- Stype: name
- Adds in a specific skill type.
- Replace 'x' with the ID of the skill type.
- Replace 'name' with the name of the skill type (without text codes).

- All Skills
- Adds all usable battle skills as individual actions.

- Skill: x
- Skill: name
- Adds in a specific skill as a usable action.
- Replace 'x' with the ID of the skill.
- Replace 'name' with the name of the skill.

- Guard
- Adds the basic guard command.

- Item
- Adds the basic item command.

- Party
- Requires VisuMZ_2_PartySystem.
- Allows this actor to switch out with a different party member.

- Escape
- Adds the escape command.

- Auto Battle
- Adds the auto battle command.

- Boost
- Requires VisuMZ_3_BoostAction.js.
- Adds the Boost battle command.

- Unboost
- Requires VisuMZ_3_BoostAction.js.
- Adds the Unboost battle command.

- Combat Log
- Requires VisuMZ_4_CombatLog.
- Opens up the combat log.

- Talk
- Requires VisuMZ_3_BattleCmdTalk!
- Shows talk command if applicable.

- Weapon Swap
- Requires VisuMZ_2_WeaponSwapSystem.
- Swaps the current weapon.

Example:

<Battle Commands>
Attack
Skill: Heal
Skills
Guard
Item
Escape
</Battle Commands>
</pre>

---

<pre>
<Command Text: x>

- Used for: Skill Notetags
- When a skill is used in a <Battle Commands> notetag set, you can change
the skill name text that appears to something else.
- Replace 'x' with the skill's name you want to shown in the Actor Battle
Command window.
- Recommended Usage: Shorten skill names that are otherwise too big to fit
inside of the Actor Battle Command window.
</pre>

---

<pre>
<Command Icon: x>

- Used for: Skill Notetags
- When a skill is used in a <Battle Commands> notetag set, you can change
the skill icon that appears to something else.
- Replace 'x' with the ID of icon you want shown in the Actor Battle Command
window to represent the skill.
</pre>

---

<pre>
<Command Require Learn>

- Used for: Skill Notetags
- Determines if a battle command is visible or not by whether the actor has
learned the skill.
- Learning the skill is a requirement. Acquiring the skill through traits
does not count as learning the skill.
</pre>

---

<pre>
<Command Require Access>

- Used for: Skill Notetags
- Determines if a battle command is visible or not by whether the actor has
access to the skill.
- Having access to the skill can come through either learning the skill or
temporarily acquiring it through trait objects.
</pre>

---

<pre>
<Command Show Switch: x>

<Command Show All Switches: x,x,x>
<Command Show Any Switches: x,x,x>

- Used for: Skill Notetags
- Determines if a battle command is visible or not through switches.
- Replace 'x' with the switch ID to determine the skill's visibility.
- If 'All' notetag variant is used, item will be hidden until all
switches are ON. Then, it would be shown.
- If 'Any' notetag variant is used, item will be shown if any of the
switches are ON. Otherwise, it would be hidden.
- This can be applied to Attack and Guard commands, too.
</pre>

---

<pre>
<Command Hide Switch: x>

<Command Hide All Switches: x,x,x>
<Command Hide Any Switches: x,x,x>

- Used for: Skill Notetags
- Determines if a battle command is visible or not through switches.
- Replace 'x' with the switch ID to determine the skill's visibility.
- If 'All' notetag variant is used, item will be shown until all
switches are ON. Then, it would be hidden.
- If 'Any' notetag variant is used, item will be hidden if any of the
switches are ON. Otherwise, it would be shown.
- This can be applied to Attack and Guard commands, too.
</pre>

---

<pre>
<Battle Portrait: filename>

- Used for: Actor
- This is used with the "Portrait" Battle Layout.
- Sets the battle portrait image for the actor to 'filename'.
- Replace 'filename' with a picture found within your game project's
img/pictures/ folder. Filenames are case sensitive. Leave out the filename
extension from the notetag.
- This will override any menu images used for battle only.
</pre>

---

<pre>
<Battle Portrait Offset: +x, +y>
<Battle Portrait Offset: -x, -y>

<Battle Portrait Offset X: +x>
<Battle Portrait Offset X: -x>

<Battle Portrait Offset Y: +y>
<Battle Portrait Offset Y: -y>

- Used for: Actor
- This is used with the "Portrait" and "Border" Battle Layouts.
- Offsets the X and Y coordinates for the battle portrait.
- Replace 'x' with a number value that offsets the x coordinate.
- Negative x values offset left. Positive x values offset right.
- Replace 'y' with a number value that offsets the y coordinate.
- Negative y values offset up. Positive x values offset down.
</pre>

---

<pre>
<Help Description>
text
text
</Help Description>

- Used for: State Notetags
- Assigns a help description for the state that's displayed under the
"Status" actor command.
- Replace 'text' with text you want displayed for the help window.
- This best works with one line for compatibility with other plugins.
- Insert %1 into the help description to show any data that would otherwise
be shown as the state display, such as Absorption Barrier count.
- This is used as a common notetag between Battle Core's state descriptions
and State Tooltips' state descriptions.
</pre>

---

<pre>
<In-Battle Status Description>
text
text
</In-Battle Status Description>
- Assigns a help description for the state that's displayed under the
"Status" actor command.
- Replace 'text' with text you want displayed for the help window.
- This best works with one line for compatibility with other plugins.
- Insert %1 into the help description to show any data that would otherwise
be shown as the state display, such as Absorption Barrier count.
- The description used here will not be used for State Tooltips.
- If both <Help Description> and <In-Battle Status Description> notetags
exist in the same state, priority will be given to this one for the
In-Battle Status Window.
</pre>

---

<pre>
<Exclude From Status Listing>

- Used for: State Notetags
- Excludes the state from being displayed in the status listing.
</pre>

---

=== JavaScript Notetag: Battle Command-Related ===

The following are notetags made for users with JavaScript knowledge to
determine if skill-based battle commands are visible or hidden.

---

<pre>
<JS Command Visible>
code
code
visible = code;
</JS Command Visible>

- Used for: Skill Notetags
- The 'visible' variable is the final returned variable to determine the
skill's visibility in the Battle Command Window.
- Replace 'code' with JavaScript code to determine the skill's visibility in
the Battle Command Window.
- The 'user' variable represents the user who will perform the skill.
- The 'skill' variable represents the skill to be used.
</pre>

---

=== Targeting-Related Notetags ===

The following notetags are related to the targeting aspect of skills and
items and may adjust the scope of how certain skills/items work.

---

<pre>
<Always Hit>

<Always Hit Rate: x%>

- Used for: Skill, Item Notetags
- Causes the action to always hit or to always have a hit rate of exactly
the marked x%.
- Replace 'x' with a number value representing the hit success percentage.
</pre>

---

<pre>
<Repeat Hits: x>

- Used for: Skill, Item Notetags
- Changes the number of hits the action will produce.
- Replace 'x' with a number value representing the number of hits to incur.
</pre>

---

<pre>
<Target: x Random Any>

- Used for: Skill, Item Notetags
- Makes the skill pick 'x' random targets when used.
- Targets can be both actors and enemies.
- This will overwrite the existing database scope and ignore the database's
existing scope in favor of this.
- Replace 'x' with a number value representing the number of random targets.
</pre>

---

<pre>
<Target: x Random Enemies>

- Used for: Skill, Item Notetags
- Makes the skill pick 'x' random targets when used.
- Targets are only enemies.
- This will overwrite the existing database scope and ignore the database's
existing scope in favor of this.
- Replace 'x' with a number value representing the number of random targets.
</pre>

---

<pre>
<Target: x Random Allies>

- Used for: Skill, Item Notetags
- Makes the skill pick 'x' random targets when used.
- Targets are only actors.
- This will overwrite the existing database scope and ignore the database's
existing scope in favor of this.
- Replace 'x' with a number value representing the number of random targets.
</pre>

---

<pre>
<Target: All Allies But User>

- Used for: Skill, Item Notetags
- This will overwrite the existing database scope and ignore the database's
existing scope in favor of this.
- Targets all allies with the exception of the user.
</pre>

---

<pre>
<Target: Ally or Enemy>

- Used for: Skill, Item Notetags
- Allows the player to target allies or enemies with the skill/item.
- Keep in mind this does NOT allow you to select dead party members.
- This will overwrite the existing database scope and ignore the database's
existing scope in favor of this.
- Target selection emphasis will go to allies first.
- Ignored when used by enemies and will be treated as an ally scope.
- Auto-battle actors will also treat this action as an ally scope.
- For certain battle layouts in frontview, this will open the Actor Select
window in order for Touch Input to be able to select actors.
</pre>

---

<pre>
<Target: Enemy or Ally>

- Used for: Skill, Item Notetags
- Allows the player to target enemies or allies with the skill/item.
- Keep in mind this does NOT allow you to select dead party members.
- This will overwrite the existing database scope and ignore the database's
existing scope in favor of this.
- Target selection emphasis will go to enemies first.
- Ignored when used by enemies and will be treated as an enemy scope.
- Auto-battle actors will also treat this action as an enemy scope.
- For certain battle layouts in frontview, this will open the Actor Select
window in order for Touch Input to be able to select actors.
</pre>

---

<pre>
<Single or Multiple Select>

- Used for: Skill, Item Notetags
- Requires an original scope that can select individual targets.
- This will allow the skill/item to be able to select either single targets
or multiple targets at once.
- In order to select "all enemies", the player must press the "Page Up"
keyboard button or the visual on screen "All Enemies" button.
- In order to select "all allies", the player must press the "Page Down"
keyboard button or the visual on screen "All Allies" button.
- Those wondering why this isn't regulated to a command left or right of
the enemies and actors is because mouse controls and touch controls
would not be able to select all enemies or all allies that way.
- This can NOT be used with single dead ally scopes.
- If there is an enemy with Taunt or Provoke, the option to select
"All Enemies" does not become possible.
- The enemy AI and Auto-Battle actor AI will NOT make use of the ability to
toggle between single and multiple target scopes. They will only use the
single target versions of these skills.
</pre>

---

<pre>
<Disperse Damage>

- Used for: Skill, Item Notetags
- This will cause any damage dealt by this skill to be split equally amongst
all targets of the skill including repeats.
- For basic attacks, any damage reduction added attack trait totals will
by reverted.
- This does NOT have to be used with <Single or Multiple Select> notetag and
can be used by itself for an "All" scope, making the skill/item deal less
damage if there's more enemies and more damage if there's less enemies.
</pre>

---

<pre>
<Cannot Target User>

- Used for: Skill, Item Notetags
- This will cause the action to be unable to select the user as the target.
- This is not a targeting scope. Instead, it is used in addition to any
other targeting scopes out there.
- When used with "All" scopes, the user is removed from the target pool.
- This is also applied outside of battle.
- If the user somehow enters the target pool, the user is then replaced by
a random ally found in the party.
</pre>

---

=== JavaScript Notetag: Targeting-Related ===

---

<pre>
<JS Accuracy>
code
code
rate = code;
</JS Accuracy>

- Used for: Skill, Item Notetags
- Only applies during battle.
- The 'rate' variable is the final returned amount to determine the
accuracy hit success rate.
- Base value comes from Game_Action.itemHit
- Skill/Item <JS Accuracy> runs
- Then <JS Accuracy as User/Target> notetags run
- Replace 'code' with JavaScript code to determine the final 'rate' to be
returned as the accuracy hit success rate.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
- Works best with VisuMZ Core Engine's "Improved Accuracy" QoL formula in
order to consolidate both HIT and EVA.
</pre>

---

<pre>
<JS Accuracy as User>
code
code
rate = code;
</JS Accuracy as User>

<JS Accuracy as Target>
code
code
rate = code;
</JS Accuracy as Target>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Only applies during battle.
- The 'rate' variable is the final returned amount to determine the
accuracy hit success rate.
- Base value comes from Game_Action.itemHit
- Skill/Item <JS Accuracy> runs
- Then <JS Accuracy as User/Target> notetags run
- If used on trait objects, this will apply to any skills/items used as long
as the unit affected by the trait object has access to the trait object.
- If the 'as User' notetag variant is used, this code will be run as a
response to the action from the action user end.
- If the 'as Target' notetag variant is used, this code will be run as a
response to the action from the action target end.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Targets>
code
code
targets = [code];
</JS Targets>

- Used for: Skill, Item Notetags
- The 'targets' variable is an array that is returned to be used as a
container for all the valid action targets.
- This is NOT used for filtering out who the player can or cannot select.
- This determines a final result.
- The 'targets' variable will include the original set of targets determined
by the skill/item's original scale.
- Replace 'code' with JavaScript code to determine valid targets.
</pre>

---

=== Damage-Related Notetags ===

[[File:BattleCoreDmgStyles.png|400px]]

---

<pre>
<Damage Style: name>

- Used for: Skill, Item Notetags
- Replace 'name' with a Damage Style name to change the way calculations are
made using the damage formula input box.
- Names can be found in Plugin Parameters => Damage Settings => Style List
</pre>

---

<pre>
<Damage Flinch>

- Used for: Skill, Item Notetags
- Normally, MP and TP actions do not cause damage flinching. However,
skills and items with this notetag will cause damage flinching if they
hurt the target's MP or TP.
- HP damage will always be affected and cause target to flinch.
</pre>

---

<pre>
<Armor Reduction: x>
<Armor Reduction: x%>
- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- If used on skills and/or items, sets the current skill/item's armor
reduction properties to 'x' and/or 'x%'.
- If used on trait objects, adds 'x' and/or 'x%' armor reduction properties
when calculating one's own armor.
- Use the 'x' notetag variant to determine a flat reduction value.
- Use the 'x%' notetag variant to determine a percentile reduction value.
</pre>

---

<pre>
<Armor Penetration: x>
<Armor Penetration: x%>
- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- If used on skills and/or items, sets the current skill/item's armor
penetration properties to 'x' and/or 'x%'.
- If used on trait objects, adds 'x' and/or 'x%' armor penetration
properties when calculating a target's armor.
- Use the 'x' notetag variant to determine a flat penetration value.
- Use the 'x%' notetag variant to determine a percentile penetration value.
</pre>

---

<pre>
<Magic Reduction: x>
<Magic Reduction: x%>
- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- If used on skills and/or items, sets the current skill/item's armor
reduction properties to 'x' and/or 'x%'.
- If used on trait objects, adds 'x' and/or 'x%' armor reduction properties
when calculating one's own armor.
- This applies to magical attacks.
- Use the 'x' notetag variant to determine a flat reduction value.
- Use the 'x%' notetag variant to determine a percentile reduction value.
</pre>

---

<pre>
<Magic Penetration: x>
<Magic Penetration: x%>
- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- If used on skills and/or items, sets the current skill/item's armor
penetration properties to 'x' and/or 'x%'.
- If used on trait objects, adds 'x' and/or 'x%' armor penetration
properties when calculating a target's armor.
- This applies to magical attacks.
- Use the 'x' notetag variant to determine a flat penetration value.
- Use the 'x%' notetag variant to determine a percentile penetration value.
</pre>

---

<pre>
<Bypass Damage Cap>

- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- If used on skills and/or items, this will cause the action to never have
its damage capped.
- If used on trait objects, this will cause the affected unit to never have
its damage capped.
</pre>

---

<pre>
<Damage Cap: x>

- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- If used on skills and/or items, this will declare the hard damage cap to
be the 'x' value.
- If used on trait objects, this will raise the affect unit's hard damage
cap to 'x' value. If another trait object has a higher value, use that
value instead.
</pre>

---

<pre>
<Bypass Soft Damage Cap>

- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- If used on skills and/or items, this will cause the action to never have
its damage scaled downward to the soft cap.
- If used on trait objects, this will cause the affected unit to never have
its damage scaled downward to the soft cap.
</pre>

---

<pre>
<Soft Damage Cap: +x%>
<Soft Damage Cap: -x%>

- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- If used on skills and/or items, this will increase/decrease the action's
soft cap by x% where 'x' is a percentage value representing the increment
changed by the hard cap value.
- If used on trait objects, this will raise the affect unit's soft damage
limit by x% where 'x' is a percentage value representing the increment
changed by the hard cap value.
</pre>

---

<pre>
<Unblockable>

- Used for: Skill, Item Notetags
- Using "Guard" against this skill will not reduce any damage.
</pre>

---

<pre>
<Popup Position: Head>
<Popup Position: Center>
<Popup Position: Base>

- Used for: Enemy Notetags
- Determines the popup starting position for this enemy.
- Head makes the popups start at the top of the ennemy.
- Center makes the popups start at the center of the ennemy.
- Base makes the popups start at the bottom of the ennemy.
- If this notetag is not used, refer to the default Plugin Parameter setting
found in Damage Settings.
</pre>

---

<pre>
<Popup Offset X: +x>
<Popup Offset X: -x>
<Popup Offset Y: +y>
<Popup Offset Y: -y>

- Used for: Enemy Notetags
- Alters the popup x/y position offset for this enemy.
- Replace 'x' with a number representing the horizontal position x offset.
- Negative: left. Positive: right.
- Replace 'y' with a number representing the vertical position y offset.
- Negative: up. Positive: down.
- If these notetags are not used, refer to the default Plugin Parameter
settings found in Damage Settings.
</pre>

---

=== Critical-Related Notetags ===

The following notetags affect skill and item critical hit rates and the
critical damage multiplier.

---

<pre>
<Always Critical>

- Used for: Skill, Item Notetags
- This skill/item will always land a critical hit regardless of the
user's CRI parameter value.
</pre>

---

<pre>
<Set Critical Rate: x%>

- Used for: Skill, Item Notetags
- This skill/item will always have a x% change to land a critical hit
regardless of user's CRI parameter value.
- Replace 'x' with a percerntage value representing the success rate.
</pre>

---

<pre>
<Modify Critical Rate: x%>
<Modify Critical Rate: +x%>
<Modify Critical Rate: -x%>

- Used for: Skill, Item Notetags
- Modifies the user's CRI parameter calculation for this skill/item.
- The 'x%' notetag variant will multiply the user's CRI parameter value
for this skill/item.
- The '+x%' and '-x%' notetag variants will incremenetally increase/decrease
the user's CRI parameter value for this skill/item.
</pre>

---

<pre>
<Modify Critical Multiplier: x%>
<Modify Critical Multiplier: +x%>
<Modify Critical Multiplier: -x%>

- Used for: Skill, Item Notetags
- These notetags determine the damage multiplier when a critical hit lands.
- The 'x%' notetag variant multiply the multiplier to that exact percentage.
- The '+x%' and '-x%' notetag variants will change the multiplier with an
incremenetal rate for this skill/item.
</pre>

---

<pre>
<Modify Critical Bonus Damage: x%>
<Modify Critical Bonus Damage: +x%>
<Modify Critical Bonus Damage: -x%>

- Used for: Skill, Item Notetags
- These notetags determine the bonus damage added when a critical hit lands.
- The 'x%' notetag variant multiply the damage to that exact percentage.
- The '+x%' and '-x%' notetag variants will change the bonus damage with an
incremenetal rate for this skill/item.
</pre>

---

=== JavaScript Notetags: Critical-Related ===

The following are notetags made for users with JavaScript knowledge to
determine how critical hit-related aspects are calculated.

---

<pre>
<JS Critical Rate>
code
code
rate = code;
</JS Critical Rate>

- Used for: Skill, Item Notetags
- The 'rate' variable is the final returned amount to determine the
critical hit success rate.
- Replace 'code' with JavaScript code to determine the final 'rate' to be
returned as the critical hit success rate.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Critical Rate as User>
code
code
rate = code;
</JS Critical Rate as User>

<JS Critical Rate as Target>
code
code
rate = code;
</JS Critical Rate as Target>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Only applies during battle.
- The 'rate' variable is the final returned amount to determine the
critical hit success rate.
- Base value comes from Game_Action.itemCri
- Skill/Item <JS Critical Rate> runs
- Then <JS Critical Rate as User/Target> notetags run
- Replace 'code' with JavaScript code to determine the final 'rate' to be
returned as the critical hit success rate.
- If used on trait objects, this will apply to any skills/items used as long
as the unit affected by the trait object has access to the trait object.
- If the 'as User' notetag variant is used, this code will be run as a
response to the action from the action user end.
- If the 'as Target' notetag variant is used, this code will be run as a
response to the action from the action target end.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Critical Damage>
code
code
multiplier = code;
bonusDamage = code;
</JS Critical Damage>

- Used for: Skill, Item Notetags
- The 'multiplier' variable is returned later and used as the damage
multiplier used to amplify the critical damage amount.
- The 'bonusDamage' variable is returned later and used as extra added
damage for the critical damage amount.
- Replace 'code' with JavaScript code to determine how the 'multiplier' and
'bonusDamage' variables are calculated.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

=== Life Steal-Related Notetags ===

[[File:BattleCore_Update123_Preview1.png|600px]]

---

<pre>
<HP Life Steal: x%>
<MP Life Steal: x%>

- Used for: Skill, Item Notetags
- Causes this skill/item to have Life Steal properties, allowing the user to
take x% of the HP/MP Damage as recovered HP/MP.
- HP Life Steal can only take HP from dealt HP damage.
- MP Life Steal can only take MP from dealt MP damage.
- Replace 'x' with a number representing the percentage of the dealt damage
used as HP/MP recovery.
- This cannot be used with skills/items with HP Drain/MP Drain. Life Steal
is a different mechanic from HP Drain/MP Drain.
</pre>

---

<pre>
<HP Life Steal Certain Hit: +x%>
<HP Life Steal Physical Hit: +x%>
<HP Life Steal Magical Hit: +x%>

<HP Life Steal Certain Hit: -x%>
<HP Life Steal Physical Hit: -x%>
<HP Life Steal Magical Hit: -x%>

<MP Life Steal Certain Hit: +x%>
<MP Life Steal Physical Hit: +x%>
<MP Life Steal Magical Hit: +x%>

<MP Life Steal Certain Hit: -x%>
<MP Life Steal Physical Hit: -x%>
<MP Life Steal Magical Hit: -x%>

- Used for: Used for: Actor, Class, Armor, Enemy, State Notetags
- The related battler's various trait properties can have passive life steal
properties that will trigger upon using skills/items with matching hit
types regardless of whether or not the skill/item innately has Life Steal.
- Notetag variants with "Certain Hit" will only trigger from "Certain Hit"
skill and item types. Same with "Physical" and "Magical" variants.
- HP Life Steal can only take HP from dealt HP damage.
- MP Life Steal can only take HP from dealt MP damage.
- Replace 'x' with a number representing the additive stacking percentage
boost of the dealt damage used as HP/MP recovery. The effects will stack
additively with other trait objects.
- This cannot be used with skills/items with HP Drain/MP Drain. Life Steal
is a different mechanic from HP Drain/MP Drain.
</pre>

---

<pre>
<Cancel Life Steal>

<Cancel HP Life Steal>
<Cancel MP Life Steal>

- Used for: Skill, Item Notetags
- Prevents this skill from allowing Life Steal effects to occur including
the passive life steal calculators from the skill/item user.
- This does not affect HP Drain/MP Drain. Life Steal is a different mechanic
from HP Drain/MP Drain.
</pre>

---

<pre>
<Guard Life Steal>

<Guard HP Life Steal>
<Guard MP Life Steal>

- Used for: Used for: Actor, Class, Armor, Enemy, State Notetags
- If the related battler becomes the target of Life Steal, this will prevent
the Life Steal effects from taking effect.
- This does not affect HP Drain/MP Drain. Life Steal is a different mechanic
from HP Drain/MP Drain.
</pre>

---

<pre>
<Disarm Life Steal>

<Disarm HP Life Steal>
<Disarm MP Life Steal>

- Used for: Used for: Actor, Class, Armor, Enemy, State Notetags
- Makes the related battler unable to HP/MP Life Steal regardless of the
skill/item and its related properties like equipment.
- This does not prevent skills/items with innate Life Steal from being used.
Only the Life Steal part of the skill/item will have no effect.
- This does not affect HP Drain/MP Drain. Life Steal is a different mechanic
from HP Drain/MP Drain.
</pre>

---

<pre>
<Negative Life Steal>

<Negative HP Life Steal>
<Negative MP Life Steal>

- Used for: Used for: Actor, Class, Armor, Enemy, State Notetags
- If the related battler becomes the target of Life Steal, this will invert
the healing properties of Life Steal, causing the Life Steal user to
instead take HP/MP damage.
- This does NOT heal the target related battler.
- This does not prevent skills/items with innate Life Steal from being used.
Only the Life Steal part of the skill/item will have no effect.
- This does not affect HP Drain/MP Drain. Life Steal is a different mechanic
from HP Drain/MP Drain.
</pre>

---

=== Action Sequence-Related Notetags ===

[[File:BattleCoreActSeq.png|400px]]

Action Sequences allow you full control over how a skill and/or item plays
through its course. These notetags give you control over various aspects of
those Action Sequences. More information is found in the Action Sequences
help section.

---

[[File:BattleCorePentaSlash.gif]]

<pre>
<Custom Action Sequence>

- Used for: Skill, Item Notetags
- Removes all automated Action Sequence parts from the skill.
- Everything Action Sequence-related will be done by Common Events.
- Insert Common Event(s) into the skill/item's effects list to make use of
the Custom Action Sequences.
- This will prevent common events from loading in the Item Scene and Skill
Scene when used outside of battle.
</pre>

---

<pre>
<Auto Action Sequence>

- Used for: Skill, Item Notetags
- If the Action Sequence Plugin Parameter "Auto Notetag" is enabled, this
plugin will prevent custom action sequences from happening for the skill
or item, and instead, use an Automatic Action Sequence instead.
- Ignore this if you have "Auto Notetag" disabled or set to false. By
default, this setting is set to false. Please be aware of the changes
you've made to your game before using it.
</pre>

---

<pre>
<Bypass Auto Action Sequence>

- Used for: Skill, Item Notetags
- This notetag is used for the game devs that have the Action Sequence
Plugin Parameter "Auto Notetag" on for applying <Custom Action Sequence>
to everything.
- This will allow items and skills to be able to launch their common
events from the menu scene regardless of the inherent restriction to
prevent action sequence based skills/items with common events from
launching.
- Ignore this if you have "Auto Notetag" disabled or set to false. By
default, this setting is set to false. Please be aware of the changes
you've made to your game before using it.
</pre>

---

<pre>
<Common Event: name>

- Used for: Skill, Item Notetags
- Battle only: calls forth a Common Event of a matching name.
- Replace 'name' with the name of a Common Event to call from when this
skill/item is used in battle.
- Remove any \I[x] in the name.
- Insert multiple notetags to call multiple Common Events in succession.
- This will occur after any Common Event Trait Effects for the skill/item's
database entry.
- This is primarily used for users who are reorganizing around their Common
Events and would still like to have their skills/items perform the correct
Action Sequences in case the ID's are different.
</pre>

---

<pre>
<Display Icon: x>
<Display Text: string>

- Used for: Skill, Item Notetags
- When displaying the skill/item name in the Action Sequence, determine the
icon and/or text displayed.
- Replace 'x' with a number value representing the icon ID to be displayed.
- Replace 'string' with a text value representing the displayed name.
- If used with Skills & States Core's <Command Text: x>, the Command Text
notetag will take priority in the command window, but the List Name
notetag will appear in the skill list.
- This does not affect the display text atop the screen. To change that, use
the Battle Core's <Display Text: x> notetag to change how it's displayed.
</pre>

---

[[File:BattleCore_CommonEventKeys.png]]

<pre>
<Common Event Key: name>
<Common Event Keys: name, name, name>

<Common Event Keys>
key
key
key
</Common Event Keys>

- Used for: Skill, Item Notetags
- Will generate Common Events for the skill/item with a corresponding key.
- Replace 'name' with the name of the Common Event's key that you want to
reference. That key will be converted into a Common Event effect for the
skill/item and be treated as an action sequence.
- The notetag variants that use multiple keys will have the keys added in
the order they are listed.
- If keys do not reference any Common Events, no Common Events will be
added for that key.
- To mark a Common Event with a key, insert inside a Common Event's name the
[ and ] brackets around the text that will be used as the Common Event's
key text.
- For example, if Common Event's name is "Penta Slash [PENTA]", then the
key used is "PENTA" without the quotes.
- This key could then be referenced by <Common Event Key: PENTA> notetag.
- Do not use commas (,) inside the key text as it will be automatically
removed for the sake of consistency.
- This feature is made for make the process of sharing Action Sequences to
become easier without needing to line up Common Event ID's.
</pre>

---

=== Animated Sideview Battler-Related Notetags ===

[[File:BattleCoreSvEnemies.png|600px]]

Enemies can use Animated Sideview Actor graphics thanks to this plugin.
These notetags give you control over that aspect. Some of these also affect
actors in addition to enemies.

---

<pre>
<Sideview Battler: filename>

<Sideview Battlers>
filename: weight
filename: weight
filename: weight
</Sideview Battlers>

- Used for: Enemy Notetags
- Replaces the enemy's battler graphic with an animated Sideview Actor
graphic found in the img/sv_actors/ folder.
- Replace 'filename' with the filename of the graphic to use. Do not insert
any extensions. This means the file 'Actor1_1.png' will be only inserted
as 'Actor1_1' without the '.png' at the end.
- If the multiple notetag vaiant is used, then a random filename is selected
from the list upon the enemy's creation.
- Replace 'weight' with a number value representing how often the 'filename'
would come up. The higher the weight, the more often. You may omit this
and the colon(:) and just type in the 'filename' instead.
- Add/remove lines as you see fit.

Example:

<Sideview Battlers>
Actor1_1: 25
Actor1_3: 10
Actor1_5
Actor1_7
</Sideview Battlers>
</pre>

---

<pre>
<Sideview Anchor: x, y>

- Used for: Actor, Enemy Notetags
- Sets the sprite anchor positions for the sideview sprite.
- Replace 'x' and 'y' with numbers depicting where the anchors should be for
the sideview sprite.
- By default, the x and y anchors are 0.5 and 1.0.
</pre>

---

<pre>
<Sideview Home Offset: +x, +y>
<Sideview Home Offset: -x, -y>

- Used for: Actor, Class, Weapon, Armor, State Notetags
- Offsets the sideview actor sprite's home position by +/-x, +/-y.
- Replace 'x' and 'y' with numbers depicting how much to offset each of the
coordinates by. For '0' values, use +0 or -0.
- This notetag will not work if you remove it from the JavaScript code in
Plugin Parameters > Actor > JS: Home Position
</pre>

---

<pre>
<Sideview Weapon Offset: +x, +y>
<Sideview Weapon Offset: -x, -y>

- Used for: Actor, Class, Weapon, Armor, Enemy State Notetags
- Offsets the sideview weapon sprite's position by +/-x, +/-y.
- Replace 'x' and 'y' with numbers depicting how much to offset each of the
coordinates by. For '0' values, use +0 or -0.
</pre>

---

<pre>
<Sideview Show Shadow>
<Sideview Hide Shadow>

- Used for: Actor, Enemy Notetags
- Sets it so the sideview battler's shadow will be visible or hidden.
</pre>

---

<pre>
<Sideview Shadow Scale: x%>
<Sideview Shadow Scale: x.y>

- Used for: Actor, Enemy Notetags
- Adjusts the scaling size of the sideview battler's shadow.
- This affects both the X and Y scale.
</pre>

---

<pre>
<Sideview Shadow Scale X: x%>
<Sideview Shadow Scale X: x.y>

<Sideview Shadow Scale Y: x%>
<Sideview Shadow Scale Y: x.y>

- Used for: Actor, Enemy Notetags
- Adjusts the scaling size of the sideview battler's shadow.
- These affect their respective X and Y scales separately.
</pre>

---

<pre>
<Sideview Collapse>
<Sideview No Collapse>

- Used for: Enemy Notetags
- Either shows the collapse graphic or does not show the collapse graphic.
- Collapse graphic means the enemy will 'fade away' once it's defeated.
- No collapse graphic means the enemy's corpse will remain on the screen.
</pre>

---

<pre>
<Sideview Idle Motion: name>

<Sideview Idle Motions>
name: weight
name: weight
name: weight
</Sideview Idle Motions>

- Used for: Enemy Notetags
- Changes the default idle motion for the enemy.
- Replace 'name' with any of the following motion names:
- 'walk', 'wait', 'chant', 'guard', 'damage', 'evade', 'thrust', 'swing',
'missile', 'skill', 'spell', 'item', 'escape', 'victory', 'dying',
'abnormal', 'sleep', 'dead'
- If the multiple notetag vaiant is used, then a random motion name is
selected from the list upon the enemy's creation.
- Replace 'weight' with a number value representing how often the 'name'
would come up. The higher the weight, the more often. You may omit this
and the colon(:) and just type in the 'name' instead.
- Add/remove lines as you see fit.

Example:

<Sideview Idle Motions>
walk: 25
wait: 50
guard
victory
abnormal
</Sideview Idle Motions>
</pre>

---

<pre>
<Sideview Size: width, height>

- Used for: Enemy Notetags
- When using a sideview battler, its width and height will default to the
setting made in Plugin Parameters => Enemy Settings => Size: Width/Height.
- This notetag lets you change that value to something else.
- Replace 'width' and 'height' with numbers representing how many pixels
wide/tall the sprite will be treated as.
- This does NOT change the image size. This only changes the HITBOX size.
</pre>

---

<pre>
<Sideview Weapon: weapontype>

<Sideview Weapons>
weapontype: weight
weapontype: weight
weapontype: weight
</Sideview Weapons>

- Used for: Enemy Notetags
- Give your sideview enemies weapons to use.
- Replace 'weapontype' with the name of the weapon type found under the
Database => Types => Weapon Types list (without text codes).
- If the multiple notetag vaiant is used, then a random weapon type is
selected from the list upon the enemy's creation.
- Replace 'weight' with a number value representing how often the weapontype
would come up. The higher the weight, the more often. You may omit this
and the colon(:) and just type in the 'weapontype' instead.
- Add/remove lines as you see fit.

Example:

<Sideview Weapons>
Dagger: 25
Sword: 25
Axe
</Sideview Weapons>
</pre>

---

<pre>
<traitname Sideview Battler: filename>

<traitname Sideview Battlers>
filename: weight
filename: weight
filename: weight
</traitname Sideview Battlers>

- Used for: Enemy Notetags
- Requires VisuMZ_1_ElementStatusCore
- Allows certain Trait Sets to cause battlers to have a unique appearance.
- Replace 'filename' with the filename of the graphic to use. Do not insert
any extensions. This means the file 'Actor1_1.png' will be only inserted
as 'Actor1_1' without the '.png' at the end.
- If the multiple notetag vaiant is used, then a random filename is selected
from the list upon the enemy's creation.
- Replace 'weight' with a number value representing how often the 'filename'
would come up. The higher the weight, the more often. You may omit this
and the colon(:) and just type in the 'filename' instead.
- Add/remove lines as you see fit.

Examples:

<Male Sideview Battlers>
Actor1_1: 25
Actor1_3: 10
Actor1_5
Actor1_7
</Male Sideview Battlers>

<Female Sideview Battlers>
Actor1_2: 25
Actor1_4: 10
Actor1_6
Actor1_8
</Female Sideview Battlers>
</pre>

---

<pre>
<traitname Sideview Idle Motion: name>

<traitname Sideview Idle Motions>
name: weight
name: weight
name: weight
</traitname Sideview Idle Motions>

- Used for: Enemy Notetags
- Requires VisuMZ_1_ElementStatusCore
- Allows certain Trait Sets to cause battlers to have unique idle motions.
- Replace 'name' with any of the following motion names:
- 'walk', 'wait', 'chant', 'guard', 'damage', 'evade', 'thrust', 'swing',
'missile', 'skill', 'spell', 'item', 'escape', 'victory', 'dying',
'abnormal', 'sleep', 'dead'
- If the multiple notetag vaiant is used, then a random motion name is
selected from the list upon the enemy's creation.
- Replace 'weight' with a number value representing how often the 'name'
would come up. The higher the weight, the more often. You may omit this
and the colon(:) and just type in the 'name' instead.
- Add/remove lines as you see fit.

Examples:

<Jolly Sideview Idle Motions>
wait: 25
victory: 10
walk
</Jolly Sideview Idle Motions>

<Serious Sideview Idle Motions>
walk: 25
guard: 10
wait
</Jolly Sideview Idle Motions>
</pre>

---

<pre>
<traitname Sideview Weapon: weapontype>

<traitname Sideview Weapons>
weapontype: weight
weapontype: weight
weapontype: weight
</traitname Sideview Weapons>

- Used for: Enemy Notetags
- Requires VisuMZ_1_ElementStatusCore
- Allows certain Trait Sets to cause battlers to have unique weapons.
- Replace 'weapontype' with the name of the weapon type found under the
Database => Types => Weapon Types list (without text codes).
- If the multiple notetag vaiant is used, then a random weapon type is
selected from the list upon the enemy's creation.
- Replace 'weight' with a number value representing how often the weapontype
would come up. The higher the weight, the more often. You may omit this
and the colon(:) and just type in the 'weapontype' instead.
- Add/remove lines as you see fit.

Examples:

<Male Sideview Weapons>
Dagger: 25
Sword: 25
Axe
</Male Sideview Weapons>

<Female Sideview Weapons>
Dagger: 25
Spear: 25
Cane
</Female Sideview Weapons>
</pre>

---

=== Enemy-Related Notetags ===

---

<pre>
<Battler Sprite Cannot Move>

- Used for: Enemy Notetags
- Prevents the enemy from being able to move, jump, and/or float due to
Action Sequences. Useful for rooted enemies.
</pre>

---

[[File:BattleCoreSwap.png|600px]]

<pre>
<Swap Enemies>
name: weight
name: weight
name: weight
</Swap Enemies>

- Used for: Enemy Notetags
- Causes this enemy database object to function as a randomizer for any of
the listed enemies inside the notetag. When the enemy is loaded into the
battle scene, the enemy is immediately replaced with one of the enemies
listed. The randomization is based off the 'weight' given to each of the
enemy 'names'.
- Replace 'name' with the database enemy of the enemy you wish to replace
the enemy with.
- Replace 'weight' with a number value representing how often the 'name'
would come up. The higher the weight, the more often. You may omit this
and the colon(:) and just type in the 'name' instead.
- Add/remove lines as you see fit.

Example:

<Swap Enemies>
Bat: 50
Slime: 25
Orc
Minotaur
</Swap Enemies>
</pre>

---

<pre>
<Aspect Name: name>

- Used for: Enemy Notetags
- Changes enemy's aspect name shown in the In-Battle Status and other
supported plugin menus.
- Requires <Aspect Description> in order to show.
- Replace 'name' with text for how enemy aspect should be renamed.
</pre>

---

<pre>
<Aspect Color: color>

- Used for: Enemy Notetags
- Changes enemy's aspect name color shown in the In-Battle Status and other
supported plugin menus.
- Requires <Aspect Description> in order to show.
- Replace 'color' with either a number from 0 to 31 representing the text
color or in the format of '#rrggbb' to custom pick a hex color.
</pre>

---

<pre>
<Aspect Icon: x>

- Used for: Enemy Notetags
- Changes enemy's aspect icon shown in the In-Battle Status and other
supported plugin menus.
- Requires <Aspect Description> in order to show.
- Replace 'x' with a number representing the icon index used to represent
the enemy aspect.
</pre>

---

<pre>
<Aspect Description>
text
text
</Aspect Description>

- Used for: Enemy Notetags
- Changes enemy's aspect description shown in the In-Battle Status and other
supported plugin menus.
- Replace 'text' with the text you would like to appear as a description for
the enemy's aspect.
</pre>

---

=== JavaScript Notetags: Mechanics-Related ===

These JavaScript notetags allow you to run code at specific instances during
battle provided that the unit has that code associated with them in a trait
object (actor, class, weapon, armor, enemy, or state). How you use these is
entirely up to you and will depend on your ability to understand the code
used and driven for each case.

---

<pre>
<JS Pre-Start Battle>
code
code
code
</JS Pre-Start Battle>

<JS Post-Start Battle>
code
code
code
</JS Post-Start Battle>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code at the start of battle aimed at the function:
BattleManager.startBattle()
- 'Pre' runs before the function runs.
- 'Post' runs after the function runs.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Pre-Start Turn>
code
code
code
</JS Pre-Start Turn>

<JS Post-Start Turn>
code
code
code
</JS Post-Start Turn>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code at the start of a turn aimed at the function:
BattleManager.startTurn()
- 'Pre' runs before the function runs.
- 'Post' runs after the function runs.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Pre-Start Action>
code
code
code
</JS Pre-Start Action>

<JS Post-Start Action>
code
code
code
</JS Post-Start Action>

- Used for: Actor, Class, Skill, Item, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code at the start of an action aimed at the function:
BattleManager.startAction()
- 'Pre' runs before the function runs.
- 'Post' runs after the function runs.
- If used on skills and/or items, this will only apply to the skill/item
being used and does not affect other skills and items.
- If used on trait objects, this will apply to any skills/items used as long
as the unit affected by the trait object has access to the trait object.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Pre-Apply>
code
code
code
</JS Pre-Apply>

- Used for: Skill, Item Notetags
- Runs JavaScript code at the start of an action hit aimed at the function:
Game_Action.prototype.apply()
- 'Pre' runs before the function runs.
- If used on skills and/or items, this will only apply to the skill/item
being used and does not affect other skills and items.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Pre-Apply as User>
code
code
code
</JS Pre-Apply as User>

<JS Pre-Apply as Target>
code
code
code
</JS Pre-Apply as Target>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code at the start of an action hit aimed at the function:
Game_Action.prototype.apply()
- 'Pre' runs before the function runs.
- If used on trait objects, this will apply to any skills/items used as long
as the unit affected by the trait object has access to the trait object.
- If the 'as User' notetag variant is used, this code will be run as a
response to the action from the action user end.
- If the 'as Target' notetag variant is used, this code will be run as a
response to the action from the action target end.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Pre-Damage>
code
code
code
</JS Pre-Damage>

- Used for: Skill, Item Notetags
- Runs JavaScript code before damage is dealt aimed at the function:
Game_Action.prototype.executeDamage()
- 'Pre' runs before the function runs.
- If used on skills and/or items, this will only apply to the skill/item
being used and does not affect other skills and items.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Pre-Damage as User>
code
code
code
</JS Pre-Damage as User>

<JS Pre-Damage as Target>
code
code
code
</JS Pre-Damage as Target>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code before damage is dealt aimed at the function:
Game_Action.prototype.executeDamage()
- 'Pre' runs before the function runs.
- If used on trait objects, this will apply to any skills/items used as long
as the unit affected by the trait object has access to the trait object.
- If the 'as User' notetag variant is used, this code will be run as a
response to the action from the action user end.
- If the 'as Target' notetag variant is used, this code will be run as a
response to the action from the action target end.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Post-Damage>
code
code
code
</JS Post-Damage>

- Used for: Skill, Item Notetags
- Runs JavaScript code after damage is dealt aimed at the function:
Game_Action.prototype.executeDamage()
- 'Post' runs after the function runs.
- If used on skills and/or items, this will only apply to the skill/item
being used and does not affect other skills and items.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Post-Damage as User>
code
code
code
</JS Post-Damage as User>

<JS Post-Damage as Target>
code
code
code
</JS Post-Damage as Target>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code after damage is dealt aimed at the function:
Game_Action.prototype.executeDamage()
- 'Post' runs after the function runs.
- If used on trait objects, this will apply to any skills/items used as long
as the unit affected by the trait object has access to the trait object.
- If the 'as User' notetag variant is used, this code will be run as a
response to the action from the action user end.
- If the 'as Target' notetag variant is used, this code will be run as a
response to the action from the action target end.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Post-Apply>
code
code
code
</JS Post-Apply>

- Used for: Skill, Item Notetags
- Runs JavaScript code at the end of an action hit aimed at the function:
Game_Action.prototype.apply()
- 'Post' runs after the function runs.
- If used on skills and/or items, this will only apply to the skill/item
being used and does not affect other skills and items.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one using the skill/item.
- The 'target' variable represents the one receiving the skill/item hit.
</pre>

---

<pre>
<JS Post-Apply as User>
code
code
code
</JS Post-Apply as User>

<JS Post-Apply as Target>
code
code
code
</JS Post-Apply as Target>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code at the end of an action hit aimed at the function:
Game_Action.prototype.apply()
- 'Post' runs after the function runs.
- If used on trait objects, this will apply to any skills/items used as long
as the unit affected by the trait object has access to the trait object.
- If the 'as User' notetag variant is used, this code will be run as a
response to the action from the action user end.
- If the 'as Target' notetag variant is used, this code will be run as a
response to the action from the action target end.
- Replace 'code' with JavaScript code to run desired effects.
</pre>

---

<pre>
<JS Pre-End Action>
code
code
code
</JS Pre-End Action>

<JS Post-End Action>
code
code
code
</JS Post-End Action>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code at the end of an action aimed at the function:
BattleManager.endAction()
- 'Pre' runs before the function runs.
- 'Post' runs after the function runs.
- If used on trait objects, this will apply to any skills/items used as long
as the unit affected by the trait object has access to the trait object.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Pre-End Turn>
code
code
code
</JS Pre-End Turn>

<JS Post-End Turn>
code
code
code
</JS Post-End Turn>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code at the end of a turn aimed at the function:
Game_Battler.prototype.onTurnEnd()
- 'Pre' runs before the function runs.
- 'Post' runs after the function runs.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Pre-Regenerate>
code
code
code
</JS Pre-Regenerate>

<JS Post-Regenerate>
code
code
code
</JS Post-Regenerate>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code when a unit regenerates HP/MP aimed at the function:
Game_Battler.prototype.regenerateAll()
- 'Pre' runs before the function runs.
- 'Post' runs after the function runs.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Battle Victory>
code
code
code
</JS Battle Victory>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code when a battle is won aimed at the function:
BattleManager.processVictory()
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Escape Success>
code
code
code
</JS Escape Success>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code when escaping succeeds aimed at the function:
BattleManager.onEscapeSuccess()
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Escape Failure>
code
code
code
</JS Escape Failure>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code when escaping fails aimed at the function:
BattleManager.onEscapeFailure()
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Battle Defeat>
code
code
code
</JS Battle Defeat>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code when a battle is lost aimed at the function:
BattleManager.processDefeat()
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

<pre>
<JS Pre-End Battle>
code
code
code
</JS Pre-End Battle>

<JS Post-End Battle>
code
code
code
</JS Post-End Battle>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs JavaScript code when the battle is over aimed at the function:
BattleManager.endBattle()
- 'Pre' runs before the function runs.
- 'Post' runs after the function runs.
- Replace 'code' with JavaScript code to run desired effects.
- The 'user' variable represents the one affected by the trait object.
</pre>

---

=== Battle Layout-Related Notetags ===

[[File:BattleCoreBattleStyleBorder.png|600px]]

These tags will change the battle layout for a troop regardless of how the
plugin parameters are set up normally. Insert these tags in either the
noteboxes of maps or the names of troops for them to take effect. If both
are present for a specific battle, then priority goes to the setting found
in the troop name.

---

<pre>
<Layout: type>
<Battle Layout: type>

- Used for: Map Notetags, Troop Name Tags, and Troop Comment Tags
- Changes the battle layout style used for this specific map or battle.
- Replace 'type' with 'default', 'list', 'xp', 'portrait', or 'border'.
- Those with VisuMZ_3_FrontviewBattleUI can use 'frontview'.
- Those with VisuMZ_3_SideviewBattleUI can use 'sideview'.
- If using Troop Comment Tags, then as long as the tag appears in a comment
found on any of the Troop's pages (even if they don't run), the tag will
be considered in effect.
</pre>

---

=== Troop Size Tags ===

[[File:BattleCore_ExtTroop.png|600px]]

---

<pre>
<Extend: x>
<Extend: x, x, x>

- Used for: Troop Name Tags and Troop Comment Tags
- Adds enemies from another troop to the current troop.
- Enemies from another troop will retain their database positions.
- Replace 'x' with the ID of the database troop entry you wish to add enemy
members from.
- Insert multiple x's to add from more troops.
- Extended troop members will be added in the order they're listed.
- Be cautious of how many enemies you add as too many will lag the battle
system. We are not responsible for frame drops due to this.
</pre>

---

=== Troop Comment Tags ===

Place these tags inside of a comment found in a troop page's event list.

---

[[File:BattleCore_OnceParallelWhenStartBattle.png|600px]]

<pre>
<Once Parallel When Start Battle>

- Used for: Troop Page Comment Tags
- Causes the troop page to immediately load the moment the battle scene
begins to fade in (not after it fades in). This is faster than a turn 0
condition troop page. Troop page conditions are ignored.
- This can be used for things like the Action Sequence Camera plugin, the
Visual Battle Environment plugin, and/or initial battle poses and such in
order to provide a near seamless battle transition experience.
- This does NOT trigger when coming out of the options menu or party menu.
- This WILL trigger when going from battle to battle nonstop via plugins
like VisuStella MZ's Chain Battles.
- When actors are moving towards their home positions, it will take around
30 frames by default. Use this information however you like.
</pre>

---

Template:MainPageLatestPlugins

2026-05-17T10:42:05Z

Irina:

<noinclude>__NOTOC__ 
{| style="width: 800px;" cellspacing="0" cellpadding="0"
|
</noinclude>
{| style="width: 100%;" cellspacing="5" cellpadding="0"

{{NewsEntry
|date = 2026 May 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #161]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 9 Plugins
: ‎
: Mostly compatibility updates and clarity updates!
: Two new JS functions added to Events & Movement Core!
}}

{{NewsEntry
|date = 2026 April 20
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #160]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 11 Plugins
}}

{{NewsEntry
|date = 2026 March 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #159]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 6 Plugins
: ‎
: Mostly bug fixes and compatibility updates!
}}

{{NewsEntry
|date = 2026 February 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #158]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 5 Plugins
: ‎
: Mostly bug fixes!
: Happy Lunar New Year!❤️
}}

{{NewsEntry
|date = 2026 January 19
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #157]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 9 Plugins
: ‎
: [[Events and Movement Core VisuStella MZ]]
; New Features: Reference Switches and Reference Variables
:
: [[Battle System - OTB VisuStella MZ]]
; New Features: Auto-Conversion for States
}}

{{NewsEntry
|date = 2025 December 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #156]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 12 Plugins
: ‎
: [[Events and Movement Core VisuStella MZ]]
; New Plugin Parameter
:
: [[Extended Message Functionality VisuStella MZ]]
; New Features/Plugin Parameters
:
: [[Map Camera Zoom VisuStella MZ]]
; New Plugin Parameter
}}

{{NewsEntry
|date = 2025 November 13
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #155]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 4 Plugins
: ‎
: [[Elements and Status Menu Core VisuStella MZ]]
; New notetag
:
: [[Battle System - OTB VisuStella MZ]]
; New script calls
:
: [[Extended Message Functionality VisuStella MZ]]
; New Voice Acting Plugin Parameters
}}







|}
<noinclude>== Archived ==
{| style="width: 800px;" cellspacing="0" cellpadding="0"
|







{{NewsEntry
|date = 2025 October 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #154]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 5 Plugins
: ‎
: This month's changes are bug fixes and compatibility patches!
}}

{{NewsEntry
|date = 2025 September 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #153]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 11 Plugins
: ‎
: Mostly bug fixes and compatibility patches this month!
}}

{{NewsEntry
|date = 2025 August 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #152]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 6 Plugins
: ‎
: All bug fixes and compatibility patches this month
}}

{{NewsEntry
|date = 2025 July 17
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #151]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 7 Plugins
: ‎
: All bug fixes and compatibility patches this month
}}

{{NewsEntry
|date = 2025 June 12
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #150]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 9 Plugins
: ‎
: AP, SP, CP, and JP got new notetags to give more options to gain bonuses.
}}

{{NewsEntry
|date = 2025 May 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #149]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 16 Plugins
: ‎
: Mostly bug fixes and compatibility patches
}}

{{NewsEntry
|date = 2025 May 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #149]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 16 Plugins
: ‎
: Mostly bug fixes and compatibility patches
}}

{{NewsEntry
|date = 2025 April 17
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #148]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 9 Plugins
: ‎
: Skill Toggles have been added
: [[File:SkillToggle.gif|228px|center|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2025 March 20
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #147]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 11 Plugins
: Many bug fixes and new features!
: [[File:WeaknessUpdate.png|228px|center|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2025 February 20
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #146]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 33 Plugins
: Mostly compatibility updates for RMMZ 1.9.0!
: ‎
: Read more about the RMMZ 1.9.0 changes here:
: [[File:RMMZ_190.png|228px|center|link=RMMZ Changelog]]
}}

{{NewsEntry
|date = 2025 January 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #145]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 21 Plugins
: Bug fixes and new features!
: ‎
: We wish you all a very Happy New Year!
: [[File:HappyNewYear2025.jpg|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 December 19
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #144]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 13 Plugins
: Bug fixes and new features!
: ‎
: Skills & States Core
: Aura and Miasma Passives
: [[File:SkillsStatesCore_Aura.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 November 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #143]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 13 Plugins
: Bug fixes and new features!
: ‎
: Items & Equips Core
: Shop Status Window Styles
: [[File:ItemEquipCore_StatusWindowStyles.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 October 17
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #142]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 18 Plugins
: Bug fixes and new features!
: ‎-
: Equipment Set Bonuses
: Set Wildcards
: [[File:EquipSetBonus_Wildcards.png|300px|link=VisuStella MZ Changelog]]

}}

{{NewsEntry
|date = 2024 September 20
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustella.itch.io/visumz-sample Battle Core]:''' Fixed an error with in-battle status where buffed parameter value were visibly hidden.
:: '''[https://visustellamz.itch.io/multi-layer-hp-gauge Multi-Layer HP Gauge]:''' Fixed an error where multi-layer HP gauges would cover the in-battle status window.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 September 19
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #141]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 9 Plugins
: Bug fixes and new features!
: ‎-
: Battle Core
: In-Battle Status
: [[File:BattleCore_InBattleStatus1.png|300px|link=VisuStella MZ Changelog]]
: -
: Main Menu Core
: Custom Mouse Cursor
: [[File:MainMenuCore_CustomCursor.gif|300px|link=VisuStella MZ Changelog]]
: -
: Encounter Effects
: Battle Transition Effects
: [[File:EncEffect_Glitch.gif|300px|link=VisuStella MZ Changelog]]
: [[File:EncEffect_Twirl.gif|300px|link=VisuStella MZ Changelog]]
: [[File:EncEffect_Warp.gif|300px|link=VisuStella MZ Changelog]]

}}

{{NewsEntry
|date = 2024 August 29
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #140]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 16 Plugins
: Bug fixes and new features!
: ‎
: Core Engine
: Taller Tiles
: [[File:CoreEngine-TallerTiles.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 July 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #139]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 22 Plugins
: Lots of bug fixes and new features!
: ‎
: Options Core
: Rebind Keyboard/Controller
: [[File:OptionsCoreRebind1.png|300px|link=VisuStella MZ Changelog]]
: [[File:OptionsCoreRebind2.png|300px|link=VisuStella MZ Changelog]]
: [[File:OptionsCoreRebind3.png|300px|link=VisuStella MZ Changelog]]
: ‎
: Message Core
: Auto-Casing
: [[File:MessageCore-AutoCasing.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 June 13
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #138]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 18 Plugins
: Lots of bug fixes and new features!
: ‎
: Extended Tactics Menu
: [[File:BattleGridSystem_ExtendedTactics.png|300px|link=VisuStella MZ Changelog]]
: ‎
: Tile expansion!
: [[File:EventsMoveCore_TileExpand.png|300px|link=VisuStella MZ Changelog]]
: ‎
: Extinction Effect
: [[File:LifeStateEffects_Extinct.gif|300px|link=VisuStella MZ Changelog]]
: ‎
: Cascading Message Tooltips
: [[File:MessageKeywords_Cascades.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 May 18
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustella.itch.io/visumz-sample Battle Core]:''' Fixed an error that would cause a crash with Show Animation on the map scene.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 May 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #137]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 28 Plugins
: Lots of bug fixes and new features!
: [[File:DmgComboWindow.png]]
: A damage combo window added to Battle Core!
}}

{{NewsEntry
|date = 2024 May 8
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustella.itch.io/visumz-sample Skills & States Core]:''' Fixed an error with conditional switches not working for passive states.
:: '''[https://visustellamz.itch.io/character-creation-system Character Creation System]:''' Fixed an error with BGM fading out after scene.
:: '''[https://visustellamz.itch.io/skill-learn-system Skill Learn System]:''' Fixed incompatibility problem with Equip Passive System and ID clashing.
:: '''[https://visustellamz.itch.io/item-amplify-skills Item Amplify Skills]:''' Fixed incompatibility problem with Sideview Battle UI.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 April 22
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustellamz.itch.io/battle-grid-system Battle Grid System]:''' Fixed ''Area of Effect'' notetags should now work with regular targeting again.
:: '''[https://visustellamz.itch.io/equip-medal-system Equip Medal System]:''' Fixed odd error when medals have MaxHP/MaxMP traits.
:: '''[https://visustellamz.itch.io/unique-tile-effects Unique Tile Effects]:''' ''Can Swim'' notetag can now work from inventory.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 April 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #136]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 30 Plugins
: Lots of bug fixes and new features!
}}

{{NewsEntry
|date = 2024 March 31
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustella.itch.io/visumz-sample Skills & States Core]:''' Non-show passive state fixes.
:: '''[https://visustellamz.itch.io/battle-grid-system Battle Grid System]:''' Lots of fixes.
:: '''[https://visustellamz.itch.io/date-time-system Date & Time System]:''' Fix HUD display plugin parameters.
:: '''[https://visustellamz.itch.io/equip-battle-skills Equip Battle Skills]:''' Better Command Remember support.
:: '''[https://visustellamz.itch.io/equip-passive-system Equip Passive States]:''' Fixed non-description crash.
:: '''[https://visustellamz.itch.io/event-chain-reactions Event Chain Reactions]:''' Non-heavy player fix.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 March 29
|align = center
|content =
; [[Battle Grid System VisuStella MZ]]

: [[File:VisuMZ.150.jpg|300px|link=Battle Grid System VisuStella MZ]]
: VisuStella MZ's '''Battle Grid System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/swoS2bwVj0k here]!
: This is VisuStella MZ's #150th plugin!
}}

{{NewsEntry
|date = 2024 March 27
|align = center
|content =
; [[Equip Medal System VisuStella MZ]]

: [[File:VisuMZ.149.jpg|300px|link=Equip Medal System VisuStella MZ]]
: VisuStella MZ's '''Equip Medal System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/guIvEDn_X3o here]!
: This is VisuStella MZ's #149th plugin!
}}

{{NewsEntry
|date = 2024 March 25
|align = center
|content =
; [[Equip Passive System VisuStella MZ]]

: [[File:VisuMZ.148.jpg|300px|link=Equip Passive System VisuStella MZ]]
: VisuStella MZ's '''Equip Passive System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/n_X2J2Q9FHQ here]!
: This is VisuStella MZ's #148th plugin!
}}

{{NewsEntry
|date = 2024 March 18 + 24
|align = left
|content =
<center>Hot Fix made for 1 plugin!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustellamz.itch.io/battle-grid-system Battle Grid System]:'''
::: Fixed a game freeze that would occur from displaying certain skill types within non-battle scenes.
::: Fixed a bug with weapon ranges used by enemies not registering correctly
::: Fixed a bug where crash targets did not register properly
::: Fixed a bug where starting ranks/flanks did not register properly
::: Fixed a notetag example that was just incorrect and wouldn't do anything

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 March 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #135]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 28 Plugins
: Lots of bug fixes!
}}

{{NewsEntry
|date = 2024 March 6
|align = left
|content =
<center>Hot Fix made for 5 plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustellamz.itch.io/equip-passive-system Equip Passive System]:''' Fixed some notetags that did not allow for numeric ID's.
:: '''[https://visustellamz.itch.io/equip-medal-system Equip Medal System]:''' Fixed some notetags that did not allow for numeric ID's. Also fixed the evolve into next notetag.
:: '''[https://visustellamz.itch.io/item-concoct-skills Item Concoction Skills]:''' Fixed masking not updating.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 February 24
|align = left
|content =
<center>Hot Fix made for 5 plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustellamz.itch.io/aggro-control-system Aggro Control System]:''' Updated to better fit Battle Grid System
:: '''[https://visustellamz.itch.io/battle-grid-system Battle Grid System]:''' Fixed a bug where it required State Tooltips; Fixed a bug where the action sequence to add triggers to nodes did not work
:: '''[https://visustellamz.itch.io/item-crafting-system Item Crafting System]:''' Fixed a crash that would otherwise require the batch shop plugin.
:: '''[https://visustellamz.itch.io/equip-passive-system Equip Passive System]:''' Fixed a crash that required passives to have help descriptions
:: '''[https://visustellamz.itch.io/equip-medal-system Equip Medal System]:''' Fixed the inability to access the medal menu if "Optimize" and "Clear" were removed.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 February 24
|align = center
|content =
; [https://visustellamz.itch.io/grande Early Access for the Grande Series has begun!]

: [[File:Grande.jpg|300px|link=https://visustellamz.itch.io/grande]]

: Includes the following Plugins:

; [[Equip Passive System VisuStella MZ]]
; [[Equip Medal System VisuStella MZ]]
; [[Battle Grid System VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2024 February 23
|align = center
|content =
; [[Tile Grafter System VisuStella MZ]]

: [[File:VisuMZ.147.jpg|300px|link=Tile Grafter System VisuStella MZ]]
: VisuStella MZ's '''Tile Grafter System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/3bbNd1Z_pX8 here]!
: This is VisuStella MZ's #147th plugin!
}}

{{NewsEntry
|date = 2024 February 21
|align = center
|content =
; [[Picture Effects VisuStella MZ]]

: [[File:VisuMZ.146.jpg|300px|link=Picture Effects VisuStella MZ]]
: VisuStella MZ's '''Picture Effects VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/e_p8YAnEjbM here]!
: This is VisuStella MZ's #146th plugin!
}}

{{NewsEntry
|date = 2024 February 19
|align = center
|content =
; [[Date and Time System VisuStella MZ]]

: [[File:VisuMZ.145.jpg|300px|link=Date and Time System VisuStella MZ]]
: VisuStella MZ's '''Date and Time System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/qOF1qCMqqyU here]!
: This is VisuStella MZ's #145th plugin!
}}

{{NewsEntry
|date = 2024 February 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #134]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 21 Plugins
: Lots of new features added including Custom Font Manager!
}}

{{NewsEntry
|date = 2024 January 29
|align = center
|content =
; [https://visustellamz.itch.io/wanderlust-vol-2 Early Access for the Wanderlust Series Volume 2 has begun!]

: [[File:WanderlustVol2.jpg|300px|link=https://visustellamz.itch.io/wanderlust-vol-2]]

: Includes the following Plugins:

; [[Date and Time System VisuStella MZ]]
; [[Picture Effects VisuStella MZ]]
; [[Tile Grafter System VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2024 January 26
|align = center
|content =
; [[Dice Rolls and RNG Seeds VisuStella MZ]]

: [[File:VisuMZ.144.jpg|300px|link=Dice Rolls and RNG Seeds VisuStella MZ]]
: VisuStella MZ's '''Dice Rolls and RNG Seeds VisuStella MZ''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=EwwPnRvCrS4 here]!
: This is VisuStella MZ's #144th plugin!
}}

{{NewsEntry
|date = 2024 January 24
|align = center
|content =
; [[Event Signals VisuStella MZ]]

: [[File:VisuMZ.143.jpg|300px|link=Event Signals VisuStella MZ]]
: VisuStella MZ's '''Event Signals VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/lLCr7T93Ndw here]!
: This is VisuStella MZ's #143rd plugin!
}}

{{NewsEntry
|date = 2024 January 22
|align = center
|content =
; [[QTE and Trigger System VisuStella MZ]]

: [[File:VisuMZ.142.jpg|300px|link=QTE and Trigger System VisuStella MZ]]
: VisuStella MZ's '''QTE and Trigger System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/UTak0ezYszI here]!
: This is VisuStella MZ's #142nd plugin!
}}

{{NewsEntry
|date = 2024 January 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #133]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 16 Plugins
: Lots of new features added including Text & Audio Language Switching!
}}

{{NewsEntry
|date = 2024 January 2
|align = center
|content =
; [https://visustellamz.itch.io/custom-construct-vol-4 Early Access for the Custom Construct Series Volume 4 has begun!]

: [[File:CustomConstructVol4.jpg|300px|link=https://visustellamz.itch.io/custom-construct-vol-4]]

: Includes the following Plugins:

; [[QTE and Trigger System VisuStella MZ]]
; [[Event Signals VisuStella MZ]]
; [[Dice Rolls and RNG Seeds VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 December 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #132]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 24 Plugins
}}

{{NewsEntry
|date = 2023 December 1
|align = center
|content =
; [[Shop Bust Style UI VisuStella MZ]]

: [[File:VisuMZ.141.jpg|300px|link=Shop Bust Style UI VisuStella MZ]]
: VisuStella MZ's '''Shop Bust Style UI''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=MDgeccpI3-0 here]!
: This is VisuStella MZ's #141st plugin!
}}

{{NewsEntry
|date = 2023 November 30
|align = center
|content =
; Hot Fix made for 3 plugins!
: [[File:HotFix.jpg|300px|link=]]
: A hot fix has been made for the following plugins:
: [https://visustella.itch.io/visumz-sample Message Core] (better Wordwrap Support for CN/JP)
: [https://visustella.itch.io/visumz-sample Items & Equips Core] (fixed Cursed Item message)
: [https://visustellamz.itch.io/skill-shop Skill Shop] (fixed crash at startup)
: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2023 November 29
|align = center
|content =
; [[Shop Batches VisuStella MZ]]

: [[File:VisuMZ.140.jpg|300px|link=Shop Batches VisuStella MZ]]
: VisuStella MZ's '''Shop Batches''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=fYBUbaifslU here]!
: This is VisuStella MZ's #140th plugin!
}}

{{NewsEntry
|date = 2023 November 27
|align = center
|content =
; [[Shop Listing Unlock VisuStella MZ]]

: [[File:VisuMZ.139.jpg|300px|link=Shop Listing Unlock VisuStella MZ]]
: VisuStella MZ's '''Shop Listing Unlock''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=D2PGsbSZUUY here]!
: This is VisuStella MZ's #139th plugin!
}}

{{NewsEntry
|date = 2023 November 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #131]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 17 Plugins
}}

{{NewsEntry
|date = 2023 October 30
|align = center
|content =
; [https://visustellamz.itch.io/merchant-manager-series-vol-4 Early Access for the Merchant Manager Series Volume 4 has begun!]

: [[File:MerchantManagerVol4.jpg|300px|link=https://visustellamz.itch.io/merchant-manager-series-vol-4]]

: Includes the following Plugins:

; [[Shop Listing Unlock VisuStella MZ]]
; [[Shop Batches VisuStella MZ]]
; [[Shop Bust Style UI VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 October 27
|align = center
|content =
; [[Item Amplify Skills VisuStella MZ]]

: [[File:VisuMZ.138.jpg|300px|link=Item Amplify Skills VisuStella MZ]]
: VisuStella MZ's '''Item Amplify Skills''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=o2uU2f08-oU here]!
: This is VisuStella MZ's #138th plugin!
}}

{{NewsEntry
|date = 2023 October 25
|align = center
|content =
; [[Item Concoction Skills VisuStella MZ]]

: [[File:VisuMZ.137.jpg|300px|link=Item Concoction Skills VisuStella MZ]]
: VisuStella MZ's '''Item Concoction Skills''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=BZ0AAnKa-cA here]!
: This is VisuStella MZ's #137th plugin!
}}

{{NewsEntry
|date = 2023 October 23
|align = center
|content =
; [[Item Throw Skills VisuStella MZ]]

: [[File:VisuMZ.136.jpg|300px|link=Item Throw Skills VisuStella MZ]]
: VisuStella MZ's '''Item Throw Skills''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=16yks-S7o_s here]!
: This is VisuStella MZ's #136th plugin!
}}

{{NewsEntry
|date = 2023 October 12
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #130]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 13 Plugins
}}

{{NewsEntry
|date = 2023 October 4
|align = center
|content =
; [https://visustellamz.itch.io/combat-crusaders-vol-2 Early Access for the Combat Crusaders Series Volume 2 has begun!]

: [[File:CombatCrusadersVol2.jpg|300px|link=https://visustellamz.itch.io/combat-crusaders-vol-2]]

: Includes the following Plugins:

: [[Item Throw Skills VisuStella MZ]]
: [[Item Concoction Skills VisuStella MZ]]
: [[Item Amplify Skills VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 September 29
|align = center
|content =
; [[Character Creation System VisuStella MZ]]

: [[File:VisuMZ.135.jpg|300px|link=Character Creation System VisuStella MZ]]
: VisuStella MZ's '''Character Creation System''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=BHMzb6UUgQM here]!
: This is VisuStella MZ's #135th plugin!
}}

{{NewsEntry
|date = 2023 September 27
|align = center
|content =
; [[Challenge System VisuStella MZ]]

: [[File:VisuMZ.134.jpg|300px|link=Challenge System VisuStella MZ]]
: VisuStella MZ's '''Challenge System''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=Iz1YjaMpeuc here]!
: This is VisuStella MZ's #134th plugin!
}}

{{NewsEntry
|date = 2023 September 25
|align = center
|content =
; [[Random Dungeon Maps VisuStella MZ]]

: [[File:VisuMZ.133.jpg|300px|link=Random Dungeon Maps VisuStella MZ]]
: VisuStella MZ's '''Random Dungeon Maps''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=ZEF2WyxDDSU here]!
: This is VisuStella MZ's #133nd plugin!
}}

{{NewsEntry
|date = 2023 September 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #129]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 19 Plugins
}}

{{NewsEntry
|date = 2023 September 2
|align = center
|content =
; [https://visustellamz.itch.io/dungeon-divers-vol-2 Early Access for the Dungeon Divers Series Volume 2 has begun!]

: [[File:DungeonDiversVol2.jpg|300px|link=https://visustellamz.itch.io/dungeon-divers-vol-2]]


: Includes the following Plugins:

: [[Random Dungeon Maps VisuStella MZ]]
: [[Challenge System VisuStella MZ]]
: [[Character Creation System VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 September 1
|align = center
|content =
; [[Side Chatter VisuStella MZ]]

: [[File:VisuMZ.132.jpg|300px|link=Side Chatter VisuStella MZ]]
: VisuStella MZ's '''Side Chatter''' plugin for official release!
: Watch the preview video [https://youtu.be/-BfMuGK4HAU here]!
: This is VisuStella MZ's #132nd plugin!
}}

{{NewsEntry
|date = 2023 August 30
|align = center
|content =
; [[Battle Voices VisuStella MZ]]

: [[File:VisuMZ.131.jpg|300px|link=Battle Voices VisuStella MZ]]
: VisuStella MZ's '''Battle Voices''' plugin for official release!
: Watch the preview video [https://youtu.be/3mBMJL4rbFc here]!
: This is VisuStella MZ's #131st plugin!
}}

{{NewsEntry
|date = 2023 August 28
|align = center
|content =
; [[Voice Acting Control VisuStella MZ]]

: [[File:VisuMZ.130.jpg|300px|link=Voice Acting Control VisuStella MZ]]
: VisuStella MZ's '''Voice Acting Control''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=cHlAP5bBJEY here]!
: This is VisuStella MZ's #130th plugin!
}}

{{NewsEntry
|date = 2023 August 17
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #128]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 26 Plugins
}}

{{NewsEntry
|date = 2023 July 29
|align = center
|content =
; [https://visustellamz.itch.io/visual-novel-vol-4 Early Access for the Visual Novel Series Volume 4 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/2193581" width="208" height="167"><a href="https://visustellamz.itch.io/visual-novel-vol-4">[Access Key] Visual Novel Series Vol. 4 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Voice Acting Control VisuStella MZ]]
: [[Battle Voices VisuStella MZ]]
: [[Side Chatter VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 July 28
|align = center
|content =
; [[Icon Balloons VisuStella MZ]]

: [[File:VisuMZ.129.jpg|300px|link=Icon Balloons VisuStella MZ]]
: VisuStella MZ's '''Icon Balloons''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=seSLVWpaaVc here]!
: This is VisuStella MZ's #129th plugin!
}}

{{NewsEntry
|date = 2023 July 26
|align = center
|content =
; [[Proximity Messages VisuStella MZ]]

: [[File:VisuMZ.128.jpg|300px|link=Proximity Messages VisuStella MZ]]
: VisuStella MZ's '''Proximity Messages''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=oLHPOoqg6kc here]!
: This is VisuStella MZ's #128th plugin!
}}

{{NewsEntry
|date = 2023 July 24
|align = center
|content =
; [[Map Event Effects VisuStella MZ]]

: [[File:VisuMZ.127.jpg|300px|link=Map Event Effects VisuStella MZ]]
: VisuStella MZ's '''Map Event Effects''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=Kk11pfa3v6w here]!
: This is VisuStella MZ's #127th plugin!
}}

{{NewsEntry
|date = 2023 July 13
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #127]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 23 Plugins
}}

{{NewsEntry
|date = 2023 July 1
|align = center
|content =
; [https://visustellamz.itch.io/enchanted-explorers-vol-2 Early Access for the Enchanted Explorers Series Volume 2 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/2142226" width="208" height="167"><a href="https://visustellamz.itch.io/enchanted-explorers-vol-2">[Access Key] Enchanted Explorers Series Volume 2 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Map Event Effects VisuStella MZ]]
: [[Proximity Messages VisuStella MZ]]
: [[Icon Balloons VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 June 30
|align = center
|content =
; [[Skill Stealer VisuStella MZ]]

: [[File:VisuMZ.126.jpg|300px|link=Skill Stealer VisuStella MZ]]
: VisuStella MZ's '''Skill Stealer''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=ab6cIhYMav8 here]!
: This is VisuStella MZ's #126th plugin!
}}

{{NewsEntry
|date = 2023 June 28
|align = center
|content =
; [[Skill Mastery VisuStella MZ]]

: [[File:VisuMZ.125.jpg|300px|link=Skill Mastery VisuStella MZ]]
: VisuStella MZ's '''Skill Mastery''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=hjAEq9xIuA4 here]!
: This is VisuStella MZ's #125th plugin!
}}

{{NewsEntry
|date = 2023 June 26
|align = center
|content =
; [[Equip Battle Skills VisuStella MZ]]

: [[File:VisuMZ.124.jpg|300px|link=Equip Battle Skills VisuStella MZ]]
: VisuStella MZ's '''Equip Battle Skills''' plugin for official release!
: Watch the preview video [https://youtu.be/EKaSYFdUdEE here]!
: This is VisuStella MZ's #124th plugin!
}}

{{NewsEntry
|date = 2023 June 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #126]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 14 Plugins
}}

{{NewsEntry
|date = 2023 May 31
|align = center
|content =
; Hot Fix made for 2 plugins!
: [[File:HotFix.jpg|300px|link=]]
: A hot fix has been made for the following plugins:
: [https://visustellamz.itch.io/frontview-battle-ui Frontview Battle UI]
: [https://visustellamz.itch.io/furniture-system Furniture System]
: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2023 May 27
|align = center
|content =
; [https://visustellamz.itch.io/battle-technician-vol-4 Early Access for the Battle Technician Series Volume 4 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/2088596" width="208" height="167"><a href="https://visustellamz.itch.io/battle-technician-vol-4">[Access Key] Battle Technician Series Vol. 4 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Equip Battle Skills VisuStella MZ]]
: [[Skill Mastery VisuStella MZ]]
: [[Skill Stealer VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 May 26
|align = center
|content =
; [[Skill Shop VisuStella MZ]]

: [[File:VisuMZ.123.jpg|300px|link=Skill Shop VisuStella MZ]]
: VisuStella MZ's '''Skill Shop''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=jNZerP-1hXY here]!
: This is VisuStella MZ's #123 plugin!

}}

{{NewsEntry
|date = 2023 May 24
|align = center
|content =
; Hot Fix made for Battle System - ATB
: [[File:VisuMZ.022.jpg|300px|link=https://visustellamz.itch.io/battle-system-atb]]
: A hot fix has been made for the Battle System - ATB plugin.
: [https://visustellamz.itch.io/battle-system-atb Please download it again].
: Thank you and sorry for the inconvenience!
}}

{{NewsEntry
|date = 2023 May 24
|align = center
|content =
; [[Recruiting Board VisuStella MZ]]

: [[File:VisuMZ.122.jpg|300px|link=Recruiting Board VisuStella MZ]]
: VisuStella MZ's '''Recruiting Board''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=j-QoO5dSja8 here]!
: This is VisuStella MZ's #122 plugin!

}}

{{NewsEntry
|date = 2023 May 22
|align = center
|content =
; [[Hospital Shop VisuStella MZ]]

: [[File:VisuMZ.121.jpg|300px|link=Hospital Shop VisuStella MZ]]
: VisuStella MZ's '''Hospital Shop''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=FdzG-ealtys here]!
: This is VisuStella MZ's #121 plugin!

}}

{{NewsEntry
|date = 2023 May 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #125]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 17 Plugins
}}

{{NewsEntry
|date = 2023 April 13
|align = center
|content =
; [https://visustellamz.itch.io/merchant-manager-series-vol-3 Early Access for the Merchant Manager Series Volume 3 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/2013860" width="208" height="167"><a href="https://visustellamz.itch.io/merchant-manager-series-vol-3">[Access Key] Merchant Manager Series Vol. 3 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Hospital Shop VisuStella MZ]]
: [[Recruiting Board VisuStella MZ]]
: [[Skill Shop VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].

; [[VisuStella MZ Changelog|Plugin Updates! Update #124]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 9 Plugins

}}

{{NewsEntry
|date = 2023 April 7
|align = center
|content =
; [[Multi-Layer HP Gauge VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=HgrL31Smu08</youtube>

}}

{{NewsEntry
|date = 2023 April 5
|align = center
|content =
; [[Visual Gauge Styles VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=J7r-Yx2MBSA</youtube>

}}

{{NewsEntry
|date = 2023 April 3
|align = center
|content =
; [[Bestiary VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=VGzXdawZ16M</youtube>

}}

{{NewsEntry
|date = 2023 March 16
|align = center
|content =
; Hot Fix!

Hot fixes have been made for plugin(s) below. Please download them again:

: [[Unique Tile Effects VisuStella MZ]]

; [[VisuStella MZ Changelog|Plugin Updates! Update #123]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 22 Plugins
}}

{{NewsEntry
|date = 2023 February 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #122]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 19 Plugins

}}

{{NewsEntry
|date = 2023 January 21
|align = center
|content =
; [https://visustellamz.itch.io/visual-novel-vol-3 Early Access for the Visual Novel Series Volume 3 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/1886739" width="208" height="167"><a href="https://visustellamz.itch.io/visual-novel-vol-3">[Access Key] Visual Novel Series Vol. 3 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Animated Message Text Effects VisuStella MZ]]
: [[Visual Cutin Effect VisuStella MZ]]
: [[CG Gallery VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].

}}

{{NewsEntry
|date = 2023 January 20
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #121]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 23 Plugins

}}

{{NewsEntry
|date = 2023 January 6
|align = center
|content =
; [[Unique Tile Effects VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=lZesyw9DFdo</youtube>

}}

{{NewsEntry
|date = 2023 January 4
|align = center
|content =
; [[Event Chain Reactions VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=RY7rxwZTw0I</youtube>

}}

{{NewsEntry
|date = 2023 January 2
|align = center
|content =
; [[Tutorial Panel System VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=Y9CwVDMpOPc</youtube>

}}

{{Latest Plugins 2023}}
{{Latest Plugins 2022 Q4}}
{{Latest Plugins 2022 Q3}}
{{Latest Plugins 2022 Q2}}
{{Latest Plugins 2022 Q1}}
{{Latest Plugins 2021 Q4}}
{{Latest Plugins 2021 Q3}}
{{Latest Plugins 2021 Q2}}
{{Latest Plugins 2021 Q1}}
{{Latest Plugins 2020 Q4}}
{{Latest Plugins 2020 Q3}}
{{Latest Plugins 2020 Q2}}
{{Latest Plugins 2020 Q1}}
{{Latest Plugins 2019}}

[[Category:Display templates|MainPageLatestPlugins]]
</noinclude>
<noinclude>|}</noinclude>

Category:Notetags (MZ)

2026-05-17T08:51:16Z

Irina:

{{TOCright}}

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

<html><img src='https://img.itch.zone/aW1nLzQwMDQ3NzQucG5n/original/zLbbTl.png'></html>

[[RPG Maker MZ]]'s editor is unable to allow for custom traits/properties that a game dev may wish to associate with a database object, event, map, etc. [[:Category:Notetags (MZ)|Notetags]] are used to work around such limitations by allowing the game dev to tag certain traits/properties using specific Notetags declared by the related plugin.

Here is a list of [[:Category:Notetags (MZ)|Notetag(s)]] that you may use.

== [[Active Chain Skills VisuStella MZ]] ==

{{VisuMZ Active Chain Skills Notetags}}

== [[Aggro Control System VisuStella MZ]] ==

{{VisuMZ Aggro Control System Notetags}}

== [[Ambience Sounds VisuStella MZ]] ==

{{VisuMZ Ambience Sounds Notetags}}

== [[Anti-Damage Barriers VisuStella MZ]] ==

{{VisuMZ Anti-Damage Barriers Notetags}}

== [[Auto Skill Triggers VisuStella MZ]] ==

{{VisuMZ Auto Skill Triggers Notetags}}

== [[Battle AI VisuStella MZ]] ==

{{VisuMZ Battle AI Notetags}}

== [[Battle Command - Talk VisuStella MZ]] ==

{{VisuMZ Battle Command - Talk Notetags}}

== [[Battle Core VisuStella MZ]] ==

{{VisuMZ Battle Core Notetags}}

== [[Battle Cursor VisuStella MZ]] ==

{{VisuMZ Battle Cursor Notetags}}

== [[Battle Grid System VisuStella MZ]] ==

{{VisuMZ Battle Grid System Notetags}}

== [[Battle System - ATB VisuStella MZ]] ==

{{VisuMZ Battle System ATB Notetags}}

== [[Battle System - BTB VisuStella MZ]] ==

{{VisuMZ Battle System BTB Notetags}}

== [[Battle System - CTB VisuStella MZ]] ==

{{VisuMZ Battle System - CTB Notetags}}

== [[Battle System - ETB VisuStella MZ]] ==

{{VisuMZ Battle System - ETB Notetags}}

== [[Battle System - FTB VisuStella MZ]] ==

{{VisuMZ Battle System FTB Notetags}}

== [[Battle System - OTB VisuStella MZ]] ==

{{VisuMZ Battle System OTB Notetags}}

== [[Battle System - PTB VisuStella MZ]] ==

{{VisuMZ Battle System - PTB Notetags}}

== [[Battle System - STB VisuStella MZ]] ==

{{VisuMZ Battle System STB Notetags}}

== [[Battle Voices VisuStella MZ]] ==

{{VisuMZ Battle Voices Notetags}}

== [[Bestiary VisuStella MZ]] ==

{{VisuMZ Bestiary Notetags}}

== [[Boost Action VisuStella MZ]] ==

{{VisuMZ Boost Action Notetags}}

== [[Break Shields VisuStella MZ]] ==

{{VisuMZ Break Shields Notetags}}

== [[Bright Effects VisuStella MZ]] ==

{{VisuMZ Bright Effects Notetags}}

== [[Button Trigger Events VisuStella MZ]] ==

{{VisuMZ Button Trigger Events Notetags}}

== [[Challenge System VisuStella MZ]] ==

{{VisuMZ Challenge System Notetags}}

== [[Character Creation System VisuStella MZ]] ==

{{VisuMZ Character Creation System Notetags}}

== [[Class Change System VisuStella MZ]] ==

{{VisuMZ Class Change System Notetags}}

== [[Combat Log VisuStella MZ]] ==

{{VisuMZ Combat Log Notetags}}

== [[Common Event Menu VisuStella MZ]] ==

{{VisuMZ Common Event Menu Notetags}}

== [[Conditional Random Encounters VisuStella MZ]] ==

{{VisuMZ Conditional Random Encounters Notetags}}

== [[Consumable Defensive States VisuStella MZ]] ==

{{VisuMZ Consumable Defensive States Notetags}}

== [[Core Engine VisuStella MZ]] ==

{{VisuMZ Core Engine Notetags}}

== [[Database Inheritance VisuStella MZ]] ==

{{VisuMZ Database Inheritance Notetags}}

== [[Date and Time VisuStella MZ]] ==

{{VisuMZ Date and Time System Notetags}}

== [[Dragonbones Union VisuStella MZ]] ==

{{VisuStella MZ Dragonbones Union Notetags}}

== [[Dice Rolls and RNG Seeds VisuStella MZ]] ==

{{VisuMZ Dice Rolls and RNG Seeds Notetags}}

== [[Elements and Status Menu Core VisuStella MZ]] ==

{{VisuMZ Elements and Status Menu Core Notetags}}

== [[Encounter Effects VisuStella MZ]] ==

{{VisuMZ Encounter Effects Notetags}}

== [[Enhanced TP System VisuStella MZ]] ==

{{VisuMZ Enhanced TP System Notetags}}

== [[Enemy Levels VisuStella MZ]] ==

{{VisuMZ Enemy Levels Notetags}}

== [[Equip Battle Skills VisuStella MZ]] ==

{{VisuMZ Equip Battle Skills Notetags}}

== [[Equip Medal System VisuStella MZ]] ==

{{VisuMZ Equip Medal System Notetags}}

== [[Equip Passive System VisuStella MZ]] ==

{{VisuMZ Equip Passive System Notetags}}

== [[Equipment Set Bonuses VisuStella MZ]] ==

{{VisuMZ Equipment Set Bonuses Notetags}}

== [[Event Chain Reactions VisuStella MZ]] ==

{{VisuMZ Event Chain Reactions Notetags}}

== [[Event Signals VisuStella MZ]] ==

{{VisuMZ Event Signals Notetags}}

== [[Events and Movement Core VisuStella MZ]] ==

{{VisuMZ Events and Movement Core Notetags}}

== [[Evolution Matrix Skills VisuStella MZ]] ==

{{VisuMZ Evolution Matrix Skills Notetags}}

== [[Extra Enemy Drops VisuStella MZ]] ==

{{VisuMZ Extra Enemy Drops Notetags}}

== [[Field Skills VisuStella MZ]] ==

{{VisuMZ Field Skills Notetags}}

== [[Fluctuating Shop Prices VisuStella MZ]] ==

{{VisuMZ Fluctuating Shop Prices Notetags}}

== [[Frontview Battle UI VisuStella MZ]] ==

{{VisuMZ Frontview Battle UI Notetags}}

== [[Full Field Recovery VisuStella MZ]] ==

{{VisuMZ Full Field Recovery Notetags}}

== [[Furniture System VisuStella MZ]] ==

{{VisuMZ Furniture System Notetags}}

== [[Hospital Shop VisuStella MZ]] ==

{{VisuMZ Hospital Shop Notetags}}

== [[Input Combo Skills VisuStella MZ]] ==

{{VisuMZ Input Combo Skills Notetags}}

== [[Items and Equips Core VisuStella MZ]] ==

{{VisuMZ Items and Equips Core Notetags}}

== [[Item Crafting System VisuStella MZ]] ==

{{VisuMZ Item Crafting System Notetags}}

== [[Item Concoction Skills VisuStella MZ]] ==

{{VisuMZ Item Concoction Skills Notetags}}

== [[Item Throw Skills VisuStella MZ]] ==

{{VisuMZ Item Throw Skills Notetags}}

== [[Life State Effects VisuStella MZ]] ==

{{VisuMZ Life State Effects Notetags}}

== [[Lighting Effects VisuStella MZ]] ==

{{VisuMZ Lighting Effects Notetags}}

== [[Limited Skill Uses VisuStella MZ]] ==

{{VisuMZ Limited Skill Uses Notetags}}

== [[Main Menu Core VisuStella MZ]] ==

{{VisuMZ Main Menu Core Notetags}}

== [[Map Camera Zoom VisuStella MZ]] ==

{{VisuMZ Map Camera Zoom Notetags}}

== [[Map Damage Effect VisuStella MZ]] ==

{{VisuMZ Map Damage Effect Notetags}}

== [[Map Event Effects VisuStella MZ]] ==

{{VisuMZ Map Event Effects Notetags}}

== [[More Currencies VisuStella MZ]] ==

{{VisuMZ More Currencies Notetags}}

== [[Movement Effects VisuStella MZ]] ==

{{VisuMZ Movement Effects Notetags}}

== [[Multi-Layer HP Gauge VisuStella MZ]] ==

{{VisuMZ Multi-Layer HP Gauge Notetags}}

== [[New Game Plus VisuStella MZ]] ==

{{VisuMZ New Game Plus Notetags}}

== [[One Time Purchase VisuStella MZ]] ==

{{VisuMZ One Time Purchase Notetags}}

== [[Proximity Compass VisuStella MZ]] ==

{{VisuMZ Proximity Compass Notetags}}

== [[Proximity Messages VisuStella MZ]] ==

{{VisuMZ Proximity Messages Notetags}}

== [[Quest Journal System VisuStella MZ]] ==

{{VisuMZ Quest Journal System Notetags}}

== [[QTE and Trigger System VisuStella MZ]] ==

{{VisuMZ QTE and Trigger System Notetags}}

== [[Random Dungeon Maps VisuStella MZ]] ==

{{VisuMZ Random Dungeon Maps Notetags}}

== [[Recruiting Board VisuStella MZ]] ==

{{VisuMZ Recruiting Board Notetags}}

== [[Shop Batches VisuStella MZ]] ==

{{VisuMZ Shop Batches Notetags}}

== [[Shop Common Events VisuStella MZ]] ==

{{VisuMZ Shop Common Events Notetags}}

== [[Shop Listing Unlock VisuStella MZ]] ==

{{VisuMZ Shop Listing Unlock Notetags}}

== [[Skill Containers VisuStella MZ]] ==

{{VisuMZ Skill Containers Notetags}}

== [[Skill Cooldowns VisuStella MZ]] ==

{{VisuMZ Skill Cooldowns Notetags}}

== [[Skill Learn System VisuStella MZ]] ==

{{VisuMZ Skill Learn System Notetags}}

== [[Skill Mastery VisuStella MZ]] ==

{{VisuMZ Skill Mastery Notetags}}

== [[Skill Shop VisuStella MZ]] ==

{{VisuMZ Skill Shop Notetags}}

== [[Skill Stealer VisuStella MZ]] ==

{{VisuMZ Skill Stealer Notetags}}

== [[Skills and States Core VisuStella MZ]] ==

{{VisuMZ Skills and States Core Notetags}}

== [[State Tooltips VisuStella MZ]] ==

{{VisuMZ State Tooltips Notetags}}

== [[Steal Items VisuStella MZ]] ==

{{VisuMZ Steal Items Notetags}}

== [[Unique Tile Effects VisuStella MZ]] ==

{{VisuMZ Unique Tile Effects Notetags}}

== [[Variable Gauges VisuStella MZ]] ==

{{VisuMZ Variable Gauges Notetags}}

== [[Victory Aftermath VisuStella MZ]] ==

{{VisuMZ Victory Aftermath Notetags}}

== [[Visual Cutin Effect VisuStella MZ]] ==

{{VisuMZ Visual Cutin Effect Notetags}}

== [[Visual Fogs VisuStella MZ]] ==

{{VisuMZ Visual Fogs Notetags}}

== [[Visual Item Inventory VisuStella MZ]] ==

{{VisuMZ Visual Item Inventory Notetags}}

== [[Visual State Effects VisuStella MZ]] ==

{{VisuMZ Visual State Effects Notetags}}

== [[Visual Parallaxes VisuStella MZ]] ==

{{VisuMZ Visual Parallaxes Notetags}}

== [[Weakness Display VisuStella MZ]] ==

{{VisuMZ Weakness Display Notetags}}

== [[Weapon Animation VisuStella MZ]] ==

{{VisuMZ Weapon Animation Notetags}}

== [[Weapon Swap System VisuStella MZ]] ==

{{VisuMZ Weapon Swap System Notetags}}

== [[Weapon Unleash VisuStella MZ]] ==

{{VisuMZ Weapon Unleash Notetags}}

== [[Weather Effects VisuStella MZ]] ==

{{VisuMZ Weather Effects Notetags}}

== End of List ==

|}

Template:VisuMZ One Time Purchase Notetags

2026-05-17T08:50:30Z

Irina: Created page with "=== Bulk-Related Notetags === --- <pre> <Allow Bulk Buy> - Used for: Item, Weapon, Armor Notetags - Always allow item to be purchaseable in bulk, even with One Time Purchas..."

=== Bulk-Related Notetags ===

---

<pre>
<Allow Bulk Buy>

- Used for: Item, Weapon, Armor Notetags
- Always allow item to be purchaseable in bulk, even with One Time Purchase
mode enabled.
</pre>

---

One Time Purchase VisuStella MZ

2026-05-17T08:50:12Z

Irina:

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=yBNk0aT7cmQ</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/1395448" width="552" height="167"><a href="https://visustellamz.itch.io/one-time-purchase">One Time Purchase plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Merchant Manager Vol 2}}

}}



[[File:OneTimePurchase_Preview.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Items and Equips Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:OneTimePurchase_Preview.png|600px]]

Not all NPC peddlers have infinite stocks of items. Sometimes, it makes more
sense for them to only sell whatever they have on hand, regardless of the
item's usual limitability. This plugin allows you to switch between a "One
Time Purchase" mode where item entries can only be bought once in a store
versus unlimited. To sell more than one of a specific item type, just add
more entries to it. However, anything that has been bought will remain sold
out until the NPC peddler restocks.

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

* Plugin Command that lets you switch between "One Time Purchase" mode for single entry buy versus unlimited buy.
* Shop contents are stored based on what the player has bought.
* Plugin Commands allow for the player to revisit those instances of the shop where the item entries have already been bought.
* Inserting multiple copies of the item type in a shop's goods listing will allow for the player to buy multiples in restricted form.

== Requirements ==

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

=== Required Plugin List ===

* [[Items and Equips Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 3}}

== Instructions - Quick Start ==

Here are some instructions to get yourself started quickly on using the
Randomize Shop feature.

---

[[File:OneTimePurchase_Command1.png]]

<pre>
Step 1: Create An Event with a Plugin Command

1. Create a new event on a map.
2. Open it up.
3. Add a new Plugin Command: "Mode: Enable One Time Purchase Mode?".
4. Set the "Enable/Disable" parameter to "true".
5. Click OK to save the contents of the Plugin Command.
</pre>

---

[[File:OneTimePurchase_Step2.png]]

<pre>
Step 2: Populate Shop Goods

1. Create a new event command with "Shop Processing".
2. Add merchanise to it.
3. Add three copies of "Potion" (yes, the same exact item).
4. This will be used to demonstrate how to purchase multiple "copies" of the
items in limited form.
5. Any price variations among the copies will be based on the first copy of
the item listed. This is how vanilla RPG Maker MZ handles it.
6. Add in other items, too.
7. Click OK to save the contents of the "Shop Processing" event.
</pre>

---

[[File:OneTimePurchase_Step3.png]]

<pre>
Step 3: Close the One Time Purchase Mode:

1. Add a new Plugin Command: "Mode: Enable One Time Purchase Mode?".
2. Set the "Enable/Disable" parameter to "false".
3. Click OK to save the contents of the Plugin Command.
4. This is so that the mode does not affect other shops.
</pre>

---

[[File:OneTimePurchase_Step4.png]]

<pre>
Step 4: Add in a Self Switch

1. After the Plugin Command is inserted, add in a Self Switch.
2. Set Self Switch "A" to ON.
3. Click OK to save the contents of the Self Switch.
</pre>

---

[[File:OneTimePurchase_Step5.png]]

<pre>
Step 5: New Page

1. Create a new page for the event.
2. Make the new page require Self Switch "A" to be ON in order to appear.
3. Remember to give the new event page a graphic.
</pre>

---

[[File:OneTimePurchase_Step6.png]]

<pre>
Step 6: Add the "Open" Plugin Command

1. Add a new Plugin Command: "Mode: Enable One Time Purchase Mode?" with
the setting set to true.
2. Add a new Plugin Command: "This Event: Open Last Shop".
3. Add a new Plugin Command: "Mode: Enable One Time Purchase Mode?" with
the setting set to false.
4. Save the event.
5. Save your game and Play Test it.
</pre>

---

{{Notetags MZ}}

{{VisuMZ One Time Purchase Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ One Time Purchase Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:OneTimePurchase_Params.png]]

These are the general settings for this plugin.

---

General Settings

Default On/Off:
- Do you want "One Time Purchase" mode to be on by default?
- One Time Purchase
- Unlimited Purchase

Sold Text:
- Text that's shown for any bought items.
- You may use text codes.

Offset X:
- Offset the "Sold Text" by this many pixels.
- Negative: left, Positive: right

Offset Y:
- Offset the "Sold Text" by this many pixels.
- Negative: up, Positive: down

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.01: May 18, 2026
* Bug Fixes!
** Fixed a bug where going to sell items while in One Time Purchase mode does not show other touch screen UI buttons other than OK. Fix by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Notetag added by Arisu:
*** <nowiki><Allow Bulk Buy></nowiki>
**** Always allow item to be purchaseable in bulk, even with One Time Purchase mode enabled.

Version 1.00 Official Release Date: March 9, 2022
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Merchant Manager Volume 2]]

== End of File ==

|}




[[Category: RPG Maker MZ Item Plugins]]

[[Category: RPG Maker MZ Equip Plugins]]

[[Category: RPG Maker MZ Gameplay Plugins]]



[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]

[[Category: RPG Maker MZ Menu Plugins]]

Template:VisuMZ Shop Common Events Notetags

2026-05-17T08:49:09Z

Irina: /* Shop Common Event-Related Notetags */

<noinclude>[[Category:Display templates|VisuMZ Shop Common Events Notetags]]</noinclude>
The following are notetags that have been added through this plugin. These
notetags will not work with your game if this plugin is OFF or not present.

---

=== Shop Common Event-Related Notetags ===

[[File:ShopCommonEvents_Preview.gif]]

---

<pre>
<Once Buy Common Event: id>
<Repeat Buy Common Event: id>

- Used for: Item, Weapon, Armor Notetags
- This will cause a specific Common Event to launch when bought.
- Common Event must use Plugin Command "Return: To Last Shop" at the end
of the event.
- Replace 'id' with a number representing the ID of the Common Event that
you wish to launch upon this item being bought.
- The "Once" notetag variant will only occur once when bought.
- Any subsequent purchases of the item will not launch the Common Event.
- The "Repeat" notetag variant will occur repeatedly when bought.
- If both "Once" and "Repeat" notetags are present in the item, then the
"Once" variant will take priority first. Any subsequent purchases will go
to the "Repeat" variant.
- Any switch requirement notetags need to be met in order for either
notetag to have any effect.
- Use the Plugin Command "Return: To Last Shop" to return back to the last
shop scene.
</pre>

---

<pre>
<Once Sell Common Event: id>
<Repeat Sell Common Event: id>

- Used for: Item, Weapon, Armor Notetags
- This will cause a specific Common Event to launch when sold.
- Common Event must use Plugin Command "Return: To Last Shop" at the end
of the event.
- Replace 'id' with a number representing the ID of the Common Event that
you wish to launch upon this item being sold.
- The "Once" notetag variant will only occur once when sold.
- Any subsequent sellings of the item will not launch the Common Event.
- The "Repeat" notetag variant will occur repeatedly when sold.
- If both "Once" and "Repeat" notetags are present in the item, then the
"Once" variant will take priority first. Any subsequent sellings will go
to the "Repeat" variant.
- Any switch requirement notetags need to be met in order for either
notetag to have any effect.
- Use the Plugin Command "Return: To Last Shop" to return back to the last
shop scene.
</pre>

---

=== Requirement Switch-Related Notetags ===

---

<pre>
<Once Buy Common Event Switch: id>
<Once Buy Common Event All Switches: id, id, id>
<Once Buy Common Event Any Switches: id, id, id>

<Repeat Buy Common Event Switch: id>
<Repeat Buy Common Event All Switches: id, id, id>
<Repeat Buy Common Event Any Switches: id, id, id>

- Used for: Item, Weapon, Armor Notetags
- Requires the respective Buy Common Events to have these Switches enabled
in the "ON" position in order for them to launch.
- "Once" variant will only affect the "Once" notetag buy variants.
- "Repeat" variant will only affect the "Repeat" notetag buy variants.
- The "All" variant will require all listed Switch ID's to be "ON".
- The "Any" variant will require only one listed Switch ID to be "ON".
- Replace 'id' with a number representing the Switch ID that needs to be in
the "ON" position for the requirement to be met.
- Insert multiple 'id' to require more Switch ID's.
</pre>

---

<pre>
<Once Sell Common Event Switch: id>
<Once Sell Common Event All Switches: id, id, id>
<Once Sell Common Event Any Switches: id, id, id>

<Repeat Sell Common Event Switch: id>
<Repeat Sell Common Event All Switches: id, id, id>
<Repeat Sell Common Event Any Switches: id, id, id>

- Used for: Item, Weapon, Armor Notetags
- Requires the respective Sell Common Events to have these Switches enabled
in the "ON" position in order for them to launch.
- "Once" variant will only affect the "Once" notetag sell variants.
- "Repeat" variant will only affect the "Repeat" notetag sell variants.
- The "All" variant will require all listed Switch ID's to be "ON".
- The "Any" variant will require only one listed Switch ID to be "ON".
- Replace 'id' with a number representing the Switch ID that needs to be in
the "ON" position for the requirement to be met.
- Insert multiple 'id' to require more Switch ID's.
</pre>

---

QTE and Trigger System VisuStella MZ

2026-05-17T08:48:07Z

Irina:

{{MzPlugin
|preview = <youtube>https://youtu.be/UTak0ezYszI</youtube>

|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/2452274" width="552" height="167"><a href="https://visustellamz.itch.io/qte-trigger-sys">QTE & Trigger System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Custom Construct Vol 4}}

}}



[[File:QteTrigger_ButtonSequence.gif]]

[[File:QteTrigger_FillGauge.gif]]

[[File:QteTrigger_TimedHit.gif]]

[[File:QteTrigger_TimedSeq.gif]]

[[File:QteTrigger_TimingBar.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Events and Movement Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:VisuMZ.142.jpg|600px]]

Sometimes, we need a way to trigger Switch or Variable changes. This can be
in an organic fashion or through Quick Time Events (QTE's). QTE's allow for
immediate changes to Switches or Variables through player inputs. Or if you
have ever wanted a Common Event to run when a specific Switch or Variable
changes its current value to something else, you can use this plugin's
trigger system for Switches, Variables, Items, Weapons, and Armors to call
and trigger Common Events whenever their values change. These don't have to
be recurring as they can also function as one-time "promises", too.

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

* Quick Time Events (QTE) can be played to adjust values of variables and/or switches based off different types of QTE's like Button Mashing, Direction Struggle, Timed Hits, and more.
* 10+ different QTE Plugin Commands for you to pick and choose from to give players more engaging gameplay.
* Trigger Common Events by simply changing certain Switches to ON/OFF positions or Variables to different values.
* Items, weapons, and armors can also register Common Events to trigger when the party gains or loses a copy of that item, weapon, or armor.
* If these triggers occur on a scene that isn't battle or the map, then the Common Events are queued up for until the player moves to the battle or map scenes to trigger them.
* If the triggering Common Event only has script calls, then the effect will run right then and there.
* Create Promises, one-time Common Event triggers upon a switch, variable, item, weapon, or armor having its value changed.
* Getting a Game Over can also result in a trigger that will bypass the Game Over scene, too.
* Game Over Common Events will prevent the game from ending completely and return back to map scene.
* The Common Event that is run upon a Game Over can be altered and changed.
* Have different Common Events depending on the map or troop encountered.
* The Game Over Common Event can be persistent or function as a one time deal depending on how you, as the game dev, choose to follow up with it.

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Events and Movement Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

=== Quick Time Events ===

[[File:QteTrigger_TimingBar.gif]]

Also known as QTE's, these events function as player involved input trigger
systems which affect Variable or Switch values depending on the QTE type
(such as Variables for Button Mashing). Because these are player-input
reliant triggers, it's usually best for the event to be halted while the QTE
plays out (although you can disable this). Naturally, as such, the event
will not continue until the QTE is finished playing in the event commands.

QTE's are activated through Plugin Commands and can have the messages and
such displayed with each QTE displayed differently each time. Adjust this in
the Plugin Parameters for each QTE to fit the situation.

Only one QTE type can be played at a single time. Two or more QTE's cannot
be played at the same time. This is to prevent clutter and cause input
clashes.

If a QTE Plugin Command has a Switch and/or Variable assigned (or multiple),
those Switches and Variables will be reset to OFF and 0 respectively. Based
on the QTE type, data can be recorded to both the Switches and Variables.
Some Switches can indicate the successful player input of a QTE while other
Variables can indicate how much time was remaining upon finishing the QTE or
the score for the QTE.

Furthermore, for play testing purposes, during a QTE input sequence, you can
just hold down the "debug" button (usually Control) to automatically input
the needed input sequences. This ONLY works during Play Testing!

---

=== Switch and Variable Triggers ===

[[File:SwVarTrigger.png]]

Switches and Variables can have their names included with the name tags:
<Toggle Trigger Common Event: x> or <Change Trigger Common Event: x> to
automatically activate a Common Event at the next available moment. The
activated Common Event will only run once per trigger as opposed to
continuously like an Autorun or Parallel Common Event.

These apply to Self Switches (only the custom ones added through the <Self>
name tag VisuMZ_1_ItemsEquipsCore) and Self Variables (likewise), too. The
same also applies to Map Switches and Variables (with <Map>) and any Global
Switches and Variables (with <Global>).

However, Self Switches/Variables that have triggered any Common Events will
not utilize any "This Event" event command functions. They will behave as if
they are triggered on a non-event environment.

Possible uses for this mechanic can be things like making a picture change
into something else whenever a Variable's number value is altered, or have a
picture become visible or invisible depending on a Switch's ON/OFF value.

Be wary of creating infinite loops by "turning off" Switches or "resetting"
any Variables. That will cause them to trigger, too. If you have to turn off
or reset switches/variables, consider using Promise Plugin Commands instead
of the auto-repeat tags.

---

=== JS Switch and Variable Triggers ===

[[File:QteTriggerSys_JsParam.png]]

Triggers that function off of JS Switches and Variables will behave slightly
different. As these have dynamic values that may be constantly changing, in
order to prevent lag and endless loops, there is a delay system put in place
to ensure the triggers occur properly.

This delay is set up in the Plugin Parameters. A delay of 60 means that
every 60 frames in-game, a check will be performed to see if a trigger
should occur or not.

---

=== Repeat Triggers ===

A triggered Common Event can only be repeated once per availability. This
means that if you have toggled a Switch ON/OFF three times in a single frame
then the triggered Common Event will only process one time. The same applies
to variables, items, weapons, and armors.

This also means that if the Common Event is triggered multiple times outside
of the battle and map scenes, then it will only run once when available to
run the Common Event.

---

=== Triggers for JavaScript Only Common Events ===

[[File:QteTriggerSys_JsTrigger.png|600px]]

If a triggered Common Event only has JavaScript in it through the "Script"
event command, then instead of waiting until reaching the battle or map
scene, the triggered Common Event will run the JS code immediately. Comments
will be ignored and allowed as a part of JavaScript Only Common Events.

If multiple "Script" event commands are found in the triggered Common Event,
they will run independent of each other and as local functions. This means
that the any custom JS variables declared in one of the Script call events
may not necessarily transfer over to the others if not originally meant to.

---

=== Promise Triggers ===

Anything that is assigned through a name tag or notetag will result in an
auto-repeat trigger and will always trigger without fail. However, if you
want something to trigger only once (or until you assign it again), use a
Promise Trigger.

These are assigned through Plugin Commands and they will only trigger once.
After that, the condition that caused them to trigger will not trigger again
until another Promise is made to them.

---

=== Game Over Scene ===

[[File:GameOver.png|600px]]

The Game Over scene is skipped over if there's a designated Game Over Common
Event determined. If there isn't any Game Over Common Events, then the Game
Over scene will occur normally.

If there are multiple Game Over Common Events, determined through the
default Plugin Parameters, Map Notetags, or Troop Name Tags, then a priority
system is used:

# Battle Processing "Can Lose"
# Troop Name Tag Game Over Common Event
# Map Notetag Game Over Common Event
# Plugin Parameters/Command Game Over Common Event

If a "Battle Processing" event command has a "Can Lose" option, then there
will be no Game Over Common Event to be run and instead, whatever is found
in the "Can Lose" segment will run instead. The event will not be
interrupted and continue forward. Ignore the rest.

Otherwise, if there is a Game Over Common Event determined by the enemy
troop's name with the Name Tag <Game Over Common Event: x>, then priority
will go to that Common Event. Any event running will end prematurely in
favor of this Game Over Common Event. Ignore the rest.

If there is a Game Over Common Event determined by the current map's notes
with the notetag <Game Over Common Event: x>, then priority will go to that
Common Event. Any event running will end prematurely in favor of this Game
Over Common Event. Ignore the rest.

And finally, if there are any Game Over Common Events determined through
Plugin Commands or Plugin Parameters, then follow through with those. Keep
in mind that if it is based off a Plugin Parameter, and if the parameter
"Clear Common Event After?" is enabled, it will be only a one time deal.

If there are no Game Over Common Events designated, then finally, the player
will reach the Game Over scene.

---

== 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]] ===

Those using VisuStella MZ's Battle Core can launch QTE Plugin Commands from
this plugin during the middle of Action Sequences as long as there is not
a conflicting effect during it.

Conflict effects include Active Chain Skills, Input Combo Skills, or
Evolution Matrix Skills. QTE events will not run at all while these skill
mechanics are active.

---

{{Notetags MZ}}

{{VisuMZ QTE and Trigger System Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ QTE and Trigger System Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:VisuMZ.142.jpg|600px]]

There aren't too many Plugin Parameters for this plugin.

---

General Settings

[[File:QteTriggerSys_JsParam.png]]

JS Watch Update Delay:
- Used for <JS> Switches and Variables.
- How many frames delay to wait for triggers?
- 60 frames = 1 second.

---

=== Game Over Settings ===

[[File:GameOver.png|600px]]

[[File:QteTriggerSys_Param1.png]]

These settings let you adjust Game Over-related trigger aspects.

---

Game Over Settings

Default Common Event:
- Do you want there to be a Default Common Event?
- It can be changed later with a Plugin Command.
- 0 to not use.

Heal on Common Event?:
- Do you want to heal 1 HP for all dead members after running the
Game Over Common Event?

Clear After?:
- Do you wish to clear the Game Over Common Event after it launches
or not?

---

=== QTE Settings ===

[[File:QteTrigger_FillGauge.gif]]

[[File:QteTriggerSys_Param2.png]]

These settings let you adjust QTE-related trigger aspects.

---

Settings

Early Finish Duration:
- How many frames should the game wait if the player finishes a QTE early?

Time Out > Play SFX?:
- Play the "Miss" sound effect on time out?
- Only applies to QTE's with "Miss" sound settings.

Show QTE Timer?:
- Do you wish to show a QTE Timer over each QTE window?

Timer Gauge Style:
- Select the gauge style to use for QTE Timer.
- Requires VisuMZ_3_VisualGaugeStyles!

Gauge Color 1:
Gauge Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

JS: X, Y, W, H:
- Code used to determine the position and dimensions for this window
containing the gauge.

Show QTE Progress?:
- Show a progress gauge for certain types of QTE's?

Progress Gauge Style:
- Select the gauge style to use for QTE Timer.
- Requires VisuMZ_3_VisualGaugeStyles!

Gauge Color 1:
Gauge Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

JS: X, Y, W, H:
- Code used to determine the position and dimensions for this window
containing the gauge.

Input Buffer Leeway:
- How many input buffer frames of leeway should be granted to
Button Sequence QTE?

Timed Hit Leeway:
- How many frames of leeway should be granted to Timed Hit QTE?

Overlay Opacity:
- Timed Hit overlay sprite opacity.

Max Scaling:
- What's the max scaling for Timed Hit QTE indicators?

Timed Sequence Leeway:
- How many frames of leeway should be granted to Timed Sequence QTE?

Sequence Position:
- What is the position for the Timed Sequence Landing Icon?
- Use a number between 0 and 100.

QTE Timing Bar Width:
- This is the width of the Timing Bar in pixels.

Cursor Offset X:
- Offsets the cursor x position.
- Negative: left. Positive: right.

Cursor Offset Y:
- Offsets the cursor y position.
- Negative: up. Positive: down.

Label Font Size:
- What is the font size used to display timing bar labels?

Label Offset X:
- Offsets the label x position.
- Negative: left. Positive: right.

Label Offset Y:
- Offsets the label y position.
- Negative: up. Positive: down.

Timing Bar Color 1:
Timing Bar Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

---

=== Vocabulary Settings ===

[[File:QteTrigger_TimedHit.gif]]

[[File:QteTriggerSys_Param3.png]]

These settings let you adjust the text displayed and QTE text window for
this plugin.

---

General Settings

Text Alignment:
- What is the text alignment?
- Requires VisuMZ_1_MessageCore!
- Otherwise, defaults to left alignment.

--

Message Settings:

Button Mash Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Button Sequence Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.

Direction Struggle:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Fill Gauge Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Hold & Release Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Marcher Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Swapper Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Timed Hit Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Timed Sequence Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.

Timing Bar Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

---

Message Window:

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the position and dimensions for this window.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella
* [[Arisu]]
* [[Irina]]
* [[Olivia]]
* [[Yanfly]]

== Changelog ==

Version 1.04: May 18, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Time Out > Play SFX?
**** Play the "Miss" sound effect on time out?
**** Only applies to QTE's with "Miss" sound settings.

Version 1.03: June 12, 2025
* Bug Fixes!
** Fixed a bug where some QTE's did not work properly in battle. Fix made by Arisu.

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > QTE Settings > Input Buffer Leeway
**** How many input buffer frames of leeway should be granted to Button Sequence QTE?

Version 1.01: February 15, 2024
* Bug Fixes!
** Fixed a bug where any input can be used for Timed Sequence QTE. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Comman added by Arisu:
*** QTE: Clear Current QTE
**** Clears the currently existing QTE.
* Feature Updated!
** Plugin Command: QTE: Hold & Release (OK)
*** Added Hold Common Event
*** Added Release Common Event
*** Added Overload Common Event
**** These common events will play upon different aspects of the QTE.

Version 1.00 Official Release Date: January 22, 2024
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Custom Construct Volume 4]]
* [[Timed Hits with Action Sequences]]

== End of Helpfile ==

|}








[[Category: RPG Maker MZ Gameplay Plugins]]



[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]


[[Category: RPG Maker MZ Quality of Life Plugins]]

Template:VisuMZ Item Crafting System Notetags

2026-05-17T08:46:41Z

Irina: /* Crafting Common Event Notetags */

<noinclude>[[Category:Display templates|VisuMZ Item Crafting System Notetags]]</noinclude>
The following are notetags that have been added through this plugin. These
notetags will not work with your game if this plugin is OFF or not present.

=== General Notetags ===

[[File:ItemCraftingSys_Preview1.png|600px]]

These notetags are used to mark the item as a craftable item or as items
that can only be crafted through a custom crafting list.

---

<pre>
<Crafting Ingredients>
Item id: x
Item name: x
Weapon id: x
Weapon name: x
Armor id: x
Armor name: x
Gold: x
Category name: x
</Crafting Ingredients>

- Used for: Item, Weapon, Armor Notetags
- Turns this item/weapon/armor into a craftable item by using the listed
ingredients to craft with.
- If the 'Category name' variant is used, it will draw from all items,
weapons, and armors that have matching <Category: x> notetag data.
- Insert/delete any number of copies of the ingredients as needed.
- Replace 'id' with the item/weapon/armor ID of the ingredient to be used.
- Replace 'name' with the name of the item/weapon/armor/category to be used.
- Replace 'x' with the number of ingredients needed to be used for crafting.

Category Rules:

- If the 'Category name' variant is used, it will draw from all items,
weapons, and armors that have matching <Category: x> notetag data.
- Multiples of the same category name can be used. However, the player must
select different items each time.
- If the selected category item already exists as a static ingredient, that
item cannot be selected either.

Examples:

<Crafting Ingredients>
Item 5: 1
Item 6: 3
Gold: 100
</Crafting Ingredients>

<Crafting Ingredients>
Item Potion: 1
Item Magic Water: 3
Gold: 100
</Crafting Ingredients>

<Crafting Ingredients>
Weapon 1: 4
Armor 2: 2
</Crafting Ingredients>

<Crafting Ingredients>
Weapon Sword: 4
Armor Hat: 2
</Crafting Ingredients>

<Crafting Ingredients>
Category Fruit: 2
Category Meat: 3
</Crafting Ingredients>
</pre>

---

<pre>
<Custom Crafting Only>

- Used for: Item, Weapon, Armor Notetags
- This item can only be crafted with custom crafting lists selected through
the Plugin Command.
</pre>

---

=== Proxy Notetags ===

---

<pre>
<Proxy: id>
<Proxy: name>

- Used for: Item, Weapon, Armor Notetags
- REQUIRES the most up to date VisuMZ Items and Equips Core!
- Turns this item, weapon, or armor into a proxy for another item, allowing
you to create recipes with different ingredients in <Crafting Ingredients>
notetag contents and yield the same item.
- The proxy item itself will take on the name, icon, and description of the
original item it is supposed to represent.
- No other properties are carried over from the original.
- When viewed through the Window_ShopStatus window, the contents will
reference the original item and not the proxy item.
- Proxy items themselves cannot be acquired. This includes event commands,
item drops, or equips.
- When crafted, the item yielded won't be the proxy item but the item it is
a proxy for.
- Replace 'id' with a number representing the item, weapon, or armor ID of
the same item type. If the proxy is an item, this will reference an item.
If the proxy is a weapon, this will reference a weapon. Same for armors.
- Replace 'name' with text representing the item, weapon, or armor's name.
The referenced item needs to be the same item type as the proxy. Item for
item, weapon for weapon, armor for armor.
</pre>

---

=== Switch-Related Notetags ===

[[File:ItemCraftingSys_Preview1.png|600px]]

These notetags can make item crafting require certain switches to be on,
or turn switches on/off upon crafting items.

---

<pre>
<Crafting Show Switch: x>

<Crafting Show All Switches: x,x,x>
<Crafting Show Any Switches: x,x,x>

- Used for: Item, Weapon, Armor Notetags
- Determines the visibility of the craftable item in the crafting scene.
- Replace 'x' with the switch ID to determine the item's visibility.
- If 'All' notetag variant is used, item will be hidden until all switches
are ON. Then, it would be shown.
- If 'Any' notetag variant is used, item will be shown if any of the
switches are ON. Otherwise, it would be hidden.
- Insert as many switch ID's as needed.
- This can be bypassed with the custom Item Crafting list plugin command
option if enabled.
</pre>

---

<pre>
<Crafting Turn On Switch: x>
<Crafting Turn On Switches: x,x,x>

<Crafting Turn Off Switch: x>
<Crafting Turn Off Switches: x,x,x>

- Used for: Item, Weapon, Armor Notetags
- Upon crafting this item, turn on/off the marked switch(es).
- Replace 'x' with the switch ID to turn on/off.
</pre>

---

=== Masking-Related Notetags ===

[[File:ItemCraftingSys_Preview1.png|600px]]

These notetags can are used to determine name-masking properties for
uncrafted items.

---

<pre>
<Crafting Mask: text>

- Used for: Item, Weapon, Armor Notetags
- Displays the specific 'text' when the item has not yet been crafted.
- Replace 'text' with the text you wish to display if the item has not yet
been crafted by the player.
- This can be bypassed with the custom Item Crafting list plugin command
option if enabled.
</pre>

---

<pre>
<Crafting No Mask>

- Used for: Item, Weapon, Armor Notetags
- Bypasses name masking even if the item has not yet been crafted.
</pre>

---

=== JavaScript Notetag: Effect-Related ===

The following are notetags made for users with JavaScript knowledge to
make custom effects that occur upon crafting the item.

---

<pre>
<JS Crafting Effect>
code
code
code
</JS Crafting Effect>

- Used for: Item, Weapon, Armor Notetags
- Replace 'code' with JavaScript code to determine what kinds of effects you
want to occur upon crafting this item.
- The 'item' variable represents the item being crafted.
- The 'number' variable represents the number of items being crafted.
</pre>

---

=== Crafting Animation-Related Notetags ===

[[File:ItemCraftingSys_Animation.gif]]

These notetags let you set custom crafting animations when a specific item,
weapon, or armor is crafted so that way, they don't all have to use the
default crafting animation from the plugin parameters.

---

<pre>
<Crafting Animation: id>
<Crafting Animation: id, id, id>

- Used for: Item, Weapon, Armor Notetags
- Plays the animation(s) when this item, weapon, or armor is crafted.
- This will override the default animation settings found in the plugin
parameters and use the unique one set through notetags instead.
- Replace 'id' with the ID of the animation you wish to play.
- If multiple ID's are found, then each animation will play one by one in
the order they are listed.
</pre>

---

<pre>
<Crafting Fade Speed: x>

- Used for: Item, Weapon, Armor Notetags
- This determines the speed at which the item's icon fades in during the
crafting animation.
- Replace 'x' with a number value to determine how fast the icon fades in.
- Use lower numbers for slower fade speeds and higher numbers for faster
fade speeds.
</pre>

---

<pre>
<Crafting Picture: filename>
<Picture: filename>

- Used for: Item, Weapon, Armor Notetags
- Uses a picture from your project's /img/pictures/ folder instead of the
item, weapon, or armor's icon during crafting instead.
- Replace 'filename' with the filename of the image.
- Do not include the file extension.
- Scaling will not apply to the picture.
- Use the <Picture: filename> version for any other plugins that may be
using this as an image outside of crafting, too.
- The size used for the image will vary based on your game's resolution.
</pre>

---

=== Crafting Common Event Notetags ===

Requires:

[[File:VisuMZ.083.jpg|300px|link=Shop Common Events VisuStella MZ]]

---

<pre>
<Once Craft Common Event: id>
<Repeat Craft Common Event: id>

- Used for: Item, Weapon, Armor Notetags
- Requires VisuMZ_2_ShopCommonEvents!
- This will cause a specific Common Event to launch when crafted.
- Common Event must use Plugin Command "Return: To Last Shop" at the end
of the event.
- Replace 'id' with a number representing the ID of the Common Event that
you wish to launch upon this item being crafted.
- The "Once" notetag variant will only occur once when crafted.
- Any subsequent purchases of the item will not launch the Common Event.
- The "Repeat" notetag variant will occur repeatedly when crafted.
- If both "Once" and "Repeat" notetags are present in the item, then the
"Once" variant will take priority first. Any subsequent purchases will go
to the "Repeat" variant.
- Any switch requirement notetags need to be met in order for either
notetag to have any effect.
- Use the Plugin Command "Scene: Common Event Return" to return back to the
last Item Crafting scene.
</pre>

---

=== Crafting Common Event Requirement-Related Notetags ===

Requires:

[[File:VisuMZ.083.jpg|300px|link=Shop Common Events VisuStella MZ]]

---

<pre>
<Once Craft Common Event Switch: id>
<Once Craft Common Event All Switches: id, id, id>
<Once Craft Common Event Any Switches: id, id, id>

<Repeat Craft Common Event Switch: id>
<Repeat Craft Common Event All Switches: id, id, id>
<Repeat Craft Common Event Any Switches: id, id, id>

- Used for: Item, Weapon, Armor Notetags
- Requires VisuMZ_2_ShopCommonEvents!
- Requires the respective Craft Common Events to have these Switches enabled
in the "ON" position in order for them to launch.
- "Once" variant will only affect the "Once" notetag variants.
- "Repeat" variant will only affect the "Repeat" notetag variants.
- The "All" variant will require all listed Switch ID's to be "ON".
- The "Any" variant will require only one listed Switch ID to be "ON".
- Replace 'id' with a number representing the Switch ID that needs to be in
the "ON" position for the requirement to be met.
- Insert multiple 'id' to require more Switch ID's.
</pre>

---

=== Batch-Related Notetags ===

[[File:VisuMZ.140.jpg|300px|link=]]

---

<pre>
<Craft Batch>
listing
listing
listing
</Craft Batch>

- Used for: Item, Weapon, Armor Notetags
- Requires VisuMZ_3_ShopBatches!
- Creates a list of items, weapons, and armors that the player will gain
when this batch object is crafted.
- This also means that in addition to this notetag, the notetag for
<Crafting Ingredients> is also needed.
- This item will also not be masked.
- Proxy items, weapons, or armors cannot be listed and will be bypassed.
- This item, weapon, or armor cannot be crafted if all of the listed items,
weapons, or armors are at max quantity within the party's inventory.
- The listed items will NOT utilize any on craft effects for the individual
listed items themselves.
- Replace 'listing' with any of the listing types found below:

Item id
Item name
Weapon id
Weapon name
Armor id
Armor name

Item id: quantity
Item name: quantity
Weapon id: quantity
Weapon name: quantity
Armor id: quantity
Armor name: quantity

- Replace 'id' with a number representing the ID of the item, weapon, or
armor that is to be listed.
- Items CANNOT add themselves!
- ie. Item #8 must not give Item #8.
- Replace 'name' with the associated item, weapon, or armor's name.
- Items CANNOT add themselves!
- ie. Item 'Super Potion' must not give Item 'Super Potion'.
- Replace 'quantity' with a number representing the number of items,
weapons, or armors that will be acquired when the batch item is crafted.
- If the variant without 'quantity' is used, quantity will default to 1.

Examples:

---

<Craft Batch>
Item Potion: 10
Item Super Potion: 5
Weapon Short Sword: 3
Weapon Long Sword: 2
Armor Linen Clothing: 4
Armor Cloth Armor: 3
</Craft Batch>

---

<Craft Batch>
Item 7: 10
Item 8: 5
Weapon 1: 3
Weapon 2: 2
Armor 2: 4
Armor 8: 3
</Craft Batch>

---
</pre>

---

Items and Equips Core VisuStella MZ

2026-05-17T08:45:30Z

Irina:

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=R7ylHVC-ykE</youtube>
|link1 = {{VisuStella Wave 1}}
|link2 = {{VisuStella All Waves Collection}}

}}



{|
| [[File:ItemsEquipsCoreEquipTypes.png|400px]]
| [[File:ItemsEquipsCoreShopStatus.png|400px]]

|-

| [[File:ItemsEquipsCoreEquipChange.png|400px]]
| [[File:ItemsEquipsCoreShopEquip.png|400px]]

|}

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{ExtensionPluginsMZ}}
* [[Battle System - BTB VisuStella MZ]]
* [[Battle System - ETB VisuStella MZ]]
* [[Battle System - FTB VisuStella MZ]]
* [[Battle System - PTB VisuStella MZ]]
* [[Equip Medal System VisuStella MZ]]
* [[Equipment Set Bonuses VisuStella MZ]]
* [[Item Amplify Skills VisuStella MZ]]
* [[Item Crafting System VisuStella MZ]]
* [[Item Concoction Skills VisuStella MZ]]
* [[Item Throw Skills VisuStella MZ]]
* [[More Currencies VisuStella MZ]]
* [[One Time Purchase VisuStella MZ]]
* [[Shop Batches VisuStella MZ]]
* [[Shop Bust Style UI VisuStella MZ]]
* [[Shop Listing Unlock VisuStella MZ]]
* [[Weapon Swap System VisuStella MZ]]

{{Visustella MZ}}

== Introduction ==

The Items & Equips Core makes improvements to the RPG Maker MZ item and
equipment dedicated scenes (including the shop) and how they're handled.
From more item categories, better parameter control, rulings, and more, game
devs are able to take control over key aspects of their game's items.

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

* Modifying the appearances to the Item Scene, Equip Scene, and Shop Scene.
* Categorizing items in unique and multiple categories.
* Item Scene and Shop Scene will now display detailed information on items.
* NEW! marker can be displayed over recently acquired items in-game.
* Equipment notetags to adjust parameters past the editor limitations.
* Equipment Rulings to adjust what slot types can and can't be unequipped and/or optimized.
* Equipment Type Handling offers more control over equipment loadouts.
* Items sold in shops can be hidden/shown based on Switches.
* Items sold in shops can have varying prices adjusted by notetags.

== Requirements ==

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

{{MZ Tier 1}}

== Major Changes: New Hard-Coded Features ==

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

---

=== Equipment Type Handling ===

[[File:ItemsEquipsCoreEquipTypes.png|600px]]

Characters will no longer have one universal equipment slot setting.
Classes can have different equipment type loadouts, made possible through
the usage of notetags. Also, equipment types of matching names would be
treated as the same type, where previously, they would be different types.
This means if you have two "Accessory" slots, be it in the form of notetags
or through the Database > Types tab, they can both equip the same type of
accessories.

The Change Equip event command is now updated to reflect this new change.
When processing an equip change, the slot changed will go to the first
empty slot of matching type. If all of the actor's matching slot types are
equipped, then the equip will replace the last slot available.

---

=== Shop Status Window ===

[[File:ItemsEquipsCoreShopStatus.png|600px]]

The Status Window found in the Shop Scene was originally barren and did
not display much information at all. This is changed through this plugin's
new features. While the contents of the Shop Status Window can be customized
through the Plugin Parameters, it is a change that cannot be reversed and
for the better since it gives players the much needed information revolving
around the game's items.

---

=== Core Engine Compatibility: Modern Controls ===

[[File:ItemsEquipsCoreShopEquip.png|600px]]

If the [[Core Engine VisuStella MZ|VisuStella Core Engine]] is added to your game with Modern Controls
enabled, then the Item Menu Scene, Equip Menu Scene, and Shop Menu Scene's
controls will be changed a bit.

The Item Menu Scene will automatically have the Item List Window active,
with using the Left/Right (for single column) or Page Up/Page Down (for
multi-columns) to navigate between the Item Categories. Similar will occur
when trying to sell items in the Shop Menu Scene.

The Equip Menu Scene will automatically have the Equip Slots Window active
and only activate the command window upon moving up to it.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Battle Core VisuStella MZ]]

[[File:ItemsEquipsCore_37_Comp_1.png]]

Changing the "Damage Multiplier" or "Healing Multiplier" vocabulary for the
Item and Equip Core's Shop Status Window is not done with the Item and Equip
Core's Plugin Parameters if you have the Battle Core installed.

Instead, go to Battle Core's Plugin Parameters, Damage Settings, Damage
Styles, and adjust the style's version of the "Damage Multiplier" or
"Healing Multiplier" text instead.

Why does this work this way? Because not all damage styles work off
"Multipliers" so in order for it to convey the proper message to the player,
each damage style has its own vocabulary to be more accurate.

[[File:ItemsEquipsCore_37_Comp_2.png]]

In case you forget about that, when you visit the Item and Equip Core's
plugin parameters for these, it should also remind you in the parameter's
description on where to change it.

---

[[Weapon Swap System VisuStella MZ]]

The custom equip slots feature from the VisuStella MZ Items and Equips Core
allowed you to add in extra weapon slots. This is now curated up to a max
of one weapon slot per character. This needs to be done to make the Weapon
Swap System viable.

---

{{Notetags MZ}}

{{VisuMZ Items and Equips Core Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Items and Equips Core Plugin Commands}}

== Plugin Parameters ==

=== Item Menu Settings ===

[[File:ItemsEquipsCoreShopStatus.png|600px]]

[[File:ItemsEquipsCoreParams01.png]]

The Item Menu Settings allow you to adjust specifics on how key objects and
windows in the Item Menu Scene operate.

---

General Window

Use Updated Layout:
- Use the Updated Item Menu Layout provided by this plugin?
- This will automatically enable the Status Window.
- This will override the Core Engine windows settings.

Disabled: Vanilla:
- If NOT using the updated layout, keep all settings to pure vanilla and
ignore other Plugin Parameters.
- Used for those who do not wish to fiddle with the Plugin Parameter
settings to return the item menu back to default MZ vanilla.
- Does not apply if using updated layout.
- The following settings are disabled if using vanilla:
- Categories: Only the default 4
- Category Names only display text and no icons
- No Shop Status Window
- Modern Controls Disabled
- Columns: Any -> 2

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

List Window

Columns:
- Number of maximum columns.
- If you are using the VisuStella MZ Core Engine and the "Modern Controls"
Plugin Parameter, please read through that section in case you have any
questions about how to switch between categories when using multiple
columns of items at a time.

---

Item Quantity

Item Max:
Weapon Max:
Armor Max:
- The default maximum quantity for items, weapons, and/or armors.

Quantity Format:
- How to display an item's quantity.
- %1 - Item Quantity

Font Size:
- Default font size for item quantity.

---

Shop Status Window

Show in Item Menu?:
- Show the Shop Status Window in the Item Menu?
- This is enabled if the Updated Layout is on.

Adjust List Window?:
- Automatically adjust the Item List Window in the Item Menu if using the
Shop Status Window?

Background Type:
- Select background type for this window.
- 0 - Window
- 1 - Dim
- 2 - Transparent

JS: X, Y, W, H:
- Code used to determine the dimensions for this Status Window in the
Item Menu.
- Needs "Use Updated Layout" + "Disabled: Vanilla" as false.

---

Button Assist Window

Switch Category:
- Button assist text used for switching categories.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Item Categories ===

[[File:ItemsEquipsCoreCategories.png|600px]]

[[File:ItemsEquipsCoreParams02.png]]

Item Categories appear both in the Item Menu Scene and Shop Menu Scene (but
only under the Sell command). These Plugin Parameters give you the ability
to add in the specific categories you want displayed, remove the ones you
don't, and associate them with icons.

---

List

Category List
- A list of the item categories displayed in the Item/Shop menus.

Type:
- A list of the item categories displayed in the Item/Shop menus.
- Replace x with ID numbers or text.
- AllItems, RegularItems, KeyItems
- HiddenItemA, HiddenItemB
- Consumable, Nonconsumable
- AlwaysUsable, BattleUsable, FieldUsable, NeverUsable
- AllWeapons, WType:x
- AllArmors, AType:x, EType:x
- Category:x

Icon:
- Icon used for this category.
- Use 0 for no icon.

Visibility Switch:
- This Switch must be turned ON in order for the category to show.
- Use 0 for no Switch requirement.

Sort By:
- Sort this category (in Scene_Item and Scene_Shop only) this way.

Style:
- How do you wish to draw categorie entries in the Category Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Alignment
- Decide how you want the text to be aligned.

---

Vocabulary

Hidden Item A
Hidden Item B
Consumable
Nonconsumable
Always Usable
Battle Usable
Field Usable
Never Usable
- How these categories are named in the Item Menu.

---

=== NEW! Labels ===

[[File:ItemsEquipsCoreNew.png]]

[[File:ItemsEquipsCoreParams03.png]]

Whenever the player receives a new item(s), a NEW! Label can be placed on
top of the item's icon when browsing a menu displaying the item(s). This is
a quality of life addition from more modern RPG's to help players figure out
what they've recently received. The following are Plugin Parameters made to
adjust how the NEW! Labels are handled in-game.

---

NEW! Labels

Use NEW! Labels?:
- Use the NEW! Labels or not?

Icon:
- The icon index used to represent the NEW! text.
- Use 0 to not draw any icons.

Text:
- The text written on the NEW! Label.

Font Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Font Size:
- The font size used for the NEW! text.

Fade Limit:
- What's the upper opaque limit before reversing?

Fade Speed:
- What's the fade speed of the NEW! Label?

Offset X:
- How much to offset the NEW! Label's X position by.

Offset Y:
- How much to offset the NEW! Label's Y position by.

---

=== Equip Menu Settings ===

[[File:ItemsEquipsCoreEquipTypes.png|600px]]

[[File:ItemsEquipsCoreParams04.png]]

These Plugin Parameters adjust the Equipment Menu Scene, ranging from using
a more updated and modern layout, changing the styles of other windows, and
other key visual aspects of the Equip Menu Scene. Other settings here allow
you to adjust how equipment operate under certain rulings, too.

---

General

Use Updated Layout:
- Use the Updated Equip Layout provided by this plugin?
- This will override the Core Engine windows settings.

Param Font Size:
- The font size used for parameter values.

Show Menu Portraits?:
- If Main Menu Core is installed, display the Menu Portraits instead of
the actor's face in the status window?

JS: Portrait Upper:
- If Menu Portraits are available, this is code used to draw the upper
data like this in the Status Window.

JS: Face Upper:
- If faces used used, this is code used to draw the upper data like this
in the Status Window.

JS: Parameter Lower:
- Code to determine how parameters are drawn in the Status Window.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

Status Window Width:
- The usual width of the status window if using the non-Updated Equip
Menu Layout.

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.

Cursed Equip Popup:
- Text popup appears when an actor equips a cursed weapon/armor.
- Text codes allowed.
- Requires VisuMZ_0_CoreEngine!
- Empty to not use.
- %1 - Actor, %2 - Equip, %3 - Icon.

---

Command Window

Style:
- How do you wish to draw commands in the Command Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Command Window.

Equip Icon:
- The icon used for the Equip command.

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Add Optimize Command?:
- Add the "Optimize" command to the Command Window?

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Optimize Icon:
- The icon used for the Optimize command.

Add Clear Command?:
- Add the "Clear" command to the Command Window?

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Clear Icon:
- The icon used for the Clear command.

---

Remove Equip

Icon:
- Icon used for equipment removal.

Text:
- Text used for equipment removal.

Use SHIFT Shortcut?:
- Add the "Shift" button as a shortcut key to removing items?

---

Rulings

Equip-Adjust HP/MP:
- Adjust HP/MP differences after changing equips with MaxHP/MaxMP values.

Non-Removable Types:
- Insert ID's of the Equipment Types that must always have an item
equipped and cannot be empty.

Non-Optimized Types:
- Insert ID's of the Equipment Types that will be ignored when equipment
is being optimized.

---

Button Assist Window

SHIFT: Remove:
- Button assist text used for the SHIFT Remove Shortcut.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Shop Menu Settings ===

[[File:ItemsEquipsCoreShopEquip.png|600px]]

[[File:ItemsEquipsCoreParams05.png]]

These Plugin Parameters allow you a number of options to adjust the Shop
Menu Scene. These options range from enabling an updated and modern layout,
adjust how various key visual aspects appear, and determine how prices can
be affected when it comes to selling them or buying them (for coders).

---

General

Use Updated Layout:
- Use the Updated Shop Layout provided by this plugin?
- This will override the Core Engine windows settings.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

[[File:ItemsEquipsCore_Update28_Params1.png]]

Switches

Switch: Buy:
- Buying items in the Shop Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Shop Scene opens.

Switch: Sell
- Selling items in the Shop Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Shop Scene opens.

---

Command Window

Hide Unavailable?:
- Hide all unavailable commands like when a shop is set to Purchase Only?

Style:
- How do you wish to draw commands in the Command Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Command Window.

Buy Icon:
- The icon used for the Buy command.

Sell Icon:
- The icon used for the Sell command.

Cancel Icon:
- The icon used for the Cancel command.

Rename "Cancel":
- Rename Cancel to something more logical for the Shop Menu Scene.

---

Prices

Sell Price Rate:
- The default sell price rate.

JS: Buy Price:
- Modificatons made to the buy price before finalizing it.

JS: Sell Price:
- Modificatons made to the sell price before finalizing it.

---

Button Assist Window

Small Increment:
Large Increment:
- Text used for changing amount bought/sold.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Shop Status Window ===

[[File:ItemsEquipsCoreShopStatusWindow.png]]

[[File:ItemsEquipsCoreParams06.png]]

These Plugin Parameters focuses on the Shop Status Window and determines how
its data is displayed.

---

General

Window Width:
- The usual width of the status window.

Parameter Font Size:
- Font size used for parameter changes.

Translucent Opacity:
- Opacity setting used for translucent window objects.

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.

---

Equipment Data

[[File:ItemEquipCore_StatusWindowStyles.png|600px]]

Data Style:
- How do you wish to display equipment data?
- Compare - Compares selected equip to equipped gear
- Lists all main party actors
- Displays the parameter differences when equipped
- Calculates custom JS values
- Classic - Shows basic parameters of selected equip
- Involves no actors, only shows the item's stats
- Shows weapon or armor specific parameters
- Does not show custom JS values as those are calculated per actor
- Does not show custom parameters as those are calculated per actor
- Use <Status Info> and <Custom Status Info> notetags to overwrite or
add custom data to classic equip data
- Double - Shows basic parameters in double columns
- Involves no actors, only shows the item's stats
- Shows weapon or armor specific parameters
- Does not show custom JS values as those are calculated per actor
- Does not show custom parameters as those are calculated per actor
- Use <Status Info> and <Custom Status Info> notetags to overwrite or
add custom data to classic equip data

Compare Style:

Already Equipped:
- Marker used to show an actor cannot equip an item.

Can't Equip:
- Marker used to show an actor cannot equip an item.

No Changes:
- Marker used to show no changes have occurred.

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Classic Style:

Added Weapon Params:
Added Armor Params:
- Display these parameters when a weapon/armor is selected.
- Requires VisuMZ_0_CoreEngine!

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Double Style:

Added Weapon Params:
Added Armor Params:
- Display these parameters when a weapon/armor is selected.
- Requires VisuMZ_0_CoreEngine!

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Delay MS:
- How many milliseconds (MS) to delay the preview update?
- This is to prevent lag spikes for equips only.

---

Item Data

Max State/Buff Icons:
- Maximum number of icons that can be displayed for Add/Remove
States/Buffs.

Multiplier Standard:
- Constant standard to filter out random values when calculating the
damage multiplier.

JS: Draw Item Data:
- Code used to draw the item data for the Shop Status Window.

---

Vocabulary

Consumable:
Occasions:
Scope:
Speed:
Success Rate:
Repeats:
Hit Type:
Element:
Damage Type:
Effects:
- Vocabulary used for these data entries.
- Some of these have Plugin Parameters have sub-entries.

NOTE: Regarding Damage Labels

If Visu_1_BattleCore is installed, priority goes to its Damage Style
settings. The label displayed is based on the damage style settings in
place for that specific skill or item.

Go to Battle Core > Plugin Parameters > Damage Settings > Style List >
pick the damage style you want to edit > Damage Label and change the
text settings you'd like there.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* Yanfly
* Arisu
* Olivia
* Irina

== Changelog ==

Version 1.61: May 18, 2026
* Documentation Update!
** Added extra clarity for Plugin Parameters
*** Parameters > Item Menu Scene > Shop Status Window > JS: X, Y, W, H
**** Needs "Use Updated Layout" + "Disabled: Vanilla" as false.

Version 1.60: March 16, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Parameters > Item Menu Settings > Use Updated Layout > Disabled: Vanilla
**** If NOT using the updated layout, keep all settings to pure vanilla and ignore other Plugin Parameters.
**** Used for those who do not wish to fiddle with the Plugin Parameter settings to return the item menu back to default MZ vanilla.
**** Does not apply if using updated layout.
**** The following settings are disabled if using vanilla:
***** Categories: Only the default 4
***** Category Names only display text and no icons
***** No Shop Status Window
***** Modern Controls Disabled
***** Columns: Any -> 2

Version 1.59: October 16, 2025
* Bug Fixes!
** Fixed a bug where a changed parameter in the equipment menu would accidentally highlight the next parameter's name. Fix made by Irina.

Version 1.58: February 20, 2025
* Bug Fixes!
** Optimize no longer allows player to bypass the following notetags: <nowiki><Equip Copy Limit: x></nowiki>, <nowiki><Equip Weapon Type Limit: x></nowiki>, and <nowiki><Equip Armor Type Limit: x></nowiki>. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

Version 1.57: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Added extra clarity for <nowiki><Status Info></nowiki> notetag:
*** For clarity regarding "Damage Multiplier" and "HP Recovery"/"HP Damage":
**** "Damage Multiplier" refers to the amount determined by damage formulas.
**** "HP Recovery"/"HP Damage" refers to the "Recover HP" database effect.
**** Likewise, the same will apply to "MP Recovery"/"MP Damage" if the damage formula type is to deal MP recovery/damage instead.
* New Features!
** New Notetags added by Arisu:
*** <nowiki><Status Style: type></nowiki>
**** Changes up the way the shop status window displays data for this database object in particular.
*** <nowiki><Custom Status Parameters: name, name, name></nowiki>
**** Customize which parameters are displayed for this equipment object's shop status window.
* Optimization Update!
** Plugin should run more optimized.

Version 1.56: December 19, 2024
* Bug Fixes!
** Fixed a bug where newly added equipment would cause crashes upon interaction. Fix made by Irina.

Version 1.55: November 14, 2024
* Bug Fixes!
** Fixed a bug where you can no longer attempt to equip an actor with zero equip slots and causing a crash. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
** Updated <Status Info>
*** Used for: Skill, Item, Weapon, Armor Notetags
**** Replace 'key' with one of the following for weapons and armors:
***** 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI', or 'LUK'
***** For those with VisuMZ_0_CoreEngine:
****** 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT', 'HRG', 'MRG', 'TRG'
****** 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR', 'MDR', 'FDR', 'EXR'
**** Only relevant if the Draw Style for equipment is "classic" or "double".
** Updated <Custom Status Info> notetag:
*** Used for: Skill, Item, Weapon, Armor Notetags
**** When used with weapon or armor database objects, this information is only relevant if the Draw Style for equipment is "classic" or "double".
* New Feature!
** New Plugin Parameters:
*** Parameters > Shop Status Window > Data Style:
**** How do you wish to display equipment data?
***** Compare - Compares selected equip to equipped gear
****** Lists all main party actors
****** Displays the parameter differences when equipped
****** Calculates custom JS values
***** Classic - Shows basic parameters of selected equip
***** Double - Shows basic parameters in double columns
****** Involves no actors, only shows the item's stats
****** Shows weapon or armor specific parameters
****** Does not show custom JS values as those are calculated per actor
****** Does not show custom parameters as those are calculated per actor
****** Use <Status Info> and <Custom Status Info> notetags to overwrite or add custom data to classic equip data
**** Data Style > Classic Style:
**** Data Style > Double Style:
***** Added Weapon Params
***** Added Armor Params
****** Display these parameters when a weapon/armor is selected.
****** Requires VisuMZ_0_CoreEngine!

Version 1.54: October 17, 2024
* Feature Update!
** If "Modern Controls" is selected while "Remove Equip" and "Optimize" are gone from the Equip Menu, right click will exit the menu. Feature added by Arisu.

Version 1.53: July 18, 2024
* Documentation Update!
** Help file updated for new features.
** Added warning to <JS Parameters>:
*** If you are trying to calculate a value based off a full parameter value, such as "ATK = user.atk * 0.10", it's going to break and will cause an infinite loop. Use base parameter values instead.
* New Features!
** New notetags added by Irina:
*** <ID Sort Priority: x>
**** Used for Scene_Item, Scene_Equip, Scene_Battle, and Scene_Shop's sell option (only when selling).
**** Changes sorting priority by ID for item, weapon, or armor to 'x'.
**** Default priority level is '50'.
**** Items, weapons, and armors with higher priority values will be sorted higher up on the list while lower values will be lower on the list.

Version 1.52: May 16, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Irina:
*** Parameters > Item Categories > Category List > Category > Sorted By:
**** You can now sort specific item categories by ID or Name.
**** Only usable within Scene_Item and Scene_Shop.
* Optimization Update!
** Plugin should run more optimized.

Version 1.51: December 14, 2023
* Bug Fixes!
** Fixed a bug where if an item is unequipped, it may cause a crash. Fix made by Arisu.
** Fixed a bug where <Proxy: id> did not properly give the proxy item. Fix made by Arisu.

Version 1.50: November 16, 2023
* Bug Fixes!
** <JS Buy Price> and <JS Sell Price> was not working properly. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
* Optimization Update!
** Plugin should run more optimized.
* New Features!
** New Notetags added by Arisu:
*** <Cursed>
**** If this weapon or armor is equipped, it cannot manually be removed by the player until it is purified.
**** To remove it, it must be done by event commands, script calls, or through the Purify-related Plugin Commands provided by this plugin.
**** Once purified, the weapon or armor will become unequipped unless it has a purify transformation.
**** If the newly transformed weapon/armor is equippable, it will remain in the actor's equipment slots.
**** If you are using VisuMZ_2_WeaponSwapSystem, weapons cannot become cursed in order to allow free weapon swapping. Weaponry will not be cursed if VisuMZ_2_WeaponSwapSystem is installed.
*** <Purify Transform: id>
*** <Purify Transform: name>
**** If this notetag is present on a <Cursed> weapon or armor, then upon the actor receiving purification, the weapon or armor will transform into a different item.
** New Plugin Commands added by Arisu:
*** Purify: Target Actor(s)
**** Purifies target actor(s) of any cursed weapons or armors.
*** Purify: Whole Party
**** Purifies whole party of any cursed weapons or armors.
** Added "Cursed Equip Popup" to Equip Scene Plugin Parameters.
*** Text popup appears when an actor equips a cursed weapon/armor.
** Added "Ally or Enemy" or "Enemy or Ally" scopes to Shop Status Window Plugin Parameters.
*** If unused, will default to "1 Ally" or "1 Enemy" like usual. Added by Irina.

Version 1.49: October 12, 2023
* Bug Fixes!
** Fixed a problem where for weapon types, all weapon types are listed in the equip menu even when the actor cannot equip them (though they would be disabled). Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia and sponsored by AndyL:
*** <Added EType: x>
*** <Added ETypes: x, x, x>
**** This is for armors only and does NOT work with weapons!
**** Allows a piece of armor to belong to multiple ETypes. This means a glove can be equipped as "Armgear" or as an "Accessory" if you so choose.

Version 1.48: September 14, 2023
* Bug Fixes!
** Fixed a problem where the help window position of the non-updated layout would appear in the wrong position. Fix made by Irina.
* Optimization Update!
** Plugin should run more optimized when weapons and armors exceed 2000 in database quantity.

Version 1.47: July 13, 2023
* Bug Fixes!
** Fixed a bug that would cause the shop status window to display incorrect removed buffs and debuffs. Fix made by Olivia.
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Help file updated for new features.
* Feature Updates!
** Changes made to dynamic shop listings in order to update upon listing changes rather than having to enter and exit the shop again. Update made by Arisu.
* New Features!
** New notetag effects added by Arisu and sponsored by AndyL:
*** <Conserve: x%>
**** Gives the item a percent chance when used to not consume the item.
*** <Buy Turn On Switches: x, x, x>
*** <Buy Turn Off Switches: x, x, x>
*** <Sell Turn On Switches: x, x, x>
*** <Sell Turn Off Switches: x, x, x>
**** When buying/selling an item, weapon, or armor with these notetags, turn on/off switch(es) 'x'.
*** New Plugin Parameters added by Arisu:
**** Params > Settings > Shop Status Window > Equipment Data > Delay MS:
***** How many milliseconds (MS) to delay the preview update?
***** This is to prevent lag spikes for equips only.

Version 1.46: June 15, 2023
* Bug Fixes!
** Fixed a problem where the help and input modes are not adequately adjusted when not used with the updated layout or without the Options Core custom UI placement. Fix made by Arisu.

Version 1.45: May 18, 2023
* Bug Fixes!
** Fixed a bug that would cause equip slots to not be recognized properly if the equip slot name ends in a space.

Version 1.44: April 13, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag effects added by Arisu and sponsored by Anon:
*** <Equip For Class Only: x>
*** <Equip For Classes Only: x, x, x>
*** <Equip For Class Only: name>
*** <Equip For Classes Only: name, name, name>
**** The piece of equipment can only be worn by the listed classes.
*** <Equip Requirements> notetag added.
**** Define multiple requirements that the actor needs to meet in order for this equip item to be equippable.
**** See help file for more information on the types of requirements that can be added.

Version 1.43: March 16, 2023
* Bug Fixes!
** Artifact armors should now update and refresh the party members' cache upon acquisition. Fix made by Olivia.

Version 1.42: February 16, 2023
* Bug Fixes!
** Proxy items should no longer cause infinite loops if they're made to reference other proxy items in a circular fashion. Instead, they just give the exact first found proxy instead of cycling through others. Fix made by Arisu.

Version 1.41: December 15, 2022
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu and sponsored by Anon:
*** Equip Scene > Equip Command > Help Description
*** Equip Scene > Optimize Command > Help Description
*** Equip Scene > Clear Command > Help Description
**** Help description used when these commands are selected.

Version 1.40: October 20, 2022
* Feature Update!
** For the shop status window, when comparing equipment of a type where there are multiple equipment slots (such as accessories), the plugin will now check for an empty equipment slot first and then make calculations there. Otherwise, it will use the first available equipment slot of that type regardless of the equipped item. Update made by Arisu.
* Optimization Update!
** Plugin should run more optimized.

Version 1.39: September 29, 2022:
* Feature Update!
** Changed the default code for the equip scene's status window display to prevent the face graphic and basic actor stats from going above the window boundaries if there are too many parameters displayed in the status window at a time.
** If you already have this plugin installed the changes will not be reflected unless you do the following:
**** BACKUP your game project.
**** REMOVE this plugin from the Plugin Manager list.
**** REINSTALL this plugin into the Plugin Manager list.
**** SAVE the game project.

Version 1.38: March 3, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New mechanics and notetags added by Olivia and sponsored by Anon:
*** <Party Artifact>
*** <Troop Artifact>
*** <Stackable Party Artifact>
*** <Stackable Troop Artifact>
**** Armors only! This armor cannot be equipped at all. However, by simply being in the party's inventory, its parameter bonuses and traits will be applied globally throughout the whole party or troop (depending on the notetag). Add both notetags to affect both groups.
**** The normal versions of the notetag is only applied once regardless of the number of copies are found in the party's inventory.
**** The stackable versions of the notetag will have the bonuses and traits stacked multiple times relative to the number of copies found in the party's inventory.
**** This item will NOT be added during the setup phase for Battle Tests.
***** If you want to add the item, do it manually.

Version 1.37: December 23, 2021
* Compatibility Update
** Created foundation for proxy items to be used in any applicable system and extension plugins. Update made by Arisu.

Version 1.36: December 2, 2021
* Feature Update!
** For those using custom parameters from the Core Engine and do not have the parameters all-capitalized, the plugin will automatically do it for you to prevent errors. Update made by Olivia.

Version 1.35: November 18, 2021
* Compatibility Update!
** If this plugin's updated scene is disabled, the Help Window locations for the Item, Equip, and Shop Scenes should now be at their designated locations as calculated by the VisuMZ Core Engine instead of the RMMZ default location. Update made by Irina.

Version 1.34: October 28, 2021
* Feature Update
** Added fail safe checks for projects that are using old data for starting equipment that no longer exist, thus preventing the game from opening. Update made by Arisu.

Version 1.33: August 6, 2021
* Documentation Update!
** Removed "Weapon" and "Armor" from "Used For" for <Status Info>. This was an unintended piece of documentation.

Version 1.32: July 23, 2021
* Bug Fixes!
** Fixed a bug that would cause armor duplication when changing to classes with unaligned equipment slot types. Fix made by Arisu.

Version 1.31: July 9, 2021
* Feature Update!
** Added a failsafe for price manipulation JavaScript to never have prices drop below 0 if possible. Update made by Arisu.

Version 1.30: July 2, 2021
* Documentation Update!
** Added an extra note to the help file for the following: Plugin Parameters > Item Menu Settings > List Window > Columns
*** If you are using the VisuStella MZ Core Engine and the "Modern Controls" Plugin Parameter, please read through that section in case you have any questions about how to switch between categories when using multiple columns of items at a time.

Version 1.29: June 25, 2021
* Compatibility Update
** Compatibility update with RPG Maker MZ 1.3.0+.
* Feature Update!
** Phantom data when changing equipment types in the database should no longer affect actors with cached equip ID's. Update made by Arisu.

Version 1.28: June 4, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.27: May 21, 2021
* Bug Fixes!
** Using the mouse right click in the Equip Scene while inside of the item to slot window will no longer exit the Equip Scene. Fix made by Yanfly.

Version 1.26: April 30, 2021
* Documentation Update!
** Help file updated for new features.
** "VisuStella MZ Compatibility" added VisuMZ_1_BattleCore section regarding Damage Multiplier and Healing Multiplier vocabulary settings to reduce commonly asked questions.
* New Features!
** New notetags added by Irina and sponsored by Archeia:
*** <Shop Picture Name: filename>
*** <Shop Picture Layer: x>
*** <Shop Picture Max Width: x>
*** <Shop Picture Max Height: y>
*** <Shop Picture Max Dimensions: x, y>
*** <Shop Picture Alignment: x>
*** <Shop Picture Position: y>
*** <Shop Picture Offset X: +x>
*** <Shop Picture Offset X: -x>
*** <Shop Picture Offset Y: +y>
*** <Shop Picture Offset Y: -y>
*** <Shop Picture Offset: +x, +y>
*** <Shop Picture Offset: -x, -y>
*** <Shop Picture Opacity: x>
*** <Shop Picture Opacity: x%>
**** Add images from the game project's img/pictures/ folder to display in the Shop Status Window.

Version 1.25: April 23, 2021
* Documentation Update!
** Added clarity to the <param: +x> and <param: -x> notetags:
*** These notetags do NOT work with X Parameters, S Parameters, or any custom parameters. These notetags ONLY work with the base parameters.

Version 1.24: April 16, 2021
* Bug Fixes!
** Changing an actor's equipment slots to past their original amount will no longer yield errors with duplicate slot types. Fix made by Arisu.
** Completely selling an item should now refresh the help window to the new selected item's help description. Fix made by Arisu.
* Optimization Update!
** Non-removable equipment restrictions for the equipment scene are now better optimized. Update made by Olivia.

Version 1.23: April 2, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.22: March 26, 2021
* Documentation Update!
** Added "VisuStella MZ Compatibility" section for detailed compatibility explanations with the VisuMZ_4_BreakShields plugin.

Version 1.21: March 5, 2021
* Feature Update!
** Custom equipment slots are disabled during Battle Testing for better accuracy and results.

Version 1.20: February 26, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina and sponsored by AndyL:
*** Plugin Parameters > Shop Menu Settings > Switches > Switch: Buy
*** Plugin Parameters > Shop Menu Settings > Switches > Switch: Sell
**** Buying/selling items in the Shop Scene turns this Switch to ON.
**** Switch reverts to OFF whenever the Shop Scene opens.
**** These switches can be used after a "Shop Processing" event command to determine if the player has bought an item, bought and sold an item, sold an item, or neither.

Version 1.19: January 29, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Irina.
*** <Equip Copy Limit: x>
**** Sets a maximum number of copies that the actor can wear of this equipment. Usage Example: Actors can only equip one copy of the "One-of-a-Kind Ring" on at any time despite having empty accessory slots because the ring has a <Equip Copy Limit: 1> notetag.
*** <Equip Weapon Type Limit: x>
**** This weapon cannot be equipped with other weapons of the same type once the limited amount has been reached. Usage Example: A dualwielding warrior who can only equip one sword and a dagger but never two swords or two daggers because the swords and daggers all have the <Equip Weapon Type Limit: 1> notetags on them.
*** <Equip Armor Type Limit: x>
**** This armor cannot be equipped with other armors of the same type once the limited amount has been reached. Usage Example: People cannot equip more than two glove accessories on at a time because the glove is a "Glove" armor-type and each glove item has the <Equip Armor Type Limit: 2> notetags on them.

Version 1.18: January 15, 2021
* Bug Fixes!
** Pressing "Shift" to remove equipment will now refresh the status window unlike before. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added
*** Plugin Parameters > Item Menu Settings > Background Type

Version 1.17: January 1, 2021
* Bug Fixes!
** Equipping should be working properly again. Fix made by Yanfly.

Version 1.16: December 25, 2020
* Bug Fixes!
** Equip-Adjust HP/MP should work properly now. Fix made by Yanfly.
* Documentation Update!
** Added more clarity for <JS Item Enable> to state that if the VisuStella Battle Core is installed, then all battle scope items are visible, but not necessarily enabled if they are disabled otherwise.

Version 1.15: December 18, 2020
* Bug Fixes!
** RPG Maker MZ Bug: Unusable items on an individual-actor basis will no longer be overwritten by party-based usability for battle. Fix by Yanfly.
* Documentation Update!
** Added more clarity for <JS Item Enable> to state that it removes the usable item from visibility as well if the actor unable to use it is the only person in the party.

Version 1.14: December 11, 2020
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.13: December 4, 2020
* Documentation Update!
** Added documentation for new feature(s)!
* New Features!
** New Plugin Commands added by Arisu!
*** Actor: Change Equip Slots
*** Actor: Reset Equip Slots
**** These plugin commands allow you to forcefully change the equip slots available to an actor regardless of the slots provided by its class as well as reset them.

Version 1.12: November 15, 2020
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: November 8, 2020
* Bug Fix!
** Font size ratio for the shop status window now scales to a hard coded value to prevent smaller font sizes from expanding icon sizes. Fix made by Arisu.
* Feature Update!
** Currency display in the shop menu is now reflected upon how the plugin parameters set them to display. Update made by Arisu.

Version 1.10: November 1, 2020
* Feature Update!
** Modern Controls compatibility with Core Engine no longer enables the Item Categories window and child classes to utilize the Home/End keys.

Version 1.09: October 25, 2020
* Bug Fixes!
** "All Items" category should now display the "Items" text. Fix by Irina.
** WType, AType, and EType categories now work with text. Fix by Irina.

Version 1.08: October 18, 2020
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.07: October 11, 2020
* Bug Fixes!
** XParams and SParams in the Window_EquipStatus window will no longer show a non-percentile difference if the original value is not a whole value. Fix made by Yanfly.

Version 1.06: October 4, 2020
* Bug Fixes!
** Select Item event command now displays the default amount of columns instead of whatever setting is made with the plugin parameters.

Version 1.05: September 27, 2020
* Bug Fixes!
** When using the updated shop layout, leaving the sell option will no longer cause the dummy window to appear.
* Documentation Update
** "Use Updated Layout" plugin parameters now have the added clause: "This will override the Core Engine windows settings." to reduce confusion. Added by Irina.

Version 1.04: September 13, 2020
* Bug Fixes!
** Pressing Shift to quickly remove equipment should no longer crash the game. This will also clear the help window text. Fix made by Arisu.

Version 1.03: September 6, 2020
* Bug Fixes!
** If both Optimize and Clear commands have been removed and using modern controls, pressing up at the top of the slot window list will not go to the window. Fix made by Yanfly.
** If both Optimize and Clear commands have been removed, the window will no longer appear and the slot window will be moved upward to fill any empty spaces. Fix made by Yanfly.
* New Features!
** New Plugin Parameter added in NEW! Label to let you adjust the font face.
** New Plugin Parameters added in Equip Menu Scene Settings for disabling the back rectangles and/or changing their colors.
** New Plugin Parameters added in Shop Status Window Settings for disabling the back rectangles and/or changing their colors.

Version 1.02: August 30, 2020
* Documentation Fix!
** Added: NOTE: Regarding Damage Labels
*** If Visu_1_BattleCore is installed, priority goes to its Damage Style settings. The label displayed is based on the damage style settings in place for that specific skill or item.
*** Go to Battle Core > Plugin Parameters > Damage Settings > Style List > pick the damage style you want to edit > Damage Label and change the text settings you'd like there.
*** Documentation update added by Yanfly.

Version 1.01: August 23, 2020
* Added failsafe to prevent non-existent equipment (because the database entries have been deleted) from being equipped as initial equipment. Fix made by Olivia.

Version 1.00: August 20, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 1]]

|}

== End of File ==


[[Category: RPG Maker MZ Core Plugins]]

[[Category: RPG Maker MZ Item Plugins]]

[[Category: RPG Maker MZ Equip Plugins]]

[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]

[[Category: RPG Maker MZ Quality of Life Plugins]]

Template:VisuMZ Events and Movement Core Notetags

2026-05-17T08:44:32Z

Irina: /* Map Notetags */

<noinclude>[[Category:Display templates|VisuMZ Events and Movement Core]]</noinclude>
The following are notetags that have been added through this plugin. These
notetags will not work with your game if this plugin is OFF or not present.

Some of these are comment tags. Comment tags are used for events to mark and
affect individual event pages rather than the whole event.

=== Map Notetags ===

The following notetags are used for maps only. While some of these options
are also available in the Plugin Parameters, some of these notetags extend
usage to specific maps marked by these notetags as well.

---

[[File:EventsMoveCoreVS8.gif]]

<pre>
<Diagonal Movement: On>
<Diagonal Movement: Off>

- Used for: Map Notetags
- Turns on/off diagonal movement for those maps.
- If notetag isn't present, use Plugin Parameter setting.
</pre>

---

[[File:EventMoveCoreRegions.png]]

<pre>
<type Allow Region: x>
<type Allow Region: x, x, x>

<type Forbid Region: x>
<type Forbid Region: x, x, x>

<type Dock Region: x>
<type Dock Region: x, x, x>

- Used for: Map Notetags
- Replace 'type' with 'All', 'Walk', 'Player', 'Event', 'Vehicle', 'Boat',
'Ship', or 'Airship'.
- 'Allow' notetag variants allow that type to pass through them no matter
what other passability settings are in place.
- 'Forbid' notetag variants forbid that type from passing through at all.
- 'Dock' notetag variants allow vehicles to dock there. Boats and ships must
face the region direction while airships must land directly on top.
</pre>

---

<pre>
<Map Load Common Event: x>
<Map Load Common Events: x, x, x>

- Used for: Map Notetags
- When this map is loaded, run the specified Common Events once available.
- Does NOT trigger if you transfer to a different part of the same map.
- Replace 'x' with a number representing the ID of the Common Event you wish
to reserve and run once ready.
</pre>

---

<pre>
<Save Event Locations>

- Used for: Maps Notetags
- Saves the locations of all events on the map so that when you return to
that map at a later point, the events will be in the position they were
last in.
</pre>

---

<pre>
<Hide Player>
<Show Player>

- Used for: Map Notetags
- Forcefully hides or shows the player sprite. This is so you don't need to
manually turn the setting on/off each time you enter a specific map.
- These settings will take priority over the event commands.
- If the player sprite is hidden, so are the player's followers.
- If the player sprite is visible, the player's followers will still depend
on their settings.
- These notetags are mutually exclusive from each other.
</pre>

---

<pre>
<Hide Followers>
<Show Followers>

- Used for: Map Notetags
- Forcefully hides or shows the player's followers. This is so you don't
need to manually turn them on/off each time you enter a specific map.
- These settings will take priority over the event commands.
- These notetags are mutually exclusive from each other.
</pre>

---

=== JavaScript Notetag: Map Effects ===

---

<pre>
<JS On Map Load>
code
code
</JS On Map Load>

- Used for: Map Notetags
- Replace 'code' with JavaScript code to run the moment the map finishes
loading and before fading in.
</pre>

---

<pre>
<JS On Map Exit>
code
code
</JS On Map Exit>

- Used for: Map Notetags
- Replace 'code' with JavaScript code to run the moment the player transfers
to a different map and the screen completely fades out.
</pre>

---

=== Page Comment Tags ===

The following comment tags are to be put inside of the pages of events,
troops, and common events for them to work!

---

<pre>
<Page Conditions>
conditions
conditions
conditions
</Page Conditions>

- Used for: Map Event Page, Troop Page, and Common Event Page Comment Tags
- This allows you to create custom page conditions that utilize the
Conditional Branch event command to see if the additional page conditions
are met.
</pre>

---

<pre>
<Conditions Met>
- Used for: Map Event Page, Troop Page, and Common Event Page Comment Tags
- If used between the <Page Conditions> and </Page Conditions> comment tag,
upon reaching this part of event command list, the custom page conditions
will be considered met.
</pre>

---

[[File:EventsMoveCoreCustomPageCondition.png|600px]]

<pre>
Example:

◆Comment：<Page Conditions>
◆If：Reid has equipped Potion Sword
◆Comment：If Reid has equipped the Potion Sword
：：<Condition Met>
◆
：End
◆Comment：</Page Conditions>

If Reid has the "Potion Sword" weapon equipped, then the additional custom
page conditions are met and the event page will be present/active.

If this is a troop condition, the troop page event will activate.

If this is a common event, there will be a parallel common event active.
</pre>

---

=== Event and Event Page Notetags ===

The following notetags have comment tag variants (with a few exceptions).
If a notetag is used for an event, it will affect the event constantly.
If a comment tag is used, it will only affect the page the comment tag is
on and only that page.

---

[[File:EventsMoveCoreActivationRegion.png]]

<pre>
<Activation Region: x>
<Activation Regions: x,x,x>

- Used for: Event Notetags and Event Page Comment Tags
- Allows this event to be remotely activated as long as the player is
standing within a tile marked by a designated region.
- Replace 'x' with the regions you wish to remotely activate this event in.
- Action Button: Player must press OK while being in the region.
- Player/Event Touch: Player must step onto the region.
- Autorun/Parallel: Player be in the region.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
- NOTE: This cannot be used with any other activation tags.
</pre>

---

[[File:EventsMoveCoreActivationAreas.png|600px]]

<pre>
<Activation Square: x>
<Activation Circle: x>
<Activation Delta: x>
<Activation Row: x>
<Activation Column: x>

- Used for: Event Notetags and Event Page Comment Tags
- Allows this event to be remotely activated as long as the player is
within range of its activation type.
- Replace 'x' with a number stating the range in tiles.
- Square: A square-shaped range with the event at the center.
- Circle: A circle-shaped range with the event at the center.
- Delta: A diamond-shaped range with the event at the center.
- Row: Spans horizontally across the map. 'x' expands up and down.
- Column: Spans vertically across the map. 'x' expands left and right.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
- NOTE: This cannot be used with any other activation tags.
</pre>

---

<pre>
<Always Update Movement>

- Used for: Event Notetags and Event Page Comment Tags
- Events normally have to be within screen range for them to update their
self movement. If this tag is present, the event is always updating.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCoreClickTrigger.gif]]

<pre>
<Click Trigger>

- Used for: Event Notetags and Event Page Comment Tags
- Allows this event to activate upon being clicked on with the mouse.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Copy Event: Map x, Event y>
<Copy Event: x, y>

<Copy Event: template>

- Used for: Event Notetags ONLY
- Makes this event copy all of the event settings from a different event
that can be found on a different map (as long as that map is registered
inside of Plugin Parameters => Event Template Settings => Preloaded Maps).
- Replace 'x' with a number representing the copied event's Map ID.
- If '0' is used for the Map ID, reference the current map.
- Replace 'y' with a number representing the copied event's Event ID.
- For the 'template' variant, replace 'template' with the name of the
template made in Plugin Parameters => Event Template Settings =>
Event Template List.
- If this is placed in a notetag, the effect will be present across
all event pages used.
</pre>

---

<pre>
<Custom Z: x>

- Used for: Event Notetags and Event Page Comment Tags
- Replace 'x' with a number value to determine the event sprite's Z value
relative to the tilemap.
- For reference from rmmz_core.js:
- 0 : Lower tiles
- 1 : Lower characters
- 3 : Normal characters
- 4 : Upper tiles
- 5 : Upper characters
- 6 : Airship shadow
- 7 : Balloon
- 8 : Animation
- 9 : Destination
- You can use numbers below 0 and above 9.
- Values under 0 go below the tilemap.
- Values above 9 go above everything else on the tilemap.
- These values do NOT go below or above other screen objects that are
NOT attached to the tilemap layer such as parallaxes or weather or
windows because that's simply not how z-axis work with sprite layers.
</pre>

---

<pre>
<Encounter Half Square: x>
<Encounter Half Circle: x>
<Encounter Half Delta: x>
<Encounter Half Row: x>
<Encounter Half Column: x>

- Used for: Event Notetags and Event Page Comment Tags
- If the player is within the 'x' area effect of this event, the random
encounter rate will be halved.
- Replace 'x' with a number stating the range in tiles.
- Square: A square-shaped range with the event at the center.
- Circle: A circle-shaped range with the event at the center.
- Delta: A diamond-shaped range with the event at the center.
- Row: Spans horizontally across the map. 'x' expands up and down.
- Column: Spans vertically across the map. 'x' expands left and right.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.

Script Call Check:

$isTileEncounterHalf(x, y)

- This can be used to check if a certain map tile (x, y) has an encounter
rate halving effect on it.
- Returns a boolean (true or false) when used.
</pre>

---

<pre>
<Encounter None Square: x>
<Encounter None Circle: x>
<Encounter None Delta: x>
<Encounter None Row: x>
<Encounter None Column: x>

- Used for: Event Notetags and Event Page Comment Tags
- If the player is within the 'x' area effect of this event, the random
encounter rate will be suppressed completely.
- Replace 'x' with a number stating the range in tiles.
- Square: A square-shaped range with the event at the center.
- Circle: A circle-shaped range with the event at the center.
- Delta: A diamond-shaped range with the event at the center.
- Row: Spans horizontally across the map. 'x' expands up and down.
- Column: Spans vertically across the map. 'x' expands left and right.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.

Script Call Check:

$isTileEncounterNone(x, y)

- This can be used to check if a certain map tile (x, y) has an encounter
rate suppression effect on it.
- Returns a boolean (true or false) when used.
</pre>

---

<pre>
<Erase if Encounter Half>
<Erase if Encounter None>

- Used for: Event Notetags ONLY
- Automatically erase this event if the player's party has an encounter half
or encounter none effect, or if the event has spawned in an encounter half
or encounter none area.
- This check only occurs in two situations: when the map is first loaded
after being teleported into or when the player leaves a menu and returns
back to the map.
- Events that have been erased due to this effect will NOT return even if
the encounter half/none effect is removed while the player is still on the
map. The event will return if the player exits the map and comes back.
</pre>

---

<pre>
<Exit Reset Self Data>

- Used for: Event Notetags ONLY
- When the player leaves the current map, all Self Switches and Self
Variables related to this event will be reset.
</pre>

---

[[File:EventsMoveCoreHitbox_fixed.png|600px]]

<pre>
<Hitbox Left: x>
<Hitbox Right: x>
<Hitbox Up: x>
<Hitbox Down: x>

- Used for: Event Notetags and Event Page Comment Tags
- Replace 'x' with a number to extend the hitbox of the event by that many
tiles towards the listed direction.
- Use multiples of this notetag to extend them to different directions.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCoreIcon.png]]

<pre>
<Icon: x>

- Used for: Event Notetags and Event Page Comment Tags
- Replace 'x' with the Icon ID you wish to put above this event.
- This will not override any Icons designated to the ID through a
Plugin Command.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Icon Buffer X: +x>
<Icon Buffer X: -x>

<Icon Buffer Y: +x>
<Icon Buffer Y: -x>

<Icon Buffer: +x, +y>
<Icon Buffer: -x, -y>

- Used for: Event Notetags and Event Page Comment Tags
- Allows you to adjust the positions of the icon on the envent by buffers.
- Replace 'x' and 'y' with the values to adjust the position buffers by.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCoreLabel.png]]

<pre>
<Label: text>

- Used for: Event Notetags and Event Page Comment Tags
- Puts a label over the event's head displaying 'text'.
- Text codes can be used.
- If text codes are used, avoid text codes that use < and > wrappers.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Label>
text
text
</Label>

- Used for: Event Notetags and Event Page Comment Tags
- Puts a label over the event's head displaying 'text'.
- This can display multiple lines.
- Text codes can be used.
- You can use text codes with < and > wrappers.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Label Range: x>

- Used for: Event Notetags and Event Page Comment Tags
- Sets a range requirement for the player to be in order for the event's
label to appear.
- Replace 'x' with a number value depicting the range in tiles.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Label Range Type: Square>
<Label Range Type: Circle>
<Label Range Type: Diamond>

- Used for: Event Notetags and Event Page Comment Tags
- Sets a range type for the label to appear visible for.
- Square: A square-shaped range with the event at the center.
- Circle: A circle-shaped range with the event at the center.
- Diamond: A diamond-shaped range with the event at the center.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
- If this tag is not used, refer to the default plugin parameter settings.
</pre>

---

<pre>
<Label Offset X: +x>
<Label Offset X: -x>

<Label Offset Y: +x>
<Label Offset Y: -x>

<Label Offset: +x, +y>
<Label Offset: -x, -y>

- Used for: Event Notetags and Event Page Comment Tags
- Allows you to adjust the positions of the label on the envent by offsets.
- Replace 'x' and 'y' with the values to adjust the position offsets by.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCore_LabelHueShift.gif]]

<pre>
<Label Hue Shift: +x>
<Label Hue Shift: -x>

- Used for: Event Notetags and Event Page Comment Tags
- Changes the hue of the event label by +x or -x every frame.
- Keep in mind that since this is changing hue, this will appear to have
no effect if you are using black and white labels.
- Use labels with text codes that add color to them like '\C[4]text'
- This only works with the sprite version of event labels and does not work
with the legacy version.
</pre>

---

<pre>
<Location X: +x>
<Location X: -x>

<Location Y: +x>
<Location Y: -x>

<Location: +x, +y>
<Location: +x, -y>
<Location: -x, +y>
<Location: -x, -y>

- Used for: Event Notetags and Event Page Comment Tags
- Adjusts the initial location of this event by +x and +y (or -x and -y).
- This allows you to stack events on top of each other or even move them to
various places of the map.
- Replace 'x' with a number that represents the horizontal tiles to adjust
the initial starting location by.
- Replace 'y' with a number that represents the vertical tiles to adjust
the initial starting location by.
</pre>

---

[[File:EventsMoveCore_MirrorSprite.gif]]

<pre>
<Mirror Sprite>

- Used for: Event Notetags and Event Page Comment Tags
- The event sprite's visual appearance is mirrored.
</pre>

---

[[File:EventsMoveCoreMoveOnlyRegion.gif]]

<pre>
<Move Only Region: x>
<Move Only Regions: x,x,x>

- Used for: Event Notetags and Event Page Comment Tags
- Sets the move range of this event to only the region(s) marked by the
notetag(s) or comment tag(s).
- This will bypass terrain passability.
- This will not bypass event collision.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCoreMoveSynch.gif]]

<pre>
<Move Synch Target: Player>

<Move Synch Target: Event x>

- Used for: Event Notetags and Event Page Comment Tags
- Synchronizes the movement of this event with a target (either the player
or another event). This event will only move whenever the synchronized
target moves.
- For 'Event x' variant, replace 'x' with the ID of the event to synch to.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Move Synch Type: Random>
<Move Synch Type: Approach>
<Move Synch Type: Away>
<Move Synch Type: Custom>

<Move Synch Type: Mimic>
<Move Synch Type: Reverse Mimic>

<Move Synch Type: Mirror Horizontal>
<Move Synch Type: Mirror Vertical>

- Used for: Event Notetags and Event Page Comment Tags
- Choose the type of movement the event will have if it is synchronized to
a target.
- Random: Move to a random position.
- Approach: Approaches target.
- Away: Flees from target.
- Custom: Follows a custom move route.
- Mimic: Imitates the target's movement style.
- Reverse Mimic: Does the opposite of the target's movement.
- Mirror Horizontal: Moves as if a mirror is placed horizontally.
- Mirror Vertical: Moves as if a mirror is placed vertically.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Move Synch Delay: x>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is present, the event will wait a bit after each move before
moving again.
- Replace 'x' with the number of movement instances in between.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Move Synch Distance Opacity: x>

- Used for: Event Notetags and Event Page Comment Tags
- Changes the opacity of the event based on the distance between it and its
move synched target. Closer means more opaque. Further away means more
transparent.
- Replace 'x' with a number representing the opacity change per pixel
distance away. 'x' can use decimal values like 1.05 and 1.5.
</pre>

---

[[File:EventsMoveCore_EventPicture.gif]]

<pre>
<Picture Filename: filename>

- Used for: Event Notetags and Event Page Comment Tags
- Applies a picture graphic from the /img/pictures/ folder of your project.
- This graphic will be on top of the character sprite but below the event
icon sprite.
- The picture priority will be the same as the event's priority.
- If it is "below characters", the player can walk on top of it.
- If it is "above characters", the player will behind it.
- If it is "same as characters", the priority will be based on the
current relative Y position. This also means, if the picture is big
enough, it can clip into the top of tree tiles and such.
- Replace 'filename' with a filename from the game project's /img/pictures/
folder. This is case sensitive. Do NOT include the file extension.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Picture Type: Enemy>
<Picture Type: SV Enemy>

- Used for: Event Notetags and Event Page Comment Tags
- Used with <Picture Filename: filename> notetag.
- Will use /img/enemies/ or /img/sv_enemies/ instead of /img/pictures/ to
grab a picture graphic from.
- Other picture graphic sprite related notetags will apply as normal.
</pre>

---

[[File:EventsMoveCore_EventPicture.gif]]

<pre>
<Picture Max Size: x>
<Picture Scale: y%>

- Used for: Event Notetags and Event Page Comment Tags
- Used with <Picture Filename: filename> notetag.
- If the "Max Size" or "Scale" supplementary notetags are used, the picture
graphic will be scaled proportionally to fit either the exact pixel size
for "Max Size" or the "Scale" ratio.
- Both the "Max Size" and "Scale" notetags require the "Filename" notetag.
- Replace 'x' with a number value representing the exact pixel size for the
"Max Size" notetag.
- Replace 'y' with a number value representing the scale on which to shrink
or enlarge the picture. 100% is normal size. 50% is half size. 200% is
double size.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCore_EventPicture.gif]]

<pre>
<Picture Offset X: +x>
<Picture Offset X: -x>

<Picture Offset Y: +x>
<Picture Offset Y: -x>

<Picture Offset: +x, +y>
<Picture Offset: -x, -y>

- Used for: Event Notetags and Event Page Comment Tags
- Used with <Picture Filename: filename> notetag.
- Offsets the X and Y position of the event picture relative to the event
sprite's own position.
- Replace 'x' and 'y' with numbers indicating the offset in pixels.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCore_EventPicture.gif]]

<pre>
<Picture Wait Frames: x>

- Used for: Event Notetags and Event Page Comment Tags
- Used with <Picture Filename: filename> notetag.
- Requires VisuMZ_4_AnimatedPictures!
- "Wait Frames" is used with VisuMZ's Animated Pictures plugin. This
determines the delay inbetween frame changes.
- Replace 'x' with a number representing the amount of frames to wait
inbetween frame changes.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Playtest>

- Used for: Event Notetags.
- This does NOT work when it's in the Event Page Comment Tags.
- If this notetag is found in the event's notebox (NOT comments), then the
event will only appear during a playtest session. It will not appear in a
deployed game where the playtest flag is not on.
</pre>

---

[[File:EventsMovementCore_Update25_WeightedRandom.png|600px]]

<pre>
<Random Move Weight: x>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is used on an event with random-type autonomous movement, then
the event will stick closer to their home location (where they are located
upon spawning on the map). How close they stick to their home location
will depend on the weighted 'x' value.
- Replace 'x' with a number between 0 and 1. Numbers closer to 0 give the
event more freedom when moving randomly while numbers closer to 1 cause
the event to stick closer to their home position.
</pre>

---

<pre>
<True Random Move>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is used on an event with random-type autonomous movement, then
that event will ignore the effects of weighted randomized movement.
</pre>

---

<pre>
<Save Event Location>

- Used for: Event Notetags ONLY
- Saves the locations of the event on the map so that when you return to
that map at a later point, the event will be in the position it was
last in.
</pre>

---

[[File:EventsMoveCoreShadow.png]]

<pre>
<Hide Shadow>
- Used for: Event Notetags and Event Page Comment Tags
- Hides the shadow for the event.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCore_Update123_Preview.png]]

<pre>
<Scale: x%>

<Scale X: x%>
<Scale Y: y%>

- Used for: Event Notetags and Event Page Comment Tags
- Changes the scale of the sprite to the designated size.
- For <Scale: x%> variant: replace 'x' with a number representing the
scaling overall percentage to be used.
- For <Scale X: x%> variant, replace 'x' with a number representing the x
factor for the horizontal scaling percentage to be used.
- For <Scale Y: y%> variant, replace 'y' with a number representing the y
factor for the vertical scaling percentage to be used.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Shadow Filename: filename>

- Used for: Event Notetags and Event Page Comment Tags
- Replaces the shadow graphic used with 'filename' found in the
img/system/ project folder.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Sprite Offset X: +x>
<Sprite Offset X: -x>

<Sprite Offset Y: +x>
<Sprite Offset Y: -x>

<Sprite Offset: +x, +y>
<Sprite Offset: -x, -y>

- Used for: Event Notetags and Event Page Comment Tags
- Changes how much the event's sprite is visibly offset by.
- Replace 'x' and 'y' with numbers indicating the offset in pixels.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

<pre>
<Step Pattern: Left to Right>
<Step Pattern: Right to Left>

<Step Pattern: Spin Clockwise>
<Step Pattern: Spin CW>

<Step Pattern: Spin CounterClockwise>
<Step Pattern: Spin CCW>
<Step Pattern: Spin AntiClockwise>
<Step Pattern: Spin ACW>

- Used for: Event Notetags and Event Page Comment Tags
- Changes the way the event animates if a tag is present.
- Left to Right: Makes the event sprite's step behavior go from frame 0 to
1 to 2, then back to 0 instead of looping backward.
- Right to Left: Makes the event sprite's step behavior go from frame 2 to
1 to 0, then back to 2 instead of looping forward.
- Spin Clockwise: Makes the event sprite's step behavior spin CW.
- Spin CounterClockwise: Makes the event sprite's step behavior spin CCW.
- If this is placed in a notetag, the effect will be present across
all event pages used.
- If this is placed inside a page's comment, the effect will only occur
if that event page is currently active.
</pre>

---

[[File:EventsMoveCore_TileExpand.png|600px]]

<pre>
<Tile Expand Up: x>
<Tile Expand Down: x>
<Tile Expand Left: x>
<Tile Expand Right: x>

- Used for: Event Notetags and Event Page Comment Tags
- Used for events with tile graphics. Expands the graphic up, down, left, or
right from the spritesheet.
- This does NOT expand the hitbox.
- The graphic will be anchored to the tile it's expanded from. This means
even if you expanded downward, the actual event's position will still be
the current event's X/Y coordinates. It's just grown more vertically and
is still centered horizontally.
- This is primarily used to save on having to use too many events for tiles
that expanded past 1x1 tile sizes.
</pre>

---

Events and Movement Core VisuStella MZ

2026-05-17T08:43:52Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=DA8gr31HPLc</youtube>
|link1 = {{VisuStella Wave 1}}
|link2 = {{VisuStella All Waves Collection}}

}}



[[File:EventsMoveCoreVS8.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{ExtensionPluginsMZ}}
* [[Button Trigger Events VisuStella MZ]]
* [[Common Event Menu VisuStella MZ]]
* [[Event Signals VisuStella MZ]]
* [[Field Skills VisuStella MZ]]
* [[Furniture System VisuStella MZ]]
* [[Lighting Effects VisuStella MZ]]
* [[Movement Effects VisuStella MZ]]
* [[QTE and Trigger System VisuStella MZ]]
* [[Tile Grafter System VisuStella MZ]]

{{Visustella MZ}}

== Introduction ==

The Events & Movement Core plugin adds a lot of new functionality in terms
of event flexibility and movement options to RPG Maker MZ. These range from
adding in old capabilities from previous iterations of RPG Maker to more
mainstream techniques found in other game engines. Movement options are also
expanded to support 8-directional movement as well as sprite sheets provided
that the VisuStella 8 format is used.

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

* Event commands expanded upon to include old and new functions.
* Event templates for Copying Events, Morphing Events, and Spawning Events.
* 8-directional movement option available and sprite sheet support.
* Aesthetics for tilting the sprite when dashing and having shadows below.
* Pathfinding support for event movement through custom Move Route commands.
* Advanced switches and variable support to run code automatically.
* Turn regular Switches and Variables into Self Switches and Self Variables.
* Put labels and icons over events.
* Allow numerous ways to trigger events, through clicking, proximity, or by usage of Regions.
* Change the hitbox sizes of events to larger in any direction.
* Synchronize event movement options to move when player/other events move.
* The ability for the player to turn in place.

== Requirements ==

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

{{MZ Tier 1}}

== Features ==

=== Advanced Switches and Variables ===

[[File:EventsMoveCoreAdvSwitchesVariables.png|600px]]

Switches and variables can now run JavaScript code and return values
instantly. While at first glance, this may seem no different from using
the Control Variables event command's Script option, this can be used to
instantly set up Switch and/or Variable conditions for Parallel Common
Events, Event Page Conditions, Enemy Skill Conditions, and Troop Page
Conditions instantly without needing to make an event command to do so.

---

<pre>
<JS> code </JS>
- Used for: Switch and Variable names
- Replace 'code' with JavaScript code on what value to return.
</pre>

---

NOTE: Tagged Switches/Variables are mutually exclusive from one another.
You cannot tag them with <JS>, <Self>, or <Global> simultaneously.

---

=== Self Switches and Variables ===

[[File:EventsMoveCoreSelfSwitchesVariables.png|600px]]

RPG Maker MZ by default has 4 Self Switches: A, B, C, D. For some types of
games, this isn't enough. This plugin gives you the ability convert regular
Switches into Self Switches so you could have more.

Self Variables also do not exist in RPG Maker MZ by default. Just like with
Switches, you can turn regular Variables into Self Variables.

---

<pre>
<Self>
- Used for: Switch and Variable names
- Converts the Switch/Variable into a Self Switch/Variable.
</pre>

---

After, just use them like you would for normal Switches and Variables in an
event's page conditions. If the <Self> tag is present inside the Switch or
Variable's name, then it will use data unique to only that event.

NOTE: Tagged Switches/Variables are mutually exclusive from one another.
You cannot tag them with <JS>, <Self>, or <Global> simultaneously.

---

If you need to use a script call to get a Self Switch or Self Variable's
value, you can use the following script calls.

<pre>
Get Self Switch Values:

getSelfSwitchValue(mapID, eventID, switchID)
- Replace 'mapID' with the map ID the target event is located on.
- Replace 'eventID' with the ID of the target event.
- Replace 'switchID' with the ID number if it is a Self Switch made with
<Self> or a capital letter surrounded by quotes if it's A, B, C, or D.
- This will return the true/false value of the Self Switch.
- Example: getSelfSwitchValue(12, 34, 56)
- Example: getSelfSwitchValue(12, 34, 'B')
</pre>

<pre>
Get Self Variable Values:

getSelfVariableValue(mapID, eventID, variableID)
- Replace 'mapID' with the map ID the target event is located on.
- Replace 'eventID' with the ID of the target event.
- Replace 'variableID' with the ID number of the Self Variable.
- This will return whatever stored value is found in the Self Variable.
- Example: getSelfVariableValue(12, 34, 56)
</pre>

<pre>
Set Self Switch Values:

setSelfSwitchValue(mapID, eventID, switchID, value)
- Replace 'mapID' with the map ID the target event is located on.
- Replace 'eventID' with the ID of the target event.
- Replace 'switchID' with the ID number if it is a Self Switch made with
<Self> or a capital letter surrounded by quotes if it's A, B, C, or D.
- Replace 'value' with either 'true' or 'false' for ON/OFF respectively.
Do not use quotes.
- This will change the Self Switch's value to true/false.
- Example: setSelfSwitchValue(12, 34, 56, false)
- Example: setSelfSwitchValue(12, 34, 'B', true)
</pre>

<pre>
Set Self Variable Values:

setSelfVariableValue(mapID, eventID, variableID, value)
- Replace 'mapID' with the map ID the target event is located on.
- Replace 'eventID' with the ID of the target event.
- Replace 'variableID' with the ID number of the Self Variable.
- Replace 'value' with the value you want to set the Self Variable to.
- Example: setSelfVariableValue(12, 34, 56, 88888)
</pre>

---

=== Map Switches and Variables ===

[[File:EventsMovementCore_MapSwitches.png|600px]]

Similar to Self Switches and Self Variables, Map Switches and Map Variables
are switches and variables that retain data based on the map the player is
currently located in. In other words, they're self switches and variables
but for maps instead!

These features do not exist in RPG Maker MZ by default. Just like with the
Self Switches and Self Variables, you can turn regular Switches or Variables
into Map Switches and Map Variables using the following name tag:

---

<pre>
<Map>
- Used for: Switch and Variable names
- Converts the Switch/Variable into a Map Switch/Variable.
</pre>

---

After, just use them like you would for normal Switches and Variables in an
event's page conditions. If the <Map> tag is present inside the Switch or
Variable's name, then it will use data unique to only that map.

NOTE: Tagged Switches/Variables are mutually exclusive from one another.
You cannot tag them with <JS>, <Self>, <Map>, or <Global> simultaneously.

---

If you need to use a script call to get a Map Switch or Map Variable's
value, you can use the following script calls:

<pre>
---

Get Map Switch Values:

getMapSwitchValue(mapID, switchID)
- Replace 'mapID' with the map ID the switch is located on.
- Replace 'switchID' with the ID number of the switch to get data.
- Example: getMapSwitchValue(4, 20)

---

Get Variable Switch Values:

getMapVariableValue(mapID, variableID)
- Replace 'mapID' with the map ID the switch is located on.
- Replace 'variableID' with the ID number of the variable to get data.
- Example: getMapVariableValue(6, 9)

---

Set Map Switch Values:

setMapSwitchValue(mapID, switchID, value)
- Replace 'mapID' with the map ID the switch is located on.
- Replace 'switchID' with the ID number of the switch to get data.
- Replace 'value' with either 'true' or 'false' for ON/OFF respectively.
Do not use quotes.
- Example: setMapSwitchValue(4, 20, true)
- Example: setMapSwitchValue(6, 9, false)

---

Set Map Variable Values:

setMapVariableValue(mapID, variableID, value)
- Replace 'mapID' with the map ID the switch is located on.
- Replace 'variableID' with the ID number of the variable to get data.
- Replace 'value' with the value you want to set the Map Variable to.
- Example: setMapVariableValue(6, 9, 420)

---
</pre>

---

=== Reference Switches and Reference Variables ===

Reference Switches and Reference Variables are added in version 1.62 of this
plugin. These switches and variables allow you to reference them through
strings when using script calls.

By simply naming your switch or variable ((Reference Name)), you can use
that 'reference name' in a string to call them for script calls. This is
just so you don't need to remember the ID's of every other Switch/Variable.

When referencing the strings in the script calls, case does not matter,
which means you can use all capitals or all lower case and they'll still
reference the same switch or variable.

---

For example:

<pre>
---

Switch 10 Name: ((Priscilla Joined))

Script Call: $gameSwitches.value('Priscilla Joined')
$gameSwitches.setValue('Priscilla Joined', true)

---

Variable 20 Name: Total ((Goblins Slain))

Script Call: $gameVariables.value('Goblins Slain')
$gameVariables.setValue('Goblins Slain', 50)

---
</pre>

Remember to put quotes around the name for the script call!

This only applies for the $gameSwitches and $gameVariables functions of
value(id) and setValue(id, value). They do not apply to the other
$gameSwitches and $gameVariables functions.

---

=== Character Sprite Filename Tags ===

For the files located inside of your project's /img/characters/ folder, if
the filenames themselves have specific "tags" in them, special properties
will be applied to them. These tags can be combined together with a few
exceptions.

Some of these are new to VisuStella MZ, while others are default to MZ.

---

<pre>
!filename.png
- Tag: !
- Causes this character's sprite to align with the tile grid instead of
being lifted a few pixels higher.
- This is primarily used for things like doors, chests, and floor plates.
- Default to RPG Maker MZ.
</pre>

---

<pre>
$filename.png
- Tag: $
- Causes this character's sprite to use the "big character" format.
- Primarily used for sprites like the big monsters and such which only
have 3x4 cells as opposed to 12x8 cells that regular sprite sheets have.
- Cannot be combined with the [VS8] tag.
- Default to RPG Maker MZ.
</pre>

---

<pre>
filename[Invisible].png
- Tag: [Invisible] or [Inv]
- This character's sprite will become invisible on the map screen in-game
while almost everything else about it is visible.
- This is used for those who wish to use sprite labels for things such as
autorun and parallel events.
</pre>

---

<pre>
filename[VS8].png
- Tag: [VS8]
- Converts this sprite into a VisuStella-Style 8-Direction Sprite Sheet.
- Refer to the section below.
- Cannot be combined with the $ tag.
</pre>

---

=== VisuStella-Style 8-Directional Sprite Sheets ===

[[File:EventsMoveCoreVS8.gif]]

This plugin provides support for the VisuStella-Style 8-Directional Sprite
Sheets, also know as VS8. VS8 sprite sheets offer support for walking
frames, dashing frames, carrying frames, and emotes.

---

To designate a sprite sheet as VS8, simply add [VS8] to the filename.
Something like Actor1.png would become Actor1_[VS8].png.

---

VS8 sprites are formatted as such. Each block below is a set of 3 frames.

<pre>
Walk Down Walk DL Dash Down Dash DL
Walk Left Walk DR Dash Left Dash DR
Walk Right Walk UL Dash Right Dash UL
Walk Up Walk UR Dash Up Dash UR

Carry Down Carry DL Ladder Emotes 3
Carry Left Carry DR Rope Emotes 4
Carry Right Carry UL Emotes 1 Emotes 5
Carry Up Carry UR Emotes 2 Emotes 6
</pre>

'''Note:''' While jumping, the "carry" frame is used as most of the time, this is a sprite pose with arms up in the air where the "carried" icon is.

---

Here are how each of the emote sets are grouped from left to right.

<pre>
Emotes 1: Item, Hmph, Victory
Emotes 2: Hurt, Kneel, Collapse
Emotes 3: !, ?, Music Note
Emotes 4: Heart, Anger, Sweat
Emotes 5: Cobweb, ..., Light Bulb
Emotes 6: Sleep0, Sleep1, Sleep2
</pre>

---

=== Weighted Random Movement ===

[[File:EventsMovementCore_Update25_WeightedRandom.png|600px]]

When creating events to place on the map, you can determine what type of
autonomous movement the event will have. When selecting "Random", the event
will move randomly across the map.

However, with the way "Random" movement works with the RPG Maker MZ default
code, the event is more likely to hit a wall and then hug the said wall as
it maps laps around the map's outer borders making it feel very unnatural
for any player who's been on the map long enough.

This is where "Weighted Random Movement" comes in. It changes up the random
movement behavior to function where the farther the event is, the more
likely the event is to step back towards its "home" position (aka where it
spawned upon loading the map). This is so that a housewife NPC doesn't
suddenly wander off into the middle of an army's training grounds on the
same town map.

The event will stay closer to its home value depending on how high the
weight's value is. There are a number of ways to adjust the weighted value.

---

Plugin Parameters > Movement > Event Movement > Random Move Weight

This Plugin Parameter setting allows you to set the default weight for all
events with "Random" autonomous movement. It is set at a default value of
0.10 to give the event an understandable degree of freedom.

Lower numbers give events more freedom to move. Larger numbers will make the
events stick closer to home.

Change this value to 0 to disable it.

---

You can customize this individually per event by using Notetags and/or
Comment Tags for the events.

<pre>
<Random Move Weight: x>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is used on an event with random-type autonomous movement, then
the event will stick closer to their home location (where they are located
upon spawning on the map). How close they stick to their home location
will depend on the weighted 'x' value.
- Replace 'x' with a number between 0 and 1. Numbers closer to 0 give the
event more freedom when moving randomly while numbers closer to 1 cause
the event to stick closer to their home position.
</pre>

<pre>
<True Random Move>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is used on an event with random-type autonomous movement, then
that event will ignore the effects of weighted randomized movement.
</pre>

---

{{Notetags MZ}}

{{VisuMZ Events and Movement Core Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Events and Movement Core Plugin Commands}}

== Move Route Custom Commands ==

Some custom commands have been added to the "Set Movement Route" event
command. These can be accessed by pressing the "Script..." command and
typing in the following, which don't need to be in code form.

Keep in mind that since these are custom additions and RPG Maker MZ does not
allow plugins to modify the editor, the "Preview" button will not factor in
the effects of these commands.

If you wish to use a value from a variable, insert $gameVariables.value(x)
or \V[x] in place of the x in any of the below.

If you wish to use a value from a self variable, insert \SelfVar[x] in place
of the x in any of the below. This will only draw from the current event. If
you wish to draw data from outside event self variables, we recommend you
use the \V[x] variant after using the Plugin Commands to draw data from them
for the best accuracy.

---

<pre>
Animation: x
- Replace 'x' with the ID of the animation to play on moving unit.
</pre>

---

<pre>
Balloon: name
- Replace 'name' with any of the following to play a balloon on that the
target moving unit.
- '!', '?', 'Music Note', 'Heart', 'Anger', 'Sweat', 'Cobweb', 'Silence',
'Light Bulb', 'Sleep', 'User-Defined 1', 'User-Defined 2',
'User-Defined 3', 'User-Defined 4', 'User-Defined 5'
- Do NOT insert quotes.
- Examples:
- Balloon: !
- Balloon: Sleep
- Balloon: Heart
</pre>

---

<pre>
Fade In: x
Fade Out: x
- Fades in/out the sprite's opacity.
- Fade In will continuously raise the opacity level until it reaches 255.
- Fade Out will continuously lower the opacity level until it reaches 0.
- Replace 'x' with the speed to fade in/out the sprite.
</pre>

---

<pre>
Force Carry: On
Force Carry: Off
- For usage with the VS8 sprite sheet.
- Use ON to turn force carrying on.
- Use OFF to turn force carrying off.
- Sprites using the VS8 sprite sheet will also show the VS8 Carry frames.
</pre>

---

<pre>
Force Dash: On
Force Dash: Off
- Use ON to turn force dashing on.
- Use OFF to turn force dashing off.
- Forces dashing will prompt the player or event to be in the dashing state.
- Sprites using the VS8 sprite sheet will also show the VS8 Dashing frames.
</pre>

---

<pre>
Hug: Left
Hug: Right
- Causes the moving unit to hug the left/right side of the wall.
</pre>

---

<pre>
Index: x
- Replace 'x' with a number depicting the character index to change the
moving unit's sprite to.
</pre>

---

<pre>
Index: +x
Index: -x
- Replace 'x' with the value to change the character index of the moving
unit's sprite by.
</pre>

---

<pre>
Jump Forward: x
- Replace 'x' with the number of tiles for the unit to jump forward by.
</pre>

---

<pre>
Jump To: x, y
- Replace 'x' and 'y' with the coordinates for the unit to jump to.
</pre>

---

<pre>
Jump to Event: x
- Replace 'x' with the ID of the event for the unit to jump to.
</pre>

---

<pre>
Jump to Player
- Causes the moving unit to jump to the player.
</pre>

---

<pre>
Jump To Home
- Causes the event to jump to its home position.
- This only works on events, not player characters or followers.
</pre>

---

<pre>
Move Lower Left Until Stop
Move Down Until Stop
Move Lower Right Until Stop
Move Left Until Stop
Move Right Until Stop
Move Upper Left Until Stop
Move Up Until Stop
Move Upper Right Until Stop
- Causes the moving unit to move that direction until it hits a stop.
- Events will stop moving before they make contact with the player.
</pre>

---

<pre>
Crash Move Lower Left Until Stop
Crash Move Down Until Stop
Crash Move Lower Right Until Stop
Crash Move Left Until Stop
Crash Move Right Until Stop
Crash Move Upper Left Until Stop
Crash Move Up Until Stop
Crash Move Upper Right Until Stop
- Causes the moving unit to move that direction until it hits a stop.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move To: x, y
- Replace 'x' and 'y' with the map coordinates to move the unit to through
pathfinding.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events will go around the player.
</pre>

---

<pre>
Crash Move To: x, y
- Replace 'x' and 'y' with the map coordinates to move the unit to through
pathfinding.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move to Event: x
- Replace 'x' with the ID of the event to move the unit to.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events will go around the player.
</pre>

---

<pre>
Crash Move to Event: x
- Replace 'x' with the ID of the event to move the unit to.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move to Player
- Moves the unit to the player.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move to Home
- Moves the unit towards their home position on the map.
- This only works on events, not player characters or followers.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Crash Move to Home
- Moves the unit towards their home position on the map.
- This only works on events, not player characters or followers.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move Lower Left: x
Move Down: x
Move Lower Right: x
Move Left: x
Move Right: x
Move Upper Left: x
Move Up: x
Move Upper Right: x
- Replace 'x' with the number of times to move the unit by in the designated
direction on the map.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Opacity: x%
- Replace 'x' with the percentage to change the unit's sprite opacity to.
</pre>

---

<pre>
Opacity: +x
Opacity: -x
- Replace 'x' with the increment to change the unit's sprite opacity by.
</pre>

---

<pre>
Pattern Lock: x
- Replace 'x' with the step pattern to lock the unit's sprite to.
</pre>

---

<pre>
Pattern Unlock
- Removes pattern lock effect.
</pre>

---

<pre>
Pose: name
- If using a VS8 sprite, this will cause the unit to strike a pose.
- Replace 'name' with any the following:
- 'Item', 'Hmph', 'Victory', 'Hurt', 'Kneel', 'Collapse',
'!', '?', 'Music Note', 'Heart', 'Anger', 'Sweat', 'Cobweb', 'Silence',
'Light Bulb', 'Sleep'
- Do NOT insert quotes.
- Examples:
- Balloon: Item
- Balloon: Victory
- Balloon: ?
</pre>

---

<pre>
Step Toward: x, y
- Replace 'x' and 'y' for the desired coordinates for the unit to take one
step towards.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Toward Event: x
- Replace 'x' with the ID of the event for the unit to take one step to.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Toward Player
- Causes event to take one step towards the player.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Toward Home
- Causes the event to take one step towards its home position.
- This only works on events, not player characters or followers.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Away From: x, y
- Replace 'x' and 'y' for the desired coordinates for the unit to take one
step away from.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Away From Event: x
- Replace 'x' with the ID of the event for the unit to take one step from.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Away From Player
- Causes event to take one step away from the player.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Turn To: x, y
- Replace 'x' and 'y' for the coordinates to make the unit face towards.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn to Event: x
- Replace 'x' with the ID of the event to turn the unit towards.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn to Player
- Causes the unit to turn towards the player.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn to Home
- Causes the event to turn towards its home position.
- This refers to the original position's X/Y on the map.
- The event will turn and face the tile that is its original X/Y location.
- This only works on events, not player characters or followers.
</pre>

---

<pre>
Step Away From Home
- Causes the event to take one step away from its home position.
- This only works on events, not player characters or followers.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Turn Away From: x, y
- Replace 'x' and 'y' for the coordinates to make the unit face away from.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn Away From Event: x
- Replace 'x' with the ID of the event to turn the unit away from.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn Away From Player
- Causes the unit to turn away from the player.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn Away From Home
- Causes the event to turn away from its home position.
- This only works on events, not player characters or followers.
</pre>

---

<pre>
Turn Lower Left
Turn Lower Right
Turn Upper Left
Turn Upper Right
- Causes the unit to turn to one of the diagonal directions.
</pre>

---

<pre>
Self Switch x: On
Self Switch x: Off
Self Switch x: Toggle
- Replace 'x' with 'A', 'B', 'C', 'D', or a <Self> Switch ID to adjust the
unit's self switch.
</pre>

---

<pre>
Self Variable x: y
- Replace 'x' with a <Self> Variable ID to adjust the unit's self variable.
- Replace 'y' with a number value to set the self variable to.
</pre>

---

<pre>
Teleport To: x, y
- Replace 'x' and 'y' with the coordinates to instantly move the unit to.
</pre>

---

<pre>
Teleport to Event: x
- Replace 'x' with the ID of the event to instantly move the unit to.
</pre>

---

<pre>
Teleport to Player
- Instantly moves the unit to the player's location.
</pre>

---

<pre>
Teleport to Home
- Instantly teleports an event to its home position on the map.
- This only works on events, not player characters or followers.
</pre>

---

<pre>
If none of the commands are detected above, then a script call will be ran.
</pre>

---

== Plugin Parameters ==

=== Event Label Settings ===

[[File:EventsMoveCoreLabel.png]]

[[File:EventsMoveCoreParams01.png]]

Event Labels are small windows created to display text over an event's head.
They're set up using the <Label> notetags and/or comment tags. Event Labels
are a great way to instantly relay information about the event's role to
the player.

---

<pre>
Event Labels

Sprite Based?:
- Use sprite-based labels instead of legacy-window version.
- Legacy-window version will not be supported in future.
- Sprite-based labels are more memory efficient and work better
compatibility-wise.

Mobile-Enabled?:
- Enable event labels for mobile devices?

Font Size:
- The font size used for the Event Labels.

Icon Size:
- The size of the icons used in the Event Labels.

Line Height:
- The line height used for the Event Labels.

Offset X:
- Globally offset all labels horizontally by this amount.

Offset Y:
- Globally offset all labels vertically by this amount.

Fade Speed:
- Fade speed for labels.

Visible Range:
- Range the player has to be within the event to make its label visible.

Range Type:
- What do you want the default label visible range type?
- Square
- Diamond
- Circle
</pre>

---

=== Event Icon Settings ===

[[File:EventsMoveCoreIcon.png]]

[[File:EventsMoveCoreParams02.png]]

Icons can be displayed over an event's head through the <Icon> notetags
and/or comment tags. These can be used for a variety of things such as
making them look like they're carrying an item or to indicate they have a
specific role.

---

<pre>
Event Icon

Buffer X:
- Default X position buffer for event icons.

Buffer Y:
- Default Y position buffer for event icons.

Blend Mode:
- Default blend mode for even icons.
- 0 - Normal
- 1 - Additive
- 2 - Multiply
- 3 - Screen
</pre>

---

=== Event Template Settings ===

[[File:EventsMoveCoreParams03.png]]

Event Templates allow you to store specific maps and/or event data to bring
out on need while having a premade set base. They're similar to prefabs but
aren't things that can be altered individually as one setting for an event
template will serve as a blueprint for all of them that use them.

Event Templates are used for the <Copy Event> notetags, the Morph Event and
Spawn Event Plugin Commands.

---

<pre>
Settings

Preloaded Maps:
- A list of all the ID's of the maps that will be preloaded to serve as
template maps for this plugin.
</pre>

---

<pre>
Templates
- A list of all the Event Templates used by this project. Used for notetags
and Plugin Commands.

Name:
- Name of the template. It'll be used as anchor points for notetags and
Plugin Commands.

Map ID:
- ID of the map the template event is stored on.
- This will automatically add this ID to preloaded list.

Event ID:
- ID of the event the template event is based on.

JavaScript:
JS: Pre-Copy:
JS: Post-Copy:
JS: Pre-Morph:
JS: Post-Morph:
JS: Pre-Spawn:
JS: Post-Spawn:
- Code that's ran during certain circumstances.
- The code will occur at the same time as the ones listed in the main
Event Template Settings Plugin Parameters. However, the ones listed
in these individual entries will only occur for these specific
templates and only if the templates are used.
</pre>

---

<pre>
JavaScript

JS: Pre-Copy:
JS: Post-Copy:
JS: Pre-Morph:
JS: Post-Morph:
JS: Pre-Spawn:
JS: Post-Spawn:
- Code that's ran during certain circumstances.
- These are global and are ran for all copies, morphs, and/or spawns.
</pre>

---

=== Movement Settings ===

[[File:EventsMoveCoreVS8.gif]]

[[File:EventsMoveCoreParams04.png]]

These plugin parameters allow you to control how movement works in your
game, toggling it from 4-directional to 8-directional, setting up rules to
stop self-movement from events while an event or message is present, and
other aesthetics such as tilting the sprite while dashing, setting shadows
beneath the sprites, and allow for turning in place.

⚠️⚠️⚠️Shadows do NOT appear for sprites using a "!" as their leading filename
marker. These sprites are environmental and are considered "object"
characters by the RPG Maker MZ core scripts. They do not utilize character
shadows due.

---

<pre>
8 Directional Movement

Enable:
- Allow 8-directional movement by default? Players can move diagonally.

Strict Collision:
- Enforce strict collission rules where the player must be able to pass
both cardinal directions?

Favor Horizontal:
- Favor horizontal if cannot pass diagonally but can pass both
horizontally and vertically?

Slower Diagonals?
- Enforce a slower movement speed when moving diagonally?

Speed Multiplier
- What's the multiplier to adjust movement speed when moving diagonally?
</pre>

---

<pre>
Automatic Movement

Stop During Events:
- Stop automatic event movement while events are running.

Stop During Messages:
- Stop automatic event movement while a message is running.
</pre>

---

<pre>
Bitmap

Smoothing:
- Do you want to smooth or pixelate the map sprites?
- Pixelating them is better for zooming and tilting.
</pre>

---

<pre>
Dash

Dash Modifier:
- Alters the dash speed modifier.

Dash on Ladder?
- Allow dashing while on a ladder or rope?

Enable Dash Tilt?:
- Tilt any sprites that are currently dashing?

Tilt Left Amount:
- Amount in radians when moving left (upper left, left, lower left).

Tilt Right Amount:
- Amount in radians when moving right (upper right, right, lower right).

Tilt Vertical Amount:
- Amount in radians when moving vertical (up, down).
</pre>

---

[[File:EventsMovementCore_Update25_WeightedRandom.png|600px]]

<pre>
Event Movement

Random Move Weight:
- Use numbers between 0 and 1.
- Numbers closer to 1 stay closer to their home position.
- 0 to disable it.

Shift Y:
- How many pixels should non-tile characters be shifted by?
- Negative: up. Positive: down.
</pre>

---

Path Finding

Mobile-Enabled?:
- Enable diagonal pathfinding for mobile devices?

---

[[File:EventsMoveCoreShadow.png]]

<pre>
Shadows

Show:
- Show shadows on all events and player-related sprites.

Default Filename:
- Default filename used for shadows found in img/system/ folder.

Shadow Z Layer:
- What is the sprite Z layer used for the shadow sprites?
- In-game layers are as follows:
- 0 : Lower tiles
- 1 : Lower characters
- 3 : Normal characters
- 4 : Upper tiles
- 5 : Upper characters
- 6 : Airship shadow
- 7 : Balloon
- 8 : Animation
- 9 : Destination
</pre>

---

<pre>
Turn in Place

Enable:
- When not dashing, player will turn in place before moving.
- This only applies with keyboard inputs.

Delay in Frames:
- The number of frames to wait before moving.
</pre>

---

<pre>
Vehicle Speeds

Boat Speed:
- Allows you to adjust the base speed of the boat vehicle.

Ship Speed:
- Allows you to adjust the base speed of the ship vehicle.

Airship Speed:
- Allows you to adjust the base speed of the airship vehicle.
</pre>

---

=== VisuStella 8-Dir Settings ===

[[File:EventsMoveCoreVS8.gif]]

[[File:EventsMoveCoreParams05.png]]

These are settings for sprite sheets using the VS8 format.
For more information on the VS8 format, look in the help section above.

---

<pre>
Balloon Icon Settings

Auto-Balloon Poses:
- Automatically pose VS8 sprites when using balloon icons.

Balloon Offset X:
- Offset balloon icons on VS8 sprites by x pixels.

Balloon Offset Y:
- Offset balloon icons on VS8 sprites by y pixels.
</pre>

---

[[File:EventsMoveCoreIcon.png]]

<pre>
Icons

Auto Buffer:
- Automatically buffer the X and Y coordinates of VS8 sprites?

Use Carry Pose:
- Use the carry pose when moving with an icon overhead.
</pre>

---

=== Region Rulings ===

[[File:EventMoveCoreRegions.png]]

[[File:EventsMoveCoreParams06.png]]

These settings allow you to decide the passability of the player, events,
and various vehicles through the usage of Regions.

---

<pre>
Allow Regions

All Allow:
Walk Allow:
Player Allow:
Event Allow:
Vehicle Allow:
Boat Allow:
Ship Allow:
Airship Allow:
- Insert Region ID's where the affected unit type can enter.
- Region ID's range from 0 to 255.
</pre>

---

<pre>
Forbid Regions

All Forbid:
Walk Forbid:
Player Forbid:
Event Forbid:
Vehicle Forbid:
Boat Forbid:
Ship Forbid:
Airship Forbid:
- Insert Region ID's where the affected unit type cannot enter.
- Region ID's range from 0 to 255.
</pre>

---

<pre>
Dock Regions

Vehicle Dock:
Boat Dock:
Ship Dock:
Airship Dock:
- Insert Region ID's where the affected vehicle can dock
- Region ID's range from 0 to 255.

Only Region Dockable:
- Vehicles are only able to dock at designated regions.
</pre>

---

=== Common Event on OK Button ===

[[File:EventsMoveCoreParams07.png]]

These Plugin Parameters allow you to setup Common Events that activate using
Regions when pressing the OK button while standing on top of them or in
front of them. These let you create near universally interactable objects
using Regions, such as rivers to start up fishing events or locations to
places items on.

---

<pre>
Regions

Regions 1 - 255:
- Which Common Event does this region activate?
- Use 0 to not activate any Common Events.
</pre>

---

[[File:EventsMoveCoreParams07a.png]]

<pre>
Target Tile

Target Tile:
- Which tile should be checked for Common Event on OK Button?
- Tile in front of player.
- Tile player is standing on top of.
</pre>

---

=== Common Event on Touch ===

[[File:EventsMoveCoreParams08.png]]

These Plugin Parameters allow you to setup Common Events that trigger when
stepping onto Region-marked tiles. These let you create custom effects that
will occur such as customized damage floors, traps, and/or events.

Areas marked with these regions will not allow random encounters to occur.
This is how RPG Maker works. Assuming you are not using plugins at all, by
putting on touch events all over the map, tiles with those on touch events
will not let random encounters trigger.

---

<pre>
Regions

Regions 1 - 255:
- Which Common Event does this region activate?
- Use 0 to not activate any Common Events.
</pre>

---

=== Terrain Tag Settings ===

[[File:EventsMoveCoreParams09.png]]

Terrain Tags are used in Database => Tilesets to mark certain tiles and
give them unique properties through terrain tags.

---

<pre>
Terrain Tag ID's

Rope:
- Which terrain tag number to use for ropes?
</pre>

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.65: May 18, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New JavaScript notetags added by Arisu:
*** <nowiki><JS On Map Load></nowiki>
**** Replace 'code' with JavaScript code to run the moment the map finishes loading and before fading in.
*** <nowiki><JS On Map Exit></nowiki>
**** Replace 'code' with JavaScript code to run the moment the player transfers to a different map and the screen completely fades out.

Version 1.64: March 16, 2026
* Bug Fixes!
** Click + hold movement no longer crashes when moving over events without any active pages. Fix made by Arisu.

Version 1.63: February 16, 2026
* Feature Update!
** When moving by clicking and holding down the mouse button, the touch input will no longer lock onto any events with empty event lists or populated by just comments. Update made by Arisu.

Version 1.62: January 19, 2026
* Documentation Update!
** Help file updated for new features.
** New section added: Reference Switches and Reference Variables

Version 1.61: December 15, 2025
* Bug Fixes!
** Fixed a bug where shadows would appear under lower-priority event sprites making usage of certain tiles awkward looking. This is corrected by the new Plugin Parameter. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Parameters > Movement Settings > Shadows > Shadow Z Layer
**** What is the sprite Z layer used for the shadow sprites?
**** By default, this layer will now be 0.5 instead of 0.
* Feature Update!
** If a event is made whose priority is "Below characters" and is a tile object (ie taking a sprite from the map tileset or a character sprite with "!" in front of the name), it will be automatically regulated to a custom Z layer of 0.

Version 1.60: August 29, 2024
* Bug Fixes!
** Fixed a bug where events with large hitboxes do not work with crash move. Fix made by Arisu.
** Fixed a bug where single-mode save games by Save Core would freeze after executed event movements. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Event Labels will adjust their vertical position to the picture of any attached event picture if one is present. Update by Arisu.
* New Features!
** New Notetags added by Arisu:
*** <Picture Type: Enemy>
*** <Picture Type: SV Enemy>
**** Will use /img/enemies/ or /img/sv_enemies/ instead of /img/pictures/ to grab a picture graphic from.
**** Other picture graphic sprite related notetags will apply as normal.
*** <Label Range Type: Square>
*** <Label Range Type: Circle>
*** <Label Range Type: Diamond>
**** Sets a range type for the label to appear visible for.
** New Plugin Parameters added by Arisu:
*** Parameters > Event Label Settings > Visible Range > Range Type:
**** What do you want the default label visible range type?

Version 1.59: June 13, 2024
* Bug Fixes!
** Added a cache check for character sprite tag names to reduce frame drops. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Arisu:
*** <Location X: +x>, <Location X: -x>
*** <Location Y: +y>, <Location Y: -y>
*** <Location: +x, +y>, <Location: +x, -y>
*** <Location: -x, +y>, <Location: -x, -y>
**** Adjusts the initial location of this event by +x and +y (or -x and -y).
**** This allows you to stack events on top of each other or even move them to various places of the map.
*** <Tile Expand Up: x>
*** <Tile Expand Down: x>
*** <Tile Expand Left: x>
*** <Tile Expand Right: x>
**** Used for events with tile graphics. Expands the graphic up, down, left, or right from the spritesheet.
**** This does NOT expand the hitbox.
**** The graphic will be anchored to the tile it's expanded from. This means even if you expanded downward, the actual event's position will still be the current event's X/Y coordinates. It's just grown more vertically and is still centered horizontally.
**** This is primarily used to save on having to use too many events for tiles that expanded past 1x1 tile sizes.

Version 1.58: May 16, 2024
* Documentation Update!
** Added "Features: Character Sprite Filename Tags" section.
* New Features!
** [Invisible] tag added to character sprite filenames.
*** If a character sprite's filename has [invisible] in it, it will become invisible on the map screen in-game while almost everything else about it is visible. This is used for those who wish to use sprite labels for things such as autorun and parallel events.

Version 1.57: March 14, 2024
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Plugin Command: "Event Icon: Delete" will now keep an event icon cleared until the newly added Plugin Command: "Event Icon: Restore" is used. Update made by Arisu.
** Plugin Command: "Event Icon: Change" is now renamed to have "(Temporary)" after its name in order to clarify the temporary changes made to it.
* New Features!
** New Plugin Command added by Arisu:
*** Event Icon: Event Icon: Change (Forced)
**** Change the icon that appears on an event.
**** This change is forced and needs to be restored.
*** Event Icon: Restore
**** Restores a deleted or forced icon that appears on an event.

Version 1.56: February 15, 2024
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Added fail safes for activation proximity notetags when loaded from past save files without Events and Movement Core installed. Added by Arisu.
* New Features!
** New notetags added by Arisu:
*** <Encounter Half Square: x>
*** <Encounter Half Circle: x>
*** <Encounter Half Delta: x>
*** <Encounter Half Row: x>
*** <Encounter Half Column: x>
*** <Encounter None Square: x>
*** <Encounter None Circle: x>
*** <Encounter None Delta: x>
*** <Encounter None Row: x>
*** <Encounter None Column: x>
**** If the player is within the 'x' area effect of this event, the random encounter rate will be halved or suppressed completely depending on the notetag used.
**** These include script call checks.
*** <Erase if Encounter Half>
*** <Erase if Encounter None>
**** Automatically erase this event if the player's party has an encounter half or encounter none effect, or if the event has spawned in an encounter half or encounter none area.
**** This check only occurs in two situations: when the map is first loaded after being teleported into or when the player leaves a menu and returns back to the map.
**** Events that have been erased due to this effect will NOT return even if the encounter half/none effect is removed while the player is still on the map. The event will return if the player exits the map and comes back.

Version 1.55: December 14, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Commands added by Arisu:
*** Event Popup: Player
*** Event Popup: Follower
*** Event Popup: Event
*** Event Popup: Target Tile
**** Makes a centered event popup on the player sprite, target follower sprite, target event sprite, or target tile.
**** All of these new Plugin Commands require VisuMZ_1_MessageCore and cannot be used in battle.

Version 1.54: October 12, 2023
* Documentation Update!
** Help file updated for new features.
** Help file updated to reduce confusion:
*** Call Event: Remote Read
**** This will run the page of the target event on the current event.
**** This means that any "This Event" commands will be applied to the event using this Plugin Command and NOT the target event that page data is being retrieved from.
**** Think of it as the current event using the target called event as a Common Event ala how RPG Maker 2003 works (for those familiar with it).
* Feature Update!
** Renamed "Call Event: Remote Activation" to "Call Event: Remote Read" to reduce confusion.
* Feature Update!
** <Activation Radius: x> notetag is now defined as <Activation Delta: x>
*** 'Radius' variant will still work and function as 'Delta' but will no longer be listed in the help file as 'Radius'
*** This is changed to avoid confusion with the new notetag.
* New Features!
** New notetag added by Arisu and sponsored by AndyL:
*** <Activation Circle: x>
**** A circle-shaped range with the event at the center.
**** 'x' represents the distance from the center.

Version 1.53: August 17, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** <Map Load Common Event: x>
** <Map Load Common Events: x, x, x>
*** When this map is loaded, run the specified Common Events once available.
**** Does NOT trigger if you transfer to a different part of the same map.

Version 1.52: July 13, 2023
* Documentation Update!
** Help file updated for new features.
** Updated help file for <Label: text> notetags:
*** If text codes are used, avoid text codes that use < and > wrappers.
** Updated help file for <Label> sandwich notetags:
*** You can use text codes with < and > wrappers.
* Feature Update!
** Event labels now work properly with scaling sprites.
* New Features!
** New notetag added by Arisu and sponsored by Anon:
*** <Label Hue Shift: +x>
*** <Label Hue Shift: -x>
**** Changes the hue of the event label by +x or -x every frame.
**** Keep in mind that since this is changing hue, this will appear to have no effect if you are using black and white labels.
**** Use labels with text codes that add color to them like '\C[4]text'
**** This only works with the sprite version of event labels and does not work with the legacy version.

Version 1.51: June 15, 2023
* Bug Fixes!
** Provided a fail safe for plugins using the scaling options from this plugin but do not have scaling parameters identified. The scaling ratio should now default to 1.0. Fix made by Olivia.
* Feature Update!
** Diagonal pathfinding is now improved as to not get stuck on tight corners on the map. Feature update made by Arisu.

Version 1.50: April 13, 2023
* Bug Fixes!
** <Icon: x> should now update correctly when changing pages through self switches or other event conditions. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Event Labels > Mobile-Enabled?
*** Plugin Parameters > Movement > Pathfinding > Mobile-Enabled?
**** These settings allow you to enable or disable certain features when played on mobile devices for better performance.

Version 1.49: March 16, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Event Notetag and Comment Tags added by Arisu:
*** <Scale: x%>
*** <Scale X: x%>
*** <Scale Y: y%>
**** Changes the scale of the sprite to the designated size.

Version 1.48: January 20, 2023
* Feature Update!
** <Move Synch> for certain types will also copy facing directions even if there are no tile movements (ie changing directions when pressed up against and obstacle). Update made by Arisu.

Version 1.47: November 10, 2022
* Feature Update!
** If "Follower: Set Global Chase" is set to false, followers will no longer jump towards the player location when the player jumps. This does NOT apply to gather or location changing players. Followers will still have to synchronize their positions there regardless in order to maintain consistency. Update made by Olivia.

Version 1.46: September 29, 2022
* Bug Fixes!
** Altered the self switch auto-reset timing to reduce errors. Fix by Arisu.
* Feature Update!
** Added self-movement prevention whenever scenes are deactivated. Update made by Arisu.

Version 1.45: August 18, 2022
* Bug Fixes!
** Fixed a bug that caused event labels with variables from refreshing properly. Fix made by Arisu.

Version 1.44: July 21, 2022
* Bug Fixes!
** Fixed a problem that caused <Exit Reset Self Data> notetag to not work. Fix made by Arisu.
* Feature Update!
** Diagonal pathfinding is now disabled when there are too many events on a map, causing extra collission checks. This value is set to 100 for the time being until we can figure out a better way to calculate diagonal pathfinding. Update made by Irina.

Version 1.43: July 14, 2022
* Bug Fixes!
** Move to Player for events should no longer cause hang ups. Fix by Olivia.
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Added caching function for pathfinding when using touch movement for a smoother experience. When touch movement is held down, pathfinding will utilize the non-diagonal function for less resource consumption to prevent FPS frame drops. Update made by Arisu.
* New Features!
** New notetag added by Arisu:
*** <Playtest>
**** If this notetag is found in the event's notebox (NOT comments), then the event will only appear during a playtest session. It will not appear in a deployed game where the playtest flag is not on.

Version 1.42: June 23, 2022
* Documentation Update!
** Help file updated for new features.
** Added to <Copy Event: x, y> notetag help:
*** - If '0' is used for the Map ID, reference the current map.
* Feature Update!
** Default MZ behavior would have "below characters" trigger events with only comments lock out facing "same as characters" trigger events. This is now bypassed. Update made by Arisu.
** The <Copy Event: mapID, eventID> notetags now allow usage of '0' for the mapID to reference the current map. Update made by Arisu.
** <Save Event Location> should now work more efficiently. Update by Arisu.
** Dashing animations for followers will no longer look weird after having gathered up and then proceeding to dash. Update made by Irina.
* New Features!
** New event notetag added by Arisu:
*** <Exit Reset Self Data>
**** When the player leaves the current map, all Self Switches and Self Variables related to this event will be reset.
** New Plugin Command added by Arisu and sponsored by Anon:
*** Self Data: Reset All
**** Reset the Self Switch and Self Variable data of all events within the specified map.
** New Plugin Parameter added by Arisu and sponsored by Anon:
*** Plugin Params > Movement Settings > Dash > Dash on Ladder?
**** Allow dashing while on a ladder or rope?

Version 1.41: June 1, 2022
* Bug Fixes!
** Parallel Process Common Events above 1000 should no longer crash the game. Bug fixed by Irina.

Version 1.39: May 5, 2022
* Bug Fixes!
** Save event location should now work properly with Set Event Location command. Fix made by Arisu.
** Sprite Event Labels with distance properties will no longer be visible when constantly entering/exiting the Main Menu. Fix made by Arisu.

Version 1.38: April 28, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu and sponsored by Archeia:
*** Plugin Parameters > Movement Settings > Event Movement > Shift Y
**** How many pixels should non-tile characters be shifted by?
** New Notetags added by Arisu and sponsored by Archeia:
*** <Picture Filename: filename>
**** applies a picture graphic from the /img/pictures/ folder of your game project.
**** This graphic will be on top of the character sprite but below the event icon sprite.
**** The picture priority will be the same as the event's priority. If it is "below characters", the player can walk on top of it. If it is "above characters", the player will behind it. If it is "same as characters", the priority will be based on the current relative Y position.
*** <Picture Max Size: x>
*** <Picture Scale: y%>
**** If the "Max Size" or "Scale" supplementary notetags are used, the picture graphic will be scaled proportionally to fit either the exact pixel size for "Max Size" or the "Scale" ratio.
*** <Picture Offset: +x, +y>
*** <Picture Offset: -x, -y>
**** Offsets the X and Y position of the event picture relative to the event sprite's own position.
*** <Picture Wait Frames: x>
**** Requires VisuMZ_4_AnimatedPictures! "Wait Frames" is used with VisuMZ's Animated Pictures plugin. This determines the delay inbetween frame changes.

Version 1.37: March 24, 2022
* Documentation Update!
** Added extra clarity to "Turn to Home" Movement Command.
*** This refers to the original position's X/Y on the map.
*** The event will turn and face the tile that is its original X/Y location.

Version 1.36: March 17, 2022
* Bug Fixes!
** "Turn To Home" movement command now properly faces the home position. Fix made by Irina.
* Feature Update!
** Plugin Commands now have separators for easier selection.

Version 1.35: March 3, 2022
* IMPORTANT! Compatibility Update!
** Compatibility Update with RPG Maker MZ 1.4.4.
*** For some reason this update broke any saves made before 1.4.4 was updated and they cannot be loaded. The only way saves would load is if you made a safe after 1.4.4 was done. This should be fixed and saves made with 1.4.3 and before should now be working. Update made by Irina.

Version 1.34: February 17, 2022
* Documentation Update!
** Help file updated for new features.
* Optimization Update!
** Plugin should run more optimized.
* New Features!
** Arisu has created new event notetag/comment tags:
*** <Custom Z: x>
**** Replace 'x' with a number value to determine the event sprite's Z value relative to the tilemap.
**** View the helpfile for more information.
*** <Mirror Sprite>
**** The event sprite's visual appearance is mirrored.
*** <Move Synch Distance Opacity: x>
**** Changes the opacity of the event based on the distance between it and its move synched target. Closer means more opaque. Further away means more transparent.
** Irina has created a more memory efficient version of Event Labels.
*** Plugin Parameters > Event Label Settings > Sprite Based?
**** Use sprite-based labels instead of legacy-window version.
**** Legacy-window version will not be supported in future.

Version 1.33: February 3, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Notetags added by Arisu!
*** <Hide Player>
*** <Show Player>
**** Map Notetag. Forcefully hides or shows the player sprite. This is so you don't need to manually turn the setting on/off each time you enter a specific map.
*** <Hide Followers>
*** <Show Followers>
**** Map Notetag. Forcefully hides or shows the player's followers. This is so you don't need to manually turn them on/off each time you enter a specific map.

Version 1.32: January 20, 2022
* Bug Fixes!
** Self Variable changes from custom move routes should no longer cause crashes. Fix made by Arisu.
** Self Switch custom move route toggles should now work properly. Fix made by Arisu.
* Feature Update!
** Better shadow tracking algorithm to remove any shadow twitching. Update made by Yanfly.

Version 1.31: January 6, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.30: November 25, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** Map Switches and Map Variables added by Arisu:
*** Map Switches are self-switches for maps. Instead of using <Self>, use <Map> in the Switch name to designate it as a Map Switch. The ON/OFF data for that Switch will vary depending on the map the player is currently on.
*** Map Variables are self-variables for maps. Instead of using <Self>, use <Map> in the Variable name to designate it as a Map Switch. The number data for that Variable will vary depending on the map the player is currently on.
*** Script Calls have been added for these features as well.
**** See help file for them.

Version 1.29: October 7, 2021
* Bug Fixes!
** Same map event spawning should now work properly without the need to add the current map ID to the preloaded map array. Update made by Arisu.

Version 1.28: September 30, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New move route commands added by Arisu:
*** Jump to Home
*** Move to Home
*** Crash Move to Home
*** Step Toward Home
*** Step Away From Home
*** Turn to Home
*** Turn Away From Home
*** Teleport to Home
**** These only work on events. Their actions should be reflective of what their command names suggest.

Version 1.27: September 17, 2021
* Bug Fixes!
** Fixed event spawn templates so that they can work properly with Common Events. Fix made by Arisu.

Version 1.26: September 3, 2021
* Bug Fixes!
** "Step Towards Player" custom command should now work properly. Fix made by Arisu.
** Having multiple region restriction notetags for a map will no longer cause others to lock out. Fix made by Arisu.

Version 1.25: July 30, 2021
* Bug Fixes!
** Fixed a problem that caused the 'setSelfSwitchValue' and 'setSelfVariableValue' functions to not work properly. Fix made by Irina.

Version 1.24: June 4, 2021
* Documentation Update!
** Help file updated for new features.
** Added extra clarification on which commands will go around the player character and which ones won't.
* New Move Route Custom Commands added by Arisu:
** Crash Move (direction) Until Stop
** Crash Move To: x, y
** Crash Move To Event: x
*** These allow events to collide with the player character and trigger Event Touch events.

Version 1.23: May 21, 2021
* Bug Fixes!
** Morphing by templates should no longer cause a crash. Fix made by Arisu.

Version 1.22: May 7, 2021
* Bug Fixes!
** Plugin Commands for Event Label Visibility should now update without needing to take steps as per distance detection. Fix made by Arisu.
* Documentation Update!
** Added clarity to "Common Event on Touch" Plugin Parameters.
*** Areas marked with these regions will not allow random encounters to occur. This is how RPG Maker works. Assuming you are not using plugins at all, by putting on touch events all over the map, tiles with those on touch events will not let random encounters trigger.

Version 1.21: March 12, 2021
* Bug Fixes!
** Move until stop custom move routes should no longer cause crashes. Fix made by Arisu.

Version 1.20: February 26, 2021
* Bug Fixes!
** Region Restrictions regarding Player Allow will no longer affect vehicle passability. Update made by Arisu.

Version 1.19: February 12, 2021
* Bug Fixes!
** "Self Variable: Variable ID" plugin command's Map ID should now be able to use "0" to self reference the current map. Fix made by Olivia.

Version 1.18: February 5, 2021
* Bug Fixes!
** Event icon plugin commands should now work properly. Fix made by Arisu.
* Documentation Update!
** Added new "Features: Weighted Random Movement" section.
** Help file updated for new features.
* New Features!
** New Notetags added by Arisu:
*** <Random Move Weight: x>
**** If this tag is used on an event with random-type autonomous movement, then the event will stick closer to their home location (where they are located upon spawning on the map). How close they stick to their home location will depend on the weighted 'x' value.
*** <True Random Move>
**** If this tag is used on an event with random-type autonomous movement, then that event will ignore the effects of weighted randomized movement.
** New Plugin Commands added by Arisu and sponsored by AndyL:
*** Event Timer: Change Speed
*** Event Timer: Expire Event Assign
*** Event Timer: Expire Event Clear
*** Event Timer: Frames Gain
*** Event Timer: Frames Set
*** Event Timer: Pause
*** Event Timer: Resume
**** The above Plugin Commands allow you to control the game timer better.
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Movement > Event Movement > Random Move Weight
**** Use numbers between 0 and 1. Numbers closer to 1 stay closer to their home position.

Version 1.17: January 29, 2021
* Documentation Update!
** Added "Do NOT insert quotes" to "Balloon: name" and "Pose: name".
** Added Examples for extra clarification.
* Optimization Update!
** When touch clicking an event on a map with multiple events, pathfinding will utilize the non-diagonal function for less resource consumption to prevent FPS frame drops. Fix made by Arisu.

Version 1.16: January 22, 2021
* Optimization Update!
** When touch clicking multiple times on an impassable tile, pathfinding will utilize the non-diagonal function for less resource consumption to prevent FPS frame drops. Fix made by Arisu.

Version 1.15: January 1, 2021
* Bug Fixes!
** Spawned events should now resume their automated self movement after being interacted with. Fix made by Yanfly.
* Documentation Update!
** Help file updated for new features.
** Help file updated for updated features.
* Feature Updates!
** Collission checks for the Spawn Event Plugin Commands now account for the spawning event's Hitbox, too. Update made by Yanfly.
** Spawn Event Plugin Commands adds a new parameter "Success Switch ID" to check if the spawning has been successful or not.
* New Features!
** New Plugin Commands added by Yanfly!
*** Spawn Event: Spawn At Terrain Tag
*** Spawn Event: Despawn Terrain Tag(s)
**** These function similar to their region counterparts except they target terrain tags instead.

Version 1.14: December 18, 2020
* Bug Fixes!
** Caching for event label positions now account for page index. Fix made by Yanfly.
* Documentation Update!
** Added documentation for the new features!
* New Features!
** New Plugin Commands added by Irina.
*** Follower: Set Global Chase
*** Follower: Set Target Chase
*** Follower: Set Control
*** Follower: Reset
**** These plugin commands allow you to change whether or not the followers will chase their intended targets and/or shift control over their movement route from the "Player" to the target follower.

Version 1.13: December 4, 2020
* Bug Fixes!
** Caching for event label positions now account for one-screen maps. Fix made by Arisu.

Version 1.12: November 29, 2020
* Bug Fixes!
** Click Triggers no longer work on erased events. Fix made by Arisu.
** Erased events no longer have icons appear above their heads. Fix made by Arisu.
* Feature Update!
** Initialization of the plugin's effects no only occur if the event's current page settings have been altered. Change made by Arisu.
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: November 15, 2020
* Bug Fixes!
** Morph plugin command should no longer cause crashes. Fix made by Yanfly.
* Documentation Update!
** Added documentation for the updated features!
* Feature Updates!
** Updates to these Plugin Commands made by Yanfly:
*** Call Event: Remote Activation
*** Event Icon: Change
*** Event Icon: Delete
*** Event Location: Create
*** Event Location: Delete
*** Global Switch: Get Self Switch A B C D
*** Global Switch: Get Self Switch ID
*** Global Variable: Get Self Variable ID
*** Morph Event: Change
*** Morph Event: Remove
*** Self Switch: A B C D
*** Self Switch: Switch ID
*** Self Variable: Variable ID
**** All of the above Plugin Commands can now use 0 for their Event ID's in order to refer to the running event's ID value.

Version 1.10: November 1, 2020
* Bug Fixes!
** Spawned Event preserve function now works properly. Fix made by Arisu.

Version 1.09: October 25, 2020
* Documentation Update
** Added clarity on the notetags and comment tags on when their effects are present.
* Feature Update!
** Event icons now have an unsmoothing property to them to make them look better. Update made by Irina.

Version 1.08: October 11, 2020
* Compatibility Update
** Added failsafes for better compatibility.

Version 1.07: October 4, 2020
* Documentation Update!
** Updated for the new features!
* Feature Update!
** Data from deleted events will now be cleared and removed from maps if the events do not exist to prevent conflict with plugins from the VisuStella MZ library and other plugins. Feature added by Irina.
** Move Route Custom Commands now support self variable values! If you wish to use a value from a self variable, insert \SelfVar[x] in place of the x in any of the below. This will only draw from the current event. If you wish to draw data from outside event self variables, we recommend you use the \V[x] variant after using the Plugin Commands to draw data from them for the best accuracy.
* New Features!
** New Plugin Parameter added by Yanfly!
*** Movement > Bitmap > Smoothing
**** Do you want to smooth or pixelate the map sprites? Pixelating them is better for zooming and tilting.

Version 1.06: September 27, 2020
* Bug Fixes!
** Events & Movement Core no longer disables the Core Engine's Smart Event Collision plugin parameter. Fix made by Yanfly.
* Documentation Update!
** Move Route Custom Commands updated with the new feature for inserting variable values.
* Feature Update!
** Move Route Custom Commands now support $gameVariable.value(x) values. You can also just use \V[x] for variable values, too. Added by Irina.

Version 1.05: September 20, 2020
* Bug Fixes!
** If player movement is disabled, mouse movement is disabled, too. Fix made by Arisu.
** The region restriction notetags should be fixed and work again. Fix made by Arisu.

Version 1.04: September 13: 2020
* Feature Update!
* Some Move Route Custom Commands are updated to ignore spaces:
** Jump To: x, y
** Move To: x, y
** Step Toward: x, y
** Step Away From: x, y
** Turn To: x, y
** Turn Away From: x, y
** Teleport To: x, y
*** These can now be written as x,y. There still needs to be a space between the : and x for parsing clarity, however.
*** Feature updated by Arisu with help from BlueMoon and Zeriab.
* New Features!
** New 'Move Route Custom Commands' added by Arisu.
*** Fade In: x
*** Fade Out: x
*** Force Carry: On
*** Force Carry: Off
*** Force Dash: On
*** Force Dash: Off
** New Plugin Commands added by Arisu.
*** Player Movement: Control
**** Enable or disable player control over the player character's movement.
*** Player Movement: Diagonal
**** Override settings to for player diagonal movement.

Version 1.03: September 6, 2020
* Bug Fixes!
** Sleeping pose is now fixed and working! Fix made by Yanfly.
* Documentation Update!
** Extended "Features: Self Switches and Variables" to explain how to use script calls to grab self switch information.
* New Features!
** New Plugin Commands added by Yanfly:
*** Global Switch: Get Self Switch A B C D
*** Global Switch: Get Self Switch ID
*** Global Variable: Get Self Variable ID
**** These plugin commands allow you to transfer data stored in a self switch or Self Variable into a global switch or global variable.

Version 1.02: ugust 30, 2020
* Bug Fixes!
** <Diagonal Movement: Off> notetag now works properly. Fix made by Yanfly.
** Plugin Command "Event Label: Visible" now works properly. Fix made by Shaz.
** Custom Move Route commands should now be working properly. Fix made by Shaz.

Version 1.01: August 23, 2020
* Bug Fixes!
** Event Cache issues fixed upon loading a saved game. Fix made by Yanfly.

Version 1.00: August 20, 2020
* Finished Plugin!

== See Also ==

* [[Event Popup Tips and Tricks]]
* [[Inspiration Behind Wave 1]]

== End of File ==

|}


[[Category: RPG Maker MZ Core Plugins]]





[[Category: RPG Maker MZ Gameplay Plugins]]
[[Category: RPG Maker MZ Movement Plugins]]


[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]


[[Category: RPG Maker MZ Quality of Life Plugins]]

One Time Purchase VisuStella MZ

2026-05-17T08:43:26Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=yBNk0aT7cmQ</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/1395448" width="552" height="167"><a href="https://visustellamz.itch.io/one-time-purchase">One Time Purchase plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Merchant Manager Vol 2}}

}}



[[File:OneTimePurchase_Preview.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Items and Equips Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:OneTimePurchase_Preview.png|600px]]

Not all NPC peddlers have infinite stocks of items. Sometimes, it makes more
sense for them to only sell whatever they have on hand, regardless of the
item's usual limitability. This plugin allows you to switch between a "One
Time Purchase" mode where item entries can only be bought once in a store
versus unlimited. To sell more than one of a specific item type, just add
more entries to it. However, anything that has been bought will remain sold
out until the NPC peddler restocks.

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

* Plugin Command that lets you switch between "One Time Purchase" mode for single entry buy versus unlimited buy.
* Shop contents are stored based on what the player has bought.
* Plugin Commands allow for the player to revisit those instances of the shop where the item entries have already been bought.
* Inserting multiple copies of the item type in a shop's goods listing will allow for the player to buy multiples in restricted form.

== Requirements ==

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

=== Required Plugin List ===

* [[Items and Equips Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 3}}

== Instructions - Quick Start ==

Here are some instructions to get yourself started quickly on using the
Randomize Shop feature.

---

[[File:OneTimePurchase_Command1.png]]

<pre>
Step 1: Create An Event with a Plugin Command

1. Create a new event on a map.
2. Open it up.
3. Add a new Plugin Command: "Mode: Enable One Time Purchase Mode?".
4. Set the "Enable/Disable" parameter to "true".
5. Click OK to save the contents of the Plugin Command.
</pre>

---

[[File:OneTimePurchase_Step2.png]]

<pre>
Step 2: Populate Shop Goods

1. Create a new event command with "Shop Processing".
2. Add merchanise to it.
3. Add three copies of "Potion" (yes, the same exact item).
4. This will be used to demonstrate how to purchase multiple "copies" of the
items in limited form.
5. Any price variations among the copies will be based on the first copy of
the item listed. This is how vanilla RPG Maker MZ handles it.
6. Add in other items, too.
7. Click OK to save the contents of the "Shop Processing" event.
</pre>

---

[[File:OneTimePurchase_Step3.png]]

<pre>
Step 3: Close the One Time Purchase Mode:

1. Add a new Plugin Command: "Mode: Enable One Time Purchase Mode?".
2. Set the "Enable/Disable" parameter to "false".
3. Click OK to save the contents of the Plugin Command.
4. This is so that the mode does not affect other shops.
</pre>

---

[[File:OneTimePurchase_Step4.png]]

<pre>
Step 4: Add in a Self Switch

1. After the Plugin Command is inserted, add in a Self Switch.
2. Set Self Switch "A" to ON.
3. Click OK to save the contents of the Self Switch.
</pre>

---

[[File:OneTimePurchase_Step5.png]]

<pre>
Step 5: New Page

1. Create a new page for the event.
2. Make the new page require Self Switch "A" to be ON in order to appear.
3. Remember to give the new event page a graphic.
</pre>

---

[[File:OneTimePurchase_Step6.png]]

<pre>
Step 6: Add the "Open" Plugin Command

1. Add a new Plugin Command: "Mode: Enable One Time Purchase Mode?" with
the setting set to true.
2. Add a new Plugin Command: "This Event: Open Last Shop".
3. Add a new Plugin Command: "Mode: Enable One Time Purchase Mode?" with
the setting set to false.
4. Save the event.
5. Save your game and Play Test it.
</pre>

---

{{Plugin Commands MZ}}

{{VisuMZ One Time Purchase Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:OneTimePurchase_Params.png]]

These are the general settings for this plugin.

---

General Settings

Default On/Off:
- Do you want "One Time Purchase" mode to be on by default?
- One Time Purchase
- Unlimited Purchase

Sold Text:
- Text that's shown for any bought items.
- You may use text codes.

Offset X:
- Offset the "Sold Text" by this many pixels.
- Negative: left, Positive: right

Offset Y:
- Offset the "Sold Text" by this many pixels.
- Negative: up, Positive: down

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.01: May 18, 2026
* Bug Fixes!
** Fixed a bug where going to sell items while in One Time Purchase mode does not show other touch screen UI buttons other than OK. Fix by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Notetag added by Arisu:
*** <nowiki><Allow Bulk Buy></nowiki>
**** Always allow item to be purchaseable in bulk, even with One Time Purchase mode enabled.

Version 1.00 Official Release Date: March 9, 2022
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Merchant Manager Volume 2]]

== End of File ==

|}




[[Category: RPG Maker MZ Item Plugins]]

[[Category: RPG Maker MZ Equip Plugins]]

[[Category: RPG Maker MZ Gameplay Plugins]]



[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]

[[Category: RPG Maker MZ Menu Plugins]]

Action Sequence Impact VisuStella MZ

2026-05-17T08:43:17Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=s5NcqWxVMqU</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/827763" width="552" height="167"><a href="https://visustellamz.itch.io/action-sequence-impact">Action Sequence Impact plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 5}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:ActSeqImpact_ColorBreak.gif]]

[[File:ActSeqImpact_MotionBlur.gif]]

[[File:ActSeqImpact_Shockwave.gif]]

[[File:ActSeqImpact_MotionTrail.gif]]

[[File:ActSeqImpact_ZoomBlur.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

With the aid of Pixi JS Filters, this plugin adds more impact to battle by
producing special on screen filter effects to make certain actions like
critical hits, guarding, and dodging more visibly different adding to the
flavor of the battle.

This plugin also adds new Action Sequences for the Battle Core, allowing
impacting effects like color breaks, motion blurs, shockwaves, motion
trails, and zoom blurs.

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

* Creating a color break effect when landing critical hits akin to a chromatic aberration effect.
* A battler who dodges an attack will display a motion blur effect.
* Guarding damage will cause a shockwave effect.
* Adds new Action Sequences available from the Battle Core Plugin Commands.

== Requirements ==

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

=== Required Plugin List ===

* Pixi JS Filters*
* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

'''Note''': You can download the Pixi JS Filters plugin library from the below
URL or from the Action Sequence Impact product page. Install it as a
Tier 0 plugin.

'''Note2''': Pixi JS Filters perform differently on different machines/devices.
Please understand that this is outside of VisuStella's control.

URL: [https://filters.pixijs.download/v3.1.0/pixi-filters.js PixiJS]

{{MZ Tier 3}}

== New Effects ==

The following are new visual effects added through this plugin. These visual
effects are added and modified with the sense of adding more impact to
visuals in battle.

---

=== Bizarro Inversion ===

[[File:ActionSequenceImpact_Bizarro.png]]

Swaps the blue/red colors on the battlefield. What was originally blue will
become red and what was originally red will become blue.

Anything that is attached to the battlefield will be affected. UI objects,
pictures, etc. that aren't attached to the battlefield will not be affected
by the effect. Depending on your settings, this may or may not include
battle animations, too.

---

=== Color Break ===

[[File:ActSeqImpact_ColorBreak.gif]]

When a critical hit occurs, the colors on the screen will break apart into
red, green, and blue into random directions and then come back together
similar to a chromatic aberration. This creates a sense of weight when
delivering a powerful strike.

This is optional and can be disabled.

This effect is also available as an Action Sequence in the Battle Core.

---

=== Desaturation ===

[[File:ActionSequenceImpact_Desat.png]]

Desaturates all colors on the battlefield. This will result in a black and
white greyscale effect.

Anything that is attached to the battlefield will be affected. UI objects,
pictures, etc. that aren't attached to the battlefield will not be affected
by the effect. Depending on your settings, this may or may not include
battle animations, too.

Created by [https://manugamingcreations.itch.io Manu Gaming]!

---

=== Motion Blur ===

[[File:ActSeqImpact_MotionBlur.gif]]

When a battler dodges an attack (either a miss or evasion proc), then the
battler will generate a motion blur effect. Their image splits apart in a
blurred manner and then fuses back together to become whole again. This
generates the illusion that they're hard to hit.

This is optional and can be disabled.

This effect is also available as an Action Sequence in the Battle Core.
There are two versions, one that affects only the battler while another that
affects the whole screen.

---

=== Negative Inversion ===

[[File:ActionSequenceImpact_Negative.png|600px]]

Inverts all colors on the battlefield. They pretty much swap 180 degrees of
hue with whatever color is on the opposite side.

Anything that is attached to the battlefield will be affected. UI objects,
pictures, etc. that aren't attached to the battlefield will not be affected
by the effect. Depending on your settings, this may or may not include
battle animations, too.

Created by [https://manugamingcreations.itch.io Manu Gaming]!

---

=== Oversaturation ===

[[File:ActionSequenceImpact_Oversat.png|600px]]

Oversaturates all colors on the battlefield. Colors will become extra vivid
and look extremely concentrated. Brighter colors become brighter while
darker colors become darker.

Anything that is attached to the battlefield will be affected. UI objects,
pictures, etc. that aren't attached to the battlefield will not be affected
by the effect. Depending on your settings, this may or may not include
battle animations, too.

---

=== Shockwave ===

[[File:ActSeqImpact_Shockwave.gif]]

When a guarding battler would receive HP damage (or manages to defend to 0
damage), a shockwave effect occurs to display the impact. The shockwave will
ripple out from the battler to the edges of the screen before disappearing.

This is optional and can be disabled.

This effect is also available as an Action Sequence in the Battle Core.

---

=== Motion Trail ===

[[File:ActSeqImpact_MotionTrail.gif]]

If motion trails are enabled on a battler, whenever they move, they leave
behind a residual sprite of their motion during that particular frame. The
motion blurs aid in visualizing the path the battler moved in case the
battler's movement trajectory is normally too fast to portray. Motion trails
can have different hue and/or tones.

This is an Action Sequence-only effect.

---

=== Time Scale ===

[[File:ActionSequenceImpact_TimeSlow.gif]]

[[File:ActionSequenceImpact_TimeFast.gif]]

This causes time to go slower or faster depending on the settings. All
things related to the game client will go slower or faster.

This only affects battle. The effects go away during the input phase or when
a message is present.

Created by [https://manugamingcreations.itch.io Manu Gaming]!

---

=== Time Stop ===

[[File:ActionSequenceImpact_TimeStop.gif]]

The game client will pause time for set amount of time, only the music and
any sound effects continuing.

Created by [https://manugamingcreations.itch.io Manu Gaming]!

---

=== Zoom Blur ===

[[File:ActSeqImpact_ZoomBlur.gif]]

A zoom blur will direct its focus at a specific point on the screen and
create a visual radial distortion towards that point. The intensity of the
zoom effect will diminish over the duration of the zoom blur. This helps
draw focus towards specific parts of the screen.

This is an Action Sequence-only effect.

---

{{Plugin Commands MZ}}

The following are Action Sequence Plugin Commands that have been added with
this plugin. These are accessible from the Battle Core plugin (not this one)
in order to keep all the Action Sequences in place.

Once again, these plugin commands are only accessible through the Battle
Core plugin and not this one! Make sure you have the most update to date
version of the Battle Core for them.

{{VisuMZ Action Sequence Impact Plugin Commands}}

== Plugin Parameters ==

=== Critical Color Break Settings ===

[[File:ActSeqImpact_ColorBreak.gif]]

[[File:ActSeqImpact_Params1.png]]

When critical hits occur, you can cause a Color Break effect to occur.

---

Settings

Enable/Disable?:
- Enables/disables the Color Break effect whenever a critical hit occurs?

Intensity:
- How intense do you want the Color Break effect to be?

Duration:
- What is the duration of the Color Break effect?

Easing Type:
- Select which easing type you wish to apply.

---

=== Dodge Motion Blur Settings ===

[[File:ActSeqImpact_MotionBlur.gif]]

[[File:ActSeqImpact_Params2.png]]

When a battler dodges an attack, you can create a motion blur effect.

---

Settings

Enable/Disable?:
- Enables/disables the Motion Blur effect whenever a battler evades an
attack?

Intensity Rate:
- This determines intensity rate of the motion blur.
- Use a number between 0 and 1.

Duration:
- How many frames should the motion blur last?
- What do you want to be its duration?

Easing Type:
- Select which easing type you wish to apply.

---

=== Guard Shockwave Settings ===

[[File:ActSeqImpact_Shockwave.gif]]

[[File:ActSeqImpact_Params3.png]]

When a guarding battler receives damage, you can create a shockwave effect.

---

Category

Enable/Disable?:
- Enables/disables the Shockwave effect whenever a battler is attacked
while guarding?

Amplitude:
- What is the aplitude of the shockwave effect?

Wavelength:
- What is the wavelength of the shockwave effect?

Duration:
- What is the duration of the shockwave?

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

Manu Gaming Creations
* URL: [https://manugamingcreations.itch.io https://manugamingcreations.itch.io]
* Responsible for the following Impact Effects and adapted by VisuStella:
** Desaturation
** Negative Impact
** Time Scale
** Time Stop

== Changelog ==

Version 1.10: May 18, 2026
* Compatibility Update!
** Added better compatibility with Action Sequence Impact. Previously, Dragonbones would block certain effects. Update made by Arisu.

Version 1.09: September 14, 2023
* Compatibility Update!
** Updated this plugin to work with Dragonbones Union's newest feature update to stop Dragonbones armatures from having their blend modes suppressed by PixiJS.

Version 1.08: June 15, 2023
* Bug Fixes!
** Inject animations should now work properly for animated enemies.

Version 1.07: September 8, 2022
* Bug Fixes!
** Fixed a problem with motion trails not working for Dragonbones animations that have looping properties. Fix made by Irina.

Version 1.06: May 26, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Action Sequence Effects added by Irina and sponsored by MirageV:
*** INJECT: Animation Begin
**** Injects and plays a whole spritesheet animation.
**** The spritesheet animation will play over the battler until it is finished.
**** The battler's original sprite will be invisible until finished.
*** INJECT: Animation End
**** Stops and ends any injected animations on target(s).
**** Any inject animation will be prematurely terminated.
*** INJECT: Animation Pause/Resume
**** Pauses/resumes any injected animations on target(s).
*** INJECT: Wait For Injected Animation
**** Waits for injected animations to complete before performing next command.

Version 1.05: April 14, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Impact Effects added by Irina and collaborating with Manu Gaming!
*** Impact: Bizarro Inversion
*** Impact: Desaturation
*** Impact: Negative Inversion
*** Impact: Oversaturation
*** Impact: Time Scale
*** Impact: Time Stop

Version 1.04: October 28, 2021
* Bug Fixes!
** Guard shockwave now originates from the proper location with front view sprites enabled under specific battle layouts. Fix made by Irina.

Version 1.03: December 11, 2020
* Documentation Update!
** Added documentation for new feature(s)!
* Feature Update!
** Action Sequence Impact Action Sequences "Shockwave from Each Target(s)", "Shockwave from Target(s) Center", and "Zoom Blur at Target(s) Center" now have "Offset X" and "Offset Y" plugin parameters. Added by Yanfly.
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.02: December 4, 2020
* Bug Fixes!
** Enemies with a SV Battler attached to them will no longer desynch after using a motion trail effect. Fix made by Irina.

Version 1.01: November 29, 2020
* Bug Fixes!
** Motion Trails for Dragonbones armatures are now properly adjusted for their scale and offset. Fix made by Arisu.

Version 1.00: December 2, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 5]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]








[[Category: RPG Maker MZ Eventing Plugins]]


[[Category: RPG Maker MZ Visual Plugins]]

Shop Common Events VisuStella MZ

2026-05-17T08:43:10Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=UcIVHJq4NVA</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/1196394" width="552" height="167"><a href="https://visustellamz.itch.io/shop-common-events">Shop Common Events plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Merchant Manager Vol 1}}

}}



[[File:ShopCommonEvents_Preview.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Items and Equips Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:ShopCommonEvents_Preview.gif]]

This plugin allows for shop items, weapons, and/or armors to launch common
events upon buying or selling them, either as a one-time event or repeating.
These launched Common Events will take the player outside of the shop to
process the Common Events before (optionally) returning back, giving your
player's party members a chance to comment on his or her purchases.

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

* Items, weapons, and armors can launch Common Events went bought or sold.
* These launched Common Events can occur once or repeat multiple times.
* Store the quantity of an item bought or sold into variables to allow for some more dynamic Common Events.
* Use switches to function as requirements to determine if the Common Events will launch, either by having all switches enabled or any one of a set.
* A plugin command that will return the player back to the previous shop with all of the shop settings intact.

== Requirements ==

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

=== Required Plugin List ===

* [[Items and Equips Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

=== Launching Common Events ===

[[File:ShopCommonEvents_Preview.gif]]

When launching a Common Event, through either buying or selling, any of the
event commands part of the initial shop launch will be cached away until the
player exits the shop normally.

However, if the Common Event finishes without returning the player back to
the shop without usage of the Plugin Command, then any of the cached event
commands will be lost.

---

{{Notetags MZ}}

{{VisuMZ Shop Common Events Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Shop Common Events Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:ShopCommonEvents_Preview.gif]]

[[File:ShopCommonEvents_Params.png]]

These are primarily settings to automatically record the quantity/amount
of an item, weapon, or armor bought or sold in the shop in case you want to
have a dynamic Common Event dependent on them.

---

General Settings

Variable: Buy Quantity:
- When buying, register amount bought to this variable.
- 0 to not use this feature.

Variable: Sell Quantity:
- When Selling, register amount sold to this variable.
- 0 to not use this feature.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Arisu]]
* [[Olivia]]
* [[Irina]]
* [[Yanfly]]

== Changelog ==

Version 1.03: May 18, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Once Buy Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.
** Added extra clarity for <nowiki><Once Sell Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.

Version 1.02: May 12, 2022
* Documentation Update!
** Added the following text to the <Once Buy Common Event: id>, <Repeat Buy Common Event: id>, <Once Sell Common Event: id>, and <Repeat Sell Common Event: id> notetags:
*** Use the Plugin Command "Return: To Last Shop" to return back to the last shop scene.

Version 1.01: September 17, 2021
* Bug Fixes!
** Prevents canceling purchases from launching Common Events. Fix by Arisu.

Version 1.00 Official Release Date: October 4, 2021
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Merchant Manager Volume 1]]

== End of File ==

|}




[[Category: RPG Maker MZ Item Plugins]]







[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]




[[Category: RPG Maker MZ Quality of Life Plugins]]

QTE and Trigger System VisuStella MZ

2026-05-17T08:43:03Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://youtu.be/UTak0ezYszI</youtube>

|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/2452274" width="552" height="167"><a href="https://visustellamz.itch.io/qte-trigger-sys">QTE & Trigger System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Custom Construct Vol 4}}

}}



[[File:QteTrigger_ButtonSequence.gif]]

[[File:QteTrigger_FillGauge.gif]]

[[File:QteTrigger_TimedHit.gif]]

[[File:QteTrigger_TimedSeq.gif]]

[[File:QteTrigger_TimingBar.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Events and Movement Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:VisuMZ.142.jpg|600px]]

Sometimes, we need a way to trigger Switch or Variable changes. This can be
in an organic fashion or through Quick Time Events (QTE's). QTE's allow for
immediate changes to Switches or Variables through player inputs. Or if you
have ever wanted a Common Event to run when a specific Switch or Variable
changes its current value to something else, you can use this plugin's
trigger system for Switches, Variables, Items, Weapons, and Armors to call
and trigger Common Events whenever their values change. These don't have to
be recurring as they can also function as one-time "promises", too.

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

* Quick Time Events (QTE) can be played to adjust values of variables and/or switches based off different types of QTE's like Button Mashing, Direction Struggle, Timed Hits, and more.
* 10+ different QTE Plugin Commands for you to pick and choose from to give players more engaging gameplay.
* Trigger Common Events by simply changing certain Switches to ON/OFF positions or Variables to different values.
* Items, weapons, and armors can also register Common Events to trigger when the party gains or loses a copy of that item, weapon, or armor.
* If these triggers occur on a scene that isn't battle or the map, then the Common Events are queued up for until the player moves to the battle or map scenes to trigger them.
* If the triggering Common Event only has script calls, then the effect will run right then and there.
* Create Promises, one-time Common Event triggers upon a switch, variable, item, weapon, or armor having its value changed.
* Getting a Game Over can also result in a trigger that will bypass the Game Over scene, too.
* Game Over Common Events will prevent the game from ending completely and return back to map scene.
* The Common Event that is run upon a Game Over can be altered and changed.
* Have different Common Events depending on the map or troop encountered.
* The Game Over Common Event can be persistent or function as a one time deal depending on how you, as the game dev, choose to follow up with it.

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Events and Movement Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

=== Quick Time Events ===

[[File:QteTrigger_TimingBar.gif]]

Also known as QTE's, these events function as player involved input trigger
systems which affect Variable or Switch values depending on the QTE type
(such as Variables for Button Mashing). Because these are player-input
reliant triggers, it's usually best for the event to be halted while the QTE
plays out (although you can disable this). Naturally, as such, the event
will not continue until the QTE is finished playing in the event commands.

QTE's are activated through Plugin Commands and can have the messages and
such displayed with each QTE displayed differently each time. Adjust this in
the Plugin Parameters for each QTE to fit the situation.

Only one QTE type can be played at a single time. Two or more QTE's cannot
be played at the same time. This is to prevent clutter and cause input
clashes.

If a QTE Plugin Command has a Switch and/or Variable assigned (or multiple),
those Switches and Variables will be reset to OFF and 0 respectively. Based
on the QTE type, data can be recorded to both the Switches and Variables.
Some Switches can indicate the successful player input of a QTE while other
Variables can indicate how much time was remaining upon finishing the QTE or
the score for the QTE.

Furthermore, for play testing purposes, during a QTE input sequence, you can
just hold down the "debug" button (usually Control) to automatically input
the needed input sequences. This ONLY works during Play Testing!

---

=== Switch and Variable Triggers ===

[[File:SwVarTrigger.png]]

Switches and Variables can have their names included with the name tags:
<Toggle Trigger Common Event: x> or <Change Trigger Common Event: x> to
automatically activate a Common Event at the next available moment. The
activated Common Event will only run once per trigger as opposed to
continuously like an Autorun or Parallel Common Event.

These apply to Self Switches (only the custom ones added through the <Self>
name tag VisuMZ_1_ItemsEquipsCore) and Self Variables (likewise), too. The
same also applies to Map Switches and Variables (with <Map>) and any Global
Switches and Variables (with <Global>).

However, Self Switches/Variables that have triggered any Common Events will
not utilize any "This Event" event command functions. They will behave as if
they are triggered on a non-event environment.

Possible uses for this mechanic can be things like making a picture change
into something else whenever a Variable's number value is altered, or have a
picture become visible or invisible depending on a Switch's ON/OFF value.

Be wary of creating infinite loops by "turning off" Switches or "resetting"
any Variables. That will cause them to trigger, too. If you have to turn off
or reset switches/variables, consider using Promise Plugin Commands instead
of the auto-repeat tags.

---

=== JS Switch and Variable Triggers ===

[[File:QteTriggerSys_JsParam.png]]

Triggers that function off of JS Switches and Variables will behave slightly
different. As these have dynamic values that may be constantly changing, in
order to prevent lag and endless loops, there is a delay system put in place
to ensure the triggers occur properly.

This delay is set up in the Plugin Parameters. A delay of 60 means that
every 60 frames in-game, a check will be performed to see if a trigger
should occur or not.

---

=== Repeat Triggers ===

A triggered Common Event can only be repeated once per availability. This
means that if you have toggled a Switch ON/OFF three times in a single frame
then the triggered Common Event will only process one time. The same applies
to variables, items, weapons, and armors.

This also means that if the Common Event is triggered multiple times outside
of the battle and map scenes, then it will only run once when available to
run the Common Event.

---

=== Triggers for JavaScript Only Common Events ===

[[File:QteTriggerSys_JsTrigger.png|600px]]

If a triggered Common Event only has JavaScript in it through the "Script"
event command, then instead of waiting until reaching the battle or map
scene, the triggered Common Event will run the JS code immediately. Comments
will be ignored and allowed as a part of JavaScript Only Common Events.

If multiple "Script" event commands are found in the triggered Common Event,
they will run independent of each other and as local functions. This means
that the any custom JS variables declared in one of the Script call events
may not necessarily transfer over to the others if not originally meant to.

---

=== Promise Triggers ===

Anything that is assigned through a name tag or notetag will result in an
auto-repeat trigger and will always trigger without fail. However, if you
want something to trigger only once (or until you assign it again), use a
Promise Trigger.

These are assigned through Plugin Commands and they will only trigger once.
After that, the condition that caused them to trigger will not trigger again
until another Promise is made to them.

---

=== Game Over Scene ===

[[File:GameOver.png|600px]]

The Game Over scene is skipped over if there's a designated Game Over Common
Event determined. If there isn't any Game Over Common Events, then the Game
Over scene will occur normally.

If there are multiple Game Over Common Events, determined through the
default Plugin Parameters, Map Notetags, or Troop Name Tags, then a priority
system is used:

# Battle Processing "Can Lose"
# Troop Name Tag Game Over Common Event
# Map Notetag Game Over Common Event
# Plugin Parameters/Command Game Over Common Event

If a "Battle Processing" event command has a "Can Lose" option, then there
will be no Game Over Common Event to be run and instead, whatever is found
in the "Can Lose" segment will run instead. The event will not be
interrupted and continue forward. Ignore the rest.

Otherwise, if there is a Game Over Common Event determined by the enemy
troop's name with the Name Tag <Game Over Common Event: x>, then priority
will go to that Common Event. Any event running will end prematurely in
favor of this Game Over Common Event. Ignore the rest.

If there is a Game Over Common Event determined by the current map's notes
with the notetag <Game Over Common Event: x>, then priority will go to that
Common Event. Any event running will end prematurely in favor of this Game
Over Common Event. Ignore the rest.

And finally, if there are any Game Over Common Events determined through
Plugin Commands or Plugin Parameters, then follow through with those. Keep
in mind that if it is based off a Plugin Parameter, and if the parameter
"Clear Common Event After?" is enabled, it will be only a one time deal.

If there are no Game Over Common Events designated, then finally, the player
will reach the Game Over scene.

---

== 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]] ===

Those using VisuStella MZ's Battle Core can launch QTE Plugin Commands from
this plugin during the middle of Action Sequences as long as there is not
a conflicting effect during it.

Conflict effects include Active Chain Skills, Input Combo Skills, or
Evolution Matrix Skills. QTE events will not run at all while these skill
mechanics are active.

---

{{Notetags MZ}}

{{VisuMZ QTE and Trigger System Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ QTE and Trigger System Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:VisuMZ.142.jpg|600px]]

There aren't too many Plugin Parameters for this plugin.

---

General Settings

[[File:QteTriggerSys_JsParam.png]]

JS Watch Update Delay:
- Used for <JS> Switches and Variables.
- How many frames delay to wait for triggers?
- 60 frames = 1 second.

---

=== Game Over Settings ===

[[File:GameOver.png|600px]]

[[File:QteTriggerSys_Param1.png]]

These settings let you adjust Game Over-related trigger aspects.

---

Game Over Settings

Default Common Event:
- Do you want there to be a Default Common Event?
- It can be changed later with a Plugin Command.
- 0 to not use.

Heal on Common Event?:
- Do you want to heal 1 HP for all dead members after running the
Game Over Common Event?

Clear After?:
- Do you wish to clear the Game Over Common Event after it launches
or not?

---

=== QTE Settings ===

[[File:QteTrigger_FillGauge.gif]]

[[File:QteTriggerSys_Param2.png]]

These settings let you adjust QTE-related trigger aspects.

---

Settings

Early Finish Duration:
- How many frames should the game wait if the player finishes a QTE early?

Show QTE Timer?:
- Do you wish to show a QTE Timer over each QTE window?

Timer Gauge Style:
- Select the gauge style to use for QTE Timer.
- Requires VisuMZ_3_VisualGaugeStyles!

Gauge Color 1:
Gauge Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

JS: X, Y, W, H:
- Code used to determine the position and dimensions for this window
containing the gauge.

Show QTE Progress?:
- Show a progress gauge for certain types of QTE's?

Progress Gauge Style:
- Select the gauge style to use for QTE Timer.
- Requires VisuMZ_3_VisualGaugeStyles!

Gauge Color 1:
Gauge Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

JS: X, Y, W, H:
- Code used to determine the position and dimensions for this window
containing the gauge.

Input Buffer Leeway:
- How many input buffer frames of leeway should be granted to
Button Sequence QTE?

Timed Hit Leeway:
- How many frames of leeway should be granted to Timed Hit QTE?

Overlay Opacity:
- Timed Hit overlay sprite opacity.

Max Scaling:
- What's the max scaling for Timed Hit QTE indicators?

Timed Sequence Leeway:
- How many frames of leeway should be granted to Timed Sequence QTE?

Sequence Position:
- What is the position for the Timed Sequence Landing Icon?
- Use a number between 0 and 100.

QTE Timing Bar Width:
- This is the width of the Timing Bar in pixels.

Cursor Offset X:
- Offsets the cursor x position.
- Negative: left. Positive: right.

Cursor Offset Y:
- Offsets the cursor y position.
- Negative: up. Positive: down.

Label Font Size:
- What is the font size used to display timing bar labels?

Label Offset X:
- Offsets the label x position.
- Negative: left. Positive: right.

Label Offset Y:
- Offsets the label y position.
- Negative: up. Positive: down.

Timing Bar Color 1:
Timing Bar Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

---

=== Vocabulary Settings ===

[[File:QteTrigger_TimedHit.gif]]

[[File:QteTriggerSys_Param3.png]]

These settings let you adjust the text displayed and QTE text window for
this plugin.

---

General Settings

Text Alignment:
- What is the text alignment?
- Requires VisuMZ_1_MessageCore!
- Otherwise, defaults to left alignment.

--

Message Settings:

Button Mash Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Button Sequence Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.

Direction Struggle:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Fill Gauge Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Hold & Release Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Marcher Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Swapper Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Timed Hit Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

Timed Sequence Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.

Timing Bar Text:
- Alter the text that appears for the QTE Window.
- Text codes are supported.
- Leave empty for no window.

---

Message Window:

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the position and dimensions for this window.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella
* [[Arisu]]
* [[Irina]]
* [[Olivia]]
* [[Yanfly]]

== Changelog ==

Version 1.04: May 18, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Time Out > Play SFX?
**** Play the "Miss" sound effect on time out?
**** Only applies to QTE's with "Miss" sound settings.

Version 1.03: June 12, 2025
* Bug Fixes!
** Fixed a bug where some QTE's did not work properly in battle. Fix made by Arisu.

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > QTE Settings > Input Buffer Leeway
**** How many input buffer frames of leeway should be granted to Button Sequence QTE?

Version 1.01: February 15, 2024
* Bug Fixes!
** Fixed a bug where any input can be used for Timed Sequence QTE. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Comman added by Arisu:
*** QTE: Clear Current QTE
**** Clears the currently existing QTE.
* Feature Updated!
** Plugin Command: QTE: Hold & Release (OK)
*** Added Hold Common Event
*** Added Release Common Event
*** Added Overload Common Event
**** These common events will play upon different aspects of the QTE.

Version 1.00 Official Release Date: January 22, 2024
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Custom Construct Volume 4]]
* [[Timed Hits with Action Sequences]]

== End of Helpfile ==

|}








[[Category: RPG Maker MZ Gameplay Plugins]]



[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]


[[Category: RPG Maker MZ Quality of Life Plugins]]

Item Crafting System VisuStella MZ

2026-05-17T08:42:54Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=44nhdhWTSbM</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/786776" width="552" height="167"><a href="https://visustellamz.itch.io/item-crafting-system">Item Crafting System by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 4}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:ItemCraftingSys_Preview1.png|600px]]

[[File:ItemCraftingSys_Preview2.png|600px]]

[[File:ItemCraftingSys_Animation.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Items and Equips Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

Item crafting has become a common feature in many RPG's. However, it is not
a feature included by default with RPG Maker MZ. This plugin adds in a scene
that supports item crafting, either through the main menu, or through an
event initiated command.

Craftable items are normally all available by default, but they can be
barred away through switch requirements. Upon crafting items, switches can
also be turned on/off to make a progression system if desired.

Item ingredients can be items, weapons, armors, and cost gold as well.
Multiple ingredients can be required at a time or just one. Some items can
also be set to only be craftable at custom crafting areas.

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

* Adds an item crafting scene to the game.
* Item crafting scene can be accessible from the Main Menu or through event-based Plugin Commands.
* Crafting ingredients can consist of items, weapons, armors, and gold.
* Crafting specific items can require switches to be turned on in order to be listed in the crafting list.
* Upon crafting specific items, they can also turn on/off other switches, making a progression system to be possible.
* Custom item crafting effects can occur for those who understand JavaScript to implement.
* This plugin can mask the names of uncrafted items, too.

== Requirements ==

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

'''Required Plugin List'''

* [[Items and Equips Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

=== Proxy Items ===

Proxy Items are temporary substitutes for another. When they are acquired
through crafting, they will turn into the item, weapon, or armor they are a
proxy for. Only the icon, name, help description, and status details will
match up. Everything else will remain separate such as the notetag data and
the ingredients list. This allows you to effectively have multiple ways to
craft the same item using different recipes.

For more details, look inside of the Notetags section for Proxy items.

---

{{Notetags MZ}}

{{VisuMZ Item Crafting System Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Item Crafting System Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:ItemCraftingSys_Preview1.png|600px]]

[[File:ItemCraftingSys_Param1.png]]

General settings pertaining to Item Crafting.

---

Scene_ItemCrafting

Assist Button:
- Text used to for the Button Assist Window's OK button when about ready
to craft an item.

Crafted Icon:
- Icon used to depict of an item has already been crafted.

Ingredient Bridge:
- Text used to bridge ingredients in the item crafting scene.

---

Switches

Switch: Craft:
- Crafting items in Crafting Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Crafting Scene opens.

---

Categories

Category Title:
- Text format used for display categories.
- %1 - Category Name, %2 - Needed Quantity

Selected Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Selected Text:
- This is the add on text that is displayed after an item's name that's
already an ingredient.

Uncategorized Text:
- Text used for an uncategorized item category.

Uncategorized Icon:
- Icon used for uncategorized item category.

---

Vocabulary

Owned:
-Text used for how much of an item is owned.

Shift:
- Text used for the change in value.

Net:
- Text used for the net result.

---

Global JS Effects

JS: Listing:
- Code that is run globally across all items when checking if an item
should be listed or not.

JS: Craft Effect:
- Code that is run globally across all items when crafted.

---

=== Masking Settings ===

[[File:ItemCraftingSys_Preview1.png|600px]]

[[File:ItemCraftingSys_Param2.png]]

Masking settings related to uncrafted items.

---

Masking

Enable Masking:
- Enable masking for uncrafted items?

Italics For Masking:
- Use Italics when masking?

Mask Character:
- Text used for masking per individual character.

---

=== Main Menu Settings ===

[[File:ItemCraftingSys_MainMenu.png|600px]]

[[File:ItemCraftingSys_Param3.png]]

Main Menu settings for Item Crafting.

---

Main Menu

Command Name:
- Name of the 'Crafting' option in the Main Menu.

Show in Main Menu?:
- Add the 'Crafting' option to the Main Menu by default?

Enable in Main Menu?:
- Enable the 'Crafting' option to the Main Menu by default?

---

=== Animation Settings ===

[[File:ItemCraftingSys_Animation.gif]]

[[File:ItemCraftingSys_Param4.png]]

Default settings for playing animations after crafting.

---

General

Show Animations?:
- Show animations when crafting an item?

Show Windows?:
- Show windows during an item crafting animation?

Default Animations:
- Default animation(s) do you want to play when crafting.

---

Sprite

Scale:
- How big do you want the item sprite to be on screen?

Fade Speed:
- How fast do you want the item to fade in?

---

=== Crafting Sound Settings ===

[[File:ItemCraftingSys_Animation.gif]]

[[File:ItemCraftingSys_Param5.png]]

Default settings for the sound effect played when crafting an item.

---

Sound

Filename:
- Filename of the sound effect played.

Volume:
- Volume of the sound effect played.

Pitch:
- Pitch of the sound effect played.

Pan:
- Pan of the sound effect played.

---

=== Background Settings ===

[[File:ItemCraftingSys_Preview2.png|600px]]

[[File:ItemCraftingSys_Param6.png]]

Background settings for Scene_ItemCrafting.

---

Background Settings

Snapshop Opacity:
- Snapshot opacity for the scene.

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

---

=== Window Settings ===

[[File:ItemCraftingSys_Preview2.png|600px]]

[[File:ItemCraftingSys_Param7.png]]

Window settings pertaining to Item Crafting.

---

Windows

Requirement Font Size:
- Font size used for requirement quantity.

Show Tooltips:
- Show tooltips when the mouse hovers over an ingredient?

Custom Window Skin:
- Select a custom window skin if you want the tooltip window to have one.

---

Background Types

Help Window:
Category Window:
Gold Window:
List Window:
Status Window:
Ingredient Title:
Ingredient List:
Number Window:
Button Assist Window:
- Select background type for the specific window.

---

Custom Layout

Added in version 1.20

Enable Custom Layout:
- Enable a custom layout or automatically create a layout based on the
shop scene?

Help Window JS:
- Code used to determine the dimensions for this window.

Category Window JS:
- Code used to determine the dimensions for this window.
- These settings are also used for the ingredients title window.

Gold Window JS:
- Code used to determine the dimensions for this window.

Item Window JS:
- Code used to determine the dimensions for this window.
- These settings are also used for ingredients list and number windows.

Status Window JS:
- Code used to determine the dimensions for this window.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.26: May 18, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Once Craft Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.

Version 1.25: October 16, 2025
* Compatibility Update!
** Added better compatibility checks for shop batches to make sure they don't give out free items. Fix made by Arisu.

Version 1.24: July 17, 2025
* Bug Fixes!
** Fixed a name masking bug that would result in a crash. Fix made by Arisu.

Version 1.23: May 15, 2025
* Compatibility Update!
** Added better compatibility with Message Core's text language settings. Update made by Arisu.

Version 1.22: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.
* Documentation Update!
** Added extra clarity to <nowiki><Craft Batch></nowiki>
*** Items CANNOT add themselves!
*** ie. Item 'Super Potion' must not give Item 'Super Potion'.
* Feature Update!
** Add fail safes to prevent items from having batch entries add themselves. Added by Arisu.

Version 1.21: July 18, 2024
* Compatibility Update!
** Added compatibility with new Items and Equips Core features!

Version 1.20: March 14, 2024
* Bug Fixes!
** Fixed a crash that would cause a conflict with related non-crafting scenes. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Windows > Custom Layout
**** By enabling this, you can use JS to determine the window positions you want to layout in the item crafting scene. Otherwise, if left disabled, the plugin will automatically utilize the layout found in the shop scene to determine where the windows will go.

Version 1.19: February 15, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Arisu:
*** <Craft Batch>
**** When this "item" is crafted, yields multiples of the listed item.
**** Requires VisuMZ_3_ShopBatches

Version 1.18: August 4, 2022
* Bug Fixes!
** Crafting an item on a different tab than the first will no longer reset back to the first tab. Fix made by Irina.

Version 1.17: July 14, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.16: May 12, 2022
* Compatibility Update
** Compatibility with VisuMZ Shop Common Events added.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag effects added by Irina and sponsored by MirageV:
*** <Once Craft Common Event: id>
*** <Repeat Craft Common Event: id>
**** Requires VisuMZ_2_ShopCommonEvents!
**** This will cause a specific Common Event to launch when crafted.
*** <Once Craft Common Event Switch: id>
*** <Once Craft Common Event All Switches: id, id, id>
*** <Once Craft Common Event Any Switches: id, id, id>
*** <Repeat Craft Common Event Switch: id>
*** <Repeat Craft Common Event All Switches: id, id, id>
*** <Repeat Craft Common Event Any Switches: id, id, id>
**** Requires the respective Craft Common Events to have these Switches enabled in the "ON" position in order for them to launch.
** New Plugin Command added by Irina and sponsored by MirageV:
*** Scene: Common Event Return
**** Requires VisuMZ_2_ShopCommonEvents!
**** Return to the last shop if coming from a Crafting Common Event.

Version 1.15: April 7, 2022
* Feature Update!
** Any disappearing categories as a result of hiding recipes after crafting an item will result in the first category being selected.

Version 1.14: March 31, 2022
* Feature Update!
** Failsafe added for situations where if the game dev decides to force an impossible situation in the Item Crafting scene (such as turning on a switch that erases all recipes), then the Item Scene will automatically exit out of it with zero prompts. Update made by Olivia.

Version 1.13: January 20, 2022
* Bug Fixes!
** Tooltips for proxy items no longer show the original item's materials. Fix made by Olivia.

Version 1.12: December 23, 2021
* Documentation Update!
** Help file updated for new features.
** Added Major Changes section for "Proxy Items".
* Feature Update!
** Number window is now updated to show how much of an ingredient the player owns, how much will be consumed, and the number result of the crafting.
* New Features!
** New notetags added by Arisu!
*** <Proxy: id>
*** <Proxy: name>
**** REQUIRES the most up to date VisuMZ Items and Equips Core!
**** Turns this item, weapon, or armor into a proxy for another item, allowing you to create recipes with different ingredients in <Crafting Ingredients> notetag contents and yield the same item.
**** The proxy item itself will take on the name, icon, and description of the original item it is supposed to represent.
**** No other properties are carried over from the original.
**** When viewed through the Window_ShopStatus window, the contents will reference the original item and not the proxy item.
**** Proxy items themselves cannot be acquired. This includes event commands, item drops, or equips.
**** When crafted, the item yielded won't be the proxy item but the item it is a proxy for.
**** Replace 'id' with a number representing the item, weapon, or armor ID of the same item type. If the proxy is an item, this will reference an item. If the proxy is a weapon, this will reference a weapon. Same for armors.
**** Replace 'name' with text representing the item, weapon, or armor's name. The referenced item needs to be the same item type as the proxy. Item for item, weapon for weapon, armor for armor.
** New Plugin Parameters added by Arisu!
*** Plugin Parameters > General > Vocab > Owned
*** Plugin Parameters > General > Vocab > Shift
*** Plugin Parameters > General > Vocab > Net
**** These are new vocabulary terms for the new number window appearance.

Version 1.11: July 9, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.10: June 25, 2021
* Bug Fixes!
** When exiting out of the ingredients list back towards the item selection window, the help window should now be properly updated. Fix by Irina.

Version 1.09: March 12, 2021
* Bug Fixes!
** Having extra spaces before an ingredient's name should no longer cause problems to information parsing. Fix made by Irina.

Version 1.08: March 5, 2021
* Feature Update!
** Plugin Commands and Item Crafting Scene option will not appear if you do not have any recipes prepared at all in your game. Update made by Irina.

Version 1.07: February 26, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina and sponsored by AndyL:
*** Plugin Parameters > General Settings > Switches > Switch: Craft
**** Crafting items in Crafting Scene turns this Switch to ON.
**** Switch reverts to OFF whenever the Crafting Scene opens.
**** This can be used after an "Item Crafting" plugin command to determine if the player has crafted an item or not.

Version 1.06: December 25, 2020
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag added by Yanfly.
*** <Crafting Picture: filename> and <Picture: filename>
**** Uses a picture from your project's /img/pictures/ folder instead of the item, weapon, or armor's icon during crafting instead.

Version 1.05: November 29, 2020
* Bug Fixes!
** If on-screen touch buttons are disabled, they will no longer cause crash errors. Fix made by Arisu.

Version 1.04: November 15, 2020
* Optimization Update!
** Plugin should run more optimized.

Version 1.02: October 25, 2020
* Bug Fixes!
** Masked Names no longer show in the number input window. Fixed by Irina.
** Plugin no longer requires a new game to be started in order for Item Crafting to work for the main menu. Fix made by Irina.
** Touch Button for OK will no longer bypass the item requirements. Fix made by Irina.
** Uncategorized items will now default to a newly created Uncategorized list of items. Fix made by Irina.
* Documentation Update!
** Plugin Parameters > General will is updated with "Uncategorized Text" and "Uncategorized Icon" for uncategorized items.

Version 1.01: October 18, 2020
* Feature Update!
** Bounce SFX pitch plugin parameter is now uncapped.
* Bug Fixes!
** Color matches no longer crash the game if the matching amount is set to zero. Bug fixed by Yanfly.
** Selecting a category without modern controls will now activate the list window. Bug fixed by Yanfly.
** The Category Window no longer disappears when there's only one category. Bug fixed by Yanfly.
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.00: November 2, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 4]]

== End of File ==

|}




[[Category: RPG Maker MZ Item Plugins]]



[[Category: RPG Maker MZ Gameplay Plugins]]





[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]

Battle System - STB VisuStella MZ

2026-05-17T08:42:50Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=b1O0fvM5VQ8</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/827753" width="552" height="167"><a href="https://visustellamz.itch.io/battle-system-stb">Battle System - STB plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 5}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:BattleSysSTB_Instant.gif]]

[[File:BattleSysSTB_Exploit.gif]]

[[File:BattleSysSTB_AllOut.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

The Standard Turn Battle (STB) system uses RPG Maker MZ's default non-TPB
battle system as a base. Action orders are determined by the battler's AGI
values and they go from highest to lowest. However, actions are not selected
at the start of the turn. Instead, as the turn progresses, actions are then
picked as each battler's turn comes up and is executed immediately.

Optional to the battle system but fine tuned to it is the Exploit System.
When landing an elemental weakness or critical hit against a foe, the
battler can gain bonuses as well as an extra turn while the foe will become
stunned or gain any desired state(s). When all enemies are exploited in a
single turn, a common event can also be played, too.

A Turn Order Display will also appear on the screen to show the order the
battlers will take their turns in. This lets the player plan in advance on
how to go about the rest of the turn.

*NOTE* To use this battle system, you will need the updated version of
VisuStella's Core Engine. Go into its Plugin Parameters and change the
"Battle System" plugin parameter to "stb".

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

* Utilizes the balanced AGI nature of the Default Turn Battle system.
* Allows for actions to execute immediately upon selection.
* A Turn Order Display to show the player when each battler will have its turn to perform an action.
* Skills and Items can have an "Instant Use" effect, which allows them to perform an action immediately without using up a turn.
* An optional Exploit System that can be disabled if desired, but otherwise, fine tuned to make use of STB's highly compatible nature.
* Landing an elemental weakness or critical hit can allow the active battler to gain bonuses, ranging from states to extra actions to custom effects that can be added on through JavaScript plugin parameters.
* An exploited enemy can suffer from states and/or custom effects added through JavaScript plugin parameters.
* If all enemies are exploited, a common event can run to allow for a custom follow up action.

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

=== Turn Order Display ===

[[File:BattleSysSTB_TurnOrder.png]]

The Turn Order Display will capture the battle's currently active battler
and any battlers found in the active battlers array for the BattleManager.
This does not overwrite any functions, but the Turn Order Display may or may
not conflict with any existing HUD elements that are already positioned on
the screen. If so, you can choose to offset the Turn Order Display or move
it to a different part of the screen through the plugin parameters.

---

=== Action Speed ===

[[File:BattleSysSTB_ActionSpeed.png]]

For skills and items, action speeds now behave differently now. Because
actions are now decided after a turn starts, positioning will no longer be
decided from the selected skill/item's action speed for the current turn.

Instead, the action speed used by a skill or item will determine the bonus
speed (or speed penalty if negative) for the following turn. Using a Guard
action with a +2000 Action Speed will raise the following turn's speed by
+2000, whereas what is originally a long charge time skill with -1000 speed
will decrease the following action's speed by -1000.

You can also customize how speed is calculated through JS Plugin Parameters
found in the Mechanics Settings.

---

=== Instant Use ===

[[File:BattleSysSTB_Instant.gif]]

Skills and Items can have an "Instant Use" property which allows them to be
used immediately without consuming a turn. This can be used for actions that
otherwise do not warrant a whole turn. These can be used for minor buffs,
debuffs, toggles, etc.

---

=== Exploit System ===

[[File:BattleSysSTB_Exploit.gif]]

This is an optional system. If you wish to turn it off, you can do so in the
plugin parameters.

There are two main ways that battlers can be exploited. One is by receiving
damage that strikes an elemental weakness. The other is by receiving damage
from a Critical Hit. Exploited battlers can receive penalty states. These
states can be adjusted in the plugin parameters. The default penalty state
is the Stunned state.

The battler doing the exploiting can receive bonuses instead. This is to
reward a power play. These bonuses can range from added states to receiving
an extra action and allowing the active battler to immediately attack again.

Each battler can only be exploited once per turn. This means if an enemy
would receive multiple attacks to its elemental weakness(es), the exploited
effect will only occur once per turn, meaning the penalty states won't stack
multiple times over. This limitation is for the sake of game balance, but if
you so wish, you can turn off this limitation in the plugin parameters.

Each action can also exploit only once per use and against an unexploited
target. This means battlers cannot use the same elemental attacks against
the same foes over and over to stack up an infinite amount of turns. If the
player wants to gain more bonuses, the player would have to strike against
unexploited foes. This limitation is for the sake of game balance, but if
you so wish, you can turn off this limitation in the plugin parameters.

When all members of a party/troop are exploited, a common event can be
triggered to run, allowing for potential follow up actions. How you wish to
make these common events is up to you.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins. Here is a list
of the ones this plugin is not compatible with.

---

=== [[Party System VisuStella MZ]] ===

In battle, the player cannot change entire parties at once from the Party
Command Window. The feature will be unaccessible while Standard Turn Battle
is in play. However, the player can still change party members through the
Actor Command Window by having actors replace other actors. Party changing
is also available through battle events, Common Events, and script calls.

---

=== [[Break Shields VisuStella MZ]] ===

The Break Shields plugin can be used together with Battle System - STB.
However, it cannot be used together with the STB Exploit system. This is
because both Break Shields and the Exploit system function under similar
mechanics and will conflict. However, if STB's Exploit system is turned off,
then you can use all of the Break Shield plugin's features fully.

---

{{Notetags MZ}}

{{VisuMZ Battle System STB Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Battle System STB Plugin Commands}}

== Plugin Parameters ==

=== Speed Mechanics ===

[[File:BattleSysSTB_ActionSpeed.png]]

[[File:BattleSysSTB_Params1.png]]

Determines the mechanics of the STB Battle System.

---

Speed

JS: Finalized Speed:
- Code used to calculate the finalized speed at the start of each turn.

JS: Next Turn Speed:
- Code used to calculate speed for a following turn.

---

=== Exploit System Settings ===

[[File:BattleSysSTB_Exploit.gif]]

[[File:BattleSysSTB_Params2.png]]

Here, you can adjust the main settings for the Exploit System, including
where you can turn it on/off. The Exploited and Exploiter settings are
extensions of the Exploit System and are better off with their own sections.

---

Settings

Enable System?:
- Enable the exploit system?
- If disabled, ignore all the mechanics regarding the Exploit System.

Critical Hits:
- Do critical hits exploit the opponent?

Elemental Weakness:
- Do elemental weaknesses exploit the opponent?

Minimum Rate:
- What's the minimum rate needed to count as an elemental weakness?

Forced Actions:
- Apply exploit system to Forced Actions?
- We added this function because forced actions can disrupt player
strategies when used with the exploit system.

Reset Each Turn:
- Reset exploits at the end of each turn?

---

=== Exploited Effects Settings ===

[[File:BattleSysSTB_Exploit.gif]]

[[File:BattleSysSTB_Params3.png]]

These are effects for the exploited battlers (the receiving end). Change how
you want exploited battlers to behave here.

---

Mechanics

Added States:
- A list of the states that are added when a target is exploited.

[[File:BattleSysSTB_AllOut.png|600px]]

Full Exploit Events:
vs Actors Event:
vs Enemies Event:
- If all actors/enemies have been fully exploited, run this common event.
- Does not work with unlimited exploits.

Unlimited Exploits:
- Can battlers be exploited endlessly?

JS: On Exploited:
- Code used when the target has been exploited.

---

Animation

Animation ID:
- Play this animation when the effect activates.

Mirror Animation:
- Mirror the effect animation?

Mute Animation:
- Mute the effect animation?

---

Popups

Text:
- Text displayed upon the effect activating.

Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Flash Color:
- Adjust the popup's flash color.
- Format: [red, green, blue, alpha]

Flash Duration:
- What is the frame duration of the flash effect?

---

=== Exploiter Effects Settings ===

[[File:BattleSysSTB_Exploit.gif]]

[[File:BattleSysSTB_Params4.png]]

These are effects for the battlers doing the exploiting. Change how you want
exploiter battlers to behave here.

---

Mechanics

Added States:
- A list of the states that are added when a user exploits a foe.

Extra Actions:
- Successfully exploiting an enemy will grant the user this many
extra actions.

Multiple Exploits:
- Can battlers exploit opponents multiple times with one action?

JS: On Exploiting:
- Code used when the user is exploiting a foe's weakness.

---

Animation

Animation ID:
- Play this animation when the effect activates.

Mirror Animation:
- Mirror the effect animation?

Mute Animation:
- Mute the effect animation?

---

Popups

Text:
- Text displayed upon the effect activating.

Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Flash Color:
- Adjust the popup's flash color.
- Format: [red, green, blue, alpha]

Flash Duration:
- What is the frame duration of the flash effect?

---

=== Turn Order Settings ===

[[File:BattleSysSTB_TurnOrder.png]]

[[File:BattleSysSTB_Params5.png]]

Turn Order Display settings used for Battle System STB. These adjust how the
visible turn order appears in-game.

---

General

Display Position:
- Select where the Turn Order will appear on the screen.

Offset X:
- How much to offset the X coordinate by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset the Y coordinate by.
- Negative: up. Positive: down.

Center Horizontal?:
- Reposition the Turn Order Display to always be centered if it is a
'top' or 'bottom' position?

Reposition for Help?:
- If the display position is at the top, reposition the display when the
help window is open?

Reposition Log?:
- If the display position is at the top, reposition the Battle Log Window
to be lower?

Forward Direction:
- Decide on the direction of the Turn Order.
- Settings may vary depending on position.
- Left to Right / Down to Up
- Right to Left / Up to Down

Subject Distance:
- How far do you want the currently active battler to distance itself from
the rest of the Turn Order?

Screen Buffer:
- What distance do you want the display to be away from the edge of the
screen by?

---

Reposition For Help

Repostion X By:
Repostion Y By:
- Reposition the display's coordinates by this much when the Help Window
is visible.

---

Slots

Max Horizontal:
- Maximum slots you want to display for top and bottom Turn Order Display
positions?

Max Vertical:
- Maximum slots you want to display for left and right Turn Order Display
positions?

Length:
- How many pixels long should the slots be on the Turn Order display?

Thin:
- How many pixels thin should the slots be on the Turn Order display?

Update Frames:
- How many frames should it take for the slots to update their
positions by?

---

Slot Border

Show Border?:
- Show borders for the slot sprites?

Border Thickness:
- How many pixels thick should the colored portion of the border be?

Actors
Enemies

Border Color:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Border Skin:
- Optional. Place a skin on the actor/enemy borders instead of
rendering them?

---

Slot Sprites

Actors

Sprite Type:
- Select the type of sprite used for the actor graphic.
- Face Graphic - Show the actor's face.
- Icon - Show a specified icon.
- Sideview Actor - Show the actor's sideview battler.

Default Icon:
- Which icon do you want to use for actors by default?

Enemies

Sprite Type:
- Select the type of sprite used for the enemy graphic.
- Face Graphic - Show a specified face graphic.
- Icon - Show a specified icon.
- Enemy - Show the enemy's graphic or sideview battler.

Default Face Name:
- Use this default face graphic if there is no specified face.

Default Face Index:
- Use this default face index if there is no specified index.

Default Icon:
- Which icon do you want to use for enemies by default?

Match Hue?:
- Match the hue for enemy battlers?
- Does not apply if there's a sideview battler.

---

Slot Letter

Show Enemy Letter?:
- Show the enemy's letter on the slot sprite?

Font Name:
- The font name used for the text of the Letter.
- Leave empty to use the default game's font.

Font Size:
- The font size used for the text of the Letter.

---

Slot Background

Show Background?:
- Show the background on the slot sprite?

Actors
Enemies

Background Color 1:
Background Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Background Skin:
- Optional. Use a skin for the actor background instead of
rendering them?

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.23: May 18, 2026
* Bug Fixes!
** Fixed a bug where if a stun is cleared before an actor's turn, the actor would lose that turn. This should no longer happen. Fix made by Olivia.

Version 1.22: February 16, 2026
* Bug Fixes!
** Fixed a bug where <nowiki><STB Cannot Be Exploited></nowiki> and <nowiki><STB Cannot Be Exploiter></nowiki> notetags were not working properly. Bug fixed by Olivia.

Version 1.21: September 14, 2023
* Bug Fixes!
** Fixed a bug where auto-battle would not give ONE MORE! bonus to actors. Fix made by Olivia.

Version 1.20: July 13, 2023
* Bug Fixes!
** Fixed a bug involving auto-battle that would give infinite actions if cancelled at specific timings. Fix made by Olivia.

Version 1.19: January 20, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.18: December 15, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.17: August 18, 2022
* Bug Fixes!
** Fixed bugs that caused the STB Turn Order faces and icons to not change properly for actors and enemies. Fix made by Olivia.

Version 1.16: July 7, 2022
* Compatibility Update!
** Plugin is now updated to support larger than 8 troop sizes.

Version 1.15: June 9, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Olivia:
*** Plugin Parameters > Exploit System Settings > Forced Actions
**** Apply exploit system to Forced Actions?
**** We added this function because forced actions can disrupt player strategies when used with the exploit system.

Version 1.14: March 3, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.13: November 11, 2021
* Bug Fixes!
** Critical hits for enemies with only one action per turn should now properly allow for the exploited effect to occur. Fix made by Olivia.

Version 1.12: October 28, 2021
* Bug Fixes!
** Turn Order display will no longer appear at differing X and Y positions when using specific battle layouts. Update made by Olivia.

Version 1.11: July 23, 2021
* Bug Fixes!
** Fixed a bug that altered the current action choice when enemies are using a skill that utilizes instants when there is only enough MP left for one of those actions. Fix made by Olivia.

Version 1.10: July 2, 2021
* Bug Fixes!
** Dead battlers will no longer reappear in the turn order on subsequent turns. Fix made by Olivia.
* Documentation Update!
** Help file updated for updated features.
* Feature Update!
** "Mechanics Settings" Plugin Parameters has been updated into "Speed Mechanics" with updated formulas that will now correlate any adjusted AGI changes made to battlers to alter the following turn properly. Update made by Olivia.

Version 1.09: March 26, 2021
* Bug Fixes!
** Enemy exploit actions should now associate A.I. properly. Fix by Yanfly.
* Documentation Update!
** Added "VisuStella MZ Compatibility" section for detailed compatibility explanations with the VisuMZ_4_BreakShields plugin.

Version 1.08: March 19, 2021
* Feature Update!
** Turn Order Window calculations slightly tweaked for times when the window layer is bigger than it should be. Update made by Olivia.
* Optimization Update!
** Plugin should run more optimized.

Version 1.07: January 22, 2021
* Feature Update!
** A different kind of end battle check is now made to determine hiding the turn order display. Update made by Olivia.

Version 1.06: January 1, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.05: December 25, 2020
* Bug Fixes!
** Starting battle from a surprise attack will no longer skip turn 1. And starting battle without any inputtable actors will no longer skip turn 1. Fix made by Yanfly.

Version 1.04: December 18, 2020
* Feature Update!
** Enemies can now benefit from <STB Instant> skills. Update made by Olivia.
** Action End States updating are now handled by Skills and States Core v1.07+ for proper intended usage. Change from Battle System - STB v1.02 is reverted here to prevent triggering the update twice.

Version 1.03: December 4, 2020
* Bug Fixes!
** Select Next Command no longer returns undefined. Fix made by Olivia.

Version 1.02: November 22, 2020
* Bug Fixes!
** Action End States now update at the end of each individual action. Fix made by Yanfly.

Version 1.01: November 15, 2020
* Bug Fixes!
** Now compatible with Party Command Window Disable from the Battle Core. Fix made by Yanfly.

Version 1.00: November 23, 2020
* Finished Plugin!

== See Also ==

* [[Battle System Differences VisuStella MZ]]
* [[Inspiration Behind Wave 5]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]




[[Category: RPG Maker MZ Gameplay Plugins]]





[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]


[[Category: RPG Maker MZ Quality of Life Plugins]]

Battle System - BTB VisuStella MZ

2026-05-17T08:42:38Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=dwo-92nHRqc</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/862880" width="552" height="167"><a href="https://visustellamz.itch.io/battle-system-btb">Battle System - BTB plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 6}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:BattleSysBTB_Preview1.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]
* [[Items and Equips Core VisuStella MZ]]
* [[Skills and States Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:BattleSysBTB_Preview1.png|600px]]

The Brave Turn Battle (BTB) system plays off RPG Maker MZ's default battle
system with a twist of allowing actors (and enemies) to use up actions from
the future or save up for later. These actions will be queued and delivered
all in one go! Any borrowed actions from the future will result in following
turns without any actions to use. Should a player decide to save up their
actions instead through Guarding, they can charge actions with less
repercussions. Players will have to be brave about how to go about the
battle system strategically.

Because multiple actions can be queued up all at once, they can result in
the creation of an action fusion. Some skills (and items) can appear instead
of the originally queued actions to result in stronger, better, and more
awesome effects, all of which, can be defined by the game dev.

A Turn Order Display will also appear on the screen to show the order the
battlers will take their turns in. This lets the player plan in advance on
how to go about the rest of the turn.

*NOTE* To use this battle system, you will need the updated version of
VisuStella's Core Engine. Go into its Plugin Parameters and change the
"Battle System" plugin parameter to "btb".

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

* Puts a twist on the Default Turn Battle system by allowing brave players to borrow actions from the future turns or save them up for later turns.
* Brave Points, a new currency, are added to mark how many saved turns there are for each battler.
* Certain actions can cost more Brave Points than others.
* Effects that allow battlers to alter the Brave Points of their targets.
* A Turn Order Display to show the player when each battler will have its turn to perform an action.
* Action fusion system which takes any of the queued up skills and/or items to bring forth new ones.
* Action fusion combinations can be either flexible or strict.
* Flexible action fusion combinations can have their actions queued up in any order to bring forth the result.
* Strict action fusion combinations must require their actions to be queued up in a specific order in order to bring forth the result.

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]
* [[Items and Equips Core VisuStella MZ]]
* [[Skills and States Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

=== Turn Order Display ===

[[File:BattleSysBTB_TurnOrder.png]]

The Turn Order Display will capture the battle's currently active battler
and any battlers found in the active battlers array for the BattleManager.
This does not overwrite any functions, but the Turn Order Display may or may
not conflict with any existing HUD elements that are already positioned on
the screen. If so, you can choose to offset the Turn Order Display or move
it to a different part of the screen through the plugin parameters.

---

=== Brave Points and the Brave Command ===

[[File:BattleSysBTB_BraveCmd.png]]

Abbreviated to "BP", Brave Points are a new currency available through the
Brave Turn Battle system. Battlers require at least 0 BP in order to perform
any actions for that turn. By default, each action consumes 1 BP. At the end
of each turn, each battler regenerates 1 BP. With the normal flow of battle,
this results in a net balance.

However, the player can activate the "Brave Command" located right above the
Guard Command. This lets the battler create an extra action to perform. When
used, the flow of battle will result in a negative net of BP. When BP is at
-1 or under, that battler's turn is skipped until it raises back to 0. This
effectively means that the "Brave Command" will borrow actions from future
turns.

The Guard Command, however will never consume any BP for its actions even if
replaced as it is always determined by the battler's current guard skill.
This means that when used, the Guard Command lets a battler save up BP for
future turns, allowing BP to go net positive for the turn.

By strategically deciding when to borrow actions or save up for them, whole
new strategies can be created for battle.

The game dev has control over how many max actions can be borrowed at once,
the maximum and minimum amounts for BP to go to, how much BP will cost at
default, and how much BP can be regenerated by default. These settings can
all be made within the Plugin Parameters.

---

=== Action Times + ===

While the Brave Turn Battle system is active, the "Action Times +" trait
is disabled. This is to prevent any conflicts with the Brave system. If the
Brave Turn Battle system is disabled during the course of the game, then the
"Action Times +" will resume working like normal.

---

=== Can Input ===

As mentioned in the "Brave Points and the Brave Command" above, if BP is
under 0, then that battler cannot input or act for that turn. The battler
would have to wait for BP regenerate back up to 0 first.

---

=== Can Guard ===

The Guard action is only enabled when there's one action to use for that
turn. This means that if the "Brave Command" is used to generate new actions
to perform during that turn, the Guard Command will be disabled. It can be
enabled once again if the player cancels out the Brave Command until the
action count reaches 1.

---

=== Enemy Brave Actions ===

Enemies can also use the "Brave Command" by faking it. By making a dummy
skill with the <BTB Multiple Actions: id, id, id, id> skill notetag or the
<BTB Multiple Actions: name, name, name, name> skill notetag, you can have
the enemy perform the exact skills you want in a multi-action queue.

Enemies that use this will also suffer from heavy BP expenditure and wait on
subsequent turns until they have enough BP to perform actions again.

This is also how you can have enemies perform Action Fusions. For the queued
skills, load up the Action Fusion's skill combination you want for the enemy
to perform.

---

== Action Fusions ==

This feature deserves its own section as it's quite indepth with how it
works. Action Fusions can be performed by either the actor and/or enemy
(though this can be disabled in the Plugin Parameters or through traits).
In order for them to occur, the queued up action list must have a certain
combination of skills/items for the Action Fusion to occur.

---

=== Fusion Types ===

[[File:BattleSysBTB_ActionFusion.png]]

[https://cazwolf.itch.io/ Icons by CazWolf]

There are two types of Action Fusions: Flexible and Strict. Flexible Action
Fusions can use a combination of skills/items in any order (thus flexible),
while Strict Action Fusions must have their skill/item combinations queued
up in the exact order they're listed (thus strict).

They all share the following properties:

Skill Action Fusions can only use skills for combinations. This means that
Action Fusions made as a skill database object cannot have item requirements
for the combinations.

Item Action Fusions can only use items for combinations. This means that
Action Fusions made as an item database object cannot have skills for the
combination requirements.

Skills and items that have selectable targets need to have matching targets
to be a part of the same Action Fusion combination. For example, if "Quad
Attack" requires "Attack", "Attack", "Attack", "Attack", then the player
would have to target the same enemy for each of the "Attack" actions. This
is to prevent the cases where the player wants to spread out the damage
evenly across various enemies without forming it into a single target "Quad
Attack" against one.

Skills and items that do not have selectable targets are combination targets
for any and all candidates. This means an area of effect "Flame" spell can
combine with any target selectable or otherwise skill.

When an Action Fusion is performed, it will not consume the resources for
the database object itself, but instead, from each of the skills/items used
to bring it out. This means the skill costs of the Action Fusion itself are
irrelevant, but the skill costs of the combinations do matter and will be
consumed instead. The same applies to items.

If the Action Fusion skill/item is used directly, its resource consumption
will be performed as if it was not an Action Fusion skill/item. The "Quad
Attack" skill will use its regular MP and TP costs while the "Double Elixir"
item will consume itself.

If a queue could potentially meet the demands of multiple Action Fusions,
then the Action Fusion with the highest database ID will be given priority,
as to make it less complicated. This means if the "Double Attack" Action
Fusion and "Triple Attack" Action Fusion were to occur at the same time,
if the "Triple Attack" skill has a higher ID than "Double Attack", then
"Triple Attack" will take priority instead.

The battler must be able to pay the actions of each of the queued actions
used to form the Action Fusion. This means if a battler would run out of MP
or items for the cost, it will just simply not occur.

An Action Fusion can have multiple combinations that create it as long as
there are multiple notetags that determine the Action Fusion. As an example,
the "Flame Strike" can occur with the "Attack" and "Flame" combination or
the "Strike" and "Flame" combination.

---

=== Flexible Action Fusion ===

[[File:BattleSysBTB_ActionFusion.png]]

[https://cazwolf.itch.io/ Icons by CazWolf]

<pre>
<BTB Flexible Fusion: id, id>
<BTB Flexible Fusion: id, id, id>
<BTB Flexible Fusion: id, id, id, id>

<BTB Flexible Fusion: name, name>
<BTB Flexible Fusion: name, name, name>
<BTB Flexible Fusion: name, name, name, name>

- Used for: Skill, Item Notetags
- This Action Fusion skill/item will occur as long as any of the listed
combination skills/items are queued in the action list for that turn.
These actions can be queued in any order.
- Replace 'id' with the database ID of the skill/item to use as a
combination requirement.
- Replace 'name' with the name of the skill/item to use as a combination
requirement.
- Skill Action Fusions can only use skills for combinations.
- Item Action Fusions can only use items for combinations.
- Skills and items that have selectable targets need to have matching
targets to be a part of the same Action Fusion combination.
- Skills and items that do not have selectable targets are combination
targets for any and all candidates.
- When an Action Fusion is performed, it will not consume the resources for
the database object itself, but instead, from each of the skills/items
used to bring it out.
- Is used directly, this action's resource consumption will be performed as
if it was not an Action Fusion skill/item.
- If a queue could potentially meet the demands of multiple Action Fusions,
then the Action Fusion with the highest database ID is given priority.
- The battler must be able to pay the actions of each of the queued actions
used to form the Action Fusion.
- Insert multiple copies of this notetag to give this Action Fusion more
combinations that can activate it.

Examples:

---

Fire Strike

<BTB Flexible Fusion: Attack, Fire>

This Action Fusion will occur if a battler has the "Attack" and "Fire"
actions queued up in any order. "Attack" can come before "Fire" or "Fire"
can come before "Attack" and it would still call upon "Fire Strike".

---

Flame Strike

<BTB Flexible Fusion: Attack, Flame>
<BTB Flexible Fusion: Strike, Flame>

This Action Fusion will occur if a battler has "Attack" and "Flame",
"Flame" and "Attack", "Strike" and "Flame", or "Flame" and "Strike" in its
action queue.

---
</pre>

---

=== Strict Action Fusion ===

[[File:BattleSysBTB_ActionFusion.png]]

[https://cazwolf.itch.io/ Icons by CazWolf]

<pre>
<BTB Strict Fusion: id, id>
<BTB Strict Fusion: id, id, id>
<BTB Strict Fusion: id, id, id, id>

<BTB Strict Fusion: name, name>
<BTB Strict Fusion: name, name, name>
<BTB Strict Fusion: name, name, name, name>

- Used for: Skill, Item Notetags
- This Action Fusion skill/item will occur as long as the exact listed
combination(s) of skills/items is queued in the action list for that turn.
These actions can be queued in any order.
- Replace 'id' with the database ID of the skill/item to use as a
combination requirement.
- Replace 'name' with the name of the skill/item to use as a combination
requirement.
- Skill Action Fusions can only use skills for combinations.
- Item Action Fusions can only use items for combinations.
- Skills and items that have selectable targets need to have matching
targets to be a part of the same Action Fusion combination.
- Skills and items that do not have selectable targets are combination
targets for any and all candidates.
- When an Action Fusion is performed, it will not consume the resources for
the database object itself, but instead, from each of the skills/items
used to bring it out.
- Is used directly, this action's resource consumption will be performed as
if it was not an Action Fusion skill/item.
- If a queue could potentially meet the demands of multiple Action Fusions,
then the Action Fusion with the highest database ID is given priority.
- The battler must be able to pay the actions of each of the queued actions
used to form the Action Fusion.
- Insert multiple copies of this notetag to give this Action Fusion more
combinations that can activate it.

Example:

---

Shadow Flare Blade

<BTB Strict Fusion: Shade II, Fire II, Attack>

The battler must queue up "Shade II", "Fire II", and "Attack" in that
exact order or else "Shadow Flare Blade" will not occur. Even if the
battler changed the order to "Fire II", "Shade II", and "Attack", the
Action Fusion will not occur.

---
</pre>

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Boost Action VisuStella MZ]]

The Boost Actions plugin cannot be used together with Battle System - BTB.
If the Battle System is switched to using Battle System - BTB, then the
Boost Actions plugin will shut itself off.

The reason why these plugins cannot work together is because their mechanics
play off too similarly to each other and cause conflicts. We, the plugin
developer team, highly recommend that you utilize Battle System - BTB's
Brave system instead of the Boost system to make the best use of the battle
system in effect.

---

{{Notetags MZ}}

{{VisuMZ Battle System BTB Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Battle System BTB Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:BattleSysBTB_Preview1.png|600px]]

[[File:BattleSysBTB_Params1.png]]

General settings regarding Battle System BTB. These range from how Brave
Points (BP) appear in-game to how their costs are displayed.

---

Brave Points

[[File:BattleSysBTB_BraveCmd.png]]

Full Name:
- What is the full name of "Brave Points" in your game?

Abbreviation:
- What is the abbreviation of "Brave Points" in your game?

Icon:
- What icon do you wish to use to represent Brave Points?

Cost Format:
- How are Brave Point costs displayed?
- %1 - Cost, %2 - BP Text, %3 - Icon

---

Displayed Costs

[[File:BattleSysBTB_Costs.png|600px]]

Cost Position Front?:
- Put the BP Cost at the front of skill/item costs?

Show Cost: Attack:
- Show the BP cost for the Attack command?

Show Cost: Guard:
- Show the BP cost for the Guard command?

Reduce Shown BP Cost:
- Reduce shown BP costs by this much.
- Used to match traditional games.

Show Cost: 0 BP:
- Show the BP cost when the cost is 0 BP?
- Shown BP Cost reduction is applied.

Show Cost: 1 BP:
- Show the BP cost when the cost is 1 BP?
- Shown BP Cost reduction is applied.

---

=== Mechanics Settings ===

[[File:BattleSysBTB_Params2.png]]

Adjust the mechanics settings for the Battle System BTB. Mechanics range
from how speed is handled to Brave action caps, how Brave Points are
managed, and Action Fusions.

---

Action Speed

Allow Random Speed?:
- Allow speed to be randomized base off the user's AGI?

JS: Calculate:
- Code used to calculate action speed.

---

Brave Action Max

[[File:BattleSysBTB_BraveCmd.png]]

Default:
- What is the default number of max actions a battler can have from the
Brave system?

Hard Cap:
- What is the absolute highest for maximum actions a battler can have
from the Brave system?

---

Brave Points > Limits

[[File:BattleSysBTB_BPManip.png]]

Default Maximum:
- What is the default maximum number of Brave Points a battler can have at
a time?

Default Minimum:
- What is the default minimum number of Brave Points a battler can have at
a time?

Hard Cap Maximum:
- What is the absolute maximum number of Brave Points a battler can have
at a time?

Hard Cap Minimum:
- What is the absolute minimum number of Brave Points a battler can have
at a time?

---

Brave Points > Costs

[[File:BattleSysBTB_Costs.png|600px]]

Default Skill Cost:
- How many Brave Points does a skill cost by default?

Default Item Cost:
- How many Brave Points does an item cost by default?

Predicted Cost:
- What is considered predicted cost?

---

Brave Points > Start Battle

[[File:BattleSysBTB_BPManip.png]]

Neutral:
- How many Brave Points should a battler have if the battle advantage is
neutral?

Favored:
- How many Brave Points should a battler have if the battle advantage is
favored?

---

Brave Points > Regeneration

[[File:BattleSysBTB_BPManip.png]]

Base Recovery:
- How many Brave Points are regenerated at the end of each turn?

Needs to be Alive?:
- Do battlers need to be alive to regenerate Brave Points?

---

Action Fusions

[[File:BattleSysBTB_ActionFusion.png]]

[https://cazwolf.itch.io/ Icons by CazWolf]

Actor Access?:
- Allow actors access to Action Fusions?

Enemy Access?:
- Allow enemies access to Action Fusions?

---

=== Brave Animations Settings ===

[[File:BattleSysBTB_Params3.png]]

Animation when applying/canceling Brave effects.

---

On Brave

[[File:BattleSysBTB_Preview1.png|600px]]

Animation ID:
- Play this animation when the effect activates.

Mirror Animation:
- Mirror the effect animation?

Mute Animation:
- Mute the effect animation?

---

Cancel Brave

[[File:BattleSysBTB_Preview1.png|600px]]

Animation ID:
- Play this animation when the effect activates.

Mirror Animation:
- Mirror the effect animation?

Mute Animation:
- Mute the effect animation?

---

Enemy Brave

[[File:BattleSysBTB_Preview1.png|600px]]

Show Activation?:
- Show the enemy activating Brave?

Wait Frames:
- This is the number of frames to wait between activations.

---

=== Turn Order Display Settings ===

[[File:BattleSysBTB_TurnOrder.png]]

[[File:BattleSysBTB_Params4.png]]

Turn Order Display settings used for Battle System BTB. These adjust how the
visible turn order appears in-game.

---

General

Display Position:
- Select where the Turn Order will appear on the screen.

Offset X:
- How much to offset the X coordinate by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset the Y coordinate by.
- Negative: up. Positive: down.

Center Horizontal?:
- Reposition the Turn Order Display to always be centered if it is a
'top' or 'bottom' position?

Reposition for Help?:
- If the display position is at the top, reposition the display when the
help window is open?

Reposition Log?:
- If the display position is at the top, reposition the Battle Log Window
to be lower?

Forward Direction:
- Decide on the direction of the Turn Order.
- Settings may vary depending on position.
- Left to Right / Down to Up
- Right to Left / Up to Down

Subject Distance:
- How far do you want the currently active battler to distance itself from
the rest of the Turn Order?

Screen Buffer:
- What distance do you want the display to be away from the edge of the
screen by?

---

Reposition For Help

Repostion X By:
Repostion Y By:
- Reposition the display's coordinates by this much when the Help Window
is visible.

---

Slots

Max Horizontal:
- Maximum slots you want to display for top and bottom Turn Order Display
positions?

Max Vertical:
- Maximum slots you want to display for left and right Turn Order Display
positions?

Length:
- How many pixels long should the slots be on the Turn Order display?

Thin:
- How many pixels thin should the slots be on the Turn Order display?

Update Frames:
- How many frames should it take for the slots to update their
positions by?

---

Slot Border

Show Border?:
- Show borders for the slot sprites?

Border Thickness:
- How many pixels thick should the colored portion of the border be?

Actors
Enemies

Border Color:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Border Skin:
- Optional. Place a skin on the actor/enemy borders instead of
rendering them?

---

Slot Sprites

Actors

Sprite Type:
- Select the type of sprite used for the actor graphic.
- Face Graphic - Show the actor's face.
- Icon - Show a specified icon.
- Sideview Actor - Show the actor's sideview battler.

Default Icon:
- Which icon do you want to use for actors by default?

Enemies

Sprite Type:
- Select the type of sprite used for the enemy graphic.
- Face Graphic - Show a specified face graphic.
- Icon - Show a specified icon.
- Enemy - Show the enemy's graphic or sideview battler.

Default Face Name:
- Use this default face graphic if there is no specified face.

Default Face Index:
- Use this default face index if there is no specified index.

Default Icon:
- Which icon do you want to use for enemies by default?

Match Hue?:
- Match the hue for enemy battlers?
- Does not apply if there's a sideview battler.

---

Slot Letter

Show Enemy Letter?:
- Show the enemy's letter on the slot sprite?

Font Name:
- The font name used for the text of the Letter.
- Leave empty to use the default game's font.

Font Size:
- The font size used for the text of the Letter.

---

Slot Background

Show Background?:
- Show the background on the slot sprite?

Actors
Enemies

Background Color 1:
Background Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Background Skin:
- Optional. Use a skin for the actor background instead of
rendering them?

---

=== Window Settings ===

[[File:BattleSysBTB_BPManip.png]]

[[File:BattleSysBTB_Params5.png]]

Settings regarding the windows of the Battle System BTB. These mostly adjust
how certain aspects of the Brave Turn Battle system appear in-game.

---

Window_ActorCommand

Command Text:
- What is the text that appears for the Brave command?

Show Command?:
- Show the Brave command in the Actor Command Window?

Page Up/Dn Shortcuts?:
- Use Page Up/Down for shortcuts on activating Brave?

JS: Draw Counters:
- Code used to determine how the action counters are displayed on
the window.

Action Slot:
- This is the text used to represent a non-selected action slot.

Current Action:
- This is the text used to represent the current action slot.

---

Window_BattleStatus

Display Format:
- How are actor Brave Point displayed?
- %1 - Total BP, %2 - BP Text, %3 - Icon

Predict Format:
- How are predicted Brave Point displayed?
- %1 - Total BP, %2 - BP Text, %3 - Icon, %4 - Predicted

---

Window_BattleStatus > Text Colors

Neutral Color:
- Text code color for neutral number values.

Positive Color:
- Text code color for positive number values.

Negative Color:
- Text code color for negative number values.

---

Window_BattleStatus > Style Settings > Default Style

Window_BattleStatus > Style Settings > List Style

Window_BattleStatus > Style Settings > XP Style

Window_BattleStatus > Style Settings > Portrait Style

Window_BattleStatus > Style Settings > Border Style

Window_BattleStatus > Style Settings > Alignment Style

Show Display?:
- Show the actor's BP values in the Battle Status Window?

Alignment:
- How do you want the actor BP values to be aligned?

Offset X:
Offset Y:
- Offset the actor BP display X/Y by how many pixels?

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.20: May 18, 2026
* Optimization Update!
** Plugin should run more optimized.

Version 1.19: June 12, 2025
* Bug Fixes!
** Fixed a bug where notetags like <nowiki><Target: Enemy or Ally></nowiki> would cause action fusions to not work properly. Fix made by Arisu.
** Fixed a bug where some special targeting cases were not preserved when performing action fusions. Fix made by Arisu.

Version 1.18: April 17, 2025
* Bug Fixes!
** Fixed a bug where flex fusion combinations did not work properly and where the strict fusion combinations would draw from flex fusions. Fix made by Olivia.

Version 1.17: February 20, 2025
* Bug Fixes!
** Fixed a bug where for certain battle layouts, the BTB Action Counter on the actor command window would start off center. Fix made by Olivia.

Version 1.16: March 14, 2024
* Bug Fixes!
** Fixed a bug where strict action fusion combinations would not register. Fix made by Olivia.

Version 1.15: February 15, 2024
* Bug Fixes!
** Fixed a bug where action fusions would consume double the amount of items if the skills were to cost items. Fix made by Olivia.

Version 1.14: December 15, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.13: August 18, 2022
* Bug Fixes!
** Fixed bugs that caused the BTB Turn Order faces and icons to not change properly for actors and enemies. Fix made by Olivia.

Version 1.12: August 11, 2022
* Bug Fixes!
** Fixed a bug that caused a crash due to removing actors midway in battle. Fix made by Olivia.

Version 1.11: July 7, 2022
* Compatibility Update!
** Plugin is now updated to support larger than 8 troop sizes.

Version 1.10: June 9, 2022
* Compatibility Update
** Plugins should be more compatible with one another.

Version 1.09: March 3, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.08: January 13, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.07: May 21, 2021
* Bug Fixes!
** Using items and skills outside of battle will no longer have BP restrictions imposed upon them. Fix made by Olivia.

Version 1.06: March 26, 2021
* Documentation Update!
** Added "VisuStella MZ Compatibility" section for detailed compatibility explanations with the VisuMZ_3_BoostAction plugin.

Version 1.05: March 19, 2021
* Feature Update!
** Turn Order Window calculations slightly tweaked for times when the window layer is bigger than it should be. Update made by Olivia.

Version 1.04: March 5, 2021
* Bug Fixes!
** <BTB User Set BP: x>, <BTB User Gain BP: +x>, <BTB User Lose BP: -x> notetags should no work properly. Fix made by Arisu.

Version 1.03: January 22, 2021
* Feature Update!
** A different kind of end battle check is now made to determine hiding the turn order display. Update made by Olivia.

Version 1.02: January 1, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.01: December 25, 2020
* Bug Fixes!
** Brave Point preview in the battle status will now be bound by the absolute minimum hard card and the maximum soft cap. Fixed by Yanfly.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Notetag added by Yanfly.
*** <BTB Enable Fusion>

Version 1.00: January 4, 2021
* Finished Plugin!

== See Also ==

* [[Battle System Differences VisuStella MZ]]
* [[Inspiration Behind Wave 6]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]
[[Category: RPG Maker MZ Item Plugins]]
[[Category: RPG Maker MZ Skill Plugins]]


[[Category: RPG Maker MZ Gameplay Plugins]]





[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]

Items and Equips Core VisuStella MZ

2026-05-17T08:42:31Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=R7ylHVC-ykE</youtube>
|link1 = {{VisuStella Wave 1}}
|link2 = {{VisuStella All Waves Collection}}

}}



{|
| [[File:ItemsEquipsCoreEquipTypes.png|400px]]
| [[File:ItemsEquipsCoreShopStatus.png|400px]]

|-

| [[File:ItemsEquipsCoreEquipChange.png|400px]]
| [[File:ItemsEquipsCoreShopEquip.png|400px]]

|}

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{ExtensionPluginsMZ}}
* [[Battle System - BTB VisuStella MZ]]
* [[Battle System - ETB VisuStella MZ]]
* [[Battle System - FTB VisuStella MZ]]
* [[Battle System - PTB VisuStella MZ]]
* [[Equip Medal System VisuStella MZ]]
* [[Equipment Set Bonuses VisuStella MZ]]
* [[Item Amplify Skills VisuStella MZ]]
* [[Item Crafting System VisuStella MZ]]
* [[Item Concoction Skills VisuStella MZ]]
* [[Item Throw Skills VisuStella MZ]]
* [[More Currencies VisuStella MZ]]
* [[One Time Purchase VisuStella MZ]]
* [[Shop Batches VisuStella MZ]]
* [[Shop Bust Style UI VisuStella MZ]]
* [[Shop Listing Unlock VisuStella MZ]]
* [[Weapon Swap System VisuStella MZ]]

{{Visustella MZ}}

== Introduction ==

The Items & Equips Core makes improvements to the RPG Maker MZ item and
equipment dedicated scenes (including the shop) and how they're handled.
From more item categories, better parameter control, rulings, and more, game
devs are able to take control over key aspects of their game's items.

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

* Modifying the appearances to the Item Scene, Equip Scene, and Shop Scene.
* Categorizing items in unique and multiple categories.
* Item Scene and Shop Scene will now display detailed information on items.
* NEW! marker can be displayed over recently acquired items in-game.
* Equipment notetags to adjust parameters past the editor limitations.
* Equipment Rulings to adjust what slot types can and can't be unequipped and/or optimized.
* Equipment Type Handling offers more control over equipment loadouts.
* Items sold in shops can be hidden/shown based on Switches.
* Items sold in shops can have varying prices adjusted by notetags.

== Requirements ==

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

{{MZ Tier 1}}

== Major Changes: New Hard-Coded Features ==

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

---

=== Equipment Type Handling ===

[[File:ItemsEquipsCoreEquipTypes.png|600px]]

Characters will no longer have one universal equipment slot setting.
Classes can have different equipment type loadouts, made possible through
the usage of notetags. Also, equipment types of matching names would be
treated as the same type, where previously, they would be different types.
This means if you have two "Accessory" slots, be it in the form of notetags
or through the Database > Types tab, they can both equip the same type of
accessories.

The Change Equip event command is now updated to reflect this new change.
When processing an equip change, the slot changed will go to the first
empty slot of matching type. If all of the actor's matching slot types are
equipped, then the equip will replace the last slot available.

---

=== Shop Status Window ===

[[File:ItemsEquipsCoreShopStatus.png|600px]]

The Status Window found in the Shop Scene was originally barren and did
not display much information at all. This is changed through this plugin's
new features. While the contents of the Shop Status Window can be customized
through the Plugin Parameters, it is a change that cannot be reversed and
for the better since it gives players the much needed information revolving
around the game's items.

---

=== Core Engine Compatibility: Modern Controls ===

[[File:ItemsEquipsCoreShopEquip.png|600px]]

If the [[Core Engine VisuStella MZ|VisuStella Core Engine]] is added to your game with Modern Controls
enabled, then the Item Menu Scene, Equip Menu Scene, and Shop Menu Scene's
controls will be changed a bit.

The Item Menu Scene will automatically have the Item List Window active,
with using the Left/Right (for single column) or Page Up/Page Down (for
multi-columns) to navigate between the Item Categories. Similar will occur
when trying to sell items in the Shop Menu Scene.

The Equip Menu Scene will automatically have the Equip Slots Window active
and only activate the command window upon moving up to it.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Battle Core VisuStella MZ]]

[[File:ItemsEquipsCore_37_Comp_1.png]]

Changing the "Damage Multiplier" or "Healing Multiplier" vocabulary for the
Item and Equip Core's Shop Status Window is not done with the Item and Equip
Core's Plugin Parameters if you have the Battle Core installed.

Instead, go to Battle Core's Plugin Parameters, Damage Settings, Damage
Styles, and adjust the style's version of the "Damage Multiplier" or
"Healing Multiplier" text instead.

Why does this work this way? Because not all damage styles work off
"Multipliers" so in order for it to convey the proper message to the player,
each damage style has its own vocabulary to be more accurate.

[[File:ItemsEquipsCore_37_Comp_2.png]]

In case you forget about that, when you visit the Item and Equip Core's
plugin parameters for these, it should also remind you in the parameter's
description on where to change it.

---

[[Weapon Swap System VisuStella MZ]]

The custom equip slots feature from the VisuStella MZ Items and Equips Core
allowed you to add in extra weapon slots. This is now curated up to a max
of one weapon slot per character. This needs to be done to make the Weapon
Swap System viable.

---

{{Notetags MZ}}

{{VisuMZ Items and Equips Core Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Items and Equips Core Plugin Commands}}

== Plugin Parameters ==

=== Item Menu Settings ===

[[File:ItemsEquipsCoreShopStatus.png|600px]]

[[File:ItemsEquipsCoreParams01.png]]

The Item Menu Settings allow you to adjust specifics on how key objects and
windows in the Item Menu Scene operate.

---

General Window

Use Updated Layout:
- Use the Updated Item Menu Layout provided by this plugin?
- This will automatically enable the Status Window.
- This will override the Core Engine windows settings.

Disabled: Vanilla:
- If NOT using the updated layout, keep all settings to pure vanilla and
ignore other Plugin Parameters.
- Used for those who do not wish to fiddle with the Plugin Parameter
settings to return the item menu back to default MZ vanilla.
- Does not apply if using updated layout.
- The following settings are disabled if using vanilla:
- Categories: Only the default 4
- Category Names only display text and no icons
- No Shop Status Window
- Modern Controls Disabled
- Columns: Any -> 2

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

List Window

Columns:
- Number of maximum columns.
- If you are using the VisuStella MZ Core Engine and the "Modern Controls"
Plugin Parameter, please read through that section in case you have any
questions about how to switch between categories when using multiple
columns of items at a time.

---

Item Quantity

Item Max:
Weapon Max:
Armor Max:
- The default maximum quantity for items, weapons, and/or armors.

Quantity Format:
- How to display an item's quantity.
- %1 - Item Quantity

Font Size:
- Default font size for item quantity.

---

Shop Status Window

Show in Item Menu?:
- Show the Shop Status Window in the Item Menu?
- This is enabled if the Updated Layout is on.

Adjust List Window?:
- Automatically adjust the Item List Window in the Item Menu if using the
Shop Status Window?

Background Type:
- Select background type for this window.
- 0 - Window
- 1 - Dim
- 2 - Transparent

JS: X, Y, W, H:
- Code used to determine the dimensions for this Status Window in the
Item Menu.

---

Button Assist Window

Switch Category:
- Button assist text used for switching categories.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Item Categories ===

[[File:ItemsEquipsCoreCategories.png|600px]]

[[File:ItemsEquipsCoreParams02.png]]

Item Categories appear both in the Item Menu Scene and Shop Menu Scene (but
only under the Sell command). These Plugin Parameters give you the ability
to add in the specific categories you want displayed, remove the ones you
don't, and associate them with icons.

---

List

Category List
- A list of the item categories displayed in the Item/Shop menus.

Type:
- A list of the item categories displayed in the Item/Shop menus.
- Replace x with ID numbers or text.
- AllItems, RegularItems, KeyItems
- HiddenItemA, HiddenItemB
- Consumable, Nonconsumable
- AlwaysUsable, BattleUsable, FieldUsable, NeverUsable
- AllWeapons, WType:x
- AllArmors, AType:x, EType:x
- Category:x

Icon:
- Icon used for this category.
- Use 0 for no icon.

Visibility Switch:
- This Switch must be turned ON in order for the category to show.
- Use 0 for no Switch requirement.

Sort By:
- Sort this category (in Scene_Item and Scene_Shop only) this way.

Style:
- How do you wish to draw categorie entries in the Category Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Alignment
- Decide how you want the text to be aligned.

---

Vocabulary

Hidden Item A
Hidden Item B
Consumable
Nonconsumable
Always Usable
Battle Usable
Field Usable
Never Usable
- How these categories are named in the Item Menu.

---

=== NEW! Labels ===

[[File:ItemsEquipsCoreNew.png]]

[[File:ItemsEquipsCoreParams03.png]]

Whenever the player receives a new item(s), a NEW! Label can be placed on
top of the item's icon when browsing a menu displaying the item(s). This is
a quality of life addition from more modern RPG's to help players figure out
what they've recently received. The following are Plugin Parameters made to
adjust how the NEW! Labels are handled in-game.

---

NEW! Labels

Use NEW! Labels?:
- Use the NEW! Labels or not?

Icon:
- The icon index used to represent the NEW! text.
- Use 0 to not draw any icons.

Text:
- The text written on the NEW! Label.

Font Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Font Size:
- The font size used for the NEW! text.

Fade Limit:
- What's the upper opaque limit before reversing?

Fade Speed:
- What's the fade speed of the NEW! Label?

Offset X:
- How much to offset the NEW! Label's X position by.

Offset Y:
- How much to offset the NEW! Label's Y position by.

---

=== Equip Menu Settings ===

[[File:ItemsEquipsCoreEquipTypes.png|600px]]

[[File:ItemsEquipsCoreParams04.png]]

These Plugin Parameters adjust the Equipment Menu Scene, ranging from using
a more updated and modern layout, changing the styles of other windows, and
other key visual aspects of the Equip Menu Scene. Other settings here allow
you to adjust how equipment operate under certain rulings, too.

---

General

Use Updated Layout:
- Use the Updated Equip Layout provided by this plugin?
- This will override the Core Engine windows settings.

Param Font Size:
- The font size used for parameter values.

Show Menu Portraits?:
- If Main Menu Core is installed, display the Menu Portraits instead of
the actor's face in the status window?

JS: Portrait Upper:
- If Menu Portraits are available, this is code used to draw the upper
data like this in the Status Window.

JS: Face Upper:
- If faces used used, this is code used to draw the upper data like this
in the Status Window.

JS: Parameter Lower:
- Code to determine how parameters are drawn in the Status Window.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

Status Window Width:
- The usual width of the status window if using the non-Updated Equip
Menu Layout.

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.

Cursed Equip Popup:
- Text popup appears when an actor equips a cursed weapon/armor.
- Text codes allowed.
- Requires VisuMZ_0_CoreEngine!
- Empty to not use.
- %1 - Actor, %2 - Equip, %3 - Icon.

---

Command Window

Style:
- How do you wish to draw commands in the Command Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Command Window.

Equip Icon:
- The icon used for the Equip command.

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Add Optimize Command?:
- Add the "Optimize" command to the Command Window?

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Optimize Icon:
- The icon used for the Optimize command.

Add Clear Command?:
- Add the "Clear" command to the Command Window?

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Clear Icon:
- The icon used for the Clear command.

---

Remove Equip

Icon:
- Icon used for equipment removal.

Text:
- Text used for equipment removal.

Use SHIFT Shortcut?:
- Add the "Shift" button as a shortcut key to removing items?

---

Rulings

Equip-Adjust HP/MP:
- Adjust HP/MP differences after changing equips with MaxHP/MaxMP values.

Non-Removable Types:
- Insert ID's of the Equipment Types that must always have an item
equipped and cannot be empty.

Non-Optimized Types:
- Insert ID's of the Equipment Types that will be ignored when equipment
is being optimized.

---

Button Assist Window

SHIFT: Remove:
- Button assist text used for the SHIFT Remove Shortcut.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Shop Menu Settings ===

[[File:ItemsEquipsCoreShopEquip.png|600px]]

[[File:ItemsEquipsCoreParams05.png]]

These Plugin Parameters allow you a number of options to adjust the Shop
Menu Scene. These options range from enabling an updated and modern layout,
adjust how various key visual aspects appear, and determine how prices can
be affected when it comes to selling them or buying them (for coders).

---

General

Use Updated Layout:
- Use the Updated Shop Layout provided by this plugin?
- This will override the Core Engine windows settings.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

[[File:ItemsEquipsCore_Update28_Params1.png]]

Switches

Switch: Buy:
- Buying items in the Shop Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Shop Scene opens.

Switch: Sell
- Selling items in the Shop Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Shop Scene opens.

---

Command Window

Hide Unavailable?:
- Hide all unavailable commands like when a shop is set to Purchase Only?

Style:
- How do you wish to draw commands in the Command Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Command Window.

Buy Icon:
- The icon used for the Buy command.

Sell Icon:
- The icon used for the Sell command.

Cancel Icon:
- The icon used for the Cancel command.

Rename "Cancel":
- Rename Cancel to something more logical for the Shop Menu Scene.

---

Prices

Sell Price Rate:
- The default sell price rate.

JS: Buy Price:
- Modificatons made to the buy price before finalizing it.

JS: Sell Price:
- Modificatons made to the sell price before finalizing it.

---

Button Assist Window

Small Increment:
Large Increment:
- Text used for changing amount bought/sold.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Shop Status Window ===

[[File:ItemsEquipsCoreShopStatusWindow.png]]

[[File:ItemsEquipsCoreParams06.png]]

These Plugin Parameters focuses on the Shop Status Window and determines how
its data is displayed.

---

General

Window Width:
- The usual width of the status window.

Parameter Font Size:
- Font size used for parameter changes.

Translucent Opacity:
- Opacity setting used for translucent window objects.

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.

---

Equipment Data

[[File:ItemEquipCore_StatusWindowStyles.png|600px]]

Data Style:
- How do you wish to display equipment data?
- Compare - Compares selected equip to equipped gear
- Lists all main party actors
- Displays the parameter differences when equipped
- Calculates custom JS values
- Classic - Shows basic parameters of selected equip
- Involves no actors, only shows the item's stats
- Shows weapon or armor specific parameters
- Does not show custom JS values as those are calculated per actor
- Does not show custom parameters as those are calculated per actor
- Use <Status Info> and <Custom Status Info> notetags to overwrite or
add custom data to classic equip data
- Double - Shows basic parameters in double columns
- Involves no actors, only shows the item's stats
- Shows weapon or armor specific parameters
- Does not show custom JS values as those are calculated per actor
- Does not show custom parameters as those are calculated per actor
- Use <Status Info> and <Custom Status Info> notetags to overwrite or
add custom data to classic equip data

Compare Style:

Already Equipped:
- Marker used to show an actor cannot equip an item.

Can't Equip:
- Marker used to show an actor cannot equip an item.

No Changes:
- Marker used to show no changes have occurred.

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Classic Style:

Added Weapon Params:
Added Armor Params:
- Display these parameters when a weapon/armor is selected.
- Requires VisuMZ_0_CoreEngine!

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Double Style:

Added Weapon Params:
Added Armor Params:
- Display these parameters when a weapon/armor is selected.
- Requires VisuMZ_0_CoreEngine!

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Delay MS:
- How many milliseconds (MS) to delay the preview update?
- This is to prevent lag spikes for equips only.

---

Item Data

Max State/Buff Icons:
- Maximum number of icons that can be displayed for Add/Remove
States/Buffs.

Multiplier Standard:
- Constant standard to filter out random values when calculating the
damage multiplier.

JS: Draw Item Data:
- Code used to draw the item data for the Shop Status Window.

---

Vocabulary

Consumable:
Occasions:
Scope:
Speed:
Success Rate:
Repeats:
Hit Type:
Element:
Damage Type:
Effects:
- Vocabulary used for these data entries.
- Some of these have Plugin Parameters have sub-entries.

NOTE: Regarding Damage Labels

If Visu_1_BattleCore is installed, priority goes to its Damage Style
settings. The label displayed is based on the damage style settings in
place for that specific skill or item.

Go to Battle Core > Plugin Parameters > Damage Settings > Style List >
pick the damage style you want to edit > Damage Label and change the
text settings you'd like there.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* Yanfly
* Arisu
* Olivia
* Irina

== Changelog ==

Version 1.61: May 18, 2026
* Documentation Update!
** Added extra clarity for Plugin Parameters
*** Parameters > Item Menu Scene > Shop Status Window > JS: X, Y, W, H
**** Needs "Use Updated Layout" + "Disabled: Vanilla" as false.

Version 1.60: March 16, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Parameters > Item Menu Settings > Use Updated Layout > Disabled: Vanilla
**** If NOT using the updated layout, keep all settings to pure vanilla and ignore other Plugin Parameters.
**** Used for those who do not wish to fiddle with the Plugin Parameter settings to return the item menu back to default MZ vanilla.
**** Does not apply if using updated layout.
**** The following settings are disabled if using vanilla:
***** Categories: Only the default 4
***** Category Names only display text and no icons
***** No Shop Status Window
***** Modern Controls Disabled
***** Columns: Any -> 2

Version 1.59: October 16, 2025
* Bug Fixes!
** Fixed a bug where a changed parameter in the equipment menu would accidentally highlight the next parameter's name. Fix made by Irina.

Version 1.58: February 20, 2025
* Bug Fixes!
** Optimize no longer allows player to bypass the following notetags: <nowiki><Equip Copy Limit: x></nowiki>, <nowiki><Equip Weapon Type Limit: x></nowiki>, and <nowiki><Equip Armor Type Limit: x></nowiki>. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

Version 1.57: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Added extra clarity for <nowiki><Status Info></nowiki> notetag:
*** For clarity regarding "Damage Multiplier" and "HP Recovery"/"HP Damage":
**** "Damage Multiplier" refers to the amount determined by damage formulas.
**** "HP Recovery"/"HP Damage" refers to the "Recover HP" database effect.
**** Likewise, the same will apply to "MP Recovery"/"MP Damage" if the damage formula type is to deal MP recovery/damage instead.
* New Features!
** New Notetags added by Arisu:
*** <nowiki><Status Style: type></nowiki>
**** Changes up the way the shop status window displays data for this database object in particular.
*** <nowiki><Custom Status Parameters: name, name, name></nowiki>
**** Customize which parameters are displayed for this equipment object's shop status window.
* Optimization Update!
** Plugin should run more optimized.

Version 1.56: December 19, 2024
* Bug Fixes!
** Fixed a bug where newly added equipment would cause crashes upon interaction. Fix made by Irina.

Version 1.55: November 14, 2024
* Bug Fixes!
** Fixed a bug where you can no longer attempt to equip an actor with zero equip slots and causing a crash. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
** Updated <Status Info>
*** Used for: Skill, Item, Weapon, Armor Notetags
**** Replace 'key' with one of the following for weapons and armors:
***** 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI', or 'LUK'
***** For those with VisuMZ_0_CoreEngine:
****** 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT', 'HRG', 'MRG', 'TRG'
****** 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR', 'MDR', 'FDR', 'EXR'
**** Only relevant if the Draw Style for equipment is "classic" or "double".
** Updated <Custom Status Info> notetag:
*** Used for: Skill, Item, Weapon, Armor Notetags
**** When used with weapon or armor database objects, this information is only relevant if the Draw Style for equipment is "classic" or "double".
* New Feature!
** New Plugin Parameters:
*** Parameters > Shop Status Window > Data Style:
**** How do you wish to display equipment data?
***** Compare - Compares selected equip to equipped gear
****** Lists all main party actors
****** Displays the parameter differences when equipped
****** Calculates custom JS values
***** Classic - Shows basic parameters of selected equip
***** Double - Shows basic parameters in double columns
****** Involves no actors, only shows the item's stats
****** Shows weapon or armor specific parameters
****** Does not show custom JS values as those are calculated per actor
****** Does not show custom parameters as those are calculated per actor
****** Use <Status Info> and <Custom Status Info> notetags to overwrite or add custom data to classic equip data
**** Data Style > Classic Style:
**** Data Style > Double Style:
***** Added Weapon Params
***** Added Armor Params
****** Display these parameters when a weapon/armor is selected.
****** Requires VisuMZ_0_CoreEngine!

Version 1.54: October 17, 2024
* Feature Update!
** If "Modern Controls" is selected while "Remove Equip" and "Optimize" are gone from the Equip Menu, right click will exit the menu. Feature added by Arisu.

Version 1.53: July 18, 2024
* Documentation Update!
** Help file updated for new features.
** Added warning to <JS Parameters>:
*** If you are trying to calculate a value based off a full parameter value, such as "ATK = user.atk * 0.10", it's going to break and will cause an infinite loop. Use base parameter values instead.
* New Features!
** New notetags added by Irina:
*** <ID Sort Priority: x>
**** Used for Scene_Item, Scene_Equip, Scene_Battle, and Scene_Shop's sell option (only when selling).
**** Changes sorting priority by ID for item, weapon, or armor to 'x'.
**** Default priority level is '50'.
**** Items, weapons, and armors with higher priority values will be sorted higher up on the list while lower values will be lower on the list.

Version 1.52: May 16, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Irina:
*** Parameters > Item Categories > Category List > Category > Sorted By:
**** You can now sort specific item categories by ID or Name.
**** Only usable within Scene_Item and Scene_Shop.
* Optimization Update!
** Plugin should run more optimized.

Version 1.51: December 14, 2023
* Bug Fixes!
** Fixed a bug where if an item is unequipped, it may cause a crash. Fix made by Arisu.
** Fixed a bug where <Proxy: id> did not properly give the proxy item. Fix made by Arisu.

Version 1.50: November 16, 2023
* Bug Fixes!
** <JS Buy Price> and <JS Sell Price> was not working properly. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
* Optimization Update!
** Plugin should run more optimized.
* New Features!
** New Notetags added by Arisu:
*** <Cursed>
**** If this weapon or armor is equipped, it cannot manually be removed by the player until it is purified.
**** To remove it, it must be done by event commands, script calls, or through the Purify-related Plugin Commands provided by this plugin.
**** Once purified, the weapon or armor will become unequipped unless it has a purify transformation.
**** If the newly transformed weapon/armor is equippable, it will remain in the actor's equipment slots.
**** If you are using VisuMZ_2_WeaponSwapSystem, weapons cannot become cursed in order to allow free weapon swapping. Weaponry will not be cursed if VisuMZ_2_WeaponSwapSystem is installed.
*** <Purify Transform: id>
*** <Purify Transform: name>
**** If this notetag is present on a <Cursed> weapon or armor, then upon the actor receiving purification, the weapon or armor will transform into a different item.
** New Plugin Commands added by Arisu:
*** Purify: Target Actor(s)
**** Purifies target actor(s) of any cursed weapons or armors.
*** Purify: Whole Party
**** Purifies whole party of any cursed weapons or armors.
** Added "Cursed Equip Popup" to Equip Scene Plugin Parameters.
*** Text popup appears when an actor equips a cursed weapon/armor.
** Added "Ally or Enemy" or "Enemy or Ally" scopes to Shop Status Window Plugin Parameters.
*** If unused, will default to "1 Ally" or "1 Enemy" like usual. Added by Irina.

Version 1.49: October 12, 2023
* Bug Fixes!
** Fixed a problem where for weapon types, all weapon types are listed in the equip menu even when the actor cannot equip them (though they would be disabled). Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia and sponsored by AndyL:
*** <Added EType: x>
*** <Added ETypes: x, x, x>
**** This is for armors only and does NOT work with weapons!
**** Allows a piece of armor to belong to multiple ETypes. This means a glove can be equipped as "Armgear" or as an "Accessory" if you so choose.

Version 1.48: September 14, 2023
* Bug Fixes!
** Fixed a problem where the help window position of the non-updated layout would appear in the wrong position. Fix made by Irina.
* Optimization Update!
** Plugin should run more optimized when weapons and armors exceed 2000 in database quantity.

Version 1.47: July 13, 2023
* Bug Fixes!
** Fixed a bug that would cause the shop status window to display incorrect removed buffs and debuffs. Fix made by Olivia.
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Help file updated for new features.
* Feature Updates!
** Changes made to dynamic shop listings in order to update upon listing changes rather than having to enter and exit the shop again. Update made by Arisu.
* New Features!
** New notetag effects added by Arisu and sponsored by AndyL:
*** <Conserve: x%>
**** Gives the item a percent chance when used to not consume the item.
*** <Buy Turn On Switches: x, x, x>
*** <Buy Turn Off Switches: x, x, x>
*** <Sell Turn On Switches: x, x, x>
*** <Sell Turn Off Switches: x, x, x>
**** When buying/selling an item, weapon, or armor with these notetags, turn on/off switch(es) 'x'.
*** New Plugin Parameters added by Arisu:
**** Params > Settings > Shop Status Window > Equipment Data > Delay MS:
***** How many milliseconds (MS) to delay the preview update?
***** This is to prevent lag spikes for equips only.

Version 1.46: June 15, 2023
* Bug Fixes!
** Fixed a problem where the help and input modes are not adequately adjusted when not used with the updated layout or without the Options Core custom UI placement. Fix made by Arisu.

Version 1.45: May 18, 2023
* Bug Fixes!
** Fixed a bug that would cause equip slots to not be recognized properly if the equip slot name ends in a space.

Version 1.44: April 13, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag effects added by Arisu and sponsored by Anon:
*** <Equip For Class Only: x>
*** <Equip For Classes Only: x, x, x>
*** <Equip For Class Only: name>
*** <Equip For Classes Only: name, name, name>
**** The piece of equipment can only be worn by the listed classes.
*** <Equip Requirements> notetag added.
**** Define multiple requirements that the actor needs to meet in order for this equip item to be equippable.
**** See help file for more information on the types of requirements that can be added.

Version 1.43: March 16, 2023
* Bug Fixes!
** Artifact armors should now update and refresh the party members' cache upon acquisition. Fix made by Olivia.

Version 1.42: February 16, 2023
* Bug Fixes!
** Proxy items should no longer cause infinite loops if they're made to reference other proxy items in a circular fashion. Instead, they just give the exact first found proxy instead of cycling through others. Fix made by Arisu.

Version 1.41: December 15, 2022
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu and sponsored by Anon:
*** Equip Scene > Equip Command > Help Description
*** Equip Scene > Optimize Command > Help Description
*** Equip Scene > Clear Command > Help Description
**** Help description used when these commands are selected.

Version 1.40: October 20, 2022
* Feature Update!
** For the shop status window, when comparing equipment of a type where there are multiple equipment slots (such as accessories), the plugin will now check for an empty equipment slot first and then make calculations there. Otherwise, it will use the first available equipment slot of that type regardless of the equipped item. Update made by Arisu.
* Optimization Update!
** Plugin should run more optimized.

Version 1.39: September 29, 2022:
* Feature Update!
** Changed the default code for the equip scene's status window display to prevent the face graphic and basic actor stats from going above the window boundaries if there are too many parameters displayed in the status window at a time.
** If you already have this plugin installed the changes will not be reflected unless you do the following:
**** BACKUP your game project.
**** REMOVE this plugin from the Plugin Manager list.
**** REINSTALL this plugin into the Plugin Manager list.
**** SAVE the game project.

Version 1.38: March 3, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New mechanics and notetags added by Olivia and sponsored by Anon:
*** <Party Artifact>
*** <Troop Artifact>
*** <Stackable Party Artifact>
*** <Stackable Troop Artifact>
**** Armors only! This armor cannot be equipped at all. However, by simply being in the party's inventory, its parameter bonuses and traits will be applied globally throughout the whole party or troop (depending on the notetag). Add both notetags to affect both groups.
**** The normal versions of the notetag is only applied once regardless of the number of copies are found in the party's inventory.
**** The stackable versions of the notetag will have the bonuses and traits stacked multiple times relative to the number of copies found in the party's inventory.
**** This item will NOT be added during the setup phase for Battle Tests.
***** If you want to add the item, do it manually.

Version 1.37: December 23, 2021
* Compatibility Update
** Created foundation for proxy items to be used in any applicable system and extension plugins. Update made by Arisu.

Version 1.36: December 2, 2021
* Feature Update!
** For those using custom parameters from the Core Engine and do not have the parameters all-capitalized, the plugin will automatically do it for you to prevent errors. Update made by Olivia.

Version 1.35: November 18, 2021
* Compatibility Update!
** If this plugin's updated scene is disabled, the Help Window locations for the Item, Equip, and Shop Scenes should now be at their designated locations as calculated by the VisuMZ Core Engine instead of the RMMZ default location. Update made by Irina.

Version 1.34: October 28, 2021
* Feature Update
** Added fail safe checks for projects that are using old data for starting equipment that no longer exist, thus preventing the game from opening. Update made by Arisu.

Version 1.33: August 6, 2021
* Documentation Update!
** Removed "Weapon" and "Armor" from "Used For" for <Status Info>. This was an unintended piece of documentation.

Version 1.32: July 23, 2021
* Bug Fixes!
** Fixed a bug that would cause armor duplication when changing to classes with unaligned equipment slot types. Fix made by Arisu.

Version 1.31: July 9, 2021
* Feature Update!
** Added a failsafe for price manipulation JavaScript to never have prices drop below 0 if possible. Update made by Arisu.

Version 1.30: July 2, 2021
* Documentation Update!
** Added an extra note to the help file for the following: Plugin Parameters > Item Menu Settings > List Window > Columns
*** If you are using the VisuStella MZ Core Engine and the "Modern Controls" Plugin Parameter, please read through that section in case you have any questions about how to switch between categories when using multiple columns of items at a time.

Version 1.29: June 25, 2021
* Compatibility Update
** Compatibility update with RPG Maker MZ 1.3.0+.
* Feature Update!
** Phantom data when changing equipment types in the database should no longer affect actors with cached equip ID's. Update made by Arisu.

Version 1.28: June 4, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.27: May 21, 2021
* Bug Fixes!
** Using the mouse right click in the Equip Scene while inside of the item to slot window will no longer exit the Equip Scene. Fix made by Yanfly.

Version 1.26: April 30, 2021
* Documentation Update!
** Help file updated for new features.
** "VisuStella MZ Compatibility" added VisuMZ_1_BattleCore section regarding Damage Multiplier and Healing Multiplier vocabulary settings to reduce commonly asked questions.
* New Features!
** New notetags added by Irina and sponsored by Archeia:
*** <Shop Picture Name: filename>
*** <Shop Picture Layer: x>
*** <Shop Picture Max Width: x>
*** <Shop Picture Max Height: y>
*** <Shop Picture Max Dimensions: x, y>
*** <Shop Picture Alignment: x>
*** <Shop Picture Position: y>
*** <Shop Picture Offset X: +x>
*** <Shop Picture Offset X: -x>
*** <Shop Picture Offset Y: +y>
*** <Shop Picture Offset Y: -y>
*** <Shop Picture Offset: +x, +y>
*** <Shop Picture Offset: -x, -y>
*** <Shop Picture Opacity: x>
*** <Shop Picture Opacity: x%>
**** Add images from the game project's img/pictures/ folder to display in the Shop Status Window.

Version 1.25: April 23, 2021
* Documentation Update!
** Added clarity to the <param: +x> and <param: -x> notetags:
*** These notetags do NOT work with X Parameters, S Parameters, or any custom parameters. These notetags ONLY work with the base parameters.

Version 1.24: April 16, 2021
* Bug Fixes!
** Changing an actor's equipment slots to past their original amount will no longer yield errors with duplicate slot types. Fix made by Arisu.
** Completely selling an item should now refresh the help window to the new selected item's help description. Fix made by Arisu.
* Optimization Update!
** Non-removable equipment restrictions for the equipment scene are now better optimized. Update made by Olivia.

Version 1.23: April 2, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.22: March 26, 2021
* Documentation Update!
** Added "VisuStella MZ Compatibility" section for detailed compatibility explanations with the VisuMZ_4_BreakShields plugin.

Version 1.21: March 5, 2021
* Feature Update!
** Custom equipment slots are disabled during Battle Testing for better accuracy and results.

Version 1.20: February 26, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina and sponsored by AndyL:
*** Plugin Parameters > Shop Menu Settings > Switches > Switch: Buy
*** Plugin Parameters > Shop Menu Settings > Switches > Switch: Sell
**** Buying/selling items in the Shop Scene turns this Switch to ON.
**** Switch reverts to OFF whenever the Shop Scene opens.
**** These switches can be used after a "Shop Processing" event command to determine if the player has bought an item, bought and sold an item, sold an item, or neither.

Version 1.19: January 29, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Irina.
*** <Equip Copy Limit: x>
**** Sets a maximum number of copies that the actor can wear of this equipment. Usage Example: Actors can only equip one copy of the "One-of-a-Kind Ring" on at any time despite having empty accessory slots because the ring has a <Equip Copy Limit: 1> notetag.
*** <Equip Weapon Type Limit: x>
**** This weapon cannot be equipped with other weapons of the same type once the limited amount has been reached. Usage Example: A dualwielding warrior who can only equip one sword and a dagger but never two swords or two daggers because the swords and daggers all have the <Equip Weapon Type Limit: 1> notetags on them.
*** <Equip Armor Type Limit: x>
**** This armor cannot be equipped with other armors of the same type once the limited amount has been reached. Usage Example: People cannot equip more than two glove accessories on at a time because the glove is a "Glove" armor-type and each glove item has the <Equip Armor Type Limit: 2> notetags on them.

Version 1.18: January 15, 2021
* Bug Fixes!
** Pressing "Shift" to remove equipment will now refresh the status window unlike before. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added
*** Plugin Parameters > Item Menu Settings > Background Type

Version 1.17: January 1, 2021
* Bug Fixes!
** Equipping should be working properly again. Fix made by Yanfly.

Version 1.16: December 25, 2020
* Bug Fixes!
** Equip-Adjust HP/MP should work properly now. Fix made by Yanfly.
* Documentation Update!
** Added more clarity for <JS Item Enable> to state that if the VisuStella Battle Core is installed, then all battle scope items are visible, but not necessarily enabled if they are disabled otherwise.

Version 1.15: December 18, 2020
* Bug Fixes!
** RPG Maker MZ Bug: Unusable items on an individual-actor basis will no longer be overwritten by party-based usability for battle. Fix by Yanfly.
* Documentation Update!
** Added more clarity for <JS Item Enable> to state that it removes the usable item from visibility as well if the actor unable to use it is the only person in the party.

Version 1.14: December 11, 2020
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.13: December 4, 2020
* Documentation Update!
** Added documentation for new feature(s)!
* New Features!
** New Plugin Commands added by Arisu!
*** Actor: Change Equip Slots
*** Actor: Reset Equip Slots
**** These plugin commands allow you to forcefully change the equip slots available to an actor regardless of the slots provided by its class as well as reset them.

Version 1.12: November 15, 2020
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: November 8, 2020
* Bug Fix!
** Font size ratio for the shop status window now scales to a hard coded value to prevent smaller font sizes from expanding icon sizes. Fix made by Arisu.
* Feature Update!
** Currency display in the shop menu is now reflected upon how the plugin parameters set them to display. Update made by Arisu.

Version 1.10: November 1, 2020
* Feature Update!
** Modern Controls compatibility with Core Engine no longer enables the Item Categories window and child classes to utilize the Home/End keys.

Version 1.09: October 25, 2020
* Bug Fixes!
** "All Items" category should now display the "Items" text. Fix by Irina.
** WType, AType, and EType categories now work with text. Fix by Irina.

Version 1.08: October 18, 2020
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.07: October 11, 2020
* Bug Fixes!
** XParams and SParams in the Window_EquipStatus window will no longer show a non-percentile difference if the original value is not a whole value. Fix made by Yanfly.

Version 1.06: October 4, 2020
* Bug Fixes!
** Select Item event command now displays the default amount of columns instead of whatever setting is made with the plugin parameters.

Version 1.05: September 27, 2020
* Bug Fixes!
** When using the updated shop layout, leaving the sell option will no longer cause the dummy window to appear.
* Documentation Update
** "Use Updated Layout" plugin parameters now have the added clause: "This will override the Core Engine windows settings." to reduce confusion. Added by Irina.

Version 1.04: September 13, 2020
* Bug Fixes!
** Pressing Shift to quickly remove equipment should no longer crash the game. This will also clear the help window text. Fix made by Arisu.

Version 1.03: September 6, 2020
* Bug Fixes!
** If both Optimize and Clear commands have been removed and using modern controls, pressing up at the top of the slot window list will not go to the window. Fix made by Yanfly.
** If both Optimize and Clear commands have been removed, the window will no longer appear and the slot window will be moved upward to fill any empty spaces. Fix made by Yanfly.
* New Features!
** New Plugin Parameter added in NEW! Label to let you adjust the font face.
** New Plugin Parameters added in Equip Menu Scene Settings for disabling the back rectangles and/or changing their colors.
** New Plugin Parameters added in Shop Status Window Settings for disabling the back rectangles and/or changing their colors.

Version 1.02: August 30, 2020
* Documentation Fix!
** Added: NOTE: Regarding Damage Labels
*** If Visu_1_BattleCore is installed, priority goes to its Damage Style settings. The label displayed is based on the damage style settings in place for that specific skill or item.
*** Go to Battle Core > Plugin Parameters > Damage Settings > Style List > pick the damage style you want to edit > Damage Label and change the text settings you'd like there.
*** Documentation update added by Yanfly.

Version 1.01: August 23, 2020
* Added failsafe to prevent non-existent equipment (because the database entries have been deleted) from being equipped as initial equipment. Fix made by Olivia.

Version 1.00: August 20, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 1]]

|}

== End of File ==


[[Category: RPG Maker MZ Core Plugins]]

[[Category: RPG Maker MZ Item Plugins]]

[[Category: RPG Maker MZ Equip Plugins]]

[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]

[[Category: RPG Maker MZ Quality of Life Plugins]]

Events and Movement Core VisuStella MZ

2026-05-17T08:42:10Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=DA8gr31HPLc</youtube>
|link1 = {{VisuStella Wave 1}}
|link2 = {{VisuStella All Waves Collection}}

}}



[[File:EventsMoveCoreVS8.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{ExtensionPluginsMZ}}
* [[Button Trigger Events VisuStella MZ]]
* [[Common Event Menu VisuStella MZ]]
* [[Event Signals VisuStella MZ]]
* [[Field Skills VisuStella MZ]]
* [[Furniture System VisuStella MZ]]
* [[Lighting Effects VisuStella MZ]]
* [[Movement Effects VisuStella MZ]]
* [[QTE and Trigger System VisuStella MZ]]
* [[Tile Grafter System VisuStella MZ]]

{{Visustella MZ}}

== Introduction ==

The Events & Movement Core plugin adds a lot of new functionality in terms
of event flexibility and movement options to RPG Maker MZ. These range from
adding in old capabilities from previous iterations of RPG Maker to more
mainstream techniques found in other game engines. Movement options are also
expanded to support 8-directional movement as well as sprite sheets provided
that the VisuStella 8 format is used.

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

* Event commands expanded upon to include old and new functions.
* Event templates for Copying Events, Morphing Events, and Spawning Events.
* 8-directional movement option available and sprite sheet support.
* Aesthetics for tilting the sprite when dashing and having shadows below.
* Pathfinding support for event movement through custom Move Route commands.
* Advanced switches and variable support to run code automatically.
* Turn regular Switches and Variables into Self Switches and Self Variables.
* Put labels and icons over events.
* Allow numerous ways to trigger events, through clicking, proximity, or by usage of Regions.
* Change the hitbox sizes of events to larger in any direction.
* Synchronize event movement options to move when player/other events move.
* The ability for the player to turn in place.

== Requirements ==

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

{{MZ Tier 1}}

== Features ==

=== Advanced Switches and Variables ===

[[File:EventsMoveCoreAdvSwitchesVariables.png|600px]]

Switches and variables can now run JavaScript code and return values
instantly. While at first glance, this may seem no different from using
the Control Variables event command's Script option, this can be used to
instantly set up Switch and/or Variable conditions for Parallel Common
Events, Event Page Conditions, Enemy Skill Conditions, and Troop Page
Conditions instantly without needing to make an event command to do so.

---

<pre>
<JS> code </JS>
- Used for: Switch and Variable names
- Replace 'code' with JavaScript code on what value to return.
</pre>

---

NOTE: Tagged Switches/Variables are mutually exclusive from one another.
You cannot tag them with <JS>, <Self>, or <Global> simultaneously.

---

=== Self Switches and Variables ===

[[File:EventsMoveCoreSelfSwitchesVariables.png|600px]]

RPG Maker MZ by default has 4 Self Switches: A, B, C, D. For some types of
games, this isn't enough. This plugin gives you the ability convert regular
Switches into Self Switches so you could have more.

Self Variables also do not exist in RPG Maker MZ by default. Just like with
Switches, you can turn regular Variables into Self Variables.

---

<pre>
<Self>
- Used for: Switch and Variable names
- Converts the Switch/Variable into a Self Switch/Variable.
</pre>

---

After, just use them like you would for normal Switches and Variables in an
event's page conditions. If the <Self> tag is present inside the Switch or
Variable's name, then it will use data unique to only that event.

NOTE: Tagged Switches/Variables are mutually exclusive from one another.
You cannot tag them with <JS>, <Self>, or <Global> simultaneously.

---

If you need to use a script call to get a Self Switch or Self Variable's
value, you can use the following script calls.

<pre>
Get Self Switch Values:

getSelfSwitchValue(mapID, eventID, switchID)
- Replace 'mapID' with the map ID the target event is located on.
- Replace 'eventID' with the ID of the target event.
- Replace 'switchID' with the ID number if it is a Self Switch made with
<Self> or a capital letter surrounded by quotes if it's A, B, C, or D.
- This will return the true/false value of the Self Switch.
- Example: getSelfSwitchValue(12, 34, 56)
- Example: getSelfSwitchValue(12, 34, 'B')
</pre>

<pre>
Get Self Variable Values:

getSelfVariableValue(mapID, eventID, variableID)
- Replace 'mapID' with the map ID the target event is located on.
- Replace 'eventID' with the ID of the target event.
- Replace 'variableID' with the ID number of the Self Variable.
- This will return whatever stored value is found in the Self Variable.
- Example: getSelfVariableValue(12, 34, 56)
</pre>

<pre>
Set Self Switch Values:

setSelfSwitchValue(mapID, eventID, switchID, value)
- Replace 'mapID' with the map ID the target event is located on.
- Replace 'eventID' with the ID of the target event.
- Replace 'switchID' with the ID number if it is a Self Switch made with
<Self> or a capital letter surrounded by quotes if it's A, B, C, or D.
- Replace 'value' with either 'true' or 'false' for ON/OFF respectively.
Do not use quotes.
- This will change the Self Switch's value to true/false.
- Example: setSelfSwitchValue(12, 34, 56, false)
- Example: setSelfSwitchValue(12, 34, 'B', true)
</pre>

<pre>
Set Self Variable Values:

setSelfVariableValue(mapID, eventID, variableID, value)
- Replace 'mapID' with the map ID the target event is located on.
- Replace 'eventID' with the ID of the target event.
- Replace 'variableID' with the ID number of the Self Variable.
- Replace 'value' with the value you want to set the Self Variable to.
- Example: setSelfVariableValue(12, 34, 56, 88888)
</pre>

---

=== Map Switches and Variables ===

[[File:EventsMovementCore_MapSwitches.png|600px]]

Similar to Self Switches and Self Variables, Map Switches and Map Variables
are switches and variables that retain data based on the map the player is
currently located in. In other words, they're self switches and variables
but for maps instead!

These features do not exist in RPG Maker MZ by default. Just like with the
Self Switches and Self Variables, you can turn regular Switches or Variables
into Map Switches and Map Variables using the following name tag:

---

<pre>
<Map>
- Used for: Switch and Variable names
- Converts the Switch/Variable into a Map Switch/Variable.
</pre>

---

After, just use them like you would for normal Switches and Variables in an
event's page conditions. If the <Map> tag is present inside the Switch or
Variable's name, then it will use data unique to only that map.

NOTE: Tagged Switches/Variables are mutually exclusive from one another.
You cannot tag them with <JS>, <Self>, <Map>, or <Global> simultaneously.

---

If you need to use a script call to get a Map Switch or Map Variable's
value, you can use the following script calls:

<pre>
---

Get Map Switch Values:

getMapSwitchValue(mapID, switchID)
- Replace 'mapID' with the map ID the switch is located on.
- Replace 'switchID' with the ID number of the switch to get data.
- Example: getMapSwitchValue(4, 20)

---

Get Variable Switch Values:

getMapVariableValue(mapID, variableID)
- Replace 'mapID' with the map ID the switch is located on.
- Replace 'variableID' with the ID number of the variable to get data.
- Example: getMapVariableValue(6, 9)

---

Set Map Switch Values:

setMapSwitchValue(mapID, switchID, value)
- Replace 'mapID' with the map ID the switch is located on.
- Replace 'switchID' with the ID number of the switch to get data.
- Replace 'value' with either 'true' or 'false' for ON/OFF respectively.
Do not use quotes.
- Example: setMapSwitchValue(4, 20, true)
- Example: setMapSwitchValue(6, 9, false)

---

Set Map Variable Values:

setMapVariableValue(mapID, variableID, value)
- Replace 'mapID' with the map ID the switch is located on.
- Replace 'variableID' with the ID number of the variable to get data.
- Replace 'value' with the value you want to set the Map Variable to.
- Example: setMapVariableValue(6, 9, 420)

---
</pre>

---

=== Reference Switches and Reference Variables ===

Reference Switches and Reference Variables are added in version 1.62 of this
plugin. These switches and variables allow you to reference them through
strings when using script calls.

By simply naming your switch or variable ((Reference Name)), you can use
that 'reference name' in a string to call them for script calls. This is
just so you don't need to remember the ID's of every other Switch/Variable.

When referencing the strings in the script calls, case does not matter,
which means you can use all capitals or all lower case and they'll still
reference the same switch or variable.

---

For example:

<pre>
---

Switch 10 Name: ((Priscilla Joined))

Script Call: $gameSwitches.value('Priscilla Joined')
$gameSwitches.setValue('Priscilla Joined', true)

---

Variable 20 Name: Total ((Goblins Slain))

Script Call: $gameVariables.value('Goblins Slain')
$gameVariables.setValue('Goblins Slain', 50)

---
</pre>

Remember to put quotes around the name for the script call!

This only applies for the $gameSwitches and $gameVariables functions of
value(id) and setValue(id, value). They do not apply to the other
$gameSwitches and $gameVariables functions.

---

=== Character Sprite Filename Tags ===

For the files located inside of your project's /img/characters/ folder, if
the filenames themselves have specific "tags" in them, special properties
will be applied to them. These tags can be combined together with a few
exceptions.

Some of these are new to VisuStella MZ, while others are default to MZ.

---

<pre>
!filename.png
- Tag: !
- Causes this character's sprite to align with the tile grid instead of
being lifted a few pixels higher.
- This is primarily used for things like doors, chests, and floor plates.
- Default to RPG Maker MZ.
</pre>

---

<pre>
$filename.png
- Tag: $
- Causes this character's sprite to use the "big character" format.
- Primarily used for sprites like the big monsters and such which only
have 3x4 cells as opposed to 12x8 cells that regular sprite sheets have.
- Cannot be combined with the [VS8] tag.
- Default to RPG Maker MZ.
</pre>

---

<pre>
filename[Invisible].png
- Tag: [Invisible] or [Inv]
- This character's sprite will become invisible on the map screen in-game
while almost everything else about it is visible.
- This is used for those who wish to use sprite labels for things such as
autorun and parallel events.
</pre>

---

<pre>
filename[VS8].png
- Tag: [VS8]
- Converts this sprite into a VisuStella-Style 8-Direction Sprite Sheet.
- Refer to the section below.
- Cannot be combined with the $ tag.
</pre>

---

=== VisuStella-Style 8-Directional Sprite Sheets ===

[[File:EventsMoveCoreVS8.gif]]

This plugin provides support for the VisuStella-Style 8-Directional Sprite
Sheets, also know as VS8. VS8 sprite sheets offer support for walking
frames, dashing frames, carrying frames, and emotes.

---

To designate a sprite sheet as VS8, simply add [VS8] to the filename.
Something like Actor1.png would become Actor1_[VS8].png.

---

VS8 sprites are formatted as such. Each block below is a set of 3 frames.

<pre>
Walk Down Walk DL Dash Down Dash DL
Walk Left Walk DR Dash Left Dash DR
Walk Right Walk UL Dash Right Dash UL
Walk Up Walk UR Dash Up Dash UR

Carry Down Carry DL Ladder Emotes 3
Carry Left Carry DR Rope Emotes 4
Carry Right Carry UL Emotes 1 Emotes 5
Carry Up Carry UR Emotes 2 Emotes 6
</pre>

'''Note:''' While jumping, the "carry" frame is used as most of the time, this is a sprite pose with arms up in the air where the "carried" icon is.

---

Here are how each of the emote sets are grouped from left to right.

<pre>
Emotes 1: Item, Hmph, Victory
Emotes 2: Hurt, Kneel, Collapse
Emotes 3: !, ?, Music Note
Emotes 4: Heart, Anger, Sweat
Emotes 5: Cobweb, ..., Light Bulb
Emotes 6: Sleep0, Sleep1, Sleep2
</pre>

---

=== Weighted Random Movement ===

[[File:EventsMovementCore_Update25_WeightedRandom.png|600px]]

When creating events to place on the map, you can determine what type of
autonomous movement the event will have. When selecting "Random", the event
will move randomly across the map.

However, with the way "Random" movement works with the RPG Maker MZ default
code, the event is more likely to hit a wall and then hug the said wall as
it maps laps around the map's outer borders making it feel very unnatural
for any player who's been on the map long enough.

This is where "Weighted Random Movement" comes in. It changes up the random
movement behavior to function where the farther the event is, the more
likely the event is to step back towards its "home" position (aka where it
spawned upon loading the map). This is so that a housewife NPC doesn't
suddenly wander off into the middle of an army's training grounds on the
same town map.

The event will stay closer to its home value depending on how high the
weight's value is. There are a number of ways to adjust the weighted value.

---

Plugin Parameters > Movement > Event Movement > Random Move Weight

This Plugin Parameter setting allows you to set the default weight for all
events with "Random" autonomous movement. It is set at a default value of
0.10 to give the event an understandable degree of freedom.

Lower numbers give events more freedom to move. Larger numbers will make the
events stick closer to home.

Change this value to 0 to disable it.

---

You can customize this individually per event by using Notetags and/or
Comment Tags for the events.

<pre>
<Random Move Weight: x>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is used on an event with random-type autonomous movement, then
the event will stick closer to their home location (where they are located
upon spawning on the map). How close they stick to their home location
will depend on the weighted 'x' value.
- Replace 'x' with a number between 0 and 1. Numbers closer to 0 give the
event more freedom when moving randomly while numbers closer to 1 cause
the event to stick closer to their home position.
</pre>

<pre>
<True Random Move>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is used on an event with random-type autonomous movement, then
that event will ignore the effects of weighted randomized movement.
</pre>

---

{{Notetags MZ}}

{{VisuMZ Events and Movement Core Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Events and Movement Core Plugin Commands}}

== Move Route Custom Commands ==

Some custom commands have been added to the "Set Movement Route" event
command. These can be accessed by pressing the "Script..." command and
typing in the following, which don't need to be in code form.

Keep in mind that since these are custom additions and RPG Maker MZ does not
allow plugins to modify the editor, the "Preview" button will not factor in
the effects of these commands.

If you wish to use a value from a variable, insert $gameVariables.value(x)
or \V[x] in place of the x in any of the below.

If you wish to use a value from a self variable, insert \SelfVar[x] in place
of the x in any of the below. This will only draw from the current event. If
you wish to draw data from outside event self variables, we recommend you
use the \V[x] variant after using the Plugin Commands to draw data from them
for the best accuracy.

---

<pre>
Animation: x
- Replace 'x' with the ID of the animation to play on moving unit.
</pre>

---

<pre>
Balloon: name
- Replace 'name' with any of the following to play a balloon on that the
target moving unit.
- '!', '?', 'Music Note', 'Heart', 'Anger', 'Sweat', 'Cobweb', 'Silence',
'Light Bulb', 'Sleep', 'User-Defined 1', 'User-Defined 2',
'User-Defined 3', 'User-Defined 4', 'User-Defined 5'
- Do NOT insert quotes.
- Examples:
- Balloon: !
- Balloon: Sleep
- Balloon: Heart
</pre>

---

<pre>
Fade In: x
Fade Out: x
- Fades in/out the sprite's opacity.
- Fade In will continuously raise the opacity level until it reaches 255.
- Fade Out will continuously lower the opacity level until it reaches 0.
- Replace 'x' with the speed to fade in/out the sprite.
</pre>

---

<pre>
Force Carry: On
Force Carry: Off
- For usage with the VS8 sprite sheet.
- Use ON to turn force carrying on.
- Use OFF to turn force carrying off.
- Sprites using the VS8 sprite sheet will also show the VS8 Carry frames.
</pre>

---

<pre>
Force Dash: On
Force Dash: Off
- Use ON to turn force dashing on.
- Use OFF to turn force dashing off.
- Forces dashing will prompt the player or event to be in the dashing state.
- Sprites using the VS8 sprite sheet will also show the VS8 Dashing frames.
</pre>

---

<pre>
Hug: Left
Hug: Right
- Causes the moving unit to hug the left/right side of the wall.
</pre>

---

<pre>
Index: x
- Replace 'x' with a number depicting the character index to change the
moving unit's sprite to.
</pre>

---

<pre>
Index: +x
Index: -x
- Replace 'x' with the value to change the character index of the moving
unit's sprite by.
</pre>

---

<pre>
Jump Forward: x
- Replace 'x' with the number of tiles for the unit to jump forward by.
</pre>

---

<pre>
Jump To: x, y
- Replace 'x' and 'y' with the coordinates for the unit to jump to.
</pre>

---

<pre>
Jump to Event: x
- Replace 'x' with the ID of the event for the unit to jump to.
</pre>

---

<pre>
Jump to Player
- Causes the moving unit to jump to the player.
</pre>

---

<pre>
Jump To Home
- Causes the event to jump to its home position.
- This only works on events, not player characters or followers.
</pre>

---

<pre>
Move Lower Left Until Stop
Move Down Until Stop
Move Lower Right Until Stop
Move Left Until Stop
Move Right Until Stop
Move Upper Left Until Stop
Move Up Until Stop
Move Upper Right Until Stop
- Causes the moving unit to move that direction until it hits a stop.
- Events will stop moving before they make contact with the player.
</pre>

---

<pre>
Crash Move Lower Left Until Stop
Crash Move Down Until Stop
Crash Move Lower Right Until Stop
Crash Move Left Until Stop
Crash Move Right Until Stop
Crash Move Upper Left Until Stop
Crash Move Up Until Stop
Crash Move Upper Right Until Stop
- Causes the moving unit to move that direction until it hits a stop.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move To: x, y
- Replace 'x' and 'y' with the map coordinates to move the unit to through
pathfinding.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events will go around the player.
</pre>

---

<pre>
Crash Move To: x, y
- Replace 'x' and 'y' with the map coordinates to move the unit to through
pathfinding.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move to Event: x
- Replace 'x' with the ID of the event to move the unit to.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events will go around the player.
</pre>

---

<pre>
Crash Move to Event: x
- Replace 'x' with the ID of the event to move the unit to.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move to Player
- Moves the unit to the player.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move to Home
- Moves the unit towards their home position on the map.
- This only works on events, not player characters or followers.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Crash Move to Home
- Moves the unit towards their home position on the map.
- This only works on events, not player characters or followers.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Move Lower Left: x
Move Down: x
Move Lower Right: x
Move Left: x
Move Right: x
Move Upper Left: x
Move Up: x
Move Upper Right: x
- Replace 'x' with the number of times to move the unit by in the designated
direction on the map.
- Events can crash into the player and trigger an event.
</pre>

---

<pre>
Opacity: x%
- Replace 'x' with the percentage to change the unit's sprite opacity to.
</pre>

---

<pre>
Opacity: +x
Opacity: -x
- Replace 'x' with the increment to change the unit's sprite opacity by.
</pre>

---

<pre>
Pattern Lock: x
- Replace 'x' with the step pattern to lock the unit's sprite to.
</pre>

---

<pre>
Pattern Unlock
- Removes pattern lock effect.
</pre>

---

<pre>
Pose: name
- If using a VS8 sprite, this will cause the unit to strike a pose.
- Replace 'name' with any the following:
- 'Item', 'Hmph', 'Victory', 'Hurt', 'Kneel', 'Collapse',
'!', '?', 'Music Note', 'Heart', 'Anger', 'Sweat', 'Cobweb', 'Silence',
'Light Bulb', 'Sleep'
- Do NOT insert quotes.
- Examples:
- Balloon: Item
- Balloon: Victory
- Balloon: ?
</pre>

---

<pre>
Step Toward: x, y
- Replace 'x' and 'y' for the desired coordinates for the unit to take one
step towards.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Toward Event: x
- Replace 'x' with the ID of the event for the unit to take one step to.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Toward Player
- Causes event to take one step towards the player.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Toward Home
- Causes the event to take one step towards its home position.
- This only works on events, not player characters or followers.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Away From: x, y
- Replace 'x' and 'y' for the desired coordinates for the unit to take one
step away from.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Away From Event: x
- Replace 'x' with the ID of the event for the unit to take one step from.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Step Away From Player
- Causes event to take one step away from the player.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Turn To: x, y
- Replace 'x' and 'y' for the coordinates to make the unit face towards.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn to Event: x
- Replace 'x' with the ID of the event to turn the unit towards.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn to Player
- Causes the unit to turn towards the player.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn to Home
- Causes the event to turn towards its home position.
- This refers to the original position's X/Y on the map.
- The event will turn and face the tile that is its original X/Y location.
- This only works on events, not player characters or followers.
</pre>

---

<pre>
Step Away From Home
- Causes the event to take one step away from its home position.
- This only works on events, not player characters or followers.
- This uses RPG Maker MZ's pathfinding algorithm. It is not perfect so do
not expect the most optimal results.
</pre>

---

<pre>
Turn Away From: x, y
- Replace 'x' and 'y' for the coordinates to make the unit face away from.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn Away From Event: x
- Replace 'x' with the ID of the event to turn the unit away from.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn Away From Player
- Causes the unit to turn away from the player.
- This supports 8 directional turning.
</pre>

---

<pre>
Turn Away From Home
- Causes the event to turn away from its home position.
- This only works on events, not player characters or followers.
</pre>

---

<pre>
Turn Lower Left
Turn Lower Right
Turn Upper Left
Turn Upper Right
- Causes the unit to turn to one of the diagonal directions.
</pre>

---

<pre>
Self Switch x: On
Self Switch x: Off
Self Switch x: Toggle
- Replace 'x' with 'A', 'B', 'C', 'D', or a <Self> Switch ID to adjust the
unit's self switch.
</pre>

---

<pre>
Self Variable x: y
- Replace 'x' with a <Self> Variable ID to adjust the unit's self variable.
- Replace 'y' with a number value to set the self variable to.
</pre>

---

<pre>
Teleport To: x, y
- Replace 'x' and 'y' with the coordinates to instantly move the unit to.
</pre>

---

<pre>
Teleport to Event: x
- Replace 'x' with the ID of the event to instantly move the unit to.
</pre>

---

<pre>
Teleport to Player
- Instantly moves the unit to the player's location.
</pre>

---

<pre>
Teleport to Home
- Instantly teleports an event to its home position on the map.
- This only works on events, not player characters or followers.
</pre>

---

<pre>
If none of the commands are detected above, then a script call will be ran.
</pre>

---

== Plugin Parameters ==

=== Event Label Settings ===

[[File:EventsMoveCoreLabel.png]]

[[File:EventsMoveCoreParams01.png]]

Event Labels are small windows created to display text over an event's head.
They're set up using the <Label> notetags and/or comment tags. Event Labels
are a great way to instantly relay information about the event's role to
the player.

---

<pre>
Event Labels

Sprite Based?:
- Use sprite-based labels instead of legacy-window version.
- Legacy-window version will not be supported in future.
- Sprite-based labels are more memory efficient and work better
compatibility-wise.

Mobile-Enabled?:
- Enable event labels for mobile devices?

Font Size:
- The font size used for the Event Labels.

Icon Size:
- The size of the icons used in the Event Labels.

Line Height:
- The line height used for the Event Labels.

Offset X:
- Globally offset all labels horizontally by this amount.

Offset Y:
- Globally offset all labels vertically by this amount.

Fade Speed:
- Fade speed for labels.

Visible Range:
- Range the player has to be within the event to make its label visible.

Range Type:
- What do you want the default label visible range type?
- Square
- Diamond
- Circle
</pre>

---

=== Event Icon Settings ===

[[File:EventsMoveCoreIcon.png]]

[[File:EventsMoveCoreParams02.png]]

Icons can be displayed over an event's head through the <Icon> notetags
and/or comment tags. These can be used for a variety of things such as
making them look like they're carrying an item or to indicate they have a
specific role.

---

<pre>
Event Icon

Buffer X:
- Default X position buffer for event icons.

Buffer Y:
- Default Y position buffer for event icons.

Blend Mode:
- Default blend mode for even icons.
- 0 - Normal
- 1 - Additive
- 2 - Multiply
- 3 - Screen
</pre>

---

=== Event Template Settings ===

[[File:EventsMoveCoreParams03.png]]

Event Templates allow you to store specific maps and/or event data to bring
out on need while having a premade set base. They're similar to prefabs but
aren't things that can be altered individually as one setting for an event
template will serve as a blueprint for all of them that use them.

Event Templates are used for the <Copy Event> notetags, the Morph Event and
Spawn Event Plugin Commands.

---

<pre>
Settings

Preloaded Maps:
- A list of all the ID's of the maps that will be preloaded to serve as
template maps for this plugin.
</pre>

---

<pre>
Templates
- A list of all the Event Templates used by this project. Used for notetags
and Plugin Commands.

Name:
- Name of the template. It'll be used as anchor points for notetags and
Plugin Commands.

Map ID:
- ID of the map the template event is stored on.
- This will automatically add this ID to preloaded list.

Event ID:
- ID of the event the template event is based on.

JavaScript:
JS: Pre-Copy:
JS: Post-Copy:
JS: Pre-Morph:
JS: Post-Morph:
JS: Pre-Spawn:
JS: Post-Spawn:
- Code that's ran during certain circumstances.
- The code will occur at the same time as the ones listed in the main
Event Template Settings Plugin Parameters. However, the ones listed
in these individual entries will only occur for these specific
templates and only if the templates are used.
</pre>

---

<pre>
JavaScript

JS: Pre-Copy:
JS: Post-Copy:
JS: Pre-Morph:
JS: Post-Morph:
JS: Pre-Spawn:
JS: Post-Spawn:
- Code that's ran during certain circumstances.
- These are global and are ran for all copies, morphs, and/or spawns.
</pre>

---

=== Movement Settings ===

[[File:EventsMoveCoreVS8.gif]]

[[File:EventsMoveCoreParams04.png]]

These plugin parameters allow you to control how movement works in your
game, toggling it from 4-directional to 8-directional, setting up rules to
stop self-movement from events while an event or message is present, and
other aesthetics such as tilting the sprite while dashing, setting shadows
beneath the sprites, and allow for turning in place.

⚠️⚠️⚠️Shadows do NOT appear for sprites using a "!" as their leading filename
marker. These sprites are environmental and are considered "object"
characters by the RPG Maker MZ core scripts. They do not utilize character
shadows due.

---

<pre>
8 Directional Movement

Enable:
- Allow 8-directional movement by default? Players can move diagonally.

Strict Collision:
- Enforce strict collission rules where the player must be able to pass
both cardinal directions?

Favor Horizontal:
- Favor horizontal if cannot pass diagonally but can pass both
horizontally and vertically?

Slower Diagonals?
- Enforce a slower movement speed when moving diagonally?

Speed Multiplier
- What's the multiplier to adjust movement speed when moving diagonally?
</pre>

---

<pre>
Automatic Movement

Stop During Events:
- Stop automatic event movement while events are running.

Stop During Messages:
- Stop automatic event movement while a message is running.
</pre>

---

<pre>
Bitmap

Smoothing:
- Do you want to smooth or pixelate the map sprites?
- Pixelating them is better for zooming and tilting.
</pre>

---

<pre>
Dash

Dash Modifier:
- Alters the dash speed modifier.

Dash on Ladder?
- Allow dashing while on a ladder or rope?

Enable Dash Tilt?:
- Tilt any sprites that are currently dashing?

Tilt Left Amount:
- Amount in radians when moving left (upper left, left, lower left).

Tilt Right Amount:
- Amount in radians when moving right (upper right, right, lower right).

Tilt Vertical Amount:
- Amount in radians when moving vertical (up, down).
</pre>

---

[[File:EventsMovementCore_Update25_WeightedRandom.png|600px]]

<pre>
Event Movement

Random Move Weight:
- Use numbers between 0 and 1.
- Numbers closer to 1 stay closer to their home position.
- 0 to disable it.

Shift Y:
- How many pixels should non-tile characters be shifted by?
- Negative: up. Positive: down.
</pre>

---

Path Finding

Mobile-Enabled?:
- Enable diagonal pathfinding for mobile devices?

---

[[File:EventsMoveCoreShadow.png]]

<pre>
Shadows

Show:
- Show shadows on all events and player-related sprites.

Default Filename:
- Default filename used for shadows found in img/system/ folder.

Shadow Z Layer:
- What is the sprite Z layer used for the shadow sprites?
- In-game layers are as follows:
- 0 : Lower tiles
- 1 : Lower characters
- 3 : Normal characters
- 4 : Upper tiles
- 5 : Upper characters
- 6 : Airship shadow
- 7 : Balloon
- 8 : Animation
- 9 : Destination
</pre>

---

<pre>
Turn in Place

Enable:
- When not dashing, player will turn in place before moving.
- This only applies with keyboard inputs.

Delay in Frames:
- The number of frames to wait before moving.
</pre>

---

<pre>
Vehicle Speeds

Boat Speed:
- Allows you to adjust the base speed of the boat vehicle.

Ship Speed:
- Allows you to adjust the base speed of the ship vehicle.

Airship Speed:
- Allows you to adjust the base speed of the airship vehicle.
</pre>

---

=== VisuStella 8-Dir Settings ===

[[File:EventsMoveCoreVS8.gif]]

[[File:EventsMoveCoreParams05.png]]

These are settings for sprite sheets using the VS8 format.
For more information on the VS8 format, look in the help section above.

---

<pre>
Balloon Icon Settings

Auto-Balloon Poses:
- Automatically pose VS8 sprites when using balloon icons.

Balloon Offset X:
- Offset balloon icons on VS8 sprites by x pixels.

Balloon Offset Y:
- Offset balloon icons on VS8 sprites by y pixels.
</pre>

---

[[File:EventsMoveCoreIcon.png]]

<pre>
Icons

Auto Buffer:
- Automatically buffer the X and Y coordinates of VS8 sprites?

Use Carry Pose:
- Use the carry pose when moving with an icon overhead.
</pre>

---

=== Region Rulings ===

[[File:EventMoveCoreRegions.png]]

[[File:EventsMoveCoreParams06.png]]

These settings allow you to decide the passability of the player, events,
and various vehicles through the usage of Regions.

---

<pre>
Allow Regions

All Allow:
Walk Allow:
Player Allow:
Event Allow:
Vehicle Allow:
Boat Allow:
Ship Allow:
Airship Allow:
- Insert Region ID's where the affected unit type can enter.
- Region ID's range from 0 to 255.
</pre>

---

<pre>
Forbid Regions

All Forbid:
Walk Forbid:
Player Forbid:
Event Forbid:
Vehicle Forbid:
Boat Forbid:
Ship Forbid:
Airship Forbid:
- Insert Region ID's where the affected unit type cannot enter.
- Region ID's range from 0 to 255.
</pre>

---

<pre>
Dock Regions

Vehicle Dock:
Boat Dock:
Ship Dock:
Airship Dock:
- Insert Region ID's where the affected vehicle can dock
- Region ID's range from 0 to 255.

Only Region Dockable:
- Vehicles are only able to dock at designated regions.
</pre>

---

=== Common Event on OK Button ===

[[File:EventsMoveCoreParams07.png]]

These Plugin Parameters allow you to setup Common Events that activate using
Regions when pressing the OK button while standing on top of them or in
front of them. These let you create near universally interactable objects
using Regions, such as rivers to start up fishing events or locations to
places items on.

---

<pre>
Regions

Regions 1 - 255:
- Which Common Event does this region activate?
- Use 0 to not activate any Common Events.
</pre>

---

[[File:EventsMoveCoreParams07a.png]]

<pre>
Target Tile

Target Tile:
- Which tile should be checked for Common Event on OK Button?
- Tile in front of player.
- Tile player is standing on top of.
</pre>

---

=== Common Event on Touch ===

[[File:EventsMoveCoreParams08.png]]

These Plugin Parameters allow you to setup Common Events that trigger when
stepping onto Region-marked tiles. These let you create custom effects that
will occur such as customized damage floors, traps, and/or events.

Areas marked with these regions will not allow random encounters to occur.
This is how RPG Maker works. Assuming you are not using plugins at all, by
putting on touch events all over the map, tiles with those on touch events
will not let random encounters trigger.

---

<pre>
Regions

Regions 1 - 255:
- Which Common Event does this region activate?
- Use 0 to not activate any Common Events.
</pre>

---

=== Terrain Tag Settings ===

[[File:EventsMoveCoreParams09.png]]

Terrain Tags are used in Database => Tilesets to mark certain tiles and
give them unique properties through terrain tags.

---

<pre>
Terrain Tag ID's

Rope:
- Which terrain tag number to use for ropes?
</pre>

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.65: May 18, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New JavaScript notetags added by Arisu:
*** <nowiki><JS On Map Load></nowiki>
**** Replace 'code' with JavaScript code to run the moment the map finishes loading and before fading in.
*** <nowiki><JS On Map Exit></nowiki>
**** Replace 'code' with JavaScript code to run the moment the player transfers to a different map and the screen completely fades out.

Version 1.64: March 16, 2026
* Bug Fixes!
** Click + hold movement no longer crashes when moving over events without
any active pages. Fix made by Arisu.

Version 1.63: February 16, 2026
* Feature Update!
** When moving by clicking and holding down the mouse button, the touch input will no longer lock onto any events with empty event lists or populated by just comments. Update made by Arisu.

Version 1.62: January 19, 2026
* Documentation Update!
** Help file updated for new features.
** New section added: Reference Switches and Reference Variables

Version 1.61: December 15, 2025
* Bug Fixes!
** Fixed a bug where shadows would appear under lower-priority event sprites making usage of certain tiles awkward looking. This is corrected by the new Plugin Parameter. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Parameters > Movement Settings > Shadows > Shadow Z Layer
**** What is the sprite Z layer used for the shadow sprites?
**** By default, this layer will now be 0.5 instead of 0.
* Feature Update!
** If a event is made whose priority is "Below characters" and is a tile object (ie taking a sprite from the map tileset or a character sprite with "!" in front of the name), it will be automatically regulated to a custom Z layer of 0.

Version 1.60: August 29, 2024
* Bug Fixes!
** Fixed a bug where events with large hitboxes do not work with crash move. Fix made by Arisu.
** Fixed a bug where single-mode save games by Save Core would freeze after executed event movements. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Event Labels will adjust their vertical position to the picture of any attached event picture if one is present. Update by Arisu.
* New Features!
** New Notetags added by Arisu:
*** <Picture Type: Enemy>
*** <Picture Type: SV Enemy>
**** Will use /img/enemies/ or /img/sv_enemies/ instead of /img/pictures/ to grab a picture graphic from.
**** Other picture graphic sprite related notetags will apply as normal.
*** <Label Range Type: Square>
*** <Label Range Type: Circle>
*** <Label Range Type: Diamond>
**** Sets a range type for the label to appear visible for.
** New Plugin Parameters added by Arisu:
*** Parameters > Event Label Settings > Visible Range > Range Type:
**** What do you want the default label visible range type?

Version 1.59: June 13, 2024
* Bug Fixes!
** Added a cache check for character sprite tag names to reduce frame drops. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Arisu:
*** <Location X: +x>, <Location X: -x>
*** <Location Y: +y>, <Location Y: -y>
*** <Location: +x, +y>, <Location: +x, -y>
*** <Location: -x, +y>, <Location: -x, -y>
**** Adjusts the initial location of this event by +x and +y (or -x and -y).
**** This allows you to stack events on top of each other or even move them to various places of the map.
*** <Tile Expand Up: x>
*** <Tile Expand Down: x>
*** <Tile Expand Left: x>
*** <Tile Expand Right: x>
**** Used for events with tile graphics. Expands the graphic up, down, left, or right from the spritesheet.
**** This does NOT expand the hitbox.
**** The graphic will be anchored to the tile it's expanded from. This means even if you expanded downward, the actual event's position will still be the current event's X/Y coordinates. It's just grown more vertically and is still centered horizontally.
**** This is primarily used to save on having to use too many events for tiles that expanded past 1x1 tile sizes.

Version 1.58: May 16, 2024
* Documentation Update!
** Added "Features: Character Sprite Filename Tags" section.
* New Features!
** [Invisible] tag added to character sprite filenames.
*** If a character sprite's filename has [invisible] in it, it will become invisible on the map screen in-game while almost everything else about it is visible. This is used for those who wish to use sprite labels for things such as autorun and parallel events.

Version 1.57: March 14, 2024
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Plugin Command: "Event Icon: Delete" will now keep an event icon cleared until the newly added Plugin Command: "Event Icon: Restore" is used. Update made by Arisu.
** Plugin Command: "Event Icon: Change" is now renamed to have "(Temporary)" after its name in order to clarify the temporary changes made to it.
* New Features!
** New Plugin Command added by Arisu:
*** Event Icon: Event Icon: Change (Forced)
**** Change the icon that appears on an event.
**** This change is forced and needs to be restored.
*** Event Icon: Restore
**** Restores a deleted or forced icon that appears on an event.

Version 1.56: February 15, 2024
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Added fail safes for activation proximity notetags when loaded from past save files without Events and Movement Core installed. Added by Arisu.
* New Features!
** New notetags added by Arisu:
*** <Encounter Half Square: x>
*** <Encounter Half Circle: x>
*** <Encounter Half Delta: x>
*** <Encounter Half Row: x>
*** <Encounter Half Column: x>
*** <Encounter None Square: x>
*** <Encounter None Circle: x>
*** <Encounter None Delta: x>
*** <Encounter None Row: x>
*** <Encounter None Column: x>
**** If the player is within the 'x' area effect of this event, the random encounter rate will be halved or suppressed completely depending on the notetag used.
**** These include script call checks.
*** <Erase if Encounter Half>
*** <Erase if Encounter None>
**** Automatically erase this event if the player's party has an encounter half or encounter none effect, or if the event has spawned in an encounter half or encounter none area.
**** This check only occurs in two situations: when the map is first loaded after being teleported into or when the player leaves a menu and returns back to the map.
**** Events that have been erased due to this effect will NOT return even if the encounter half/none effect is removed while the player is still on the map. The event will return if the player exits the map and comes back.

Version 1.55: December 14, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Commands added by Arisu:
*** Event Popup: Player
*** Event Popup: Follower
*** Event Popup: Event
*** Event Popup: Target Tile
**** Makes a centered event popup on the player sprite, target follower sprite, target event sprite, or target tile.
**** All of these new Plugin Commands require VisuMZ_1_MessageCore and cannot be used in battle.

Version 1.54: October 12, 2023
* Documentation Update!
** Help file updated for new features.
** Help file updated to reduce confusion:
*** Call Event: Remote Read
**** This will run the page of the target event on the current event.
**** This means that any "This Event" commands will be applied to the event using this Plugin Command and NOT the target event that page data is being retrieved from.
**** Think of it as the current event using the target called event as a Common Event ala how RPG Maker 2003 works (for those familiar with it).
* Feature Update!
** Renamed "Call Event: Remote Activation" to "Call Event: Remote Read" to reduce confusion.
* Feature Update!
** <Activation Radius: x> notetag is now defined as <Activation Delta: x>
*** 'Radius' variant will still work and function as 'Delta' but will no longer be listed in the help file as 'Radius'
*** This is changed to avoid confusion with the new notetag.
* New Features!
** New notetag added by Arisu and sponsored by AndyL:
*** <Activation Circle: x>
**** A circle-shaped range with the event at the center.
**** 'x' represents the distance from the center.

Version 1.53: August 17, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** <Map Load Common Event: x>
** <Map Load Common Events: x, x, x>
*** When this map is loaded, run the specified Common Events once available.
**** Does NOT trigger if you transfer to a different part of the same map.

Version 1.52: July 13, 2023
* Documentation Update!
** Help file updated for new features.
** Updated help file for <Label: text> notetags:
*** If text codes are used, avoid text codes that use < and > wrappers.
** Updated help file for <Label> sandwich notetags:
*** You can use text codes with < and > wrappers.
* Feature Update!
** Event labels now work properly with scaling sprites.
* New Features!
** New notetag added by Arisu and sponsored by Anon:
*** <Label Hue Shift: +x>
*** <Label Hue Shift: -x>
**** Changes the hue of the event label by +x or -x every frame.
**** Keep in mind that since this is changing hue, this will appear to have no effect if you are using black and white labels.
**** Use labels with text codes that add color to them like '\C[4]text'
**** This only works with the sprite version of event labels and does not work with the legacy version.

Version 1.51: June 15, 2023
* Bug Fixes!
** Provided a fail safe for plugins using the scaling options from this plugin but do not have scaling parameters identified. The scaling ratio should now default to 1.0. Fix made by Olivia.
* Feature Update!
** Diagonal pathfinding is now improved as to not get stuck on tight corners on the map. Feature update made by Arisu.

Version 1.50: April 13, 2023
* Bug Fixes!
** <Icon: x> should now update correctly when changing pages through self switches or other event conditions. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Event Labels > Mobile-Enabled?
*** Plugin Parameters > Movement > Pathfinding > Mobile-Enabled?
**** These settings allow you to enable or disable certain features when played on mobile devices for better performance.

Version 1.49: March 16, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Event Notetag and Comment Tags added by Arisu:
*** <Scale: x%>
*** <Scale X: x%>
*** <Scale Y: y%>
**** Changes the scale of the sprite to the designated size.

Version 1.48: January 20, 2023
* Feature Update!
** <Move Synch> for certain types will also copy facing directions even if there are no tile movements (ie changing directions when pressed up against and obstacle). Update made by Arisu.

Version 1.47: November 10, 2022
* Feature Update!
** If "Follower: Set Global Chase" is set to false, followers will no longer jump towards the player location when the player jumps. This does NOT apply to gather or location changing players. Followers will still have to synchronize their positions there regardless in order to maintain consistency. Update made by Olivia.

Version 1.46: September 29, 2022
* Bug Fixes!
** Altered the self switch auto-reset timing to reduce errors. Fix by Arisu.
* Feature Update!
** Added self-movement prevention whenever scenes are deactivated. Update made by Arisu.

Version 1.45: August 18, 2022
* Bug Fixes!
** Fixed a bug that caused event labels with variables from refreshing properly. Fix made by Arisu.

Version 1.44: July 21, 2022
* Bug Fixes!
** Fixed a problem that caused <Exit Reset Self Data> notetag to not work. Fix made by Arisu.
* Feature Update!
** Diagonal pathfinding is now disabled when there are too many events on a map, causing extra collission checks. This value is set to 100 for the time being until we can figure out a better way to calculate diagonal pathfinding. Update made by Irina.

Version 1.43: July 14, 2022
* Bug Fixes!
** Move to Player for events should no longer cause hang ups. Fix by Olivia.
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Added caching function for pathfinding when using touch movement for a smoother experience. When touch movement is held down, pathfinding will utilize the non-diagonal function for less resource consumption to prevent FPS frame drops. Update made by Arisu.
* New Features!
** New notetag added by Arisu:
*** <Playtest>
**** If this notetag is found in the event's notebox (NOT comments), then the event will only appear during a playtest session. It will not appear in a deployed game where the playtest flag is not on.

Version 1.42: June 23, 2022
* Documentation Update!
** Help file updated for new features.
** Added to <Copy Event: x, y> notetag help:
*** - If '0' is used for the Map ID, reference the current map.
* Feature Update!
** Default MZ behavior would have "below characters" trigger events with only comments lock out facing "same as characters" trigger events. This is now bypassed. Update made by Arisu.
** The <Copy Event: mapID, eventID> notetags now allow usage of '0' for the mapID to reference the current map. Update made by Arisu.
** <Save Event Location> should now work more efficiently. Update by Arisu.
** Dashing animations for followers will no longer look weird after having gathered up and then proceeding to dash. Update made by Irina.
* New Features!
** New event notetag added by Arisu:
*** <Exit Reset Self Data>
**** When the player leaves the current map, all Self Switches and Self Variables related to this event will be reset.
** New Plugin Command added by Arisu and sponsored by Anon:
*** Self Data: Reset All
**** Reset the Self Switch and Self Variable data of all events within the specified map.
** New Plugin Parameter added by Arisu and sponsored by Anon:
*** Plugin Params > Movement Settings > Dash > Dash on Ladder?
**** Allow dashing while on a ladder or rope?

Version 1.41: June 1, 2022
* Bug Fixes!
** Parallel Process Common Events above 1000 should no longer crash the game. Bug fixed by Irina.

Version 1.39: May 5, 2022
* Bug Fixes!
** Save event location should now work properly with Set Event Location command. Fix made by Arisu.
** Sprite Event Labels with distance properties will no longer be visible when constantly entering/exiting the Main Menu. Fix made by Arisu.

Version 1.38: April 28, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu and sponsored by Archeia:
*** Plugin Parameters > Movement Settings > Event Movement > Shift Y
**** How many pixels should non-tile characters be shifted by?
** New Notetags added by Arisu and sponsored by Archeia:
*** <Picture Filename: filename>
**** applies a picture graphic from the /img/pictures/ folder of your game project.
**** This graphic will be on top of the character sprite but below the event icon sprite.
**** The picture priority will be the same as the event's priority. If it is "below characters", the player can walk on top of it. If it is "above characters", the player will behind it. If it is "same as characters", the priority will be based on the current relative Y position.
*** <Picture Max Size: x>
*** <Picture Scale: y%>
**** If the "Max Size" or "Scale" supplementary notetags are used, the picture graphic will be scaled proportionally to fit either the exact pixel size for "Max Size" or the "Scale" ratio.
*** <Picture Offset: +x, +y>
*** <Picture Offset: -x, -y>
**** Offsets the X and Y position of the event picture relative to the event sprite's own position.
*** <Picture Wait Frames: x>
**** Requires VisuMZ_4_AnimatedPictures! "Wait Frames" is used with VisuMZ's Animated Pictures plugin. This determines the delay inbetween frame changes.

Version 1.37: March 24, 2022
* Documentation Update!
** Added extra clarity to "Turn to Home" Movement Command.
*** This refers to the original position's X/Y on the map.
*** The event will turn and face the tile that is its original X/Y location.

Version 1.36: March 17, 2022
* Bug Fixes!
** "Turn To Home" movement command now properly faces the home position. Fix made by Irina.
* Feature Update!
** Plugin Commands now have separators for easier selection.

Version 1.35: March 3, 2022
* IMPORTANT! Compatibility Update!
** Compatibility Update with RPG Maker MZ 1.4.4.
*** For some reason this update broke any saves made before 1.4.4 was updated and they cannot be loaded. The only way saves would load is if you made a safe after 1.4.4 was done. This should be fixed and saves made with 1.4.3 and before should now be working. Update made by Irina.

Version 1.34: February 17, 2022
* Documentation Update!
** Help file updated for new features.
* Optimization Update!
** Plugin should run more optimized.
* New Features!
** Arisu has created new event notetag/comment tags:
*** <Custom Z: x>
**** Replace 'x' with a number value to determine the event sprite's Z value relative to the tilemap.
**** View the helpfile for more information.
*** <Mirror Sprite>
**** The event sprite's visual appearance is mirrored.
*** <Move Synch Distance Opacity: x>
**** Changes the opacity of the event based on the distance between it and its move synched target. Closer means more opaque. Further away means more transparent.
** Irina has created a more memory efficient version of Event Labels.
*** Plugin Parameters > Event Label Settings > Sprite Based?
**** Use sprite-based labels instead of legacy-window version.
**** Legacy-window version will not be supported in future.

Version 1.33: February 3, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Notetags added by Arisu!
*** <Hide Player>
*** <Show Player>
**** Map Notetag. Forcefully hides or shows the player sprite. This is so you don't need to manually turn the setting on/off each time you enter a specific map.
*** <Hide Followers>
*** <Show Followers>
**** Map Notetag. Forcefully hides or shows the player's followers. This is so you don't need to manually turn them on/off each time you enter a specific map.

Version 1.32: January 20, 2022
* Bug Fixes!
** Self Variable changes from custom move routes should no longer cause crashes. Fix made by Arisu.
** Self Switch custom move route toggles should now work properly. Fix made by Arisu.
* Feature Update!
** Better shadow tracking algorithm to remove any shadow twitching. Update made by Yanfly.

Version 1.31: January 6, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.30: November 25, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** Map Switches and Map Variables added by Arisu:
*** Map Switches are self-switches for maps. Instead of using <Self>, use <Map> in the Switch name to designate it as a Map Switch. The ON/OFF data for that Switch will vary depending on the map the player is currently on.
*** Map Variables are self-variables for maps. Instead of using <Self>, use <Map> in the Variable name to designate it as a Map Switch. The number data for that Variable will vary depending on the map the player is currently on.
*** Script Calls have been added for these features as well.
**** See help file for them.

Version 1.29: October 7, 2021
* Bug Fixes!
** Same map event spawning should now work properly without the need to add the current map ID to the preloaded map array. Update made by Arisu.

Version 1.28: September 30, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New move route commands added by Arisu:
*** Jump to Home
*** Move to Home
*** Crash Move to Home
*** Step Toward Home
*** Step Away From Home
*** Turn to Home
*** Turn Away From Home
*** Teleport to Home
**** These only work on events. Their actions should be reflective of what their command names suggest.

Version 1.27: September 17, 2021
* Bug Fixes!
** Fixed event spawn templates so that they can work properly with Common Events. Fix made by Arisu.

Version 1.26: September 3, 2021
* Bug Fixes!
** "Step Towards Player" custom command should now work properly. Fix made by Arisu.
** Having multiple region restriction notetags for a map will no longer cause others to lock out. Fix made by Arisu.

Version 1.25: July 30, 2021
* Bug Fixes!
** Fixed a problem that caused the 'setSelfSwitchValue' and 'setSelfVariableValue' functions to not work properly. Fix made by Irina.

Version 1.24: June 4, 2021
* Documentation Update!
** Help file updated for new features.
** Added extra clarification on which commands will go around the player character and which ones won't.
* New Move Route Custom Commands added by Arisu:
** Crash Move (direction) Until Stop
** Crash Move To: x, y
** Crash Move To Event: x
*** These allow events to collide with the player character and trigger Event Touch events.

Version 1.23: May 21, 2021
* Bug Fixes!
** Morphing by templates should no longer cause a crash. Fix made by Arisu.

Version 1.22: May 7, 2021
* Bug Fixes!
** Plugin Commands for Event Label Visibility should now update without needing to take steps as per distance detection. Fix made by Arisu.
* Documentation Update!
** Added clarity to "Common Event on Touch" Plugin Parameters.
*** Areas marked with these regions will not allow random encounters to occur. This is how RPG Maker works. Assuming you are not using plugins at all, by putting on touch events all over the map, tiles with those on touch events will not let random encounters trigger.

Version 1.21: March 12, 2021
* Bug Fixes!
** Move until stop custom move routes should no longer cause crashes. Fix made by Arisu.

Version 1.20: February 26, 2021
* Bug Fixes!
** Region Restrictions regarding Player Allow will no longer affect vehicle passability. Update made by Arisu.

Version 1.19: February 12, 2021
* Bug Fixes!
** "Self Variable: Variable ID" plugin command's Map ID should now be able to use "0" to self reference the current map. Fix made by Olivia.

Version 1.18: February 5, 2021
* Bug Fixes!
** Event icon plugin commands should now work properly. Fix made by Arisu.
* Documentation Update!
** Added new "Features: Weighted Random Movement" section.
** Help file updated for new features.
* New Features!
** New Notetags added by Arisu:
*** <Random Move Weight: x>
**** If this tag is used on an event with random-type autonomous movement, then the event will stick closer to their home location (where they are located upon spawning on the map). How close they stick to their home location will depend on the weighted 'x' value.
*** <True Random Move>
**** If this tag is used on an event with random-type autonomous movement, then that event will ignore the effects of weighted randomized movement.
** New Plugin Commands added by Arisu and sponsored by AndyL:
*** Event Timer: Change Speed
*** Event Timer: Expire Event Assign
*** Event Timer: Expire Event Clear
*** Event Timer: Frames Gain
*** Event Timer: Frames Set
*** Event Timer: Pause
*** Event Timer: Resume
**** The above Plugin Commands allow you to control the game timer better.
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Movement > Event Movement > Random Move Weight
**** Use numbers between 0 and 1. Numbers closer to 1 stay closer to their home position.

Version 1.17: January 29, 2021
* Documentation Update!
** Added "Do NOT insert quotes" to "Balloon: name" and "Pose: name".
** Added Examples for extra clarification.
* Optimization Update!
** When touch clicking an event on a map with multiple events, pathfinding will utilize the non-diagonal function for less resource consumption to prevent FPS frame drops. Fix made by Arisu.

Version 1.16: January 22, 2021
* Optimization Update!
** When touch clicking multiple times on an impassable tile, pathfinding will utilize the non-diagonal function for less resource consumption to prevent FPS frame drops. Fix made by Arisu.

Version 1.15: January 1, 2021
* Bug Fixes!
** Spawned events should now resume their automated self movement after being interacted with. Fix made by Yanfly.
* Documentation Update!
** Help file updated for new features.
** Help file updated for updated features.
* Feature Updates!
** Collission checks for the Spawn Event Plugin Commands now account for the spawning event's Hitbox, too. Update made by Yanfly.
** Spawn Event Plugin Commands adds a new parameter "Success Switch ID" to check if the spawning has been successful or not.
* New Features!
** New Plugin Commands added by Yanfly!
*** Spawn Event: Spawn At Terrain Tag
*** Spawn Event: Despawn Terrain Tag(s)
**** These function similar to their region counterparts except they target terrain tags instead.

Version 1.14: December 18, 2020
* Bug Fixes!
** Caching for event label positions now account for page index. Fix made by Yanfly.
* Documentation Update!
** Added documentation for the new features!
* New Features!
** New Plugin Commands added by Irina.
*** Follower: Set Global Chase
*** Follower: Set Target Chase
*** Follower: Set Control
*** Follower: Reset
**** These plugin commands allow you to change whether or not the followers will chase their intended targets and/or shift control over their movement route from the "Player" to the target follower.

Version 1.13: December 4, 2020
* Bug Fixes!
** Caching for event label positions now account for one-screen maps. Fix made by Arisu.

Version 1.12: November 29, 2020
* Bug Fixes!
** Click Triggers no longer work on erased events. Fix made by Arisu.
** Erased events no longer have icons appear above their heads. Fix made by Arisu.
* Feature Update!
** Initialization of the plugin's effects no only occur if the event's current page settings have been altered. Change made by Arisu.
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: November 15, 2020
* Bug Fixes!
** Morph plugin command should no longer cause crashes. Fix made by Yanfly.
* Documentation Update!
** Added documentation for the updated features!
* Feature Updates!
** Updates to these Plugin Commands made by Yanfly:
*** Call Event: Remote Activation
*** Event Icon: Change
*** Event Icon: Delete
*** Event Location: Create
*** Event Location: Delete
*** Global Switch: Get Self Switch A B C D
*** Global Switch: Get Self Switch ID
*** Global Variable: Get Self Variable ID
*** Morph Event: Change
*** Morph Event: Remove
*** Self Switch: A B C D
*** Self Switch: Switch ID
*** Self Variable: Variable ID
**** All of the above Plugin Commands can now use 0 for their Event ID's in order to refer to the running event's ID value.

Version 1.10: November 1, 2020
* Bug Fixes!
** Spawned Event preserve function now works properly. Fix made by Arisu.

Version 1.09: October 25, 2020
* Documentation Update
** Added clarity on the notetags and comment tags on when their effects are present.
* Feature Update!
** Event icons now have an unsmoothing property to them to make them look better. Update made by Irina.

Version 1.08: October 11, 2020
* Compatibility Update
** Added failsafes for better compatibility.

Version 1.07: October 4, 2020
* Documentation Update!
** Updated for the new features!
* Feature Update!
** Data from deleted events will now be cleared and removed from maps if the events do not exist to prevent conflict with plugins from the VisuStella MZ library and other plugins. Feature added by Irina.
** Move Route Custom Commands now support self variable values! If you wish to use a value from a self variable, insert \SelfVar[x] in place of the x in any of the below. This will only draw from the current event. If you wish to draw data from outside event self variables, we recommend you use the \V[x] variant after using the Plugin Commands to draw data from them for the best accuracy.
* New Features!
** New Plugin Parameter added by Yanfly!
*** Movement > Bitmap > Smoothing
**** Do you want to smooth or pixelate the map sprites? Pixelating them is better for zooming and tilting.

Version 1.06: September 27, 2020
* Bug Fixes!
** Events & Movement Core no longer disables the Core Engine's Smart Event Collision plugin parameter. Fix made by Yanfly.
* Documentation Update!
** Move Route Custom Commands updated with the new feature for inserting variable values.
* Feature Update!
** Move Route Custom Commands now support $gameVariable.value(x) values. You can also just use \V[x] for variable values, too. Added by Irina.

Version 1.05: September 20, 2020
* Bug Fixes!
** If player movement is disabled, mouse movement is disabled, too. Fix made by Arisu.
** The region restriction notetags should be fixed and work again. Fix made by Arisu.

Version 1.04: September 13: 2020
* Feature Update!
* Some Move Route Custom Commands are updated to ignore spaces:
** Jump To: x, y
** Move To: x, y
** Step Toward: x, y
** Step Away From: x, y
** Turn To: x, y
** Turn Away From: x, y
** Teleport To: x, y
*** These can now be written as x,y. There still needs to be a space between the : and x for parsing clarity, however.
*** Feature updated by Arisu with help from BlueMoon and Zeriab.
* New Features!
** New 'Move Route Custom Commands' added by Arisu.
*** Fade In: x
*** Fade Out: x
*** Force Carry: On
*** Force Carry: Off
*** Force Dash: On
*** Force Dash: Off
** New Plugin Commands added by Arisu.
*** Player Movement: Control
**** Enable or disable player control over the player character's movement.
*** Player Movement: Diagonal
**** Override settings to for player diagonal movement.

Version 1.03: September 6, 2020
* Bug Fixes!
** Sleeping pose is now fixed and working! Fix made by Yanfly.
* Documentation Update!
** Extended "Features: Self Switches and Variables" to explain how to use script calls to grab self switch information.
* New Features!
** New Plugin Commands added by Yanfly:
*** Global Switch: Get Self Switch A B C D
*** Global Switch: Get Self Switch ID
*** Global Variable: Get Self Variable ID
**** These plugin commands allow you to transfer data stored in a self switch or Self Variable into a global switch or global variable.

Version 1.02: ugust 30, 2020
* Bug Fixes!
** <Diagonal Movement: Off> notetag now works properly. Fix made by Yanfly.
** Plugin Command "Event Label: Visible" now works properly. Fix made by Shaz.
** Custom Move Route commands should now be working properly. Fix made by Shaz.

Version 1.01: August 23, 2020
* Bug Fixes!
** Event Cache issues fixed upon loading a saved game. Fix made by Yanfly.

Version 1.00: August 20, 2020
* Finished Plugin!

== See Also ==

* [[Event Popup Tips and Tricks]]
* [[Inspiration Behind Wave 1]]

== End of File ==

|}


[[Category: RPG Maker MZ Core Plugins]]





[[Category: RPG Maker MZ Gameplay Plugins]]
[[Category: RPG Maker MZ Movement Plugins]]


[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]


[[Category: RPG Maker MZ Quality of Life Plugins]]

Template:VisuMZ Changelog 161 to 180

2026-05-17T08:38:35Z

Irina:

<noinclude>[[Category:Display templates|VisuMZ Changelog 161 to 180]]</noinclude>






=== May 18, 2026 - Update #161 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (2 Plugin Updates)

-

[[Events and Movement Core VisuStella MZ]]

Version 1.65: May 18, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New JavaScript notetags added by Arisu:
*** <nowiki><JS On Map Load></nowiki>
**** Replace 'code' with JavaScript code to run the moment the map finishes loading and before fading in.
*** <nowiki><JS On Map Exit></nowiki>
**** Replace 'code' with JavaScript code to run the moment the player transfers to a different map and the screen completely fades out.

-

[[Items and Equips Core VisuStella MZ]]

Version 1.61: May 18, 2026
* Documentation Update!
** Added extra clarity for Plugin Parameters
*** Parameters > Item Menu Scene > Shop Status Window > JS: X, Y, W, H
**** Needs "Use Updated Layout" + "Disabled: Vanilla" as false.

-

'''Tier 2 (5 Plugin Updates)

-

[[Battle System - BTB VisuStella MZ]]

Version 1.20: May 18, 2026
* Optimization Update!
** Plugin should run more optimized.

-

[[Battle System - STB VisuStella MZ]]

Version 1.23: May 18, 2026
* Bug Fixes!
** Fixed a bug where if a stun is cleared before an actor's turn, the actor would lose that turn. This should no longer happen. Fix made by Olivia.

-

[[Item Crafting System VisuStella MZ]]

Version 1.26: May 18, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Once Craft Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.

-

[[QTE and Trigger System VisuStella MZ]]

Version 1.04: May 18, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Time Out > Play SFX?
**** Play the "Miss" sound effect on time out?
**** Only applies to QTE's with "Miss" sound settings.

-

[[Shop Common Events VisuStella MZ]]

Version 1.03: May 18, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Once Buy Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.
** Added extra clarity for <nowiki><Once Sell Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.

-

'''Tier 3 (2 Plugin Updates)

-

[[Action Sequence Impact VisuStella MZ]]

Version 1.10: May 18, 2026
* Compatibility Update!
** Added better compatibility with Action Sequence Impact. Previously, Dragonbones would block certain effects. Update made by Arisu.

-

[[One Time Purchase VisuStella MZ]]

Version 1.01: May 18, 2026
* Bug Fixes!
** Fixed a bug where going to sell items while in One Time Purchase mode does not show other touch screen UI buttons other than OK. Fix by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Notetag added by Arisu:
*** <nowiki><Allow Bulk Buy></nowiki>
**** Always allow item to be purchaseable in bulk, even with One Time Purchase mode enabled.

-

VisuStella MZ Changelog

2026-05-17T08:37:28Z

Irina:

{{TOCright}}

[[File:VisuMZChangelog.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

[[Updates_Changing_to_Monthly|Updates to the VisuStella MZ plugin library are made monthly.]]

This way, you don't have to stay completely on top of the wiki scouring for updates.

There is no set time for when the updates occur, they just will, and there will be an announcement for them.

Updates will be generally used for bug fixes and/or feature implementations.

== Changelog ==

The following is the VisuStella MZ Plugins Changelog.

It is listed from most recent to oldest with only the most recent batch listed.

To view the whole changelog from the beginning, go here [[VisuStella MZ Changelog (Full)]].

[[RMMZ Changelog|For the RPG Maker MZ Core Script changelog, click here.]]

{{VisuMZ Changelog 161 to 180}}

{{VisuMZ Changelog 141 to 160}}











To view the whole changelog from the beginning, go here [[VisuStella MZ Changelog (Full)]].

== End of Page ==

<html><script type="text/javascript" src="https://www.free-counters.org/count/do2d"></script><br>
<a href='https://www.easybooking.eu/produkte/julia-hotelsoftware'>Hotelsoftware mit Channelmanager</a> <script type='text/javascript' src='https://www.whomania.com/ctr?id=226342abaa64ce042eae55af54bd1a163a42ded4'></script></html>

|}

Template:VisuMZ Changelog 161 to 180

2026-05-17T08:37:01Z

Irina: Created page with "<noinclude>VisuMZ Changelog 161 to 180</noinclude> <!-- END OF UPDATE ==========================================================================..."

<noinclude>[[Category:Display templates|VisuMZ Changelog 161 to 180]]</noinclude>






=== May 18, 2026 - Update #161 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (2 Plugin Updates)

-

[[Events and Movement Core VisuStella MZ]]

Version 1.65: May 18, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New JavaScript notetags added by Arisu:
*** <nowiki><JS On Map Load></nowiki>
**** Replace 'code' with JavaScript code to run the moment the map finishes loading and before fading in.
*** <nowiki><JS On Map Exit></nowiki>
**** Replace 'code' with JavaScript code to run the moment the player transfers to a different map and the screen completely fades out.

-

[[Items and Equips Core VisuStella MZ]]

Version 1.61: May 18, 2026
* Documentation Update!
** Added extra clarity for Plugin Parameters
*** Parameters > Item Menu Scene > Shop Status Window > JS: X, Y, W, H
**** Needs "Use Updated Layout" + "Disabled: Vanilla" as false.

-

'''Tier 2 (5 Plugin Updates)

-

[[Battle System - BTB VisuStella MZ]]

Version 1.20: May 18, 2026
* Optimization Update!
** Plugin should run more optimized.

-

[[Battle System - STB VisuStella MZ]]

Version 1.23: May 18, 2026
* Bug Fixes!
** Fixed a bug where if a stun is cleared before an actor's turn, the actor would lose that turn. This should no longer happen. Fix made by Olivia.

-

[[Item Crafting System VisuStella MZ]]

Version 1.26: May 18, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Once Craft Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.

-

[[QTE and Trigger System VisuStella MZ]]

Version 1.04: May 18, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Time Out > Play SFX?
**** Play the "Miss" sound effect on time out?
**** Only applies to QTE's with "Miss" sound settings.

-

[[Shop Events VisuStella MZ]]

Version 1.03: May 18, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Once Buy Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.
** Added extra clarity for <nowiki><Once Sell Common Event: id></nowiki> notetag:
*** Common Event must use Plugin Command "Scene: Common Event Return" at the end of the event.

-

'''Tier 3 (2 Plugin Updates)

-

[[ActSeqImpact VisuStella MZ]]

Version 1.10: May 18, 2026
* Compatibility Update!
** Added better compatibility with Action Sequence Impact. Previously, Dragonbones would block certain effects. Update made by Arisu.

-

[[One Time Purchase VisuStella MZ]]

Version 1.01: May 18, 2026
* Bug Fixes!
** Fixed a bug where going to sell items while in One Time Purchase mode does not show other touch screen UI buttons other than OK. Fix by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Notetag added by Arisu:
*** <nowiki><Allow Bulk Buy></nowiki>
**** Always allow item to be purchaseable in bulk, even with One Time Purchase mode enabled.

-

VisuStella MZ Changelog

2026-05-17T08:36:13Z

Irina:

{{TOCright}}

[[File:VisuMZChangelog.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

[[Updates_Changing_to_Monthly|Updates to the VisuStella MZ plugin library are made monthly.]]

This way, you don't have to stay completely on top of the wiki scouring for updates.

There is no set time for when the updates occur, they just will, and there will be an announcement for them.

Updates will be generally used for bug fixes and/or feature implementations.

== Changelog ==

The following is the VisuStella MZ Plugins Changelog.

It is listed from most recent to oldest with only the most recent batch listed.

To view the whole changelog from the beginning, go here [[VisuStella MZ Changelog (Full)]].

[[RMMZ Changelog|For the RPG Maker MZ Core Script changelog, click here.]]

{{VisuMZ Changelog 161 to 180}}

{{VisuMZ Changelog 141 to 160}}

{{VisuMZ Changelog 121 to 140}}









To view the whole changelog from the beginning, go here [[VisuStella MZ Changelog (Full)]].

== End of Page ==

<html><script type="text/javascript" src="https://www.free-counters.org/count/do2d"></script><br>
<a href='https://www.easybooking.eu/produkte/julia-hotelsoftware'>Hotelsoftware mit Channelmanager</a> <script type='text/javascript' src='https://www.whomania.com/ctr?id=226342abaa64ce042eae55af54bd1a163a42ded4'></script></html>

|}

Template:Action Sequences MZ

2026-05-08T12:44:32Z

Irina: /* Dual Wield Action Sequence Example */

<noinclude>[[Category:Display templates|template]]</noinclude>

[[File:BattleCoreActSeq.png]]

Skills and items, when used in battle, have a pre-determined series of
actions to display to the player as a means of representing what's going on
with the action. For some game devs, this may not be enough and they would
like to get more involved with the actions themselves.

Action Sequences, added through this plugin, enable this. To give a skill or
item a Custom Action Sequence, a couple of steps must be followed:

---

[[File:BattleCorePentaSlash.gif]]

1. Insert the <Custom Action Sequence> notetag into the skill or item's notebox (or else this would not work as intended).
2. Give that skill/item a Common Event through the Effects box. The selected Common Event will contain all the Action Sequence data.
3. Create the Common Event with Action Sequence Plugin Commands and/or event commands to make the skill/item do what you want it to do.

---

The Plugin Commands added through the Battle Core plugin focus entirely on
Action Sequences. However, despite the fact that they're made for skills and
items, some of these Action Sequence Plugin Commands can still be used for
regular Troop events and Common Events.

---

=== Action Sequence - Action Sets ===

[[File:BattleCoreActSeqSet.gif]]

Action Sequence Action Sets are groups of commonly used
Action Sequence Commands put together for more efficient usage.

---

<pre>
ACSET: Setup Action Set
- The generic start to most actions.

Display Action:
Immortal: On:
Battle Step:
Wait For Movement:
Cast Animation:
Wait For Animation:
- Use this part of the action sequence?
</pre>

---

<pre>
ACSET: All Targets Action Set
- Affects all targets simultaneously performing the following.

Dual/Multi Wield?
- Add times struck based on weapon quantity equipped?

Perform Action:
Wait Count:
Action Animation:
Wait For Animation:
Action Effect:
Immortal: Off:
- Use this part of the action sequence?
- Insert values for the Wait Count(s).
</pre>

---

<pre>
ACSET: Each Target Action Set
- Goes through each target one by one to perform the following.

Dual/Multi Wield?
- Add times struck based on weapon quantity equipped?

Perform Action:
Wait Count:
Action Animation:
Wait Count:
Action Effect:
Immortal: Off:
- Use this part of the action sequence?
- Insert values for the Wait Count(s).
</pre>

---

<pre>
ACSET: Finish Action
- The generic ending to most actions.

Immortal: Off:
Wait For New Line:
Wait For Effects:
Clear Battle Log:
Home Reset:
Wait For Movement:
- Use this part of the action sequence?
</pre>

---

=== Action Sequences - Angle (Camera) ===

[[File:VisuMZ_ActSeqCamera_Angle.gif]]

These action sequences allow you to have control over the camera angle.
Requires VisuMZ_3_ActSeqCamera!

---

<pre>
ANGLE: Change Angle
- Changes the camera angle.
- Requires VisuMZ_3_ActSeqCamera!

Angle:
- Change the camera angle to this many degrees.

Duration:
- Duration in frames to change camera angle.

Angle Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Angle?:
- Wait for angle changes to complete before performing next command?
</pre>

---

<pre>
ANGLE: Reset Angle
- Reset any angle settings.
- Requires VisuMZ_3_ActSeqCamera!

Duration:
- Duration in frames to reset camera angle.

Angle Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Angle?:
- Wait for angle changes to complete before performing next command?
</pre>

---

<pre>
ANGLE: Wait For Angle
- Waits for angle changes to complete before performing next command.
- Requires VisuMZ_3_ActSeqCamera!
</pre>

---

=== Action Sequences - Animations ===

[[File:BattleCoreCastAni.gif]]

These Action Sequences are related to the 'Animations' that can be found in
the Animations tab of the Database.

---

<pre>
ANIM: Action Animation
- Plays the animation associated with the action.

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Attack Animation
- Plays the animation associated with the user's weapon.

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Attack Animation 2+
- Plays the animation associated with the user's other weapons.
- Plays nothing if there is no other weapon equipped.

Targets:
- Select unit(s) to play the animation on.

Slot:
- Which weapon slot to get this data from?
- Main-hand weapon is weapon slot 1.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

[[File:BattleCore_Update132_Preview.png]]

<pre>
ANIM: Balloon Animation
- Plays a balloon animation on target(s).

Targets:
- Select unit(s) to play the animation on.

Balloon Type:
- What kind of balloon should be played on target(s)?

Wait for Completion:
- Wait for balloon animation completion before continuing?
</pre>

---

<pre>
ANIM: Balloon Icon (Single)
- Plays a balloon animation using an icon on target(s).
- Requires VisuMZ_4_IconBalloons!

Targets:
- Select unit(s) to play the animation on.

Icon Index:
- Insert the ID of the icon to show.
- Tip: Right click > Insert Icon Index

Wait for Completion:
- Wait for balloon animation completion before continuing?
</pre>

---

<pre>
ANIM: Balloon Icon (Range)
- Plays a balloon animation an icon range on target(s).
- Requires VisuMZ_4_IconBalloons!

Targets:
- Select unit(s) to play the animation on.

Starting Icon Index:
- Insert the ID of the icon to show.
- Tip: Right click > Insert Icon Index

Ending Icon Index:
- Insert the ID of the icon to show.
- Tip: Right click > Insert Icon Index

Wait for Completion:
- Wait for balloon animation completion before continuing?
</pre>

---

<pre>
ANIM: Balloon Icon (Specific)
- Plays a balloon animation with specific icons on target(s).
- Requires VisuMZ_4_IconBalloons!

Targets:
- Select unit(s) to play the animation on.

Icons:
- Insert the ID(s) of the icon to show.
- Tip: Right click > Insert Icon Index

Wait for Completion:
- Wait for balloon animation completion before continuing?
</pre>

---

<pre>
ANIM: Cast Animation
- Plays the cast animation associated with the action.

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Change Battle Portrait
- Changes the battle portrait of the actor (if it's an actor).
- Can be used outside of battle/action sequences.

Targets:
- Select unit(s) to play the animation on.
- Valid units can only be actors.

Filename:
- Select the file to change the actor's portrait to.
</pre>

---

<pre>
ANIM: Change Battle Portrait (JS)
- Changes the battle portrait of the actor through JavaScript.
- Can be used outside of battle/action sequences.

JS: Actor ID:
- Enter which Actor ID to affect.
- Uses JavaScript code.

JS: Filename:
- Enter the filename you wish to use.
- Uses JavaScript code.
</pre>

---

<pre>
ANIM: Guard Animation
- Plays the animation associated with the user's guard action (if any).

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Item Animation
- Plays the animation associated with a specific item.

Item ID:
- Which item ID will the animation come from?

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

[[File:CoreEngine_PointAni.gif]]

<pre>
ANIM: Play at Coordinate
- Plays an animation on the screen at a specific x, y coordinate.
- Requires VisuMZ_0_CoreEngine!

Animation ID:
- Plays this animation.

Coordinates:

X:
Y:
- X/Y coordinate used for the animation.
You may use JavaScript code.

Mirror Animation?:
- Mirror the animation?

Mute Animation?:
- Mute the animation?

Wait for Completion?:
- Wait the animation to finish before continuing?
</pre>

---

<pre>
ANIM: Show Animation
- Plays the a specific animation on unit(s).

Targets:
- Select unit(s) to play the animation on.

Animation ID:
- Select which animation to play on unit(s).

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Show Animation JS
- Plays the a specific animation on unit(s).
- Uses JavaScript to determine animation ID.

Targets:
- Select unit(s) to play the animation on.

JS: Animation ID:
- Select which animation to play on unit(s).
- Uses JavaScript to determine animation ID.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Skill Animation
- Plays the animation associated with a specific skill.

Skill ID:
- Which skill ID will the animation come from?

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Wait For Animation
- Causes the interpreter to wait for any animation(s) to finish.
</pre>

---

=== Action Sequences - Battle Log ===

[[File:BattleCoreBattleLog.png]]

These Action Sequences are related to the Battle Log Window, the window
found at the top of the battle screen.

---

<pre>
BTLOG: Add Text
- Adds a new line of text into the Battle Log.

Text:
- Add this text into the Battle Log.
- Text codes allowed.

Copy to Combat Log?:
- Copies text to the Combat Log.
- Requires VisuMZ_4_CombatLog

Combat Log Icon:
- What icon would you like to bind to this entry?
- Requires VisuMZ_4_CombatLog
</pre>

---

<pre>
BTLOG: Clear Battle Log
- Clears all the text in the Battle Log.
</pre>

---

<pre>
BTLOG: Display Action
- plays the current action in the Battle Log.
</pre>

---

<pre>
BTLOG: Pop Base Line
- Removes the Battle Log's last added base line and all text up to its
former location.
</pre>

---

<pre>
BTLOG: Push Base Line
- Adds a new base line to where the Battle Log currently is at.
</pre>

---

<pre>
BTLOG: Refresh Battle Log
- Refreshes the Battle Log.
</pre>

---

<pre>
BTLOG: UI Show/Hide
- Shows or hides the Battle UI (including the Battle Log).

Show/Hide?:
- Shows/hides the Battle UI.
</pre>

---

<pre>
BTLOG: Wait For Battle Log
- Causes the interpreter to wait for the Battle Log to finish.
</pre>

---

<pre>
BTLOG: Wait For New Line
- Causes the interpreter to wait for a new line in the Battle Log.
</pre>

---

=== Action Sequences - Camera ===

[[File:VisuMZ_ActSeqCamera_Pan.gif]]

These Action Sequences are battle camera-related.
Requires VisuMZ_3_ActSeqCamera!

---

<pre>
CAMERA: Clamp ON/OFF
- Turns battle camera clamping on/off.
- Requires VisuMZ_3_ActSeqCamera!

Setting:
- Turns camera clamping on/off.
</pre>

---

<pre>
CAMERA: Focus Point
- Focus the battle camera on a certain point in the screen.
- Requires VisuMZ_3_ActSeqCamera!

X Coordinate:
- Insert the point to focus the camera on.
- You may use JavaScript code.

Y Coordinate:
- Insert the point to focus the camera on.
- You may use JavaScript code.

Duration:
- Duration in frames for camera focus change.

Camera Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Camera?
- Wait for camera changes to complete before performing next command?
</pre>

---

<pre>
CAMERA: Focus Target(s)
- Focus the battle camera on certain battler target(s).
- Requires VisuMZ_3_ActSeqCamera!

Targets:
- Select unit(s) to focus the battle camera on.

Duration:
- Duration in frames for camera focus change.

Camera Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Camera?
- Wait for camera changes to complete before performing next command?
</pre>

---

<pre>
CAMERA: Offset
- Offset the battle camera from the focus target.
- Requires VisuMZ_3_ActSeqCamera!

Offset X:
- How much to offset the camera X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset the camera Y by.
- Negative: up. Positive: down.

Duration:
- Duration in frames for offset change.

Camera Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Camera?
- Wait for camera changes to complete before performing next command?
</pre>

---

<pre>
CAMERA: Reset
- Reset the battle camera settings.
- Requires VisuMZ_3_ActSeqCamera!

Reset Focus?:
- Reset the focus point?

Reset Offset?:
- Reset the camera offset?

Duration:
- Duration in frames for reset change.

Camera Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Camera?
- Wait for camera changes to complete before performing next command?

---

CAMERA: Wait For Camera
- Waits for camera changes to complete before performing next command.
- Requires VisuMZ_3_ActSeqCamera!
</pre>

---

=== Action Sequences - Dragonbones ===

[[File:DragonbonesBattler.gif]]

These Action Sequences are Dragonbones-related.
Requires VisuMZ_2_DragonbonesUnion!

---

<pre>
DB: Dragonbones Animation
- Causes the unit(s) to play a Dragonbones motion animation.
- Requires VisuMZ_2_DragonbonesUnion!

Targets:
- Select which unit(s) to perform a motion animation.

Motion Animation:
- What is the name of the Dragonbones motion animation you wish to play?
</pre>

---

<pre>
DB: Dragonbones Time Scale
- Causes the unit(s) to change their Dragonbones time scale.
- Requires VisuMZ_2_DragonbonesUnion!

Targets:
- Select which unit(s) to perform a motion animation.

Time Scale:
- Change the value of the Dragonbones time scale to this.
</pre>

---

=== Action Sequences - Elements ===

[[File:Elements.png]]

These Action Sequences can change up the element(s) used for the action's
damage calculation midway through an action.

They also require the VisuMZ_1_ElementStatusCore plugin to be present in
order for them to work.

---

<pre>
ELE: Add Elements
- Adds element(s) to be used when calculating damage.
- Requires VisuMZ_1_ElementStatusCore!

Elements:
- Select which element ID to add onto the action.
- Insert multiple element ID's to add multiple at once.
</pre>

---

<pre>
ELE: Clear Element Changes
- Clears all element changes made through Action Sequences.
- Requires VisuMZ_1_ElementStatusCore!
</pre>

---

<pre>
ELE: Force Elements
- Forces only specific element(s) when calculating damage.
- Requires VisuMZ_1_ElementStatusCore!

Elements:
- Select which element ID to force in the action.
- Insert multiple element ID's to force multiple at once.
</pre>

---

<pre>
ELE: Null Element
- Forces no element to be used when calculating damage.
- Requires VisuMZ_1_ElementStatusCore!
</pre>

---

=== Action Sequences - Grid ===

These Action Sequences are Battle Grid System-related.
Requires VisuMZ_2_BattleGridSystem!

---

{{Battle Grid System Action Sequences}}

---

=== Action Sequences - Horror Effects ===

[[File:HorrorEffects_Battle.gif]]

[[File:HorrorEffects_BattleParty.gif]]

[[File:HorrorEffects_BattleEnemy.gif]]

These Action Sequences are Horror Effects-related.

Requires VisuMZ_2_HorrorEffects!

---

<pre>
HORROR: Clear All Filters
- Clear all Horror Effects filters on the target battler(s).

Targets:
- Select unit(s) to remove Horror Effects for.
</pre>

---

<pre>
HORROR: Glitch Create
- Creates the glitch effect on the target battler(s).

Targets:
- Select unit(s) to create the Horror Effect for.

Glitch Slices:
- Glitch slices to be used with the target.

Glitch Offset:
- Default offset value.

Glitch Animated?:
- Animate the glitch effect?

Glitch Frequency:
- If animated, how frequent to make the glitch effect?
- Lower = often Higher = rarer

Glitch Strength:
- If animated, how strong is the glitch effect?
- Lower = weaker Higher = stronger
</pre>

---

<pre>
HORROR: Glitch Remove
- Removes the glitch effect on the target battler(s).

Targets:
- Select unit(s) to remove the Horror Effect for.
</pre>

---

<pre>
HORROR: Noise Create
- Creates the noise effect on the target battler(s).

Targets:
- Select unit(s) to create the Horror Effect for.

Noise Rate:
- Noise rate to be used with the target.

Noise Animated:
- Animate the noise for the target?
</pre>

---

<pre>
HORROR: Noise Remove
- Removes the noise effect on the target battler(s).

Targets:
- Select unit(s) to remove the Horror Effect for.
</pre>

---

<pre>
HORROR: TV Create
- Creates the TV effect on the target battler(s).

Targets:
- Select unit(s) to create the Horror Effect for.

TV Line Thickness:
- Default TV line thickness
- Lower = thinner Higher = thicker

TV Corner Size:
- Default TV line corner size
- Lower = smaller Higher = bigger

TV Animated:
- Animate the TV?

TV Speed:
- Speed used to animate the TV if animated
- Lower = slower Higher = faster
</pre>

---

<pre>
HORROR: TV Remove
- Removes the TV effect on the target battler(s).

Targets:
- Select unit(s) to remove the Horror Effect for.
</pre>

---

{{VisuMZ Action Sequence Impact Plugin Commands}}

=== Action Sequences - Mechanics ===

[[File:BattleCoreDmgPopups.png|400px]]

These Action Sequences are related to various mechanics related to the
battle system.

---

<pre>
MECH: Action Effect
- Causes the unit(s) to take damage/healing from action and incurs any
changes made such as buffs and states.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Active Chain Input Disable
- Disables input for Active Chain Skills at this time.
- Requires VisuMZ_3_ActiveChainSkills!
</pre>

---

<pre>
MECH: Add Buff/Debuff
- Adds buff(s)/debuff(s) to unit(s).
- Determine which parameters are affected and their durations.

Targets:
- Select unit(s) to receive the buff(s) and/or debuff(s).

Buff Parameters:
- Select which parameter(s) to buff.
- Insert a parameter multiple times to raise its stacks.

Debuff Parameters:
- Select which parameter(s) to debuff.
- Insert a parameter multiple times to raise its stacks.

Turns:
- Number of turns to set the parameter(s) buffs to.
- You may use JavaScript code.
</pre>

---

<pre>
MECH: Add State
- Adds state(s) to unit(s).

Targets:
- Select unit(s) to receive the buff(s).

States:
- Select which state ID(s) to add to unit(s).
- Insert multiple state ID's to add multiple at once.
</pre>

---

<pre>
MECH: Analyze Weakness
- Reveal elemental weakness(es) from target(s).
- Requires VisuMZ_3_WeaknessDisplay!

Targets:
- Select unit(s) to reveal elemental weaknesses for.

Reveal:
- How many elemental weaknesses do you wish to reveal?
- You may use JavaScript code.
</pre>

---

<pre>
MECH: Armor Penetration
- Adds an extra layer of defensive penetration/reduction.
- You may use JavaScript code for any of these.

Armor/Magic Penetration:

Rate:
- Penetrates an extra multiplier of armor by this value.

Flat:
- Penetrates a flat amount of armor by this value.

Armor/Magic Reduction:

Rate:
- Reduces an extra multiplier of armor by this value.

Flat:
- Reduces a flat amount of armor by this value.
</pre>

---

<pre>
MECH: ATB Gauge
- Alters the ATB/TPB Gauges.
- Requires VisuMZ_2_BattleSystemATB!

Targets:
- Select unit(s) to alter the ATB/TPB Gauges for.

Charging:

Charge Rate:
- Changes made to the ATB Gauge if it is currently charging.

Casting:

Cast Rate:
- Changes made to the ATB Gauge if it is currently casting.

Interrupt?:
- Interrupt the ATB Gauge if it is currently casting?
</pre>

---

<pre>
MECH: Boost Points Change
- Changes Boost Points for target(s).
- Requires VisuMZ_3_BoostAction!

Targets:
- Select unit(s) to alter the Boost Points for.

Alter Boost Points By:
- Alters the unit(s) Boost Points.
- Positive for gaining points. Negative for losing points.
</pre>

---

<pre>
MECH: Boost Store Data
- Stores the number of Boosts used this action inside a variable.
- Requires VisuMZ_3_BoostAction!

Variable ID:
- Which variable do you want to store the data inside?
</pre>

---

<pre>
MECH: Break Shield Change
- Changes Break Shields for target(s) if not Break Stunned.
- Requires VisuMZ_4_BreakShields!

Targets:
- Select unit(s) to alter the Break Shields for.

Alter Break Shields By:
- Alters the unit(s) Break Shields.
- Positive for gaining shields. Negative for losing shields.
</pre>

---

<pre>
MECH: Break Shield Reset
- Resets Break Shields for target(s) if not Break Stunned.
- Requires VisuMZ_4_BreakShields!

Targets:
- Select unit(s) to reset the Break Shields for.
</pre>

---

<pre>
MECH: BTB Brave Points
- Alters the target(s) Brave Points to an exact value.
- Requires VisuMZ_2_BattleSystemBTB!

Targets:
- Select unit(s) to alter the ATB/TPB Gauges for.

Alter Brave Points By:
- Alters the target(s) Brave Points.
- Positive for gaining BP.
- Negative for losing BP.
</pre>

---

<pre>
MECH: Collapse
- Causes the unit(s) to perform its collapse animation if the unit(s)
has died.

Targets:
- Select unit(s) to process a death collapse.

Force Death:
- Force death even if the unit has not reached 0 HP?
- This will remove immortality.

Wait For Effect?:
- Wait for the collapse effect to complete before performing next command?
</pre>

---

<pre>
MECH: CTB Order
- Alters the CTB Turn Order.
- Requires VisuMZ_2_BattleSystemCTB!

Targets:
- Select unit(s) to alter the CTB Turn Order for.

Change Order By:
- Changes turn order for target(s) by this amount.
- Positive increases wait. Negative decreases wait.
</pre>

---

<pre>
MECH: CTB Speed
- Alters the CTB Speed.
- Requires VisuMZ_2_BattleSystemCTB!

Targets:
- Select unit(s) to alter the CTB Speed for.

Charge Rate:
- Changes made to the CTB Speed if it is currently charging.

Cast Rate:
- Changes made to the CTB Speed if it is currently casting.
</pre>

---

<pre>
MECH: Custom Damage Formula
- Changes the current action's damage formula to custom.
- This will assume the MANUAL damage style.

Formula:
- Changes the current action's damage formula to custom.
- Use 'default' to revert the damage formula.
</pre>

---

<pre>
MECH: Damage Popup
- Causes the unit(s) to display the current state of damage received
or healed.

Targets:
- Select unit(s) to prompt a damage popup.
</pre>

---

<pre>
MECH: Emulate Attack Effect
- Emulate an "Action Effect" but using a the user's attack skill instead of
the current action.
- Essentially lets you perform the mechanics of another action without
having to use another action or needing to pay that action's costs.

User(s):
- Select unit(s) to perform the action's effects.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Emulate Guard Effect
- Emulate an "Action Effect" but using a the user's guard skill instead of
the current action.
- Essentially lets you perform the mechanics of another action without
having to use another action or needing to pay that action's costs.

User(s):
- Select unit(s) to perform the action's effects.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Emulate Item Effect
- Emulate an "Action Effect" but using a specific item instead of the
current action.
- Essentially lets you perform the mechanics of another action without
having to use another action or needing to pay that action's costs.

Item ID:
- Which item ID will be emulated?

User(s):
- Select unit(s) to perform the action's effects.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Emulate Skill Cost
- Pick a skill for target(s) to emulate paying the cost of.
- Lets you cause characters to perform paying the costs of a specific skill
without needing to actually use them.
- This will include Skill Cooldowns and Limited Skill Uses.

Skill ID:
- Which skill ID will have its cost paid for?
- Use 0 for current action's skill.

User(s):
- Select unit(s) to perform the action's effects.
</pre>

---

<pre>
MECH: Emulate Skill Effect
- Emulate an "Action Effect" but using a specific skill instead of the
current action.
- Essentially lets you perform the mechanics of another action without
having to use another action or needing to pay that action's costs.

Skill ID:
- Which skill ID will be emulated?

User(s):
- Select unit(s) to perform the action's effects.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Enemy Escape
- Causes the enemy unit(s) to escape.

Targets:
- Select unit(s) to escape.
</pre>

---

<pre>
MECH: Dead Label Jump
- If the active battler is dead, jump to a specific label in the
common event.

Jump To Label:
- If the active battler is dead, jump to this specific label in the
common event.
</pre>

---

<pre>
MECH: ETB Energy Count
- Alters the subject team's available Energy Count.
- Requires VisuMZ_2_BattleSystemETB!

Energy Count:
- Alters the subject team's available Energy Count.
- Positive for gaining energy. Negative for losing energy.
</pre>

---

<pre>
MECH: FTB Action Count
- Alters the subject team's available Action Count.
- Requires VisuMZ_2_BattleSystemFTB!

Action Count:
- Alters the subject team's available Action Count.
- Positive for gaining actions. Negative for losing actions.
</pre>

---

<pre>
MECH: HP, MP, TP
- Alters the HP, MP, and TP values for unit(s).
- Positive values for healing. Negative values for damage.

Targets:
- Select unit(s) to receive the current action's effects.

HP, MP, TP:

Rate:
- Changes made to the parameter based on rate.
- Positive values for healing. Negative values for damage.

Flat:
- Flat changes made to the parameter.
- Positive values for healing. Negative values for damage.

Damage Popup?:
- Display a damage popup after?
</pre>

---

<pre>
MECH: Immortal
- Changes the immortal flag of targets. If immortal flag is removed and a
unit would die, collapse that unit.

Targets:
- Alter the immortal flag of these groups. If immortal flag is removed and
a unit would die, collapse that unit.

Immortal:
- Turn immortal flag for unit(s) on/off?
</pre>

---

<pre>
MECH: Multipliers
- Changes the multipliers for the current action.
- You may use JavaScript code for any of these.

Critical Hit%:

Rate:
- Affects chance to land a critical hit by this multiplier.

Flat:
- Affects chance to land a critical hit by this flat bonus.

Critical Damage

Rate:
- Affects critical damage by this multiplier.

Flat:
- Affects critical damage by this flat bonus.

Damage/Healing

Rate:
- Sets the damage/healing multiplier for current action.

Flat:
- Sets the damage/healing bonus for current action.

Hit Rate

Rate:
- Affects chance to connect attack by this multiplier.

Flat:
- Affects chance to connect attack by this flat bonus.
</pre>

---

<pre>
MECH: Once Parallel
- Plays a Common Event parallel to the battle event once without repeating
itself when done.

Common Event ID:
- The ID of the parallel Common Event to play.
- Does NOT repeat itself when finished.
- When exiting battle scene, all Once Parallels are cleared.
- Once Parallels are not retained upon reentering the scene.
- Once Parallels are not stored in memory and cannot be saved.
</pre>

---

<pre>
MECH: OTB Order
- Alters the OTB Turn Order. Best used with single targets.
- Requires VisuMZ_2_BattleSystemOTB!

Targets:
- Select unit(s) to alter the OTB Turn Order for.

Current Turn By:
- Changes turn order for target(s) by this amount.
- Positive increases wait. Negative decreases wait.

Next Turn By:
- Changes turn order for target(s) by this amount.
- Positive increases wait. Negative decreases wait.

Follow Turn By:
- Changes turn order for target(s) by this amount.
- Positive increases wait. Negative decreases wait.
</pre>

---

<pre>
MECH: PTB Alter Cost
- Alters the action's cost settings.
- Requires VisuMZ_2_BattleSystemPTB!

Override?:
- Overrides any 'permanent' settings for Changeability?

Alter Changeability:
- Allow the cost type and value to be changeable?

Alter Cost Type:
- Change the cost type to this scenario.
- Use 'Unchanged' for no changes.

Alter Cost Value:
- What is the default action cost for this scenario?
</pre>

---

<pre>
MECH: PTB Conversion
- Converts full actions into half actions.
- Requires VisuMZ_2_BattleSystemPTB!

Conversion Count:
- Converts full actions into half actions.
- If not enough, consume half actions.
</pre>

---

<pre>
MECH: PTB Full/Half Action(s)
- Alters the subject team's available Full/Half Actions.
- Requires VisuMZ_2_BattleSystemPTB!

Full Actions:
- Alters the subject team's available Full Actions.
- Positive for gaining. Negative for losing.

Half Actions:
- Alters the subject team's available Half Actions.
- Positive for gaining. Negative for losing.
</pre>

---

<pre>
MECH: Remove Buff/Debuff
- Removes buff(s)/debuff(s) from unit(s).
- Determine which parameters are removed.

Targets:
- Select unit(s) to have the buff(s) and/or debuff(s) removed.

Buff Parameters:
- Select which buffed parameter(s) to remove.

Debuff Parameters:
- Select which debuffed parameter(s) to remove.
</pre>

---

<pre>
MECH: Remove State
- Remove state(s) from unit(s).

Targets:
- Select unit(s) to have states removed from.

States:
- Select which state ID(s) to remove from unit(s).
- Insert multiple state ID's to remove multiple at once.
</pre>

---

<pre>
MECH: State Turns Change By
- Changes target(s) state turns by an amount.
- Requires VisuMZ_1_SkillsStatesCore!

Targets:
- Select unit(s) to affect state turns for.

State ID:
- What is the ID of the state you wish to change turns for?
- Only works on states that can have turns.

Change Turns By:
- How many turns should the state be changed to?
- You may use JavaScript code.

Auto-Add State?:
- Automatically adds state if actor(s) does not have it applied?
</pre>

---

<pre>
MECH: State Turns Change To
- Changes target(s) state turns to a specific value.
- Requires VisuMZ_1_SkillsStatesCore!

Targets:
- Select unit(s) to affect state turns for.

State ID:
- What is the ID of the state you wish to change turns for?
- Only works on states that can have turns.

Change Turns To:
- How many turns should the state be changed to?
- You may use JavaScript code.

Auto-Add State?:
- Automatically adds state if target(s) does not have it applied?
</pre>

---

<pre>
MECH: STB Exploit Effect
- Utilize the STB Exploitation mechanics!
- Requires VisuMZ_2_BattleSystemSTB!

Target(s) Exploited?:
- Exploit the below targets?

Targets:
- Select unit(s) to become exploited.

Force Exploitation:
- Force the exploited status?

User Exploiter?:
- Allow the user to become the exploiter?

Force Exploitation:
- Force the exploiter status?
</pre>

---

<pre>
MECH: STB Extra Action
- Adds an extra action for the currently active battler.
- Requires VisuMZ_2_BattleSystemSTB!

Extra Actions:
- How many extra actions should the active battler gain?
- You may use JavaScript code.
</pre>

---

<pre>
MECH: STB Remove Excess Actions
- Removes excess actions from the active battler.
- Requires VisuMZ_2_BattleSystemSTB!

Remove Actions:
- How many actions to remove from the active battler?
- You may use JavaScript code.
</pre>

---

<pre>
MECH: Swap Weapon
- Causes the unit(s) to swap their weapon for another.
- Requires VisuMZ_2_WeaponSwapSystem!

Targets:
- Select unit(s) to swap weapons for.

Weapon Type ID:
- Which weapon type to swap to?
- This is NOT the weapon's ID.
- It's the weapon TYPE.
</pre>

---

<pre>
MECH: Text Popup
- Causes the unit(s) to display a text popup.

Targets:
- Select unit(s) to prompt a text popup.

Text:
- What text do you wish to display?

Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Flash Color:
- Adjust the popup's flash color.
- Format: [red, green, blue, alpha]

Flash Duration:
- What is the frame duration of the flash effect?
</pre>

---

<pre>
MECH: Variable Popup
- Causes the unit(s) to display a popup using the data stored inside
a variable.

Targets:
- Select unit(s) to prompt a text popup.

Variable:
- Get data from which variable to display as a popup?

Digit Grouping:
- Use digit grouping to separate numbers?
- Requires VisuMZ_0_CoreEngine!

Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Flash Color:
- Adjust the popup's flash color.
- Format: [red, green, blue, alpha]

Flash Duration:
- What is the frame duration of the flash effect?
</pre>

---

<pre>
MECH: Wait For Effect
- Waits for the effects to complete before performing next command.
</pre>

---

=== Action Sequences - Motion ===

[[File:BattleCoreActSeqSet.gif]]

These Action Sequences allow you the ability to control the motions of
sideview sprites.

---

<pre>
MOTION: Clear Freeze Frame
- Clears any freeze frames from the unit(s).

Targets:
- Select which unit(s) to clear freeze frames for.
</pre>

---

<pre>
MOTION: Freeze Motion Frame
- Forces a freeze frame instantly at the selected motion.
- Automatically clears with a new motion.

Targets:
- Select which unit(s) to freeze motions for.

Motion Type:
- Freeze this motion for the unit(s).

Frame Index:
- Which frame do you want to freeze the motion on?
- Frame index values start at 0.

Show Weapon?:
- If using 'attack', 'thrust', 'swing', or 'missile', display the
weapon sprite?
</pre>

---

<pre>
MOTION: Motion Type
- Causes the unit(s) to play the selected motion.

Targets:
- Select which unit(s) to perform a motion.

Motion Type:
- Play this motion for the unit(s).

Show Weapon?:
- If using 'attack', 'thrust', 'swing', or 'missile', display the
weapon sprite?
</pre>

---

<pre>
MOTION: Perform Action
- Causes the unit(s) to play the proper motion based on the current action.

Targets:
- Select which unit(s) to perform a motion.
</pre>

---

<pre>
MOTION: Refresh Motion
- Cancels any set motions unit(s) has to do and use their most natural
motion at the moment.

Targets:
- Select which unit(s) to refresh their motion state.
</pre>

---

<pre>
MOTION: Wait By Motion Frame
- Creates a wait equal to the number of motion frames passing.
- Time is based on Plugin Parameters => Actors => Motion Speed.

Motion Frames to Wait?:
- Each "frame" is equal to the value found in
Plugin Parameters => Actors => Motion Speed
</pre>

---

=== Action Sequences - Movement ===

[[File:BattleCoreActSeqSet.gif]]

These Action Sequences allow you the ability to control the sprites of
actors and enemies in battle.

---

<pre>
MOVE: Battle Step
- Causes the unit(s) to move forward past their home position to prepare
for action.

Targets:
- Select which unit(s) to move.

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Change Home By Distance
- Change unit(s)'s home position by a distance from their current home
position(s).
- Sideview-only!

Targets:
- Select which unit(s) to change home position(s) for.

Distance Adjustment:
- Makes adjustments to distance values to determine which direction to
change by.
- Normal - No adjustments made
- Horizontal - Actors adjust left, Enemies adjust right
- Vertical - Actors adjust Up, Enemies adjust down
- Both - Applies both Horizontal and Vertical

Distance: X:
- Horizontal distance to move.
- You may use JavaScript code.

Distance: Y:
- Vertical distance to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total change amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Change Home To JS Coordinates
- Change home position(s) to specified JS Coordinates.
- Sideview-only! Uses JavaScript!

Targets:
- Select which unit(s) to change home position(s) for.

JS: Coordinates:
- Code used to determine the coordinates for the target(s)'s new home
position.

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total change amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Change Home To Point
- Change home position(s) to a target point on the screen.
- Sideview-only! Points based off Graphics.boxWidth/Height.

Targets:
- Select which unit(s) to change home position(s) for.

Destination Point:
- Select which point to face.
- Center
- Point X, Y
- Replace 'x' and 'y' with coordinates

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total change amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Change Home To Target(s)
- Moves unit(s) to another unit(s) on the battle field.
- Sideview-only!

Targets (Moving):
- Select which unit(s) to change home position(s) for.

Targets (Destination):
- Select which unit(s) to change home position to.

Target Location:
- Select which part target group to change home position to.
- front head
- front center
- front base
- middle head
- middle center
- middle base
- back head
- back center
- back base

Melee Distance:
- The melee distance away from the target location in addition to the
battler's width.

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total change amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Face Direction
- Causes the unit(s) to face forward or backward.
- Sideview-only!

Targets:
- Select which unit(s) to change direction.

Direction:
- Select which direction to face.
</pre>

---

<pre>
MOVE: Face JS Coordinates
- Causes the unit(s) to face specified JS Coordinates.
- Sideview-only! Uses JavaScript!

Targets:
- Select which unit(s) to change direction.

JS: Coordinates:
- Code used to determine the coordinates for the target(s) to face
towards.

Face Away From?:
- Face away from the point instead?
</pre>

---

<pre>
MOVE: Face Point
- Causes the unit(s) to face a point on the screen.
- Sideview-only!

Targets:
- Select which unit(s) to change direction.

Point:
- Select which point to face.
- Home
- Center
- Point X, Y
- Replace 'x' and 'y' with coordinates

Face Away From?:
- Face away from the point instead?
</pre>

---

<pre>
MOVE: Face Target(s)
- Causes the unit(s) to face other targets on the screen.
- Sideview-only!

Targets (facing):
- Select which unit(s) to change direction.

Targets (destination):
- Select which unit(s) for the turning unit(s) to face.

Face Away From?:
- Face away from the unit(s) instead?
</pre>

---

<pre>
MOVE: Float
- Causes the unit(s) to float above the ground.
- Sideview-only!

Targets:
- Select which unit(s) to make float.

Desired Height:
- Vertical distance to float upward.
- You may use JavaScript code.

Duration:
- Duration in frames for total float amount.

Float Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Float?:
- Wait for floating to complete before performing next command?
</pre>

---

<pre>
MOVE: Home Reset
- Causes the unit(s) to move back to their home position(s) and face back to
their original direction(s).

Targets:
- Select which unit(s) to move.

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Jump
- Causes the unit(s) to jump into the air.
- Sideview-only!

Targets:
- Select which unit(s) to make jump.

Desired Height:
- Max jump height to go above the ground
- You may use JavaScript code.

Duration:
- Duration in frames for total jump amount.

Wait For Jump?:
- Wait for jumping to complete before performing next command?
</pre>

---

<pre>
MOVE: Move Distance
- Moves unit(s) by a distance from their current position(s).
- Sideview-only!

Targets:
- Select which unit(s) to move.

Distance Adjustment:
- Makes adjustments to distance values to determine which direction to
move unit(s).
- Normal - No adjustments made
- Horizontal - Actors adjust left, Enemies adjust right
- Vertical - Actors adjust Up, Enemies adjust down
- Both - Applies both Horizontal and Vertical

Distance: X:
- Horizontal distance to move.
- You may use JavaScript code.

Distance: Y:
- Vertical distance to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total movement amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Move To JS Coordinates
- Moves unit(s) to specified JS Coordinates.
- Sideview-only! Uses JavaScript!

Targets:
- Select which unit(s) to move.

JS: Coordinates:
- Code used to determine the coordinates for the target(s) to move to.

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total movement amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Move To Point
- Moves unit(s) to a designated point on the screen.
- Sideview-only! Points based off Graphics.boxWidth/Height.

Targets:
- Select which unit(s) to move.

Destination Point:
- Select which point to face.
- Home
- Center
- Point X, Y
- Replace 'x' and 'y' with coordinates

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total movement amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Move To Target(s)
- Moves unit(s) to another unit(s) on the battle field.
- Sideview-only!

Targets (Moving):
- Select which unit(s) to move.

Targets (Destination):
- Select which unit(s) to move to.

Target Location:
- Select which part target group to move to.
- front head
- front center
- front base
- middle head
- middle center
- middle base
- back head
- back center
- back base

Melee Distance:
- The melee distance away from the target location in addition to the
battler's width.

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total movement amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Opacity
- Causes the unit(s) to change opacity.
- Sideview-only!

Targets:
- Select which unit(s) to change opacity.

Desired Opacity:
- Change to this opacity value.
- You may use JavaScript code.

Duration:
- Duration in frames for opacity change.

Opacity Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Opacity?:
- Wait for opacity changes to complete before performing next command?
</pre>

---

[[File:ActSeqGrowShrink.gif]]

<pre>
MOVE: Scale/Grow/Shrink
- Causes the unit(s) to scale, grow, or shrink?.
- Sideview-only!

Targets:
- Select which unit(s) to change the scale of.

Scale X:
Scale Y:
- What target scale value do you want?
- 1.0 is normal size.

Duration:
- Duration in frames to scale for.

Scale Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Scale?:
- Wait for scaling to complete before performing next command?
</pre>

---

[[File:ActSeqSkew.gif]]

<pre>
MOVE: Skew/Distort
- Causes the unit(s) to skew.
- Sideview-only!

Targets:
- Select which unit(s) to skew.

Skew X:
Skew Y:
- What variance to skew?
- Use small values for the best results.

Duration:
- Duration in frames to skew for.

Skew Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Skew?:
- Wait for skew to complete before performing next command?
</pre>

---

[[File:ActSeqSpin.gif]]

<pre>
MOVE: Spin/Rotate
- Causes the unit(s) to spin.
- Sideview-only!

Targets:
- Select which unit(s) to spin.

Angle:
- How many degrees to spin?

Duration:
- Duration in frames to spin for.

Spin Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Revert Angle on Finish:
- Upon finishing the spin, revert the angle back to 0.

Wait For Spin?:
- Wait for spin to complete before performing next command?
</pre>

---

<pre>
MOVE: Wait For Float
- Waits for floating to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Jump
- Waits for jumping to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Movement
- Waits for movement to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Opacity
- Waits for opacity changes to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Scale
- Waits for scaling to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Skew
- Waits for skewing to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Spin
- Waits for spinning to complete before performing next command.
</pre>

---

{{VisuMZ Action Sequence Projectiles Plugin Commands}}

=== Action Sequences - Skew (Camera) ===

[[File:VisuMZ_ActSeqCamera_Skew.gif]]

These action sequences allow you to have control over the camera skew.
Requires VisuMZ_3_ActSeqCamera!

---

<pre>
SKEW: Change Skew
- Changes the camera skew.
- Requires VisuMZ_3_ActSeqCamera!

Skew X:
- Change the camera skew X to this value.

Skew Y:
- Change the camera skew Y to this value.

Duration:
- Duration in frames to change camera skew.

Skew Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Skew?:
- Wait for skew changes to complete before performing next command?
</pre>

---

<pre>
SKEW: Reset Skew
- Reset any skew settings.
- Requires VisuMZ_3_ActSeqCamera!

Duration:
- Duration in frames to reset camera skew.

Skew Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Skew?:
- Wait for skew changes to complete before performing next command?
</pre>

---

<pre>
SKEW: Wait For Skew
- Waits for skew changes to complete before performing next command.
- Requires VisuMZ_3_ActSeqCamera!
</pre>

---

=== Action Sequences - Target ===

[[File:BattleCoreTargetActSeq.png]]

If using a manual target by target Action Sequence, these commands will give
you full control over its usage.

Refer to the image above for reference on how this works.

---

<pre>
TARGET: Current Index
- Sets the current index to this value.
- Then decide to jump to a label (optional).

Set Index To:
- Sets current targeting index to this value.
- 0 is the starting index of a target group.

Jump To Label:
- If a target is found after the index change, jump to this label in the
Common Event.
</pre>

---

<pre>
TARGET: Next Target
- Moves index forward by 1 to select a new current target.
- Then decide to jump to a label (optional).

Jump To Label:
- If a target is found after the index change, jump to this label in the
Common Event.
</pre>

---

<pre>
TARGET: Previous Target
- Moves index backward by 1 to select a new current target.
- Then decide to jump to a label (optional).

Jump To Label:
- If a target is found after the index change, jump to this label in the
Common Event.
</pre>

---

<pre>
TARGET: Random Target
- Sets index randomly to determine new currernt target.
- Then decide to jump to a label (optional).

Force Random?:
- Index cannot be its previous index amount after random.

Jump To Label:
- If a target is found after the index change, jump to this label in the
Common Event.
</pre>

---

=== Action Sequences - Voice ===

[[File:VisuMZ.131.jpg|600px]]

---

<pre>
VOICE: Common Line
- Plays a common voice line from target battler(s).
- Requires VisuMZ_3_BattleVoices!

Speaker Target(s):
- Select unit(s) to play voice lines from.

Voice Line:
- What voice line do you wish to play?
</pre>

---

<pre>
VOICE: Play Special Line
- Plays a special voice line from target battler(s).
- Requires VisuMZ_3_BattleVoices!

Speaker Target(s):
- Select unit(s) to play voice lines from.

Voice Line Type:
- What voice line type do you wish to play?
- Action Name
- Chant Line
- Item Name
- Skill Name
- Spell Name
- Unique Lines

Name / Letter:
- What voice letter/name do you want to play?
</pre>

---

=== Action Sequences - Weapon ===

[[File:BattleCore_DualWield.gif]]

Allows for finer control over Dual/Multi Wielding actors.

Only works for Actors.

---

<pre>
WEAPON: Clear Weapon Slot
- Clears the active weapon slot (making others valid again).
- Only works for Actors.

Targets:
- Select unit(s) to clear the active weapon slot for.
</pre>

---

<pre>
WEAPON: Next Weapon Slot
- Goes to next active weapon slot (making others invalid).
- If next slot is weaponless, don't label jump.

Targets:
- Select unit(s) to change the next active weapon slot for.
</pre>

---

<pre>
WEAPON: Set Weapon Slot
- Sets the active weapon slot (making others invalid).
- Only works for Actors.

Targets:
- Select unit(s) to change the active weapon slot for.

Weapon Slot ID:
- Select weapon slot to make active (making others invalid).
- Use 0 to clear and normalize. You may use JavaScript code.
</pre>

---

==== Dual Wield Action Sequence Example ====

Here is an example of how to set up a dual-wield action sequence, whiled
also checking the trait objects to make sure that no other weapons are
being involved:

◆Plugin Command：VisuMZ_1_BattleCore, ACSET: Setup Action Set
Display Action = true
Immortal: On = true
Battle Step = true
Wait For Movement = true
Cast Animation = true
Wait For Animation = true

◆Script：console.log('---Before Switching---')
let user = BattleManager._subject;
let result = user.traitObjects()
.filter(obj => DataManager.isWeapon(obj))
.map(obj => obj.id);
console.log('Weapon IDs', result);

◆Plugin Command：VisuMZ_1_BattleCore, WEAPON: Set Weapon Slot
Targets = ["user"]
Weapon Slot ID = 1

◆Label：AttackLoop

◆Script：console.log('---Slot Check---')
let user = BattleManager._subject;
let result = user.traitObjects()
.filter(obj => DataManager.isWeapon(obj))
.map(obj => obj.id);
console.log('Weapon IDs', result);

◆Plugin Command：VisuMZ_1_BattleCore, ACSET: All Targets Action Set
Dual/Multi Wield? = false
Perform Action = true
Wait Count = Sprite_Battler._motionSpeed
Action Animation = true
Wait For Animation = true
Action Effect = true
Immortal: Off = true

◆Plugin Command：VisuMZ_1_BattleCore, WEAPON: Next Weapon Slot
Targets = ["user"]
Jump To Label = AttackLoop

◆Label：LoopFinished

◆Plugin Command：VisuMZ_1_BattleCore, WEAPON: Clear Weapon Slot
Targets = ["user"]

◆Script：console.log('---Slots Cleared---')
let user = BattleManager._subject;
let result = user.traitObjects()
.filter(obj => DataManager.isWeapon(obj))
.map(obj => obj.id);
console.log('Weapon IDs', result);

◆Plugin Command：VisuMZ_1_BattleCore, ACSET: Finish Action
Immortal: Off = true
Wait For New Line = true
Wait For Effects = true
Clear Battle Log = true
Home Reset = true
Wait For Movement = true

If you want to make sure the weapon slots are only using those specific
weapons, include the console.log() script calls above. Otherwise, those
can be removed. They're only used as proof of weapon separation that can be
seen inside the game's Dev Tools window (press F8 to open Dev Tools, then
click "Console" for the console logs).

---

=== Action Sequences - Zoom (Camera) ===

[[File:VisuMZ_ActSeqCamera_Zoom.gif]]

These Action Sequences are zoom-related.
Requires VisuMZ_3_ActSeqCamera!

---

<pre>
ZOOM: Change Scale
- Changes the zoom scale.
- Requires VisuMZ_3_ActSeqCamera!

Scale:
- The zoom scale to change to.

Duration:
- Duration in frames to reset battle zoom.

Zoom Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Zoom?
- Wait for zoom changes to complete before performing next command?
</pre>

---

<pre>
ZOOM: Reset Zoom
- Reset any zoom settings.
- Requires VisuMZ_3_ActSeqCamera!

Duration:
- Duration in frames to reset battle zoom.

Zoom Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Zoom?
- Wait for zoom changes to complete before performing next command?
</pre>

---

<pre>
ZOOM: Wait For Zoom
- Waits for zoom changes to complete before performing next command.
Requires VisuMZ_3_ActSeqCamera!
</pre>

---

Template:Action Sequences MZ

2026-05-08T12:42:23Z

Irina: /* Action Sequences - Weapon */

<noinclude>[[Category:Display templates|template]]</noinclude>

[[File:BattleCoreActSeq.png]]

Skills and items, when used in battle, have a pre-determined series of
actions to display to the player as a means of representing what's going on
with the action. For some game devs, this may not be enough and they would
like to get more involved with the actions themselves.

Action Sequences, added through this plugin, enable this. To give a skill or
item a Custom Action Sequence, a couple of steps must be followed:

---

[[File:BattleCorePentaSlash.gif]]

1. Insert the <Custom Action Sequence> notetag into the skill or item's notebox (or else this would not work as intended).
2. Give that skill/item a Common Event through the Effects box. The selected Common Event will contain all the Action Sequence data.
3. Create the Common Event with Action Sequence Plugin Commands and/or event commands to make the skill/item do what you want it to do.

---

The Plugin Commands added through the Battle Core plugin focus entirely on
Action Sequences. However, despite the fact that they're made for skills and
items, some of these Action Sequence Plugin Commands can still be used for
regular Troop events and Common Events.

---

=== Action Sequence - Action Sets ===

[[File:BattleCoreActSeqSet.gif]]

Action Sequence Action Sets are groups of commonly used
Action Sequence Commands put together for more efficient usage.

---

<pre>
ACSET: Setup Action Set
- The generic start to most actions.

Display Action:
Immortal: On:
Battle Step:
Wait For Movement:
Cast Animation:
Wait For Animation:
- Use this part of the action sequence?
</pre>

---

<pre>
ACSET: All Targets Action Set
- Affects all targets simultaneously performing the following.

Dual/Multi Wield?
- Add times struck based on weapon quantity equipped?

Perform Action:
Wait Count:
Action Animation:
Wait For Animation:
Action Effect:
Immortal: Off:
- Use this part of the action sequence?
- Insert values for the Wait Count(s).
</pre>

---

<pre>
ACSET: Each Target Action Set
- Goes through each target one by one to perform the following.

Dual/Multi Wield?
- Add times struck based on weapon quantity equipped?

Perform Action:
Wait Count:
Action Animation:
Wait Count:
Action Effect:
Immortal: Off:
- Use this part of the action sequence?
- Insert values for the Wait Count(s).
</pre>

---

<pre>
ACSET: Finish Action
- The generic ending to most actions.

Immortal: Off:
Wait For New Line:
Wait For Effects:
Clear Battle Log:
Home Reset:
Wait For Movement:
- Use this part of the action sequence?
</pre>

---

=== Action Sequences - Angle (Camera) ===

[[File:VisuMZ_ActSeqCamera_Angle.gif]]

These action sequences allow you to have control over the camera angle.
Requires VisuMZ_3_ActSeqCamera!

---

<pre>
ANGLE: Change Angle
- Changes the camera angle.
- Requires VisuMZ_3_ActSeqCamera!

Angle:
- Change the camera angle to this many degrees.

Duration:
- Duration in frames to change camera angle.

Angle Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Angle?:
- Wait for angle changes to complete before performing next command?
</pre>

---

<pre>
ANGLE: Reset Angle
- Reset any angle settings.
- Requires VisuMZ_3_ActSeqCamera!

Duration:
- Duration in frames to reset camera angle.

Angle Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Angle?:
- Wait for angle changes to complete before performing next command?
</pre>

---

<pre>
ANGLE: Wait For Angle
- Waits for angle changes to complete before performing next command.
- Requires VisuMZ_3_ActSeqCamera!
</pre>

---

=== Action Sequences - Animations ===

[[File:BattleCoreCastAni.gif]]

These Action Sequences are related to the 'Animations' that can be found in
the Animations tab of the Database.

---

<pre>
ANIM: Action Animation
- Plays the animation associated with the action.

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Attack Animation
- Plays the animation associated with the user's weapon.

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Attack Animation 2+
- Plays the animation associated with the user's other weapons.
- Plays nothing if there is no other weapon equipped.

Targets:
- Select unit(s) to play the animation on.

Slot:
- Which weapon slot to get this data from?
- Main-hand weapon is weapon slot 1.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

[[File:BattleCore_Update132_Preview.png]]

<pre>
ANIM: Balloon Animation
- Plays a balloon animation on target(s).

Targets:
- Select unit(s) to play the animation on.

Balloon Type:
- What kind of balloon should be played on target(s)?

Wait for Completion:
- Wait for balloon animation completion before continuing?
</pre>

---

<pre>
ANIM: Balloon Icon (Single)
- Plays a balloon animation using an icon on target(s).
- Requires VisuMZ_4_IconBalloons!

Targets:
- Select unit(s) to play the animation on.

Icon Index:
- Insert the ID of the icon to show.
- Tip: Right click > Insert Icon Index

Wait for Completion:
- Wait for balloon animation completion before continuing?
</pre>

---

<pre>
ANIM: Balloon Icon (Range)
- Plays a balloon animation an icon range on target(s).
- Requires VisuMZ_4_IconBalloons!

Targets:
- Select unit(s) to play the animation on.

Starting Icon Index:
- Insert the ID of the icon to show.
- Tip: Right click > Insert Icon Index

Ending Icon Index:
- Insert the ID of the icon to show.
- Tip: Right click > Insert Icon Index

Wait for Completion:
- Wait for balloon animation completion before continuing?
</pre>

---

<pre>
ANIM: Balloon Icon (Specific)
- Plays a balloon animation with specific icons on target(s).
- Requires VisuMZ_4_IconBalloons!

Targets:
- Select unit(s) to play the animation on.

Icons:
- Insert the ID(s) of the icon to show.
- Tip: Right click > Insert Icon Index

Wait for Completion:
- Wait for balloon animation completion before continuing?
</pre>

---

<pre>
ANIM: Cast Animation
- Plays the cast animation associated with the action.

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Change Battle Portrait
- Changes the battle portrait of the actor (if it's an actor).
- Can be used outside of battle/action sequences.

Targets:
- Select unit(s) to play the animation on.
- Valid units can only be actors.

Filename:
- Select the file to change the actor's portrait to.
</pre>

---

<pre>
ANIM: Change Battle Portrait (JS)
- Changes the battle portrait of the actor through JavaScript.
- Can be used outside of battle/action sequences.

JS: Actor ID:
- Enter which Actor ID to affect.
- Uses JavaScript code.

JS: Filename:
- Enter the filename you wish to use.
- Uses JavaScript code.
</pre>

---

<pre>
ANIM: Guard Animation
- Plays the animation associated with the user's guard action (if any).

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Item Animation
- Plays the animation associated with a specific item.

Item ID:
- Which item ID will the animation come from?

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

[[File:CoreEngine_PointAni.gif]]

<pre>
ANIM: Play at Coordinate
- Plays an animation on the screen at a specific x, y coordinate.
- Requires VisuMZ_0_CoreEngine!

Animation ID:
- Plays this animation.

Coordinates:

X:
Y:
- X/Y coordinate used for the animation.
You may use JavaScript code.

Mirror Animation?:
- Mirror the animation?

Mute Animation?:
- Mute the animation?

Wait for Completion?:
- Wait the animation to finish before continuing?
</pre>

---

<pre>
ANIM: Show Animation
- Plays the a specific animation on unit(s).

Targets:
- Select unit(s) to play the animation on.

Animation ID:
- Select which animation to play on unit(s).

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Show Animation JS
- Plays the a specific animation on unit(s).
- Uses JavaScript to determine animation ID.

Targets:
- Select unit(s) to play the animation on.

JS: Animation ID:
- Select which animation to play on unit(s).
- Uses JavaScript to determine animation ID.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Skill Animation
- Plays the animation associated with a specific skill.

Skill ID:
- Which skill ID will the animation come from?

Targets:
- Select unit(s) to play the animation on.

Mirror Animation:
- Mirror the animation?

Wait For Animation?:
- Wait for animation to complete before performing next command?
</pre>

---

<pre>
ANIM: Wait For Animation
- Causes the interpreter to wait for any animation(s) to finish.
</pre>

---

=== Action Sequences - Battle Log ===

[[File:BattleCoreBattleLog.png]]

These Action Sequences are related to the Battle Log Window, the window
found at the top of the battle screen.

---

<pre>
BTLOG: Add Text
- Adds a new line of text into the Battle Log.

Text:
- Add this text into the Battle Log.
- Text codes allowed.

Copy to Combat Log?:
- Copies text to the Combat Log.
- Requires VisuMZ_4_CombatLog

Combat Log Icon:
- What icon would you like to bind to this entry?
- Requires VisuMZ_4_CombatLog
</pre>

---

<pre>
BTLOG: Clear Battle Log
- Clears all the text in the Battle Log.
</pre>

---

<pre>
BTLOG: Display Action
- plays the current action in the Battle Log.
</pre>

---

<pre>
BTLOG: Pop Base Line
- Removes the Battle Log's last added base line and all text up to its
former location.
</pre>

---

<pre>
BTLOG: Push Base Line
- Adds a new base line to where the Battle Log currently is at.
</pre>

---

<pre>
BTLOG: Refresh Battle Log
- Refreshes the Battle Log.
</pre>

---

<pre>
BTLOG: UI Show/Hide
- Shows or hides the Battle UI (including the Battle Log).

Show/Hide?:
- Shows/hides the Battle UI.
</pre>

---

<pre>
BTLOG: Wait For Battle Log
- Causes the interpreter to wait for the Battle Log to finish.
</pre>

---

<pre>
BTLOG: Wait For New Line
- Causes the interpreter to wait for a new line in the Battle Log.
</pre>

---

=== Action Sequences - Camera ===

[[File:VisuMZ_ActSeqCamera_Pan.gif]]

These Action Sequences are battle camera-related.
Requires VisuMZ_3_ActSeqCamera!

---

<pre>
CAMERA: Clamp ON/OFF
- Turns battle camera clamping on/off.
- Requires VisuMZ_3_ActSeqCamera!

Setting:
- Turns camera clamping on/off.
</pre>

---

<pre>
CAMERA: Focus Point
- Focus the battle camera on a certain point in the screen.
- Requires VisuMZ_3_ActSeqCamera!

X Coordinate:
- Insert the point to focus the camera on.
- You may use JavaScript code.

Y Coordinate:
- Insert the point to focus the camera on.
- You may use JavaScript code.

Duration:
- Duration in frames for camera focus change.

Camera Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Camera?
- Wait for camera changes to complete before performing next command?
</pre>

---

<pre>
CAMERA: Focus Target(s)
- Focus the battle camera on certain battler target(s).
- Requires VisuMZ_3_ActSeqCamera!

Targets:
- Select unit(s) to focus the battle camera on.

Duration:
- Duration in frames for camera focus change.

Camera Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Camera?
- Wait for camera changes to complete before performing next command?
</pre>

---

<pre>
CAMERA: Offset
- Offset the battle camera from the focus target.
- Requires VisuMZ_3_ActSeqCamera!

Offset X:
- How much to offset the camera X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset the camera Y by.
- Negative: up. Positive: down.

Duration:
- Duration in frames for offset change.

Camera Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Camera?
- Wait for camera changes to complete before performing next command?
</pre>

---

<pre>
CAMERA: Reset
- Reset the battle camera settings.
- Requires VisuMZ_3_ActSeqCamera!

Reset Focus?:
- Reset the focus point?

Reset Offset?:
- Reset the camera offset?

Duration:
- Duration in frames for reset change.

Camera Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Camera?
- Wait for camera changes to complete before performing next command?

---

CAMERA: Wait For Camera
- Waits for camera changes to complete before performing next command.
- Requires VisuMZ_3_ActSeqCamera!
</pre>

---

=== Action Sequences - Dragonbones ===

[[File:DragonbonesBattler.gif]]

These Action Sequences are Dragonbones-related.
Requires VisuMZ_2_DragonbonesUnion!

---

<pre>
DB: Dragonbones Animation
- Causes the unit(s) to play a Dragonbones motion animation.
- Requires VisuMZ_2_DragonbonesUnion!

Targets:
- Select which unit(s) to perform a motion animation.

Motion Animation:
- What is the name of the Dragonbones motion animation you wish to play?
</pre>

---

<pre>
DB: Dragonbones Time Scale
- Causes the unit(s) to change their Dragonbones time scale.
- Requires VisuMZ_2_DragonbonesUnion!

Targets:
- Select which unit(s) to perform a motion animation.

Time Scale:
- Change the value of the Dragonbones time scale to this.
</pre>

---

=== Action Sequences - Elements ===

[[File:Elements.png]]

These Action Sequences can change up the element(s) used for the action's
damage calculation midway through an action.

They also require the VisuMZ_1_ElementStatusCore plugin to be present in
order for them to work.

---

<pre>
ELE: Add Elements
- Adds element(s) to be used when calculating damage.
- Requires VisuMZ_1_ElementStatusCore!

Elements:
- Select which element ID to add onto the action.
- Insert multiple element ID's to add multiple at once.
</pre>

---

<pre>
ELE: Clear Element Changes
- Clears all element changes made through Action Sequences.
- Requires VisuMZ_1_ElementStatusCore!
</pre>

---

<pre>
ELE: Force Elements
- Forces only specific element(s) when calculating damage.
- Requires VisuMZ_1_ElementStatusCore!

Elements:
- Select which element ID to force in the action.
- Insert multiple element ID's to force multiple at once.
</pre>

---

<pre>
ELE: Null Element
- Forces no element to be used when calculating damage.
- Requires VisuMZ_1_ElementStatusCore!
</pre>

---

=== Action Sequences - Grid ===

These Action Sequences are Battle Grid System-related.
Requires VisuMZ_2_BattleGridSystem!

---

{{Battle Grid System Action Sequences}}

---

=== Action Sequences - Horror Effects ===

[[File:HorrorEffects_Battle.gif]]

[[File:HorrorEffects_BattleParty.gif]]

[[File:HorrorEffects_BattleEnemy.gif]]

These Action Sequences are Horror Effects-related.

Requires VisuMZ_2_HorrorEffects!

---

<pre>
HORROR: Clear All Filters
- Clear all Horror Effects filters on the target battler(s).

Targets:
- Select unit(s) to remove Horror Effects for.
</pre>

---

<pre>
HORROR: Glitch Create
- Creates the glitch effect on the target battler(s).

Targets:
- Select unit(s) to create the Horror Effect for.

Glitch Slices:
- Glitch slices to be used with the target.

Glitch Offset:
- Default offset value.

Glitch Animated?:
- Animate the glitch effect?

Glitch Frequency:
- If animated, how frequent to make the glitch effect?
- Lower = often Higher = rarer

Glitch Strength:
- If animated, how strong is the glitch effect?
- Lower = weaker Higher = stronger
</pre>

---

<pre>
HORROR: Glitch Remove
- Removes the glitch effect on the target battler(s).

Targets:
- Select unit(s) to remove the Horror Effect for.
</pre>

---

<pre>
HORROR: Noise Create
- Creates the noise effect on the target battler(s).

Targets:
- Select unit(s) to create the Horror Effect for.

Noise Rate:
- Noise rate to be used with the target.

Noise Animated:
- Animate the noise for the target?
</pre>

---

<pre>
HORROR: Noise Remove
- Removes the noise effect on the target battler(s).

Targets:
- Select unit(s) to remove the Horror Effect for.
</pre>

---

<pre>
HORROR: TV Create
- Creates the TV effect on the target battler(s).

Targets:
- Select unit(s) to create the Horror Effect for.

TV Line Thickness:
- Default TV line thickness
- Lower = thinner Higher = thicker

TV Corner Size:
- Default TV line corner size
- Lower = smaller Higher = bigger

TV Animated:
- Animate the TV?

TV Speed:
- Speed used to animate the TV if animated
- Lower = slower Higher = faster
</pre>

---

<pre>
HORROR: TV Remove
- Removes the TV effect on the target battler(s).

Targets:
- Select unit(s) to remove the Horror Effect for.
</pre>

---

{{VisuMZ Action Sequence Impact Plugin Commands}}

=== Action Sequences - Mechanics ===

[[File:BattleCoreDmgPopups.png|400px]]

These Action Sequences are related to various mechanics related to the
battle system.

---

<pre>
MECH: Action Effect
- Causes the unit(s) to take damage/healing from action and incurs any
changes made such as buffs and states.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Active Chain Input Disable
- Disables input for Active Chain Skills at this time.
- Requires VisuMZ_3_ActiveChainSkills!
</pre>

---

<pre>
MECH: Add Buff/Debuff
- Adds buff(s)/debuff(s) to unit(s).
- Determine which parameters are affected and their durations.

Targets:
- Select unit(s) to receive the buff(s) and/or debuff(s).

Buff Parameters:
- Select which parameter(s) to buff.
- Insert a parameter multiple times to raise its stacks.

Debuff Parameters:
- Select which parameter(s) to debuff.
- Insert a parameter multiple times to raise its stacks.

Turns:
- Number of turns to set the parameter(s) buffs to.
- You may use JavaScript code.
</pre>

---

<pre>
MECH: Add State
- Adds state(s) to unit(s).

Targets:
- Select unit(s) to receive the buff(s).

States:
- Select which state ID(s) to add to unit(s).
- Insert multiple state ID's to add multiple at once.
</pre>

---

<pre>
MECH: Analyze Weakness
- Reveal elemental weakness(es) from target(s).
- Requires VisuMZ_3_WeaknessDisplay!

Targets:
- Select unit(s) to reveal elemental weaknesses for.

Reveal:
- How many elemental weaknesses do you wish to reveal?
- You may use JavaScript code.
</pre>

---

<pre>
MECH: Armor Penetration
- Adds an extra layer of defensive penetration/reduction.
- You may use JavaScript code for any of these.

Armor/Magic Penetration:

Rate:
- Penetrates an extra multiplier of armor by this value.

Flat:
- Penetrates a flat amount of armor by this value.

Armor/Magic Reduction:

Rate:
- Reduces an extra multiplier of armor by this value.

Flat:
- Reduces a flat amount of armor by this value.
</pre>

---

<pre>
MECH: ATB Gauge
- Alters the ATB/TPB Gauges.
- Requires VisuMZ_2_BattleSystemATB!

Targets:
- Select unit(s) to alter the ATB/TPB Gauges for.

Charging:

Charge Rate:
- Changes made to the ATB Gauge if it is currently charging.

Casting:

Cast Rate:
- Changes made to the ATB Gauge if it is currently casting.

Interrupt?:
- Interrupt the ATB Gauge if it is currently casting?
</pre>

---

<pre>
MECH: Boost Points Change
- Changes Boost Points for target(s).
- Requires VisuMZ_3_BoostAction!

Targets:
- Select unit(s) to alter the Boost Points for.

Alter Boost Points By:
- Alters the unit(s) Boost Points.
- Positive for gaining points. Negative for losing points.
</pre>

---

<pre>
MECH: Boost Store Data
- Stores the number of Boosts used this action inside a variable.
- Requires VisuMZ_3_BoostAction!

Variable ID:
- Which variable do you want to store the data inside?
</pre>

---

<pre>
MECH: Break Shield Change
- Changes Break Shields for target(s) if not Break Stunned.
- Requires VisuMZ_4_BreakShields!

Targets:
- Select unit(s) to alter the Break Shields for.

Alter Break Shields By:
- Alters the unit(s) Break Shields.
- Positive for gaining shields. Negative for losing shields.
</pre>

---

<pre>
MECH: Break Shield Reset
- Resets Break Shields for target(s) if not Break Stunned.
- Requires VisuMZ_4_BreakShields!

Targets:
- Select unit(s) to reset the Break Shields for.
</pre>

---

<pre>
MECH: BTB Brave Points
- Alters the target(s) Brave Points to an exact value.
- Requires VisuMZ_2_BattleSystemBTB!

Targets:
- Select unit(s) to alter the ATB/TPB Gauges for.

Alter Brave Points By:
- Alters the target(s) Brave Points.
- Positive for gaining BP.
- Negative for losing BP.
</pre>

---

<pre>
MECH: Collapse
- Causes the unit(s) to perform its collapse animation if the unit(s)
has died.

Targets:
- Select unit(s) to process a death collapse.

Force Death:
- Force death even if the unit has not reached 0 HP?
- This will remove immortality.

Wait For Effect?:
- Wait for the collapse effect to complete before performing next command?
</pre>

---

<pre>
MECH: CTB Order
- Alters the CTB Turn Order.
- Requires VisuMZ_2_BattleSystemCTB!

Targets:
- Select unit(s) to alter the CTB Turn Order for.

Change Order By:
- Changes turn order for target(s) by this amount.
- Positive increases wait. Negative decreases wait.
</pre>

---

<pre>
MECH: CTB Speed
- Alters the CTB Speed.
- Requires VisuMZ_2_BattleSystemCTB!

Targets:
- Select unit(s) to alter the CTB Speed for.

Charge Rate:
- Changes made to the CTB Speed if it is currently charging.

Cast Rate:
- Changes made to the CTB Speed if it is currently casting.
</pre>

---

<pre>
MECH: Custom Damage Formula
- Changes the current action's damage formula to custom.
- This will assume the MANUAL damage style.

Formula:
- Changes the current action's damage formula to custom.
- Use 'default' to revert the damage formula.
</pre>

---

<pre>
MECH: Damage Popup
- Causes the unit(s) to display the current state of damage received
or healed.

Targets:
- Select unit(s) to prompt a damage popup.
</pre>

---

<pre>
MECH: Emulate Attack Effect
- Emulate an "Action Effect" but using a the user's attack skill instead of
the current action.
- Essentially lets you perform the mechanics of another action without
having to use another action or needing to pay that action's costs.

User(s):
- Select unit(s) to perform the action's effects.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Emulate Guard Effect
- Emulate an "Action Effect" but using a the user's guard skill instead of
the current action.
- Essentially lets you perform the mechanics of another action without
having to use another action or needing to pay that action's costs.

User(s):
- Select unit(s) to perform the action's effects.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Emulate Item Effect
- Emulate an "Action Effect" but using a specific item instead of the
current action.
- Essentially lets you perform the mechanics of another action without
having to use another action or needing to pay that action's costs.

Item ID:
- Which item ID will be emulated?

User(s):
- Select unit(s) to perform the action's effects.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Emulate Skill Cost
- Pick a skill for target(s) to emulate paying the cost of.
- Lets you cause characters to perform paying the costs of a specific skill
without needing to actually use them.
- This will include Skill Cooldowns and Limited Skill Uses.

Skill ID:
- Which skill ID will have its cost paid for?
- Use 0 for current action's skill.

User(s):
- Select unit(s) to perform the action's effects.
</pre>

---

<pre>
MECH: Emulate Skill Effect
- Emulate an "Action Effect" but using a specific skill instead of the
current action.
- Essentially lets you perform the mechanics of another action without
having to use another action or needing to pay that action's costs.

Skill ID:
- Which skill ID will be emulated?

User(s):
- Select unit(s) to perform the action's effects.

Targets:
- Select unit(s) to receive the current action's effects.
</pre>

---

<pre>
MECH: Enemy Escape
- Causes the enemy unit(s) to escape.

Targets:
- Select unit(s) to escape.
</pre>

---

<pre>
MECH: Dead Label Jump
- If the active battler is dead, jump to a specific label in the
common event.

Jump To Label:
- If the active battler is dead, jump to this specific label in the
common event.
</pre>

---

<pre>
MECH: ETB Energy Count
- Alters the subject team's available Energy Count.
- Requires VisuMZ_2_BattleSystemETB!

Energy Count:
- Alters the subject team's available Energy Count.
- Positive for gaining energy. Negative for losing energy.
</pre>

---

<pre>
MECH: FTB Action Count
- Alters the subject team's available Action Count.
- Requires VisuMZ_2_BattleSystemFTB!

Action Count:
- Alters the subject team's available Action Count.
- Positive for gaining actions. Negative for losing actions.
</pre>

---

<pre>
MECH: HP, MP, TP
- Alters the HP, MP, and TP values for unit(s).
- Positive values for healing. Negative values for damage.

Targets:
- Select unit(s) to receive the current action's effects.

HP, MP, TP:

Rate:
- Changes made to the parameter based on rate.
- Positive values for healing. Negative values for damage.

Flat:
- Flat changes made to the parameter.
- Positive values for healing. Negative values for damage.

Damage Popup?:
- Display a damage popup after?
</pre>

---

<pre>
MECH: Immortal
- Changes the immortal flag of targets. If immortal flag is removed and a
unit would die, collapse that unit.

Targets:
- Alter the immortal flag of these groups. If immortal flag is removed and
a unit would die, collapse that unit.

Immortal:
- Turn immortal flag for unit(s) on/off?
</pre>

---

<pre>
MECH: Multipliers
- Changes the multipliers for the current action.
- You may use JavaScript code for any of these.

Critical Hit%:

Rate:
- Affects chance to land a critical hit by this multiplier.

Flat:
- Affects chance to land a critical hit by this flat bonus.

Critical Damage

Rate:
- Affects critical damage by this multiplier.

Flat:
- Affects critical damage by this flat bonus.

Damage/Healing

Rate:
- Sets the damage/healing multiplier for current action.

Flat:
- Sets the damage/healing bonus for current action.

Hit Rate

Rate:
- Affects chance to connect attack by this multiplier.

Flat:
- Affects chance to connect attack by this flat bonus.
</pre>

---

<pre>
MECH: Once Parallel
- Plays a Common Event parallel to the battle event once without repeating
itself when done.

Common Event ID:
- The ID of the parallel Common Event to play.
- Does NOT repeat itself when finished.
- When exiting battle scene, all Once Parallels are cleared.
- Once Parallels are not retained upon reentering the scene.
- Once Parallels are not stored in memory and cannot be saved.
</pre>

---

<pre>
MECH: OTB Order
- Alters the OTB Turn Order. Best used with single targets.
- Requires VisuMZ_2_BattleSystemOTB!

Targets:
- Select unit(s) to alter the OTB Turn Order for.

Current Turn By:
- Changes turn order for target(s) by this amount.
- Positive increases wait. Negative decreases wait.

Next Turn By:
- Changes turn order for target(s) by this amount.
- Positive increases wait. Negative decreases wait.

Follow Turn By:
- Changes turn order for target(s) by this amount.
- Positive increases wait. Negative decreases wait.
</pre>

---

<pre>
MECH: PTB Alter Cost
- Alters the action's cost settings.
- Requires VisuMZ_2_BattleSystemPTB!

Override?:
- Overrides any 'permanent' settings for Changeability?

Alter Changeability:
- Allow the cost type and value to be changeable?

Alter Cost Type:
- Change the cost type to this scenario.
- Use 'Unchanged' for no changes.

Alter Cost Value:
- What is the default action cost for this scenario?
</pre>

---

<pre>
MECH: PTB Conversion
- Converts full actions into half actions.
- Requires VisuMZ_2_BattleSystemPTB!

Conversion Count:
- Converts full actions into half actions.
- If not enough, consume half actions.
</pre>

---

<pre>
MECH: PTB Full/Half Action(s)
- Alters the subject team's available Full/Half Actions.
- Requires VisuMZ_2_BattleSystemPTB!

Full Actions:
- Alters the subject team's available Full Actions.
- Positive for gaining. Negative for losing.

Half Actions:
- Alters the subject team's available Half Actions.
- Positive for gaining. Negative for losing.
</pre>

---

<pre>
MECH: Remove Buff/Debuff
- Removes buff(s)/debuff(s) from unit(s).
- Determine which parameters are removed.

Targets:
- Select unit(s) to have the buff(s) and/or debuff(s) removed.

Buff Parameters:
- Select which buffed parameter(s) to remove.

Debuff Parameters:
- Select which debuffed parameter(s) to remove.
</pre>

---

<pre>
MECH: Remove State
- Remove state(s) from unit(s).

Targets:
- Select unit(s) to have states removed from.

States:
- Select which state ID(s) to remove from unit(s).
- Insert multiple state ID's to remove multiple at once.
</pre>

---

<pre>
MECH: State Turns Change By
- Changes target(s) state turns by an amount.
- Requires VisuMZ_1_SkillsStatesCore!

Targets:
- Select unit(s) to affect state turns for.

State ID:
- What is the ID of the state you wish to change turns for?
- Only works on states that can have turns.

Change Turns By:
- How many turns should the state be changed to?
- You may use JavaScript code.

Auto-Add State?:
- Automatically adds state if actor(s) does not have it applied?
</pre>

---

<pre>
MECH: State Turns Change To
- Changes target(s) state turns to a specific value.
- Requires VisuMZ_1_SkillsStatesCore!

Targets:
- Select unit(s) to affect state turns for.

State ID:
- What is the ID of the state you wish to change turns for?
- Only works on states that can have turns.

Change Turns To:
- How many turns should the state be changed to?
- You may use JavaScript code.

Auto-Add State?:
- Automatically adds state if target(s) does not have it applied?
</pre>

---

<pre>
MECH: STB Exploit Effect
- Utilize the STB Exploitation mechanics!
- Requires VisuMZ_2_BattleSystemSTB!

Target(s) Exploited?:
- Exploit the below targets?

Targets:
- Select unit(s) to become exploited.

Force Exploitation:
- Force the exploited status?

User Exploiter?:
- Allow the user to become the exploiter?

Force Exploitation:
- Force the exploiter status?
</pre>

---

<pre>
MECH: STB Extra Action
- Adds an extra action for the currently active battler.
- Requires VisuMZ_2_BattleSystemSTB!

Extra Actions:
- How many extra actions should the active battler gain?
- You may use JavaScript code.
</pre>

---

<pre>
MECH: STB Remove Excess Actions
- Removes excess actions from the active battler.
- Requires VisuMZ_2_BattleSystemSTB!

Remove Actions:
- How many actions to remove from the active battler?
- You may use JavaScript code.
</pre>

---

<pre>
MECH: Swap Weapon
- Causes the unit(s) to swap their weapon for another.
- Requires VisuMZ_2_WeaponSwapSystem!

Targets:
- Select unit(s) to swap weapons for.

Weapon Type ID:
- Which weapon type to swap to?
- This is NOT the weapon's ID.
- It's the weapon TYPE.
</pre>

---

<pre>
MECH: Text Popup
- Causes the unit(s) to display a text popup.

Targets:
- Select unit(s) to prompt a text popup.

Text:
- What text do you wish to display?

Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Flash Color:
- Adjust the popup's flash color.
- Format: [red, green, blue, alpha]

Flash Duration:
- What is the frame duration of the flash effect?
</pre>

---

<pre>
MECH: Variable Popup
- Causes the unit(s) to display a popup using the data stored inside
a variable.

Targets:
- Select unit(s) to prompt a text popup.

Variable:
- Get data from which variable to display as a popup?

Digit Grouping:
- Use digit grouping to separate numbers?
- Requires VisuMZ_0_CoreEngine!

Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Flash Color:
- Adjust the popup's flash color.
- Format: [red, green, blue, alpha]

Flash Duration:
- What is the frame duration of the flash effect?
</pre>

---

<pre>
MECH: Wait For Effect
- Waits for the effects to complete before performing next command.
</pre>

---

=== Action Sequences - Motion ===

[[File:BattleCoreActSeqSet.gif]]

These Action Sequences allow you the ability to control the motions of
sideview sprites.

---

<pre>
MOTION: Clear Freeze Frame
- Clears any freeze frames from the unit(s).

Targets:
- Select which unit(s) to clear freeze frames for.
</pre>

---

<pre>
MOTION: Freeze Motion Frame
- Forces a freeze frame instantly at the selected motion.
- Automatically clears with a new motion.

Targets:
- Select which unit(s) to freeze motions for.

Motion Type:
- Freeze this motion for the unit(s).

Frame Index:
- Which frame do you want to freeze the motion on?
- Frame index values start at 0.

Show Weapon?:
- If using 'attack', 'thrust', 'swing', or 'missile', display the
weapon sprite?
</pre>

---

<pre>
MOTION: Motion Type
- Causes the unit(s) to play the selected motion.

Targets:
- Select which unit(s) to perform a motion.

Motion Type:
- Play this motion for the unit(s).

Show Weapon?:
- If using 'attack', 'thrust', 'swing', or 'missile', display the
weapon sprite?
</pre>

---

<pre>
MOTION: Perform Action
- Causes the unit(s) to play the proper motion based on the current action.

Targets:
- Select which unit(s) to perform a motion.
</pre>

---

<pre>
MOTION: Refresh Motion
- Cancels any set motions unit(s) has to do and use their most natural
motion at the moment.

Targets:
- Select which unit(s) to refresh their motion state.
</pre>

---

<pre>
MOTION: Wait By Motion Frame
- Creates a wait equal to the number of motion frames passing.
- Time is based on Plugin Parameters => Actors => Motion Speed.

Motion Frames to Wait?:
- Each "frame" is equal to the value found in
Plugin Parameters => Actors => Motion Speed
</pre>

---

=== Action Sequences - Movement ===

[[File:BattleCoreActSeqSet.gif]]

These Action Sequences allow you the ability to control the sprites of
actors and enemies in battle.

---

<pre>
MOVE: Battle Step
- Causes the unit(s) to move forward past their home position to prepare
for action.

Targets:
- Select which unit(s) to move.

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Change Home By Distance
- Change unit(s)'s home position by a distance from their current home
position(s).
- Sideview-only!

Targets:
- Select which unit(s) to change home position(s) for.

Distance Adjustment:
- Makes adjustments to distance values to determine which direction to
change by.
- Normal - No adjustments made
- Horizontal - Actors adjust left, Enemies adjust right
- Vertical - Actors adjust Up, Enemies adjust down
- Both - Applies both Horizontal and Vertical

Distance: X:
- Horizontal distance to move.
- You may use JavaScript code.

Distance: Y:
- Vertical distance to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total change amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Change Home To JS Coordinates
- Change home position(s) to specified JS Coordinates.
- Sideview-only! Uses JavaScript!

Targets:
- Select which unit(s) to change home position(s) for.

JS: Coordinates:
- Code used to determine the coordinates for the target(s)'s new home
position.

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total change amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Change Home To Point
- Change home position(s) to a target point on the screen.
- Sideview-only! Points based off Graphics.boxWidth/Height.

Targets:
- Select which unit(s) to change home position(s) for.

Destination Point:
- Select which point to face.
- Center
- Point X, Y
- Replace 'x' and 'y' with coordinates

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total change amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Change Home To Target(s)
- Moves unit(s) to another unit(s) on the battle field.
- Sideview-only!

Targets (Moving):
- Select which unit(s) to change home position(s) for.

Targets (Destination):
- Select which unit(s) to change home position to.

Target Location:
- Select which part target group to change home position to.
- front head
- front center
- front base
- middle head
- middle center
- middle base
- back head
- back center
- back base

Melee Distance:
- The melee distance away from the target location in addition to the
battler's width.

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total change amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Face Direction
- Causes the unit(s) to face forward or backward.
- Sideview-only!

Targets:
- Select which unit(s) to change direction.

Direction:
- Select which direction to face.
</pre>

---

<pre>
MOVE: Face JS Coordinates
- Causes the unit(s) to face specified JS Coordinates.
- Sideview-only! Uses JavaScript!

Targets:
- Select which unit(s) to change direction.

JS: Coordinates:
- Code used to determine the coordinates for the target(s) to face
towards.

Face Away From?:
- Face away from the point instead?
</pre>

---

<pre>
MOVE: Face Point
- Causes the unit(s) to face a point on the screen.
- Sideview-only!

Targets:
- Select which unit(s) to change direction.

Point:
- Select which point to face.
- Home
- Center
- Point X, Y
- Replace 'x' and 'y' with coordinates

Face Away From?:
- Face away from the point instead?
</pre>

---

<pre>
MOVE: Face Target(s)
- Causes the unit(s) to face other targets on the screen.
- Sideview-only!

Targets (facing):
- Select which unit(s) to change direction.

Targets (destination):
- Select which unit(s) for the turning unit(s) to face.

Face Away From?:
- Face away from the unit(s) instead?
</pre>

---

<pre>
MOVE: Float
- Causes the unit(s) to float above the ground.
- Sideview-only!

Targets:
- Select which unit(s) to make float.

Desired Height:
- Vertical distance to float upward.
- You may use JavaScript code.

Duration:
- Duration in frames for total float amount.

Float Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Float?:
- Wait for floating to complete before performing next command?
</pre>

---

<pre>
MOVE: Home Reset
- Causes the unit(s) to move back to their home position(s) and face back to
their original direction(s).

Targets:
- Select which unit(s) to move.

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Jump
- Causes the unit(s) to jump into the air.
- Sideview-only!

Targets:
- Select which unit(s) to make jump.

Desired Height:
- Max jump height to go above the ground
- You may use JavaScript code.

Duration:
- Duration in frames for total jump amount.

Wait For Jump?:
- Wait for jumping to complete before performing next command?
</pre>

---

<pre>
MOVE: Move Distance
- Moves unit(s) by a distance from their current position(s).
- Sideview-only!

Targets:
- Select which unit(s) to move.

Distance Adjustment:
- Makes adjustments to distance values to determine which direction to
move unit(s).
- Normal - No adjustments made
- Horizontal - Actors adjust left, Enemies adjust right
- Vertical - Actors adjust Up, Enemies adjust down
- Both - Applies both Horizontal and Vertical

Distance: X:
- Horizontal distance to move.
- You may use JavaScript code.

Distance: Y:
- Vertical distance to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total movement amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Move To JS Coordinates
- Moves unit(s) to specified JS Coordinates.
- Sideview-only! Uses JavaScript!

Targets:
- Select which unit(s) to move.

JS: Coordinates:
- Code used to determine the coordinates for the target(s) to move to.

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total movement amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Move To Point
- Moves unit(s) to a designated point on the screen.
- Sideview-only! Points based off Graphics.boxWidth/Height.

Targets:
- Select which unit(s) to move.

Destination Point:
- Select which point to face.
- Home
- Center
- Point X, Y
- Replace 'x' and 'y' with coordinates

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total movement amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Move To Target(s)
- Moves unit(s) to another unit(s) on the battle field.
- Sideview-only!

Targets (Moving):
- Select which unit(s) to move.

Targets (Destination):
- Select which unit(s) to move to.

Target Location:
- Select which part target group to move to.
- front head
- front center
- front base
- middle head
- middle center
- middle base
- back head
- back center
- back base

Melee Distance:
- The melee distance away from the target location in addition to the
battler's width.

Offset Adjustment:
- Makes adjustments to offset values to determine which direction to
adjust the destination by.

Offset: X:
- Horizontal offset to move.
- You may use JavaScript code.

Offset: Y:
- Vertical offset to move.
- You may use JavaScript code.

Duration:
- Duration in frames for total movement amount.

Face Destination?:
- Turn and face the destination?

Movement Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Movement Motion:
- Play this motion for the unit(s).

Wait For Movement?:
- Wait for movement to complete before performing next command?
</pre>

---

<pre>
MOVE: Opacity
- Causes the unit(s) to change opacity.
- Sideview-only!

Targets:
- Select which unit(s) to change opacity.

Desired Opacity:
- Change to this opacity value.
- You may use JavaScript code.

Duration:
- Duration in frames for opacity change.

Opacity Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Opacity?:
- Wait for opacity changes to complete before performing next command?
</pre>

---

[[File:ActSeqGrowShrink.gif]]

<pre>
MOVE: Scale/Grow/Shrink
- Causes the unit(s) to scale, grow, or shrink?.
- Sideview-only!

Targets:
- Select which unit(s) to change the scale of.

Scale X:
Scale Y:
- What target scale value do you want?
- 1.0 is normal size.

Duration:
- Duration in frames to scale for.

Scale Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Scale?:
- Wait for scaling to complete before performing next command?
</pre>

---

[[File:ActSeqSkew.gif]]

<pre>
MOVE: Skew/Distort
- Causes the unit(s) to skew.
- Sideview-only!

Targets:
- Select which unit(s) to skew.

Skew X:
Skew Y:
- What variance to skew?
- Use small values for the best results.

Duration:
- Duration in frames to skew for.

Skew Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Skew?:
- Wait for skew to complete before performing next command?
</pre>

---

[[File:ActSeqSpin.gif]]

<pre>
MOVE: Spin/Rotate
- Causes the unit(s) to spin.
- Sideview-only!

Targets:
- Select which unit(s) to spin.

Angle:
- How many degrees to spin?

Duration:
- Duration in frames to spin for.

Spin Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Revert Angle on Finish:
- Upon finishing the spin, revert the angle back to 0.

Wait For Spin?:
- Wait for spin to complete before performing next command?
</pre>

---

<pre>
MOVE: Wait For Float
- Waits for floating to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Jump
- Waits for jumping to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Movement
- Waits for movement to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Opacity
- Waits for opacity changes to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Scale
- Waits for scaling to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Skew
- Waits for skewing to complete before performing next command.
</pre>

---

<pre>
MOVE: Wait For Spin
- Waits for spinning to complete before performing next command.
</pre>

---

{{VisuMZ Action Sequence Projectiles Plugin Commands}}

=== Action Sequences - Skew (Camera) ===

[[File:VisuMZ_ActSeqCamera_Skew.gif]]

These action sequences allow you to have control over the camera skew.
Requires VisuMZ_3_ActSeqCamera!

---

<pre>
SKEW: Change Skew
- Changes the camera skew.
- Requires VisuMZ_3_ActSeqCamera!

Skew X:
- Change the camera skew X to this value.

Skew Y:
- Change the camera skew Y to this value.

Duration:
- Duration in frames to change camera skew.

Skew Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Skew?:
- Wait for skew changes to complete before performing next command?
</pre>

---

<pre>
SKEW: Reset Skew
- Reset any skew settings.
- Requires VisuMZ_3_ActSeqCamera!

Duration:
- Duration in frames to reset camera skew.

Skew Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Skew?:
- Wait for skew changes to complete before performing next command?
</pre>

---

<pre>
SKEW: Wait For Skew
- Waits for skew changes to complete before performing next command.
- Requires VisuMZ_3_ActSeqCamera!
</pre>

---

=== Action Sequences - Target ===

[[File:BattleCoreTargetActSeq.png]]

If using a manual target by target Action Sequence, these commands will give
you full control over its usage.

Refer to the image above for reference on how this works.

---

<pre>
TARGET: Current Index
- Sets the current index to this value.
- Then decide to jump to a label (optional).

Set Index To:
- Sets current targeting index to this value.
- 0 is the starting index of a target group.

Jump To Label:
- If a target is found after the index change, jump to this label in the
Common Event.
</pre>

---

<pre>
TARGET: Next Target
- Moves index forward by 1 to select a new current target.
- Then decide to jump to a label (optional).

Jump To Label:
- If a target is found after the index change, jump to this label in the
Common Event.
</pre>

---

<pre>
TARGET: Previous Target
- Moves index backward by 1 to select a new current target.
- Then decide to jump to a label (optional).

Jump To Label:
- If a target is found after the index change, jump to this label in the
Common Event.
</pre>

---

<pre>
TARGET: Random Target
- Sets index randomly to determine new currernt target.
- Then decide to jump to a label (optional).

Force Random?:
- Index cannot be its previous index amount after random.

Jump To Label:
- If a target is found after the index change, jump to this label in the
Common Event.
</pre>

---

=== Action Sequences - Voice ===

[[File:VisuMZ.131.jpg|600px]]

---

<pre>
VOICE: Common Line
- Plays a common voice line from target battler(s).
- Requires VisuMZ_3_BattleVoices!

Speaker Target(s):
- Select unit(s) to play voice lines from.

Voice Line:
- What voice line do you wish to play?
</pre>

---

<pre>
VOICE: Play Special Line
- Plays a special voice line from target battler(s).
- Requires VisuMZ_3_BattleVoices!

Speaker Target(s):
- Select unit(s) to play voice lines from.

Voice Line Type:
- What voice line type do you wish to play?
- Action Name
- Chant Line
- Item Name
- Skill Name
- Spell Name
- Unique Lines

Name / Letter:
- What voice letter/name do you want to play?
</pre>

---

=== Action Sequences - Weapon ===

[[File:BattleCore_DualWield.gif]]

Allows for finer control over Dual/Multi Wielding actors.

Only works for Actors.

---

<pre>
WEAPON: Clear Weapon Slot
- Clears the active weapon slot (making others valid again).
- Only works for Actors.

Targets:
- Select unit(s) to clear the active weapon slot for.
</pre>

---

<pre>
WEAPON: Next Weapon Slot
- Goes to next active weapon slot (making others invalid).
- If next slot is weaponless, don't label jump.

Targets:
- Select unit(s) to change the next active weapon slot for.
</pre>

---

<pre>
WEAPON: Set Weapon Slot
- Sets the active weapon slot (making others invalid).
- Only works for Actors.

Targets:
- Select unit(s) to change the active weapon slot for.

Weapon Slot ID:
- Select weapon slot to make active (making others invalid).
- Use 0 to clear and normalize. You may use JavaScript code.
</pre>

---

==== Dual Wield Action Sequence Example ====

Here is an example of how to set up a dual-wield action sequence, whiled
also checking the trait objects to make sure that no other weapons are
being involved:

◆Plugin Command：VisuMZ_1_BattleCore, ACSET: Setup Action Set
：：Display Action = true
：：Immortal: On = true
：：Battle Step = true
：：Wait For Movement = true
：：Cast Animation = true
：：Wait For Animation = true

◆Script：console.log('---Before Switching---')
：：let user = BattleManager._subject;
：：let result = user.traitObjects()
：： .filter(obj => DataManager.isWeapon(obj))
：： .map(obj => obj.id);
：：console.log('Weapon IDs', result);

◆Plugin Command：VisuMZ_1_BattleCore, WEAPON: Set Weapon Slot
：：Targets = ["user"]
：：Weapon Slot ID = 1

◆Label：AttackLoop

◆Script：console.log('---Slot Check---')
：：let user = BattleManager._subject;
：：let result = user.traitObjects()
：： .filter(obj => DataManager.isWeapon(obj))
：： .map(obj => obj.id);
：：console.log('Weapon IDs', result);

◆Plugin Command：VisuMZ_1_BattleCore, ACSET: All Targets Action Set
：：Dual/Multi Wield? = false
：：Perform Action = true
：：Wait Count = Sprite_Battler._motionSpeed
：：Action Animation = true
：：Wait For Animation = true
：：Action Effect = true
：：Immortal: Off = true

◆Plugin Command：VisuMZ_1_BattleCore, WEAPON: Next Weapon Slot
：：Targets = ["user"]
：：Jump To Label = AttackLoop

◆Label：LoopFinished

◆Plugin Command：VisuMZ_1_BattleCore, WEAPON: Clear Weapon Slot
：：Targets = ["user"]

◆Script：console.log('---Slots Cleared---')
：：let user = BattleManager._subject;
：：let result = user.traitObjects()
：： .filter(obj => DataManager.isWeapon(obj))
：： .map(obj => obj.id);
：：console.log('Weapon IDs', result);

◆Plugin Command：VisuMZ_1_BattleCore, ACSET: Finish Action
：：Immortal: Off = true
：：Wait For New Line = true
：：Wait For Effects = true
：：Clear Battle Log = true
：：Home Reset = true
：：Wait For Movement = true

If you want to make sure the weapon slots are only using those specific
weapons, include the console.log() script calls above. Otherwise, those
can be removed. They're only used as proof of weapon separation that can be
seen inside the game's Dev Tools window (press F8 to open Dev Tools, then
click "Console" for the console logs).

---

=== Action Sequences - Zoom (Camera) ===

[[File:VisuMZ_ActSeqCamera_Zoom.gif]]

These Action Sequences are zoom-related.
Requires VisuMZ_3_ActSeqCamera!

---

<pre>
ZOOM: Change Scale
- Changes the zoom scale.
- Requires VisuMZ_3_ActSeqCamera!

Scale:
- The zoom scale to change to.

Duration:
- Duration in frames to reset battle zoom.

Zoom Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Zoom?
- Wait for zoom changes to complete before performing next command?
</pre>

---

<pre>
ZOOM: Reset Zoom
- Reset any zoom settings.
- Requires VisuMZ_3_ActSeqCamera!

Duration:
- Duration in frames to reset battle zoom.

Zoom Easing:
- Select which easing type you wish to apply.
- Requires VisuMZ_0_CoreEngine.

Wait For Zoom?
- Wait for zoom changes to complete before performing next command?
</pre>

---

<pre>
ZOOM: Wait For Zoom
- Waits for zoom changes to complete before performing next command.
Requires VisuMZ_3_ActSeqCamera!
</pre>

---

Template:VisuMZ Visual Parallaxes Plugin Commands

2026-04-19T11:43:02Z

Irina:

<noinclude>[[Category:Display templates|VisuMZ Visual Parallaxes Plugin Commands]]</noinclude>
The following are Plugin Commands that come with this plugin. They can be
accessed through the Plugin Command event command.

---

=== Parallax Plugin Commands ===

[[File:VisualParallaxes_Preview1.gif]]

[[File:VisualParallaxes_Command1.png]]

---

<pre>
Parallax: Add/Change Settings
- Add/Change settings for target parallax.
- Does not alter the map editor's parallax.
- This is temporary and will be reset upon re-entering the map.

Required:

ID:
- What is the ID of this parallax to be added/changed?

Filename:
- What is the filename of the parallax?

Type:
- What kind of parallax is this going to be?
- Normal
- Water
- Solid

Optional Settings:

Scrolling:

Map Lock?:
- Lock the parallax to the map's scrolling?
- Automatically enable if the filename starts with "!"

Loop Horizontally?:
- Loop the parallax horizontally?
- Does not work with Map Lock enabled.

Scroll:
- What is the horizontal scroll speed?
- Use a negative value to invert the direction.

Loop Vertically?:
- Loop the parallax vertically?
- Does not work with Map Lock enabled.

Scroll:
- What is the vertical scroll speed?
- Use a negative value to invert the direction.

Appearance:

Opacity:
- What is the opacity level for this parallax?
- You may use JavaScript code.

Blend Mode:
- What kind of blend mode do you wish to apply to the parallax?
- You may use JavaScript code.
- Normal
- Additive
- Multiply
- Screen

Hue:
- Do you wish to adjust this parallax's hue?
- You may use JavaScript code.

Hue Shift:
- How much do you want the hue to shift each frame?
- You may use JavaScript code.

Color Tone:
- What tone do you want for the parallax?
- Format: [Red, Green, Blue, Gray]

Location:

Regions:
- Which regions will show this parallax?
- Does not work with 0. Leave empty to ignore.

Terrain Tags:
- Which terrain tags will show this parallax?
- Does not work with 0. Leave empty to ignore.
</pre>

---

[[File:VisualParallaxes_Command2.png]]

<pre>
Parallax: Fade Opacity
- Fades the target parallax(es) opacity to a different value.
- This is temporary and will be reset upon re-entering the map.

ID(s):
- Target which parallax(es)?
- Cannot target the map editor's parallax.

Target Opacity:
- What opacity level to this value (0-255).
- You may use JavaScript code to determine the value.

Duration:
- How many frames should this change take?
- You may use JavaScript code to determine the value.
</pre>

---

[[File:VisualParallaxes_Command3.png]]

<pre>
Parallax: Remove
- Removes target parallax(es).
- This is temporary and will be reset upon re-entering the map.

ID(s):
- Remove which parallax(es)?
- Cannot remove the map editor's parallax.
</pre>

---

Template:VisuMZ Visual Fogs Plugin Commands

2026-04-19T11:42:45Z

Irina:

<noinclude>[[Category:Display templates|VisuMZ Visual Fogs Plugin Commands]]</noinclude>
The following are Plugin Commands that come with this plugin. They can be
accessed through the Plugin Command event command.

---

=== Fog Plugin Commands ===

---

[[File:VisualFogs_Preview1.gif]]

[[File:VisualFogs_Command1.png]]

<pre>
Fog: Add/Change Settings
- Add/Change settings for target fog.
- Does not alter the map editor's fog.
- This is temporary and will be reset upon re-entering the map.

Required:

ID:
- What is the ID of this fog to be added/changed?

Filename:
- What is the filename of the fog?

Optional Settings:

Scrolling:

Map Lock?:
- Lock the fog to the map's scrolling?
- Automatically enable if the filename starts with "!"

Loop Horizontally?:
- Loop the fog horizontally?
- Does not work with Map Lock enabled.

Scroll:
- What is the horizontal scroll speed?
- Use a negative value to invert the direction.

Loop Vertically?:
- Loop the fog vertically?
- Does not work with Map Lock enabled.

Scroll:
- What is the vertical scroll speed?
- Use a negative value to invert the direction.

Appearance:

Opacity:
- What is the opacity level for this fog?
- You may use JavaScript code.

Blend Mode:
- What kind of blend mode do you wish to apply to the fog?
- You may use JavaScript code.
- Normal
- Additive
- Multiply
- Screen

Hue:
- Do you wish to adjust this fog's hue?
- You may use JavaScript code.

Hue Shift:
- How much do you want the hue to shift each frame?
- You may use JavaScript code.

Color Tone:
- What tone do you want for the fog?
- Format: [Red, Green, Blue, Gray]

Location:

Regions:
- Which regions will show this fog?
- Does not work with 0. Leave empty to ignore.

Terrain Tags:
- Which terrain tags will show this fog?
- Does not work with 0. Leave empty to ignore.

Tile Blur:
- What's the blur level you wish to use for tiles?
- You may use JavaScript code.

Tile Spill:
- What's the spill amount you wish to use for tiles?
- You may use JavaScript code.

Vignette:

Type:
- What vignette do you want to use for this fog?
- This will override location settings.

Custom:
- Do you wish to use a custom vignette instead?
- Automatically changes the type to "Custom".
</pre>

---

[[File:VisualFogs_Preview3.gif]]

[[File:VisualFogs_Command2.png]]

<pre>
Fog: Fade Opacity
- Fades the target fog(s) opacity to a different value.
- This is temporary and will be reset upon re-entering the map.

ID(s):
- Target which fog(s)?
- Cannot target the map editor's fog.

Target Opacity:
- What opacity level to this value (0-255).
- You may use JavaScript code to determine the value.

Duration:
- How many frames should this change take?
- You may use JavaScript code to determine the value.
</pre>

---

[[File:VisualFogs_Command3.png]]

<pre>
Fog: Remove
- Removes target fog(s).
- This is temporary and will be reset upon re-entering the map.

ID(s):
- Remove which fog(s)?
- Cannot remove the map editor's fog.
</pre>

---

Visual Parallaxes VisuStella MZ

2026-04-19T11:41:52Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=1Nz2HKDH3Po</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/908945" width="552" height="167"><a href="https://visustellamz.itch.io/visual-parallaxes">Visual Parallaxes plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 7}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:VisualParallaxes_Preview1.gif]]

[[File:VisualParallaxes_Preview2.gif]]

[[File:VisualParallaxes_Preview3.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{Visustella MZ}}

== Introduction ==

[[File:VisualParallaxes_Preview1.gif]]

By default, RPG Maker MZ only allows each map to have one parallax. Such a
limit makes it difficult to create different layers of objects to portray
distance and the like. This plugin will remedy that by allowing you to add
an unlimited amount of parallaxes per map alongside many controls to make
the parallaxes more vivid.

A restricted parallax area system is also added to this plugin to make
parallaxes appear only within certain regions and/or terrain tags. This way,
you can utilize parallaxes as masked layers for water surfaces and the like.

To make the most out of this, with the tilesets are formatted properly,
reflective water and reflective solid surfaces are also new effects added
through this plugin. Water effects will show ripples while reflective solid
surfaces are static.

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

* Add, change, and/or remove parallaxes through map notetags.
* Lots of customization options for each of the parallaxes.
* Limit where parallaxes can be displayed on the map through regions and/or terrain tags.
* Create reflective surfaces for water and solid ground as long as the tilesets have been formatted properly.
* Use Plugin Commands midway through the game to add, change, fade, and/or remove parallaxes as needed.

== Requirements ==

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

=== Recommended Plugin List ===

* Pixi JS Filters*

This plugin recommends the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You can use this plugin without
it, but there will be features missing.

*Note* You can download the Pixi JS Filters plugin library from the below
URL or from the Action Sequence Impact product page. Install it as a
Tier 0 plugin.

*Note2* Pixi JS Filters perform differently on different machines/devices.
Please understand that this is outside of VisuStella's control.

URL: [https://filters.pixijs.download/v3.1.0/pixi-filters.js]

{{MZ Tier 4}}

== Major Changes ==

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

---

=== Parallaxes ===

[[File:VisualParallaxes_Preview1.gif]]

The map editor's inherent parallax will remain untouched and unable to
utilize the extra features provided by this plugin. However, you can just
simply create a new parallax layer over it and hide it from view if needed.

Each of the parallaxes added through this plugin's notetags and/or commands
are assigned an ID. Referring back to the ID later will allow you to update
and/or remove that parallax when needed.

The new parallaxes are created on a separate layer from the map editor's
parallax and isn't included with the new parallaxes. Layers with higher ID's
will appear above layers with lower ID's.

However, other than that, all of the new parallaxes follow the same rules as
the map editor's parallax. This means that they will not appear above the
tile map and require transparent tiles to be seen. They will also scroll the
same way the original parallax does to provide consistency.

---

=== Regions and Terrain Tags ===

[[File:VisualParallaxes_Preview3.gif]]

If you don't want a parallax to appear for the whole entire background and
want to confine them to certain areas of the map, you can assign regions or
terrain tags for them to appear in.

Only the parts of the map marked by the designated regions and/or terrain
tags will reveal the parallax. Those parts will be little squares each,
equal to the size of a tile. They have hard borders and do not have any
smoothing options in order to display the parallax tiles accurately.

Each parallax layer can have their own custom regions and/or terrain tags to
appear in. These can be adjusted through the notetag settings or through the
Plugin Commands provided by this plugin. Parallax layers can be limited to
multiple regions and/or terrain tags at the same time.

'''WARNING:''' This will cause longer load times on larger maps and affect their
performance. We highly recommend that you don't use this feature on maps
larger than 120 tiles wide or tall. However, this value can vary from device
to device.

---

=== Reflections ===

[[File:VisualParallaxes_Preview2.gif]]

In order to use reflections, you need to use tiles that are semi-transparent
or fully transparent. For example, water reflections need to come from tiles
that have been modified to be semi-transparent or fully transparent. If the
tile is completely opaque, the reflection will not show through. This rule
also applies to ground surfaces.

'''NOTE:''' This effect does not work on looping maps.

By default, water-based reflections are assigned the Terrain Tag 1 and solid
ground reflections are assigned the Terrain Tag 2. In order to make water
tiles show water reflections, you need to mark their tiles in the database's
tilesets with 1's. To mark reflective ground surfaces, mark them with 2's.
If the tiles are not tagged properly, the reflections will not be shown.

In the Plugin Parameters and notetags, you can decide if the reflections
will appear above the parallaxes or below them. By default, they will appear
above them. However, if you change them to appear below the parallaxes, then
pay attention to the opacity level of the parallaxes. If the parallaxes are
too opaque, you will barely see the reflection.

Once again, both water and ground tiles need to be semi-transparent or fully
transparent in order for reflections to be seen.

'''WARNING:''' This will cause longer load times on larger maps and affect their
performance. We highly recommend that you don't use this feature on maps
larger than 120 tiles wide or tall. However, this value can vary from device
to device.

---

=== Not For Battle ===

For clarification, the VisuStella MZ Visual Parallaxes plugin is NOT made
for battle. There's a separate plugin for that called [[Visual Battle Environment VisuStella MZ|Visual Battle Environment]].
The reason why parallaxes aren't made for battle is because the
way parallaxes are handled in map vary from how they would be handled in
battle. Using the Visual Parallax Plugin Commands will only alter the
parallax appearances when the player finishes battle.

---

== Extra Features ==

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

---

=== Pixi JS Filters ===

If the game project has Pixi JS Filters installed, then water reflections
will have a ripple effect. This is based off the Pixi JS ReflectionFilter
and will follow their rules. There are a couple of settings that can be
adjusted to customize the reflective properties.

Boundary: Vertical position of the reflection point, default is 50% (middle)
smaller numbers produce a larger reflection, larger numbers produce a
smaller reflection. This also means that reflections closer to the edges
will also have a different visual ripple effect than those towards the
middle of the reflection.

Amplitude: Starting and ending amplitude of waves allows you to control the
intensity of the reflection ripples. Use larger numbers for more intensity.
You have control over the values for the start and end values.

Wavelength: Starting and ending wavelength values determine the size of the
ripples for the reflection filter. Use larger numbers for larger wave sizes.
You have control over the values for the start and end values.

---

{{Notetags MZ}}

{{VisuMZ Visual Parallaxes Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Visual Parallaxes Plugin Commands}}

== Plugin Parameters ==

=== Water Reflection Settings ===

[[File:VisualParallaxes_Preview2.gif]]

[[File:VisualParallaxes_Param1.png]]

These are the default settings for water-based reflections.

---

Markers

Regions:
- By default, which regions by default apply this reflection?
- 0 is ignored.

Terrain Tags:
- By default, which terrain tags by default apply this reflection?
- 0 is ignored.

---

Positioning

Above Parallaxes?:
- Place water reflections above visual parallaxes?

---

Appearance

Blur Rate:
- How much do you wish to blur this reflection?
- Use a decimal number between 0 and 1.

Opacity:
- What is the default opacity for this reflection?
- Use a value between 0 and 255.

Water Boundary:
- At which point is the water boundary?
- Use a decimal number between 0 and 1.

Amplitude Start:
- What should be the starting amplitude value?

Amplitude End:
- What should be the ending amplitude value?

Wavelength Start:
- What should be the starting wavelength value?

Wavelength End:
- What should be the ending wavelength value?

---

=== Solid Reflection Settings ===

[[File:VisualParallaxes_Preview3.gif]]

[[File:VisualParallaxes_Param2.png]]

These are the default settings for solid ground reflections.

---

Markers

Regions:
- By default, which regions by default apply this reflection?
- 0 is ignored.

Terrain Tags:
- By default, which terrain tags by default apply this reflection?
- 0 is ignored.

---

Positioning

Above Parallaxes?:
- Place water reflections above visual parallaxes?

---

Appearance

Blur Rate:
- How much do you wish to blur this reflection?
- Use a decimal number between 0 and 1.

Opacity:
- What is the default opacity for this reflection?
- Use a value between 0 and 255.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.14: April 20, 2026
* Bug Fixes!
** Fixed a bug where making editor changes to the current map a parallax has been placed through plugin command will cause it all to be erased and reset. Fix made by Arisu.
* Documentation Update!
** Added an extra note to Parallax: Add/Change Settings.
** Added an extra note to Parallax: Fade Opacity.
** Added an extra note to Parallax: Remove.
*** This is temporary and will be reset upon re-entering the map.

Version 1.13: November 14, 2024
* Compatibility Update!
** Added reflection compatibility with spawned events.

Version 1.12: July 18, 2024
* Optimization Update!
** Plugin should run more optimized.
** Uses a better algorithm to determine terrain tags.

Version 1.11: April 18, 2024
* Bug Fixes!
** Fixed a bug where having a '!' at the start of a parallax file's name did not automatically incur map lock when done from plugin commands. Fix made by Arisu.

Version 1.10: November 16, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.09: August 17, 2023
* Bug Fixes!
** Fixed an error that would cause a crash upon using the "Return to Title Screen" event command with the "Event Title Screen" plugin installed. Fix made by Irina.

Version 1.08: May 18, 2023
* Bug Fixes!
** Reflections should now work properly with VisuMZ_1_EventsMoveCore's latest version. Fix made by Arisu.

Version 1.07: August 4, 2022
* Compatibility Update!
** Map Locked parallaxes now work better with smooth scroll.

Version 1.06: July 7, 2022
* Feature Update!
** Blend modes are now revamped for the parallaxes to behave more like they do for pictures for better accuracy. Update made by Irina.

Version 1.05: January 27, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.04: January 6, 2022
* Compatibility Update
** Added compatibility functionality for future plugins.
* Optimization Update!
** Plugin should run more optimized.

Version 1.03: December 9, 2021
* Documentation Update!
** Added section to "Major Changes" for clarification purposes:
*** Not For Battle
*** For clarification, the VisuStella MZ Visual Parallxes plugin is NOT made for battle. There's a separate plugin for that called Visual Battle Environment. The reason why parallaxes aren't made for battle is because the way parallaxes are handled in map vary from how they would be handled in battle. Using the Visual Parallaxes Plugin Commands will only alter the parallax appearances when the player finishes battle.
* Feature Update!
** Added fail safes to prevent Plugin Command usage during battle to cause problems while inside battle test. Update made by Irina.

Version 1.02: June 25, 2021
* Compatibility Update
** Added compatibility functionality for Event Title Scene.

Version 1.01: May 28, 2021
* Feature Update!
** Fail safe added for those without Pixi JS Filters added.
** Removed the VisuStella MZ Core Engine requirement.
* Optimization Update!
** Plugin should run more optimized.

Version 1.00 Official Release Date: March 12, 2021
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 7]]

== End of File ==

|}









[[Category: RPG Maker MZ Movement Plugins]]


[[Category: RPG Maker MZ Eventing Plugins]]


[[Category: RPG Maker MZ Visual Plugins]]

Visual Fogs VisuStella MZ

2026-04-19T11:41:42Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=17gdTl1-PzQ</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/908939" width="552" height="167"><a href="https://visustellamz.itch.io/visual-fogs">Visual Fogs plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 7}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:VisualFogs_Preview1.gif]]

[[File:VisualFogs_Preview2.gif]]

[[File:VisualFogs_Preview3.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{Visustella MZ}}

== Introduction ==

[[File:VisualFogs_Preview1.gif]]

Fogs are a handy feature long removed from RPG Maker since RPG Maker XP.
This plugin reintroduces them back into RPG Maker MZ. Fogs function similar
to parallaxes, except rather than being under the tile map, fogs appear
above the tile map and the characters. This plugin gives you an unlimited
amount of fogs to apply to each map alongside many controls to make the fogs
appear more vivid.

A restricted fog area system is also added to this plugin to make fogs
appear only within certain regions and/or terrain tags. This way, you can
utilize parallaxes as masked layers for obscured sections of the map.

Sometimes, fogs may be too intrusive to the player's visibility. A vignette
feature has been added to make fogs appear only on the borders or certain
sides of the screen. This way, fogs can still add to the atmosphere without
obscuring too much of the visible screen.

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

* Add, change, and/or remove fogs through map notetags.
* Lots of customization options for each of the fogs.
* Limit where fogs can be displayed on the map through regions and/or terrain tags to obscure parts of the map.
* Use vignettes to obscure sides of the screen without affecting the center.
* Use Plugin Commands midway through the game to add, change, fade, and/or remove fogs as needed.

== Requirements ==

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

{{MZ Tier 4}}

== Major Changes ==

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

---

=== Fogs ===

[[File:VisualFogs_Preview1.gif]]

Fogs are not an inherent feature for the map editor. They need to be added
through map notetags or Plugin Commands.

Each of the fogs added through this plugin's notetags and/or commands are
assigned an ID. Referring back to the ID later will allow you to update
and/or remove that fog when needed.

When fogs are created, they appear above the tile map and characters, but
below the weather. This means they are created between the two layers when
the map's sprites are generated.

Fogs will behave very similar to parallaxes in how they move about the
screen. This means that if a fog is set to looping, it will loop in
accordance to the screen's display coordinates. This is to maintain
consistency with how the RPG Maker MZ engine behaves.

---

=== Regions and Terrain Tags ===

[[File:VisualFogs_Preview3.gif]]

If you don't want a fog to appear for the whole entire foreground and want
to confine them to certain areas of the map, you can assign regions or
terrain tags for them to appear in.

<pre>
NOTE: This effect does not work on looping maps.
</pre>

Only the parts of the map marked by the designated regions and/or terrain
tags will reveal the fog. Those parts will be little squares each,
equal to the size of a tile. They have soft borders due to blurring options.
The foggy tiles will be slightly larger than normal due to spill values.

You may notice that some tiles don't blur well when they are towards the
right and bottom sides of the screen when the blur values are higher than
normal. This is a known issue with Pixi JS's filters and there's not much
the VisuStella team can do about it. Instead, what we recommend is that you
use a fog vignette on an upper layer to mask the bleeding issue.

Each fog layer can have their own custom regions and/or terrain tags to
appear in. These can be adjusted through the notetag settings or through the
Plugin Commands provided by this plugin. Fog layers can be limited to
multiple regions and/or terrain tags at the same time.

WARNING: This will cause longer load times on larger maps and affect their
performance. We highly recommend that you don't use this feature on maps
larger than 120 tiles wide or tall. However, this value can vary from device
to device.

---

=== Vignettes ===

[[File:VisualFogs_Preview2.gif]]

If you don't want fogs to obscure the whole screen, use a vignette to make
them appear only at the sides of the screen. You can use custom vignette
masks or rendered ones provided by this plugin.

If you decide to make a custom vignette mask, create them similar to regular
image masks. This means that white areas of the masking image will be the
parts of the screen where the fog appears while the black areas of the image
will hide the fog. You can use gradients to make the vignette mask appear
more smooth.

Vignettes cannot be used with region and terrain tags. This is because the
region and terrain tag tiles move alongside the screen while vignettes are
always locked onto the borders of the screen. However, if you wish to use
both, just apply two different fog layers instead.

---

=== Not For Battle ===

For clarification, the VisuStella MZ Visual Fogs plugin is NOT made for
battle. There's a separate plugin for that called [[Visual Battle Environment VisuStella MZ|Visual Battle Environment]].
The reason why fogs aren't made for battle is because the way fogs are
handled in map vary from how they would be handled in battle. Using the
Visual Fogs Plugin Commands will only alter the fog appearances when the
player finishes battle.

---

{{Notetags MZ}}

{{VisuMZ Visual Fogs Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Visual Fogs Plugin Commands}}

== Plugin Parameters ==

=== Default Settings ===

[[File:VisualFogs_Preview1.gif]]

[[File:VisualFogs_Param1.png]]

The below are the default settings when it comes to creating fogs through
map notetags.

---

Defaults

Fog Opacity:
- What is the default fog opacity level for map notetags?

Blend Mode:
- What is the default fog blend mode for map notetags?
- Normal
- Additive
- Multiply
- Screen

Tile Blur:
- What is the default fog tile blur intensity for map notetags?

Tile Spill:
- What is the default fog tile spill amount for map notetags?

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.13: April 20, 2026
* Bug Fixes!
** Fixed a bug where making editor changes to the current map a fog has been placed through plugin command will cause it all to be erased and reset. Fix made by Arisu.
* Documentation Update!
** Added an extra note to Fog: Add/Change Settings.
** Added an extra note to Fog: Fade Opacity.
** Added an extra note to Fog: Remove.
*** This is temporary and will be reset upon re-entering the map.

Version 1.12: July 18, 2024
* Optimization Update!
** Plugin should run more optimized.
** Uses a better algorithm to determine terrain tags.

Version 1.11: April 18, 2024
* Bug Fixes!
** Fixed a bug where having a '!' at the start of a fog graphic file's name did not automatically incur map lock when done from plugin commands. Fix made by Arisu.

Version 1.10: November 16, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.09: August 17, 2023
* Bug Fixes!
** Fixed an error that would cause a crash upon using the "Return to Title Screen" event command with the "Event Title Screen" plugin installed. Fix made by Irina.

Version 1.08: June 15, 2023
* Bug Fixes!
** Fixes a visual bug involving the borders with the zoom animation upon entering a random encounter. Fix made by Arisu.

Version 1.07: August 4, 2022
* Compatibility Update!
** Vignettes now work better with zoom.

Version 1.06: July 7, 2022
* Feature Update!
** Blend modes are now revamped for the fogs to behave more like they do for pictures for better accuracy. Update made by Irina.

Version 1.05: December 9, 2021
* Documentation Update!
** Added section to "Major Changes" for clarification purposes:
*** Not For Battle
*** For clarification, the VisuStella MZ Visual Fogs plugin is NOT made for battle. There's a separate plugin for that called Visual Battle Environment. The reason why fogs aren't made for battle is because the way fogs are handled in map vary from how they would be handled in battle. Using the Visual Fogs Plugin Commands will only alter the fog appearances when the player finishes battle.
* Feature Update!
** Added fail safes to prevent Plugin Command usage during battle to cause problems while inside battle test. Update made by Irina.

Version 1.04: June 25, 2021
* Compatibility Update
** Added compatibility functionality for Event Title Scene.

Version 1.03: May 28, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.02: May 21, 2021
* Documentation Update!
** Added a clause we forgot to mention that region-locked fog effects only work on maps with no looping. A note will be added to the "Regions and Terrain Tags" and notetag sections. We apologize for any inconveniences this may cause.

Version 1.01: May 7, 2021
* Bug Fixes!
** Cached vignettes will no longer be cleared from memory. Fix by Irina.

Version 1.00 Official Release Date: March 5, 2021
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 7]]

== End of File ==

|}









[[Category: RPG Maker MZ Movement Plugins]]


[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]

[[Category: RPG Maker MZ Visual Plugins]]


[[Category: RPG Maker MZ Quality of Life Plugins]]

Message Keywords VisuStella MZ

2026-04-19T11:41:31Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=ij6WoEwqnzU</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/1270212" width="552" height="167"><a href="https://visustellamz.itch.io/message-keywords">Message Keywords plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Visual Novel Vol 2}}

}}



[[File:MessageKeywords_Preview.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Message Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:MessageKeywords_Preview.gif]]

This plugin adds Keyword support for the Message Window and any others
listed in the Plugin Parameters. By having Keyword support, the player can
hover their mouse cursor over the Keyword and a tooltip window will appear,
explaining further about the Keyword in question. This can be used in the
Message Window to explain lore, in the Help Window to go into detail about
more complex mechanics, and more!

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

* Setup Keywords within the Plugin Parameters.
* Keywords determine how the Keyword marker will be replaced and what kind of text will be displayed in the tooltip window.
* Use Keywords to explain or remind the player about lore heavy topics.
* Keywords can be used to explain indepth mechanics inside Help Window.
* Alter the tooltip window's settings to your liking.

== Requirements ==

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

=== Required Plugin List ===

* [[Message Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 3}}

== Instructions ==

[[File:MessageKeywords_Preview.gif]]

Here are the instructions on how to use this plugin.

---

[[File:MessageKeywords_Params1a.png]]

<pre>
Step 1:

- Open up the Plugin Parameters for this plugin.
- Open up the "Keyword List" Parameter list.
- Add your own or modify existing Keywords.
- The "Keyword" is the Keyword Marker that will be referenced when using a
Keyword inside of the Message Window or Help Window. Remember this.
- The "Replacement Text" is the text that appears in place of the Keyword
Marker. This can be used to color code or as a shortcut for Keywords.
- Replacement text does not have to be exactly the same as the Keyword.
- "Tooltip Text" is the text that appears inside the tooltip window when
the player's mouse cursor hovers over the Keyword.
- Save your changes.
</pre>

---

[[File:MessageKeywords_Example2.png]]

<pre>
Step 2:

- Create a new "Show Message" event command or modify a database object's
help "Description".
- Insert the Keyword Marker in the following format: ((Keyword))
- Replace "Keyword" with the Keyword Marker mentioned in Step 1.
- To use the default examples, you can type in ((Example)) or ((Ojima)).
- Save the changes.
- Go view them in game.
- Hover the mouse cursor over the specific Keywords and a tooltip window
should appear.
</pre>

---

Tooltip window text does not support Word Wrap. It is simply disabled from
the very start so any Word Wrap text codes will not work with it.

---

== Extra Features ==

[[File:MessageKeywords_Preview.gif]]

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

---

=== [[Elements and Status Menu Core VisuStella MZ]] ===

=== [[Items and Equips Core VisuStella MZ]] ===

=== [[Quest Journal System VisuStella MZ]] ===

=== [[Message Log VisuStella MZ]] ===

=== [[Visual Text Window VisuStella MZ]] ===

Custom windows provided by these plugins will have Keyword support as long
as their respective window names are listed in the Plugin Parameters.

---

{{Text Codes MZ}}

{{VisuMZ Message Keywords Text Codes}}

== Plugin Parameters ==

=== Keyword List ===

[[File:MessageKeywords_Params1.png]]

[[File:MessageKeywords_Params1a.png]]

This array governs the Keywords that are used for the game.

---

Keyword List

Keyword Marker:
- This is the marker used to determine the tooltip and any associated text
- To use this inside the Message Window or Help Description, type out the
following:

((Keyword))

Where "Keyword" would be the Keyword Marker used. Case does not matter.

Replacement Text:
- The text displayed as a replacement for the tooltip.
- You may use text codes.

Tooltip Text:
- The text displayed for this tooltip.
- You may use text codes.

Cascades:
- Used only for Window_Help Cascades.
- Displays these additional keywords.

Cascade Family:
- What is the name of this cascade family?
- Same families won't have multiple cascades.
- ie. Multiple cascades in the "Heal" cascade will won't display others.
- If no family is used, its keyword will be its family name.

---

=== Tooltip Settings ===

[[File:MessageKeywords_Preview.gif]]

[[File:MessageKeywords_Params2.png]]

Settings for the Message Keyword Tooltips Window.

---

Appearance

Scale:
- What scale size do you want for the tooltip?
- Use 1.0 for normal size.

Skin Filename:
- What window skin do you want to use for the tooltip?

Skin Opacity:
- What opacity setting is used for the tooltip?
- Use a number between 0 and 255.

---

Offset

Offset X:
- Offset the tooltip X position from the mouse?
- Negative: left. Positive: right.

Offset Y:
- Offset the tooltip Y position from the mouse?
- Negative: up. Positive: down.

---

Help Window Cascade

[[File:MessageKeywords_Cascades.png|600px]]

Cascading tooltips will show all of the available keywords found in the
help window and list them off to the side to show off each tooltip at once.
This allows players to read keyword definitions without needing to utilize
touch inputs.

'''WARNING''': The more keywords you use per help description, the more
windows will appear on the screen. You need to keep this in mind as you
design your help description keywords as to not clutter the screen.

'''NOTE''': Cascades will not appear in Scene_Equip when the slot window is
currently active in order to make sure the slot items are visible and not
obscured. Hovering over keywords is still possible.

Enable Cascade?:
- Enable Window_Help cascade tooltips?
- Must be enabled to use.

Attach to Window?:
- Attach cascade windows to Window_Help?

Activation Style:
- What is the activation style you wish to use for cascading tooltips?
- Always Activated
- Shift Toggles On/Off

Default Toggle State:
- What is the default toggle state if the shift toggle option is used?

Offset Position:

Offset X:
- Offset the cascade X position?
- Negative: left. Positive: right.

Offset Y:
- Offset the cascade Y position?
- Negative: up. Positive: down.

Move Animation:

Start X:
- Starting offset cascade X position?
- Negative: left. Positive: right.

Start Y:
- Starting offset cascade Y position?
- Negative: up. Positive: down.

Duration:
- Duration to move cascading windows into position?

Toggle Button Prompt:
- Requires VisuMZ_0_CoreEngine!

Prompt Format:
- Prompt display for toggling cascade mode.
- Requires VisuMZ_0_CoreEngine!

Scale:
- Use a number between 0 and 1 to determine the scale.
- 0 = 0%; 0.5 = 50%; 1.0 = 100%

Offset X:
- Offset the cascade prompt X position?
- Negative: left. Positive: right.

Offset Y:
- Offset the cascade prompt Y position?
- Negative: up. Positive: down.

---

=== Supported Windows ===

[[File:MessageKeywords_Params3.png]]

Message Keyword support will be provided to these windows.
Not every window is a valid candidate, however.

---

Supported Windows

String:
- Type in the constructor name of window you wish to add to the supported
Window list.
- Any windows not on the list will not support Keywords in the sense that
tooltips will not appear. However, Keyword Markers can still be used to
offer a quick shortcut to replacement text outside of tooltip windows.
- Any of the windows listed here will have their refresh functions monkey
patched via JavaScript to support Message Keywords.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Irina]]
* [[Arisu]]
* [[Olivia]]
* [[Yanfly]]

== Changelog ==

Version 1.07: April 20, 2026
* Compatibility Update!
** Message Keywords now work properly with the Sideview Battle UI. Update made by Irina.

Version 1.06: January 19, 2026
* Feature Update!
** Display and toggling of Message Keywords only occurs if the Help Window is visible. This is to prevent shortcut clashing with other plugins.

Version 1.05: June 13, 2024
* Documentation Update!
** Help file updated for new features.
* Compatibility Update!
** Plugins should be more compatible with one another.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Keyword List > Keyword > Cascades
**** Used only for Window_Help Cascades.
**** Displays these additional keywords.
*** Parameters > Tooltip Settings > Help Window Cascade
**** Cascading tooltips will show all of the available keywords found in the help window and list them off to the side to show off each tooltip at once. This allows players to read keyword definitions without needing to utilize touch inputs.

Version 1.04: March 14, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash upon opening up the log window. Fix made by Irina.

Version 1.03: August 11, 2022
* Bug Fixes!
** Fixed a bug that caused games with a sleeping mouse on initialization to always trigger the tooltip window. Fix made by Arisu.

Version 1.02: April 21, 2022
* Compatibility Update!
** Added compatibility update with VisuMZ's Quest Journal System to not auto-clear the keyword tooltip window when tracking variables are being updated with the Quest Tracker open. Update made by Arisu.

Version 1.01: February 24, 2022
* Feature Update!
** Variables are now parsed before and after the parsing of keywords. Update made by Arisu.

Version 1.00 Official Release Date: December 8, 2021
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Visual Novel Volume 2]]

== End of File ==

|}













[[Category: RPG Maker MZ Utility Plugins]]

[[Category: RPG Maker MZ Visual Plugins]]

[[Category: RPG Maker MZ Message Plugins]]
[[Category: RPG Maker MZ Quality of Life Plugins]]

Auto Skill Triggers VisuStella MZ

2026-04-19T11:41:22Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=SIhe1CciK54</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/786772" width="552" height="167"><a href="https://visustellamz.itch.io/auto-skill-triggers">Auto Skill Triggers by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 4}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:AutoSkillTrigger_SelfDestruct.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

Sometimes you want some skills that only occur after a specific condition
triggers (ie. death, receiving specific elemental damage, or allies
performing skills of a specific type). These skill triggers are now made
possible through this plugin.

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

* Skill triggers that launch at the start of battle or winning a battle.
* Skills that let actors/enemies do one last hurrah before dying.
* Skills that function as a reaction to the user performing specific actions ranging from basic attacks, guarding, items, physical attacks, magical attacks, certain hit attacks, skills from specific skill types, or actions that inflict any specific kind of elemental damage.
* A total of 60 different auto triggers for a variety of situations.

== Requirements ==

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

'''Required Plugin List'''

* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 3}}

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Battle System - FTB VisuStella MZ]]

[[Battle System - ETB VisuStella MZ]]

[[Battle System - PTB VisuStella MZ]]

These battle systems are incompatible with Auto Skill Triggers. This is due
to their turn structures, making them highly incompatible with the way that
Auto Skill Triggers work.

---

{{Notetags MZ}}

{{VisuMZ Auto Skill Triggers Notetags}}

== Plugin Parameters ==

=== General Settings ===

These are general settings used for this plugin. These are primarily used to
impose a limit on the number of auto skill triggers that can happen per
battler per turn (meaning each member in battle has that limit individually
and not as a whole). Generally speaking, we recommend imposing limits limits
like MP costs, TP costs, cooldowns, and the like.

This is because auto skill triggers, when left unchecked and reacting to
everything, can cause a runaway effect where the player no longer inputs
anything. Instead, it is best to put a limit (even if high) on the number of
auto triggers to prevent such a thing from happening.

If you still want seemingly unlimited auto skill triggers, change the
numbers to 100 or something, but keep in mind that we're not responsible for
runaway effects when the risk of it happening is already mentioned.

---

Settings

Limit Per Turn (Turn-Based):
- Turn-Based Only.
- How many triggers per battler per turn?
- Higher risk of runaway auto triggers at higher counts.

Limit Per Turn (TPB-Based):
- TPB-Only.
- How many triggers per battler per turn?
- Higher risk of runaway auto triggers at higher counts.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.18: April 20, 2026
* Bug Fixes!
** Fixed a bug where battle start auto skill triggers would erase the bonus effects of preemptive and surprise attacks. Fix made by Olivia.

Version 1.17: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > General Settings:
**** These are general settings used for this plugin. These are primarily used to impose a limit on the number of auto skill triggers that can happen per battler per turn (meaning each member in battle has that limit individually and not as a whole). Generally speaking, we recommend imposing limits limits like MP costs, TP costs, cooldowns, and the like.
**** This is because auto skill triggers, when left unchecked and reacting to everything, can cause a runaway effect where the player no longer inputs anything. Instead, it is best to put a limit (even if high) on the number of auto triggers to prevent such a thing from happening.
**** If you still want seemingly unlimited auto skill triggers, change the numbers to 100 or something, but keep in mind that we're not responsible for runaway effects when the risk of it happening is already mentioned.
*** Plugin Parameters > Limit Per Turn (Turn-Based)
**** Turn-Based Only. How many triggers per battler per turn? Higher risk of runaway auto triggers at higher counts.
*** Plugin Parameters > Limit Per Turn (TPB-Based)
**** TPB-Only. How many triggers per battler per turn? Higher risk of runaway auto triggers at higher counts.

Version 1.16: January 18, 2024
* Compatibility Update!
** Added better compatibiliy with Battle System - OTB when using states with Action Times+. Update made by Olivia.

Version 1.15: August 17, 2023
* Compatibility Update!
** Added better compatibility with Battle System - ATB's wait setting. Update made by Olivia.

Version 1.14: July 13, 2023
* Compatibility Update!
** Added better compatibility with Battle System - ATB's active setting. Update made by Olivia.
** Added better compatibility with Battle System - OTB for battle start and enemy responses. Update made by Olivia.

Version 1.13: January 20, 2023
* Compatibility Update!
** Added better compatibility with Battle System OTB's forced action update. Update made by Olivia.

Version 1.12: June 30, 2022
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.11: March 10, 2022
* Compatibility Update
** Plugins should be more compatible with one another.

Version 1.10: December 16, 2021
* Compatibility Update!
** Auto Skill Triggers is now disabled with the following battle systems: ETB, FTB, and PTB. This is due to the way their turn structures work, making them highly incompatible with one another.
** We may revisit this in the future, but for now, Auto Skill Triggers are to be disabled by code when any of the battle systems are detected.
* Documentation Update!
** Added "VisuStella MZ Compatibility" section.

Version 1.09: June 25, 2021
* Feature Update!
** Added failsafe for those using illegal syntax charactes inside of their database type names which conflict with notetag creation. Fix by Irina.

Version 1.08: March 19, 2021
* Bug Fixes!
** Death Triggers that cannot be used will no longer cause the battler to become immortal. Fix made by Irina.

Version 1.07: March 12, 2021
* Optimization Update!
** Skills that cannot be used will no longer be checked for auto triggers. Update made by Olivia.

Version 1.06: February 12, 2021
* Optimization Update!
** Skills that cannot be used will no longer be checked for auto triggers. Update made by Olivia.

Version 1.05: January 22, 2021
* Bug Fixes!
** Triggers involving the user should now work properly. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Notetag added by Arisu:
*** <Auto Trigger x%: condition>
**** If using the x% variant, the Auto Trigger has a x% chance to occur.
**** Replace 'x' with a number value representing the chance to succeed.

Version 1.04: December 25, 2020
* Compatibility Update
** Added compatibility functionality for Battle System - STB.

Version 1.03: November 22, 2020
* Bug Fixes!
** Auto Skill Triggers no long clear battler speed in TPB. Fixed by Yanfly.

Version 1.02: November 1, 2020
* Bug Fixes!
** Stunned enemies will have their auto triggers bypassed. Fix made by Olivia.

Version 1.01: October 18, 2020
* Bug Fixes!
** Skills and Items used outside of battle should no longer crash the game. Fix made by Yanfly.
** Specific trigger types should no longer crash the game. Fix made by Yanfly.

Version 1.00: October 28, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 4]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]

[[Category: RPG Maker MZ Skill Plugins]]


[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]

Visual Battle Environment VisuStella MZ

2026-04-19T11:41:13Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=Cna60jschK4</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/990020" width="552" height="167"><a href="https://visustellamz.itch.io/visual-battle-environment">Visual Battle Environment plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 8}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:VisualBattleEnv_Ani1.gif]]

[[File:VisualBattleEnv_Ani2.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:VisualBattleEnv_Ani1.gif]]

[[File:VisualBattleEnv_Ani2.gif]]

Add extra layers of images to your battle system for background purposes or
foreground purposes. These images can be battlebacks, pictures, parallaxes,
whatever you need them to be. Add extra settings to them, such as scrolling,
blend modes, different opacity levels, hues, and more.

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

* Create battle environment images located behind battlers to function as a part of the background.
* Create battle environment images located in front of battlers to function as a part of the foreground.
* Apply custom settings to them, such as changing their blend modes, their scrolling speeds, and opacity levels.
* Customize their hue and if they have a hue shift at all.
* Apply color tones if needed to give more color control.
* Alter their opacity levels midway during battle.
* An unlimited amounts of back environments and front environments to add to the battle scene.
* Environment images are layered based on their ID's. Lower ID's appear below while higher ID's appear above.

== Requirements ==

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

=== Required Plugin List ===

* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

{{Plugin Commands MZ}}

{{VisuMZ Visual Battle Environment Plugin Commands}}

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.09: April 20, 2026
* Bug Fixes!
** Fixed a bug where upon returning from the options menu or any other similar menu while in battle, any previously removed battle environments would reappear. Fix made by Irina.

Version 1.08: August 18, 2022
* Bug Fixes!
** Fixed a crash from a previous version of Battle Core. Fix made by Olivia.

Version 1.07: January 27, 2022
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.06: December 16, 2021
* Compatibility Update
** Compatibility update with RPG Maker MZ's new subfolders. Update by Irina.

Version 1.05: August 6, 2021
* Bug Fixes!
** Environments no longer visibly vanish when changing to the Options or Party management scenes. Fix made by Irina.

Version 1.04: July 16, 2021
* Bug Fixes!
** Games with UI dimensions that are different from screen dimensions should no longer be affected by the distance difference. Fix made by Irina.

Version 1.03: May 28, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.02: April 30, 2021
* Bug Fixes!
** Added a fail safe for changing color tones in case the value fails to be an array (it will default to zero tone). Fix made by Arisu.

Version 1.01: April 9, 2021
* Bug Fixes!
** Crashes should no longer occur when performing a troop transition from the map. Fix made by Olivia.

Version 1.00 Official Release Date: May 10, 2021
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 8]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]








[[Category: RPG Maker MZ Eventing Plugins]]


[[Category: RPG Maker MZ Visual Plugins]]

Tutorial Panel System VisuStella MZ

2026-04-19T11:40:59Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=Y9CwVDMpOPc</youtube>

|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/1833175" width="552" height="167"><a href="https://visustellamz.itch.io/tutorial-panel-system">Tutorial Panel System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Custom Construct Vol 3}}

}}



[[File:TutorialPanelSys_Preview1.gif]]

[[File:TutorialPanelSys_Preview2.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{Visustella MZ}}

== Introduction ==

[[File:VisuMZ.112.jpg|600px]]

The plugin adds the ability to display tutorial panels seen in many recent
JRPG's. The tutorial panel system allows the player to read forward and
backward at their own pace while having visuals displayed on the relevant
tutorial pages. The player can later reread the tutorials found in a
dedicated Tutorial List scene that is accessible through the main menu.

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

* Adds modern JRPG Tutorial Panel system.
* Players can read tutorials at their own pace, advancing forward and backward as needed, all while tutorials provide visuals.
* The list of already read tutorials can be accessed from the Main Menu if enabled and made visible through the Plugin Commands/Parameters.
* Tutorials can be viewed from the map scene or battle scene.
* Tutorial calls can be bypassed if the player has already viewed them, in order to prevent tediousness.
* Tutorials can be bypassed manually by the player through the Options scene if they do not wish to read tutorials for whatever reason (such as their second or third playthrough of the game).
* Tutorials can still be forcefully opened ignoring the bypass options of having already been read or turned off through the Options menu.
* Game devs can silently register tutorials to be placed into the Tutorial List scene for the player to read without having to show the tutorial.
* Within the Tutorial List scene, tutorials are separated into categories, allowing players to sort through them easily.
* Players can expand and collapse categories as needed if there are too many tutorials to navigate through.
* Some tutorials can already be made visible and registered by default.

== Requirements ==

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

{{MZ Tier 2}}

== Extra Features ==

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

---

=== [[Core Engine VisuStella MZ]] ===

[[File:TutorialPanelSys_Preview1.gif]]

This plugin provides vocabulary that can be used for the Button Assist
Window added through the VisuMZ Core Engine.

---

=== [[Main Menu Core VisuStella MZ]] ===

[[File:TutorialPanelSys_Preview5.png|600px]]

The latest version of the VisuMZ Main Menu Core already has the settings for
the Tutorial List command.

---

=== [[Options Core VisuStella MZ]] ===

[[File:TutorialPanelSys_Preview4.png|600px]]

The latest version of the VisuMZ Options Core should have the settings for
showing/hiding tutorials.

---

{{Plugin Commands MZ}}

{{VisuMZ Tutorial Panel System Plugin Commands}}

== Plugin Parameters ==

=== Category List Settings ===

[[File:TutorialPanelSys_Preview2.png|600px]]

[[File:TutorialPanelSys_Param1.png]]

List of categories that are used for this plugin. Categories will be listed
in the order they appear with "Unlisted" category displayed first.

---

Category

ID Key:
- This category's identification key.
- Categories require unique keys for the plugin to differentiate them.

Title:
- This category's title.
- You may use text codes.

---

=== Tutorial List Settings ===

[[File:TutorialPanelSys_Preview2.png|600px]]

[[File:TutorialPanelSys_Param2.png]]

List of tutorials that are used for this plugin. Here is where you add all
the tutorials seen in game. How they appear and such is all handled here.

---

Tutorial

ID Key:
- This tutorial's identification key.
- Tutorials require unique keys for the plugin to differentiate them.

Title:
- This tutorial's title. Displayed in a separate window.
- You may use text codes.

Category:
- The category this tutorial is listed under.
- If unlisted, the tutorial will be listed under "Unlisted".

Pages:
- List of pages that are shown for this tutorial.
- Pages are displayed in the order listed.

---

[[File:TutorialPanelSys_Param2a.png]]

Page Settings

Filename:
- Displayed image associated with this page.
- Found in the game project's /img/pictures/ folder.

Description:
- The description text displayed for this page.
- Text codes are allowed.

---

=== Scene_TutorialData Settings ===

[[File:TutorialPanelSys_Preview1.gif]]

[[File:TutorialPanelSys_Param3.png]]

Settings for Scene_TutorialData. This scene is where the contents of the
tutorials are displayed.

---

Background

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.

---

Button Assist Vocab

Change Page:
- Vocabulary used for changing pages.
- You may use text codes.

Next Page:
- Vocabulary used for moving to the next page.
- You may use text codes.

Done Tutorial:
- Vocabulary used for being done with the tutorial.
- You may use text codes.

---

Windows > Pages Window

Active Page Text:
- Vocabulary used for active page.
- You may use text codes.

Inactive Page Text:
- Vocabulary used for inactive page.
- You may use text codes.

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

Windows > Description Window

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

Windows > Picture Window

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

Windows > Title Window

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

=== Scene_TutorialList Settings ===

[[File:TutorialPanelSys_Preview2.png|600px]]

[[File:TutorialPanelSys_Param4.png]]

Settings for Scene_TutorialList. This is the scene where the player can go
to reread previously viewed tutorials.

---

Main Menu Settings

Command Name:
- Name of the 'Tutorials' option in the Main Menu.

Show in Main Menu?:
- Add the 'Tutorials' option to the Main Menu by default?

Enable in Main Menu?:
- Enable the 'Tutorials' option to the Main Menu by default?

Background

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.

---

Button Assist Vocab

View Tutorial:
- Text for viewing tutorial.

Expand Category:
- Text for expanding categories.

Collapse Category:
- Text for collapsing categories.

---

Windows > List Window

Open Categories:
- Text format for an open category.
- %1 - Category Name, %2 - Quest Amount

Closed Categories:
- Text format for an open category.
- %1 - Category Name, %2 - Quest Amount

Unlisted Category:
- Text used for "unlisted" category.
- You may use text codes.

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

=== Scene_Battle Settings ===

[[File:TutorialPanelSys_Preview3.png|600px]]

[[File:TutorialPanelSys_Param5.png]]

Settings for Scene_Battle. This governs how tutorials appear in battle.

---

Windows > Battle Status Window

Hide During?:
- Hide the battle status window during tutorials?
- Does NOT affect VisuMZ_3_SideviewBattleUI!

---

Windows > Pages Window

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

Windows > Description Window

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

Windows > Picture Window

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

Windows > Title Window

Background Type:
- Select background type for this window.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

Windows > Button Assist Window

Background Type:
- Select background type for this window.
- Requires VisuMZ_0_CoreEngine!

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.
- Requires VisuMZ_0_CoreEngine!

---

=== Options Settings ===

[[File:TutorialPanelSys_Preview4.png|600px]]

[[File:TutorialPanelSys_Param6.png]]

Options settings for this plugin.

---

Options

Add Option?:
- Add the 'Tutorials' option to the Options menu?

Adjust Window Height:
- Automatically adjust the options window height?

Option Name:
- Command name of the option.

---

=== Sound Settings ===

[[File:TutorialPanelSys_Param7.png]]

Sound settings when changing tutorial pages.

---

Sound

Filename:
- Filename of the sound effect played.

Volume:
- Volume of the sound effect played.

Pitch:
- Pitch of the sound effect played.

Pan:
- Pan of the sound effect played.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Arisu]]
* [[Olivia]]
* [[Irina]]
* [[Yanfly]]

== Changelog ==

Version 1.03: April 20, 2026
* Bug Fixes!
** If the picture used in the tutorial page is too big, it would cover the Button Assist Window. This is now fixed and the picture would appear behind the Button Assist Window if available. Fix made by Irina.
** Previously, when multiple tutorials are shown in battle, there would be a frame or two of flicker between the tutorial images. This should now be fixed. Fix made by Irina.

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added by Irina:
*** Plugin Parameters > Scene Battle > Button Assist Window
**** Button Assist Window > Background Type
**** Button Assist Window > JS: X, Y, W, H
***** Added menu button assist to the battle scene where it previously was not available.
***** Requires VisuMZ_0_CoreEngine!

Version 1.01: April 18, 2024
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Command added by Arisu:
*** Debug: Full Tutorial List?
**** For playtest only! Allows you to fully view Tutorial.
**** Resets when the game client is closed.

Version 1.00 Official Release Date: January 2, 2023
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Custom Construct Volume 3]]

== End of File ==

|}












[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]

[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]

[[Category: RPG Maker MZ Quality of Life Plugins]]

Party System VisuStella MZ

2026-04-19T11:40:50Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=8AQ-NgFGwRA</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/745029" width="552" height="167"><a href="https://visustellamz.itch.io/party-system">Party System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 2}}
|link3 = {{VisuStella All Waves Collection}}

}}



{|
| [[File:PartySystemMenu1.png|400px]]
| [[File:PartySystemBattle1.png|400px]]

|-

| [[File:PartySystemScene1.png|400px]]
| [[File:PartySystemScene2.png|400px]]

|}

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{Visustella MZ}}

== Introduction ==

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.

== Requirements ==

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

{{MZ Tier 2}}

== Major Changes ==

[[File:PartySystemMenu1.png|600px]]

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.

---

=== Temporary Parties ===

Temporary parties are very specific parties that will overwrite whatever the
player has set as a party. These can include current party members or even
actors that haven't joined. The temporary party cannot be changed nor can
the positions of said party members can be changed.

When a temporary party is present, menu and battle commands involving
changing party members will be disabled.

Once the temporary party is disbanded, the player's selected party will be
available once again as well as all of the functions to change party members
and their positions.

---

== 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]] ===

[[File:PartySystemBattle1.png|600px]]

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.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

=== [[Battle System - OTB VisuStella MZ]] ===

With Battle System - OTB, the player cannot change entire parties at once
from the Party Command Window. The feature will be unaccessible while
Order Turn Battle is in play. However, the player can still change party
members through the Actor Command Window by having actors replace other
actors. Party changing is also available through battle events, Common
Events, and script calls.

---

=== [[Battle System - STB VisuStella MZ]] ===

With Battle System - STB, the player cannot change entire parties at once
from the Party Command Window. The feature will be unaccessible while
Standard Turn Battle is in play. However, the player can still change party
members through the Actor Command Window by having actors replace other
actors. Party changing is also available through battle events, Common
Events, and script calls.

---

{{Plugin Commands MZ}}

{{VisuMZ Party System Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:PartySystemParams1.png]]

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.

---

[[File:PartySystemMenu1.png|600px]]

[[File:PartySystemMenu2.png|600px]]

General

Max Battle Members:
- Maximum number of battle members.

---

[[File:PartySystemScene1.png|600px]]

Party Scene

Add Remove Command:
- Add the 'Remove' command to the party scene?

Locked Member Icon:
- Icon used for a locked party member.

Required 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.

---

[[File:PartySystemBattle2.png]]

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.

---

[[File:PartySystemBattle1.png|600px]]

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?

TPB: Immediate Action:
- Allow actors to immediate act upon switching in for TPB battle systems?

---

=== Vocabulary Settings ===

[[File:PartySystemParams2.png]]

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

---

General

Active Party:
- Vocabulary used to represent the Active Party.

Reserve Party:
- Vocabulary used to represent the Reserve Party.

Status:
- Vocabulary used to represent the Status Window.

---

Party Scene > Windows

Empty:
- For the party and status windows when no actor is selected.

Remove:
- For the remove option.

---

Party Scene > Button Assist

Swap Positions:
- Button assist text for the page up/down commands.
- Requires VisuMZ_0_CoreEngine!

Remove:
- Button assist text for the removal command.
- Requires VisuMZ_0_CoreEngine!

Sort:
- 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 ===

[[File:PartySystemParams3.png]]

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 ===

[[File:PartySystemParams4.png]]

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.

Columns:
- 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.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.36: April 20, 2026
* Compatibility Update!
** Added better compatibility for other plugins that add extra commands to the party command window.

Version 1.35: August 14, 2025
* Bug Fixes!
** Fixed a bug where if the battle had no battle back setting and is using a map snapshot, the snapshot would be overwritten if the player enters the party change menu from battle. This should no longer occur and the map snapshot will be preserved. Fix made by Olivia.

Version 1.34: July 17, 2025
* Compatibility Update!
** Added better compatibility with TPB when using the in-battle Party switch command from the Party Command Window. Update made by Irina.

Version 1.33: May 15, 2025
* Compatibility Update!
** Added better compatibility for $gameParty.swapOrder function to allow it to work on the map. Update made by Irina.

Version 1.32: December 19, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash upon adding new members if the VisuStella Core Engine wasn't installed. Fix made by Arisu.

Version 1.31: August 29, 2024
* Documentation Update!
** Help file updated for new features.
** New section added to "Major Changes":
*** Temporary Parties
**** Temporary parties are very specific parties that will overwrite whatever the player has set as a party. These can include current party members or even actors that haven't joined. The temporary party cannot be changed nor can the positions of said party members can be changed.
**** When a temporary party is present, menu and battle commands involving changing party members will be disabled.
**** Once the temporary party is disbanded, the player's selected party will be available once again as well as all of the functions to change party members and their positions.
* New Features!
** New Plugin Commands added by Arisu:
*** Temp: Create Temporary Party (Normal)
**** Creates a temporary party with specific actors.
*** Temp: Create Temporary Party (JS)
**** Creates a temporary party selected with JavaScript.
*** Temp: Disband Temporary Party
**** Clears temporary party.

Version 1.30: April 18, 2024
* Bug Fixes!
** Fixed a bug where party changes with FTB, ETB, and PTB did not replace the newely added party member on the turn order timeline. Fix by Olivia.

Version 1.29: March 14, 2024
* Bug Fixes!
** Fixed a bug where party changes with PTB did not register correctly. Fix made by Olivia.

Version 1.28: November 16, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.27: February 16, 2023
* Optimization Update!
** Plugin should run more optimized.
* Feature Update!
** When holding the "up" keyboard button with the reserve window active, the return to the active party window will no longer happen unless the "up" key is released and then pressed again. Update made by Olivia.

Version 1.26: January 20, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.25: July 28, 2022
* Bug Fixes!
** Changing party members via actor command with a less than max battle size after removing a middle member midway through battle will no longer cause weird results when switching. Fix made by Arisu.
** Party members that were switched out during battle animations with active TPB/ATB will no longer cause damage popup crashes when switched back in a follow up battle. Fix made by Arisu.

Version 1.24: March 24, 2022
* Compatibility Update!
** Compatibility update with Skills & States Core Passive Conditions involving the party leader. Update made by Arisu.

Version 1.23: January 13, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.22: July 16, 2021
* Feature Update!
** Added a fail safe that prevents on-battle start events from triggering when adding party members outside of battle under evented circumstances that function as a bridge between event and battle. Fix by Irina.

Version 1.21: July 9, 2021
* Bug Fixes!
** When using TPB-based battle systems, adding actors to the main party would not enable them to move. This should be fixed. Fix made by Irina.

Version 1.20: July 2, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.19: June 18, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.18: April 16, 2021
* Documentation Update!
** Fixed typo. Fix made by Arisu.

Version 1.17: March 26, 2021
* Documentation Update!
** Added "VisuStella MZ Compatibility" section for detailed compatibility explanations with the VisuMZ_2_BattleSystemOTB plugin.

Version 1.16: March 19, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.15: March 5, 2021
* Documentation Update!
** Help file updated for new features.
* New Features
** New Plugin Parameter added by Irina:
*** Plugin Parameters > Gneral > Battle Scene > Battle Party Icon
**** For some reason, we never had a setting that lets you change the party icon. Well, now there is!

Version 1.14: February 5, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Commands added by Arisu!
*** Party: Move Party Index to Reserve
**** Moves an actor in a specific party index to reserve. Map only. Must be 1 actor left. You may use code.
*** Party: Move Random Reserve to Active
**** Moves a random actor from the reserve party to active. Map only. Must be enough space in active party.

Version 1.13: January 29, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Commands added by Arisu!
*** Party: Move Actor(s) to Active
**** Map only. Moves an actor to the active party if there is room.
*** Party: Move Actor(s) to Reserve
**** Map only. Moves an actor to the reserve party.

Version 1.12: January 15, 2021
* Bug Fixes!
** For battle testing, if the number of battle test members exceeds the maximum battle member slots, trim them until they match. Fix by Olivia.

Version 1.11: January 1, 2021
* Compatibility Update
** Plugins should be more compatible with one another.

Version 1.10: December 25, 2020
* Compatibility Update
** Plugins should be more compatible with one another.

Version 1.09: December 18, 2020
* Bug Fixes!
** Removing party members in the active party by event command will now be properly removed from the party. Fix made by Yanfly.

Version 1.08: December 4, 2020
* Bug Fixes!
** With TPB battle systems, after switching out party members, the battle system will no longer carry over any previous active battle members in the command window. Fix made by Yanfly.
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.07: November 22, 2020
* Bug Fixes!
** With Active TPB, switching out a party member mid-action is no longer possible to prevent bugs. Intead, there party switching action will be queued and take effect after the action has been completed. Fix made by Yanfly.
* Compatibility Update!
** Game_Party.swapOrder function now works with this plugin. However, keep in mind that due to how this party system plugin allows you have empty slots in the active battle party, this function will fill in the empty slots upon usage. Update made by Yanfly.

Version 1.06: November 1, 2020
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.05: October 25, 2020
* Bug Fixes!
** Plugin Command "Party: Change Max Battle Members" now works again. Fix made by Arisu.

Version 1.04: October 18, 2020
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.03: October 11, 2020
* Bug Fixes!
** Adding party members during battle through the party window command will no longer cause crashes after they input an action. Fix made by Yanfly.

Version 1.02: October 4, 2020
* Bug Fixes!
** Adding party members during test play should now work again. Fix made by Irina.
** Changing party members mid-battle through the actor command should now refresh the party followers afterwards. Fix made by Yanfly.
* New Features!
** New Plugin Parameter added by Arisu!
*** General > Party Command Window > TPB: Immediate Action
**** Allow actors to immediate act upon switching in for TPB battle systems?

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!

== See Also ==

* [[Inspiration Behind Wave 2]]

== Help File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]




[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]

[[Category: RPG Maker MZ Quality of Life Plugins]]

Date and Time System VisuStella MZ

2026-04-19T11:40:41Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://youtu.be/qOF1qCMqqyU</youtube>

|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/2501190" width="552" height="167"><a href="https://visustellamz.itch.io/date-time-system">Date & Time System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wanderlust Vol 2}}

}}



[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_HUD.png]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:VisuMZ.145.jpg|600px]]

Does your game need a time system? This plugin adds time-related mechanics
to RPG Maker MZ, allowing you to control either Game Time, governed by your
own custom rules, or Real Time, synchronized to the player's PC or device.

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

* Pick between Game Time or Real Time. Game Time uses in-game rules while real time synchronizes the timer with the player's PC or device.
* In Game Time, create custom months, weekdays, and even change up rulings like how many hours a day there are or minutes in an hour.
* Game Time allows for Time Dilation, where you can change how fast a minute occurs or even slow it down. This can be adjusted midgame even.
* Pause and unpause Game Time as you see fit, or even use notetags to halt the passage of Game Time inside certain maps like building interiors.
* Enables usage of real time data, like dates and time. This data can be utilized in-game for variables, switches, and going as far as tinting the screen on certain maps based on the time of day.
* Variables and switches will be automatically updated and can be used to save date and time-related information.
* Recorded data found in variables and switches are highly useful for immediate event usage.
* Determine the screen tone and/or overlay used depending on what time of the day it is.
* Certain message-related text codes can be used to make quick mention of what time it is, certain aspects of a date, seasons, and more.
* Compatibility with other plugins can enable more features to be used, such as date and time-related battle encounters, season items for shops, usage of different tilesets for different dates/times, and more!
* Date/Time HUD is added for the map scene to quickly display information to the player about the date and time.
* The HUD is fully customizable and custom images/icons can be used as well as custom JavaScript code to modify how certain aspects appear in-game.
* Parts of the HUD can be disabled for those who may only want a Time system but not a Date system or vice versa.

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

=== Tint Screen / Screen Tone ===

[[File:DateTimeSystem_Preview1.gif]]

Although this plugin has screen tones for different times of the day, these
do NOT conflict with the "Tint Screen" command to adjust screen tones like
one may predict. Instead, the ones used in this plugin are a separate tint
effect and can, in fact, be stacked on top of each other.

Keep in mind that if you are using VisuMZ_2_LightingEffects, the screen
tones added by this plugin won't take effect in favor of the overlay system
to better work with the Lighting Effects system.

---

== 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]] ===

[[File:VisuMZ.002.jpg|300px|link=Battle Core VisuStella MZ]]

If you have VisuStella MZ's Battle Core installed, you will gain access to
a few of the new comment tags available to Troops. These comment tags allow
you to setup which troops that appear based on certain Date and/or Time
conditions.

For example, if you want some enemies that only appear during the day time,
you can use the <Encounter Cycles: Dawn, Day> comment tag. If you want them
to appear at night, <Encounter Cycles: Dusk, Night> will work.

For another example, we can make some enemies that appear only during
specific seasons like <Encounter Season: Winter>. Other setups can be more
numerically involved like during specific months, hours, weekdays, etc.

Keep in mind that if you are using these conditions, all other conditions
need to be met for those Troops, such as which regions they're supposed to
appear in on the map or any other plugin related conditions like for the
VisuStella MZ Conditional Random Encounters plugin.

Battlebacks will need to do the same though the notetag for this will be
placed on the map notebox itself and for seasonal changes only.

---

=== [[Events and Movement Core VisuStella MZ]] ===

[[File:VisuMZ.005.jpg|300px|link=Events and Movement Core VisuStella MZ]]

If you have VisuStella MZ's Events & Movement Core installed, you will gain
access to allowing certain tilesets to swap to another upon loading the map.
Inside the base tileset's notebox, you can insert <Winter Swap To: 7> and it
will exchange itself to tileset 7 if the season happens to be winter.

The effect does not end there, it will perform another check, but this time,
on the new tileset the map was changed to. There, it can optionally perform
another check like <Night Swap To: 8> if desired.

Priority will be given to seasons first, then the day cycles (dawn, day,
dusk, night). This way, you can ensure that the tileset you're using matches
the conditions of the season or time of day if so desired.

If time changes into a new season or day cycle while on the map, there won't
be any changes made immediately. Instead, the player must exit and reenter
the map for the changes to be seen. This is to prevent any awkward changes
and transitions that may occur otherwise. The same applies to battlebacks.

---

=== [[Items and Equips Core VisuStella MZ]] ===

[[File:VisuMZ.006.jpg|300px|link=Items and Equips Core VisuStella MZ]]

If you have VisuStella MZ's Items & Equips Core installed, you will gain
access to new notetags that govern if some items, weapons, or armors can
appear in shops during specific times or dates. This can make way for the
idea of seasonal items and the like where certain holiday cookies are
available during the winter and cool drinks are available during summers.

Additionally, you can have price changes depending on seasons and times.
Is it almost time for the bakery to close, make the items cheaper around
then. What about the holiday season? Make them cheaper again. Make your
players feel the discount frenzy.

---

=== [[Message Core VisuStella MZ]] ===

[[File:VisuMZ.004.jpg|300px|link=Message Core VisuStella MZ]]

If you have VisuStella MZ's Message Core installed, you can access the new
text codes added through this plugin to quickly display times and dates. A
few of these text codes are also used to display seasons, weekdays, parts of
the day cycle, and more. This can be used with both Game Time and Real Time
vocabularies.

---

=== [[Skills and States Core VisuStella MZ]] ===

[[File:VisuMZ.007.jpg|300px|link=Skills and States Core VisuStella MZ]]

Installing VisuStella MZ's Skills & States Core gives you access to several
special notetags that allow you to take advantage of the Date & Time System.

Some of these notetags make it so that some skills can only be used during
specific seasons or times of the day. For example, the skill "Moon Beam" can
only be used during the Night hours. Other things like "Summer Heat" can
only be used during the Summer months.

Other notetags involve changing up how much certain skills cost for MP, HP,
TP, and more. A skill like "Icicle Rain" might cost 200% less MP during the
Summer months while "Solarbeam" might cost 50% less MP during Day hours.

Damage can also be affected by dates and times. Skills like "Vine Whip" can
deal more damage during Spring months and skills like "Nocturnal Healing"
might yield less HP recovery during non-Night hours.

State turns can also benefit from these effects. A "Sleep" state might last
a couple of more turns during the Night hours while "Burn" wouldn't last as
long during Winter months.

---

=== [[Save Core VisuStella MZ]] ===

[[File:VisuMZ.009.jpg|300px|link=Save Core VisuStella MZ]]

Those using the VisuStella MZ Save Core plugin can gain access to another
feature when used together with this plugin. If the player loads a save file
then the game will record the time difference upon loading in minutes onto a
variable. This means that you can detect how long the player has been away
from the game offline and use that as a game mechanic.

In order for this mechanic to work, the Save Core must be implemented, save
the game (with this plugin installed), and then load it. If a save was made
before this plugin is installed, loading the old save file won't give out a
time difference. This is not an error as it is moreso a condition has not
been first met.

This uses Real Time and is based off the player's PC date and time settings.
For what it's worth, it's possible for the player to "cheat" using time
travel shenanigans, but just keep in mind that if a player travels backwards
in time, the variable's value will be negative. Use that information however
you want.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

=== [[Lighting Effects VisuStella MZ]] ===

[[File:VisuMZ.099.jpg|300px|link=Lighting Effects VisuStella MZ]]

If you have using VisuStella MZ's Lighting Effects plugin, tints/tones will
not be used, but instead, overlay values will be. This is so that the
overlay can utilize the lighting system in play. Do not be surprised if any
changes to this plugin's tone-related Plugin Parameters do nothing as long
as Lighting Effects is enabled.

---

{{Notetags MZ}}

{{VisuMZ Date and Time System Notetags}}

{{Text Codes MZ}}

{{VisuMZ Date and Time System Text Codes}}

{{Plugin Commands MZ}}

{{VisuMZ Date and Time System Plugin Commands}}

== Script Calls ==

The following are Script Calls that can be used with this plugin. These are
made for JavaScript proficient users. We are not responsible if you use them
incorrectly or for unintended usage.

---

=== Date and Time-Related Script Calls ===

---

<pre>
TimeManager.getYear()

- Gets the current year.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
</pre>

---

<pre>
TimeManager.getMonth()

- Gets the current month.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- The first month starts at 1.
</pre>

---

<pre>
TimeManager.getDate()

- Gets the current date.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- The first date starts at 1.
</pre>

---

<pre>
TimeManager.getWeekday()

- Gets the current weekday.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- The first weekday starts at 1.
</pre>

---

<pre>
TimeManager.getHour()

- Gets the current hour.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- The first hour starts at 0.
</pre>

---

<pre>
TimeManager.getMinute()

TimeManager.getMinuteRaw()

- Gets the current minute.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- If you are using Game Time, you may be using the Plugin Parameter called
"Round Minutes to 10s" where it only shows the minute count for every 10
minutes. The Raw version will return the actual minute value while the
non-raw version will show the selected version if enabled.
- Returns a numeric value.
- The first minute starts at 0.
</pre>

---

<pre>
TimeManager.getSecond()

- Gets the current minute.
- Only works for Real Time.
- Game Time does not use seconds and if you use this, you will always get 0.
- Returns a numeric value.
- The first second starts at 0.
</pre>

---

<pre>
TimeManager.checkSeason()

- Checks the current season based on what month it currently is.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- 1 means Spring.
- 2 means Summer.
- 3 means Autumn.
- 4 means Winter.
</pre>

---

<pre>
TimeManager.checkWeekdayType()

- Checks the current weekday type based on what weekday it currently is.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- 1 means Weekday.
- 2 means Weekend.
</pre>

---

<pre>
TimeManager.checkDayCycle()

- Checks the current day cycle based on what hour it currently is.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- 1 means Dawn.
- 2 means Day.
- 3 means Dusk.
- 4 means Night.
</pre>

---

<pre>
TimeManager.forceRefreshHUD()

- For the moment you need force the HUD to refresh.
- Does not happen if you're not on the map and/or not using the HUD.

</pre>

---

== Plugin Parameters ==

=== Default Settings ===

[[File:DateTimeSystem_Preview1.gif]]

These are the default settings for the plugin that determines time type
and time-based screen tones/overlays.

---

Default Settings

[[File:DateTimeSystem_Param1.png]]

Default Map Time Type:
- What do you want to be the default time system?
- Change per map with <Time System: x> notetag.
- None - Time doesn't pass on most maps
- Game - Time passes based on game rules
- Real - Time passes based on real life

[[File:DateTimeSystem_Param2.png]]

Default Map Time Tone:
- Do maps have time-based screen tones/tints?
- Can change with <No Time Tone> or <Time Tone> notetags.

---

=== Game Time General Settings ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param3.png]]

Here are the general settings regarding Game Time.

---

Starting Data:

Start Year:
- What is the number of the starting year?

Start Month:
- What is the number of the starting month?

Start Date:
- What is the number of the starting date?

Start Weekday:
- What is the number of the starting weekday?

Start Hour:
- What is the number of the starting hour?

Start Minute:
- What is the number of the starting minute?

---

Game Time Mechanics:

MS Per Game Minute:
- How many milliseconds will count as a game minute?
- 1000 milliseconds = 1 real life second.

Minutes in an Hour:
- How many minutes are there in an hour?
- This is for Game Time only.

Round Minutes to 10s:
- Rounds the displayed minutes to 10's so they only visually update every
10 Game Time minutes.

Hours in a Day:
- How many hours are there in a day? This is for Game Time only.

JS: Check Leap Year:
- Code used to determine how a year is considered a leap year.

---

Pause Conditions:

If Event Running:
- Pauses Game Time update if an event is running?
- Doesn't apply to Parallels. Applies to Autorun.

If Forced Player Move:
- Pauses Game Time update if player movement is forced?
- Doesn't apply to Parallels. Applies to Autorun.

If Gather Followers:
- Pauses Game Time update if followers are gathering?
- Doesn't apply to Parallels. Applies to Autorun.

If Vehicle Entry/Exit:
- Pauses Game Time update if followers are gathering?
- Doesn't apply to Parallels. Applies to Autorun.

---

Month Structure:

List of Months:
- Here, adjust the in-game months for Game Time.
- Months will occur in the order they're in.

Name:
- What is the name of the month?

Abbreviation:
- What is the abbreviation of this month?

Total Days:
- How many days are there in this month?

Leap Month?:
- Is this month a leap month?
- It'll get an extra day each leap year.

Season:
- What season is this month a part of?
- Spring
- Summer
- Autumn
- Winter

---

Weekday Structure:

List of Weekdays:
- Here, adjust the in-game weekdays for Game Time.
- Weekdays will occur in the order they're in.

Name:
- What is the name of this weekday?

Abbreviation:
- What is the abbreviation of this weekday?

Weekday Type:
- Is this day part of the weekdays or weekend?
- Weekday
- Weekend

---

Day Structure:

Dawn Hours:
- What hours are considered "Dawn" hours?
- This is for Game Time only.

Day Hours:
- What hours are considered "Day" hours?
- This is for Game Time only.

Dusk Hours:
- What hours are considered "Dusk" hours?
- This is for Game Time only.

Night Hours:
- What hours are considered "Night" hours?
- This is for Game Time only.

---

=== Game Time Tone Settings ===

[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_Param4.png]]

These settings determine the screen tones used for Game Time and will occur
the order the hours appear.

---

Tone Settings

Tone:
- What tone/tint is used for various Game Time hours?
- Format: [Red, Green, Blue, Gray]. Starts at 0:00.

---

=== Game Time Overlay Settings ===

[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_Param5.png]]

These settings determine the screen tones used for Game Time and will occur
the order the hours appear.

Requires VisuMZ_2_LightingEffects!

---

Overlay Settings

Overlay:
- What overlay is used for this hour? Starts at 0:00.
- Format: #rrggbb.
- Requires VisuMZ_2_LightingEffects!

---

=== Game Time Variables & Switches ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param6.png]]

Adjust the variables and switches that record data here. These will be
automatically updated upon time changes.

Changing these variables' values does not mean the Game Time will be
changed in-game. These variables are just for automatically reading what
the Game Time is. If you wish to change the Game Time, you will need to use
the Plugin Commands "Change Date To" and "Change Time To" instead.

---

Calendar:

Year Variable:
- Select a variable to record the year.
- Leave at 0 to not use.

Month Variable:
- Select a variable to record the month.
- Leave at 0 to not use.

Date Variable:
- Select a variable to record the date.
- Leave at 0 to not use.

Full Date Variable:
- Select a variable to record the full date.
- Leave at 0 to not use.
- Result is year + month (2 digits) + date (2 digits)
- For example, Year 2, Month 4, Date 12 will yield 20412

---

Weekday:

Weekday Variable:
- Select a variable to record the weekday.
- Leave at 0 to not use.

---

Time:

Hour Variable:
- Select a variable to record the hour.
- Leave at 0 to not use.

Minute Variable:
- Select a variable to record the minute.
- Leave at 0 to not use.

Second Variable:
- Select a variable to record the second.
- Leave at 0 to not use.
- Not available for Game Time.

Full Time Variable:
- Select a variable to record the full time.
- Leave at 0 to not use.
- Result is hour + minutes (2 digits) + seconds (2 digits)
- For example, Hour 16, Minute 8, Seconds 0 will yield 160800

---

Seasons:

Spring Switch:
- Turns on when season is a "Spring" month.
- Leave at 0 to not use.

Summer Switch:
- Turns on when season is a "Summer" month.
- Leave at 0 to not use.

Autumn Switch:
- Turns on when season is a "Autumn" month.
- Leave at 0 to not use.

Winter Switch:
- Turns on when season is a "Winter" month.
- Leave at 0 to not use.

---

Days:

Weekday Switch:
- Turns on when day is "Weekday". Leave at 0 to not use.

Weekend Switch:
- Turns on when day is "Weekend". Leave at 0 to not use.

---

Hours:

Dawn Switch:
- Turns on when time is "Dawn" hours. Leave at 0 to not use.

Day Switch:
- Turns on when time is "Day" hours. Leave at 0 to not use.

Dusk Switch:
- Turns on when time is "Dusk" hours. Leave at 0 to not use.

Night Switch:
- Turns on when time is "Night" hours. Leave at 0 to not use.

---

=== Game Time Vocabulary Settings ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param7.png]]

Here are the vocabulary-related terms involving Game Time.

---

Seasons:

Spring:
- How "Spring" is displayed.

Summer:
- How "Summer" is displayed.

Autumn:
- How "Autumn" is displayed.

Winter:
- How "Winter" is displayed.

---

Weekday Type:

Weekday:
- How "Weekday" is displayed.

Weekend:
- how "Weekend" is displayed.

---

Time-Related:

Meridiem:

Ante Meridiem:
- How "Ante Meridiem" is displayed.

Post Meridiem:
- How "Post Meridiem" is displayed.

---

Day Cycle:

Dawn:
- How "Dawn" is displayed.

Day:
- How "Day" is displayed.

Dusk:
- How "Dusk" is displayed.

Night:
- How "Night" is displayed.

---

=== Real Time General Settings ===

[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_Param8.png]]

Here are the general settings regarding Real Time.

---

Seasonal Months:

Spring Months:
- Which Real Time months are Spring months for this game?

Summer Months:
- Which Real Time months are Summer months for this game?

Autumn Months:
- Which Real Time months are Autumn months for this game?

Winter Months:
- Which Real Time months are Winter months for this game?

---

Week Structure:

Weekdays:
- Which Real Time weekdays are considered "Weekdays"?

Weekends:
- Which Real Time weekdays are considered "Weekends"?

---

Day Structure:

Dawn Hours:
- What hours are considered "Dawn" hours?
- Use military time.

Day Hours:
- What hours are considered "Day" hours?
- Use military time.

Dusk Hours:
- What hours are considered "Dusk" hours?
- Use military time.

Night Hours:
- What hours are considered "Night" hours?
- Use military time.

---

VisuMZ_1_SaveCore:

Difference Variable:
- Select a variable that records the time difference from the last save
game and the current load game in minutes.

---

=== Real Time Tones & Overlay Settings ===

[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_Param9.png]]

Adjust the tones and overlay settings to change what color the screen will
appear based on the time of day.

---

Screen Tones/Tints

00:00 / 12 AM to 23:00 / 11 PM:
- What tone/tint is used for this hour?
- Format: [Red, Green, Blue, Gray]

---

Screen Overlay

00:00 / 12 AM to 23:00 / 11 PM:
- What overlay is used for this hour?
- Format: #rrggbb.
- Requires VisuMZ_2_LightingEffects!

---

=== Real Time Variables & Switches ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param10.png]]

Adjust the variables and switches that record data here. These will be
automatically updated upon time changes.

Changing these variables' values does not mean the Real Time will be
changed in-game. These variables are just for automatically reading what
the Real Time is. Real Time value cannot be changed by the plugin.

---

Calendar:

Year Variable:
- Select a variable to record the year.
- Leave at 0 to not use.

Month Variable:
- Select a variable to record the month.
- Leave at 0 to not use.

Date Variable:
- Select a variable to record the date.
- Leave at 0 to not use.

Full Date Variable:
- Select a variable to record the full date.
- Leave at 0 to not use.
- Result is year + month (2 digits) + date (2 digits)
- For example, Year 2, Month 4, Date 12 will yield 20412

---

Weekday:

Weekday Variable:
- Select a variable to record the weekday.
- Leave at 0 to not use.

---

Time:

Hour Variable:
- Select a variable to record the hour.
- Leave at 0 to not use.

Minute Variable:
- Select a variable to record the minute.
- Leave at 0 to not use.

Second Variable:
- Select a variable to record the second.
- Leave at 0 to not use.
- Not available for Game Time.

Full Time Variable:
- Select a variable to record the full time.
- Leave at 0 to not use.
- Result is hour + minutes (2 digits) + seconds (2 digits)
- For example, Hour 16, Minute 8, Seconds 0 will yield 160800

---

Seasons:

Spring Switch:
- Turns on when season is a "Spring" month.
- Leave at 0 to not use.

Summer Switch:
- Turns on when season is a "Summer" month.
- Leave at 0 to not use.

Autumn Switch:
- Turns on when season is a "Autumn" month.
- Leave at 0 to not use.

Winter Switch:
- Turns on when season is a "Winter" month.
- Leave at 0 to not use.

---

Days:

Weekday Switch:
- Turns on when day is "Weekday". Leave at 0 to not use.

Weekend Switch:
- Turns on when day is "Weekend". Leave at 0 to not use.

---

Hours:

Dawn Switch:
- Turns on when time is "Dawn" hours. Leave at 0 to not use.

Day Switch:
- Turns on when time is "Day" hours. Leave at 0 to not use.

Dusk Switch:
- Turns on when time is "Dusk" hours. Leave at 0 to not use.

Night Switch:
- Turns on when time is "Night" hours. Leave at 0 to not use.

---

=== Real Time Vocabulary Settings ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param11.png]]

Here are the vocabulary-related terms involving Real Time.

---

Month Names:

Full Names:

Month 1 to 12:
- Name of this month.

Abbreviations:

Month 1 to 12:
- Abbreviation of this month.

---

Seasons:

Spring:
Summer:
Autumn:
Winter:
- How this season is displayed.

---

Weekday Names:

Full Names:

Weekday 1 to Weekday 7:
- Name of this weekday.

Abbreviation:

Weekday 1 to Weekday 7:
- Abbreviation of this weekday.

Weekday Type:

Weekday:
Weekend:
- How "Weekday/end" is displayed.

---

Time-Related:

Meridiem:

Ante Meridiem:
Post Meridiem:
- How "Ante/Post Meridiem" is displayed.

Day Cycle:

Dawn:
Day:
Dusk:
Night:
- How "Dawn", "Day", "Dusk", "Night" is displayed.

---

=== Date/Time HUD Sprites ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param12.png]]

These settings let you adjust the HUD sprites displayed for this plugin.

---

General:

Enabled?:
- Enables usage of the Date/Time HUD.

Show by Default:
- Sets up default visibility of the Date/Time HUD.
- Individual maps can be adjusted by notetags.

Opacity Speed:
- How fast does fade in/out work?
- Lower is slower. Higher is faster.

---

Position:

Position X:
- How much to position the HUD's X by.
- Negative: left. Positive: right.

Position Y:
- How much to position the HUD's Y by.
- Negative: up. Positive: down.

---

Season Sprite:

Enabled?:
- Enables usage of this sprite.

Opacity:
- What is the default opacity for this sprite?
- Use a value between 0 and 255.

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

Scale:

Scale X:
- What is the scale used for this sprite icon's X?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Scale Y:
- What is the scale used for this sprite icon's Y?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Icons:

Spring Icon:
Summer Icon:
Autumn Icon:
Winter Icon:
- What icon is used for this months?
- Ignore if there is an image equivalent.

Images:

Spring Image:
Summer Image:
Autumn Image:
Winter Image:
- What image is used for spring months?
- Ignores any icon equivalents.

---

DayCycle Sprite:

Enabled?:
- Enables usage of this sprite.

Opacity:
- What is the default opacity for this sprite?
- Use a value between 0 and 255.

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

Scale:

Scale X:
- What is the scale used for this sprite icon's X?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Scale Y:
- What is the scale used for this sprite icon's Y?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Icons:

Dawn Icon:
Day Icon:
Dusk Icon:
Night Icon:
- What icon is used for these day cycle hours?
- Ignore if there is an image equivalent.

Images:

Dawn Image:
Day Image:
Dusk Image:
Night Image:
- What image is used for these day cycle hours?
- Ignores any icon equivalents.

---

Weekday Type Sprite:

Enabled?:
- Enables usage of this sprite.

Opacity:
- What is the default opacity for this sprite?
- Use a value between 0 and 255.

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

Scale:

Scale X:
- What is the scale used for this sprite icon's X?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Scale Y:
- What is the scale used for this sprite icon's Y?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Icons:

Weekday Icon:
Weekend Icon:
- What icon is used for weekdays?
- Ignore if there is an image equivalent.

Images:

Weekday Image:
Weekend Image:
- What image is used for weekdays?
- Ignores any icon equivalents.

---

Year Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Year Format:
- How is the year written when it's less than 4 digits?
- %1 - Current Year

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

Month Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

Date Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

Weekday Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

Time Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

=== Date/Time HUD Options Settings ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param13.png]]

Options settings for the Date & Time System.

---

Options:

Add Option?:
- Add the 'Date Time HUD' option to the Options menu?

Adjust Window Height:
- Automatically adjust the options window height?

Option Name:
- Command name of the option.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella
* [[Irina]]
* [[Arisu]]
* [[Olivia]]
* [[Yanfly]]

== Changelog ==

Version 1.07: April 20, 2026
* Bug Fixes!
** Loading a previous save would yield any potential time changes from any action committed afterwards that weren't saved. This should be fixed now. Fix made by Arisu.

Version 1.06: September 18, 2025
* Bug Fixes!
** Fixed a bug where manual game time updates made by Plugin Commands would not allow variables to update if Game Time was paused. Fix made by Arisu.

Version 1.05: August 14, 2025
* Documentation Update!
** Added warning to these Plugin Commands:
*** Game Time: Record to Variable(s)
*** Real Time: Record to Variable(s)
**** Does NOT overwrite automatic variables used in Plugin Parameters.
** Added segment to Plugin Parameters: Game Time Variables & Switches
*** Changing these variables' values does not mean the Game Time will be changed in-game. These variables are just for automatically reading what the Game Time is. If you wish to change the Game Time, you will need to use the Plugin Commands "Change Date To" and "Change Time To" instead.
** Added segment to Plugin Parameters: Real Time Variables & Switches
*** Changing these variables' values does not mean the Real Time will be changed in-game. These variables are just for automatically reading what the Real Time is. Real Time value cannot be changed by the plugin.

Version 1.04: November 14, 2024
* Bug Fixes!
** Fixed a bug where turns were added to each state without using any of the notetag effects. Fix made by Olivia.

Version 1.03: May 16, 2024
* Bug Fixes!
** Fixed a bug where the Winter switch would turn on during summer. Fix made by Irina.

Version 1.02: April 18, 2024
* Bug Fixes!
** Fixed a bug where "Show by Default" plugin parameter did not register. Fix made by Olivia.
* Feature Update!
** Default option state for the Date & Time HUD will be true for those not using the Options Core. Update by Olivia.

Version 1.01: February 15, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash when using Real Time and skip title. Fix made by Irina.
** Fixed a bug where seasonal tilesets could cause a crash. Fix by Irina.

Version 1.00 Official Release Date: February 19, 2024
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wanderlust Volume 2]]

== End of Helpfile ==

|}








[[Category: RPG Maker MZ Gameplay Plugins]]



[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]

Battle System - OTB VisuStella MZ

2026-04-19T11:40:32Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=ASwfGzpyznQ</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/990013" width="552" height="167"><a href="https://visustellamz.itch.io/battle-system-otb">Battle System - OTB plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 8}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:BattleSysOTB_Ani.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:BattleSysOTB_Preview.png|600px]]

This plugin changes the RPG Maker MZ battle system to "Order Turn Battle",
a turn-based battle system where actions are executed immediately and the
orders for both the current and next turn are not only visible, but also
malleable. New mechanics are introduced where the player can manipulate the
turn order of an action's user or action's target in various ways they want.

The two Turn Orders are displayed at the top of the top of the screen to
give the player a clear understanding of who's turn it will be when it
becomes time to act, making it easier and viable for the player to formulate
strategies and adapt to the situation in battle.

*NOTE* To use this battle system, you will need the updated version of
VisuStella's Core Engine. Go into its Plugin Parameters and change the
"Battle System" plugin parameter to "otb".

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

* Utilizes the balanced AGI nature of the Default Turn Battle system.
* Allows for actions to execute immediately upon selection.
* Two Turn Order Displays appear at the top of the screen, giving the player an idea of who's turn it will be and when, for both the current turn and the next turn.
* Skills and Items can have an "Instant Use" effect, which allows them to perform an action immediately without using up a turn.
* Skills and Items can manipulate the turn order of the action's user or the action's target(s). This can apply to either the current turn or the next turn, depending on the notetags and/or action effects used.
* The Turn Order Display will give a preview on how turn orders will change upon specific skills and/or items being used.

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

=== Turn Order Displays ===

The Two Turn Order Displays will capture the battle's current and next turn
orders determined by the BattleManager. This feature does not overwrite any
functions, but the Turn Order Displays may or may not conflict with any
existing HUD elements that are already positioned on the screen. If so, you
can choose to offset the Turn Order Display or move it to a different part
of the screen through the plugin parameters.

---

=== Agility ===

Agility behaves slightly different from normal when it comes to the Order
Turn Battle system. Aside from the first turn in battle, agility will always
calculate the turn order for the "Next Turn" when conducted. This means that
any changes to agility values will not have any effect on the next turn's
already established turn order.

However, this can be remedied by utilizing the notetags provided by this
plugin to alter the Next Turn orders for specific targets. In fact, for
skill and item "effects" that add AGI Buffs and/or Debuffs, the target's
turn position on the Turn Order Display will be manipulated in accordance.
This auto-conversion feature can be disabled in the Plugin Parameters.

---

=== Action Speed ===

[[File:BattleSysOTB_TurnOrderChange.png]]

Because the Order Turn Battle system already calculates agility speeds
before selecting an action to perform, the effects of the action speed will
not work the same way it did with the default battle system. Instead, the
Action Speed will be sent through a formula to determine its effect on the
following turn, either pushing the user ahead in next turn's turn order
(with a positive speed value) or back (with a negative speed value).

This option can have its formula altered or straight up disabled in the
Plugin Parameters.

---

=== Infinity Speed and Clamping ===

Since Action Speeds are decided in such a way, enemies that will survive a
stun state past two turns will have "Infinity" speed on the recovery turn,
allowing them to act first relative to the rest of the battle participants
in order to balance out the turns they've lost.

Enemies with "Infinity" speed cannot be overtaken through turn order
manipulation while they are on the "Next Turn" order. If anything, battlers
who shift their turn order faster will be just trailing behind them, thus
the "clamping" effect. However if this occurs during the "Current Turn"
order, all is fair game and any battler can overtake them. Plan out your
battle system effects carefully with these rules in mind.

If you do not like the idea of Infinity Speed and/or Clamping, you can turn
them off in the Plugin Parameters.

This effect does not affect stun states that last only one turn. The effect
will only occur with stun states that last 2 turns or more.

---

=== Instant Use ===

Skills and Items can have an "Instant Use" property which allows them to be
used immediately without consuming a turn. This can be used for actions that
otherwise do not warrant a whole turn. These can be used for minor buffs,
debuffs, toggles, etc.

---

=== Force Actions ===

Due to how OTB behaves, Force Actions have be adjusted to fit the battle
system. With other battle systems, force actions are added into a hidden
queue that would act upon after the current battler finishes his/her current
action. The new changes made with force actions is that they now appear on
the queue visibly.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Party System VisuStella MZ]]

In battle, the player cannot change entire parties at once from the Party
Command Window. The feature will be unaccessible while Order Turn Battle is
in play. However, the player can still change party members through the
Actor Command Window by having actors replace other actors. Party changing
is also available through battle events, Common Events, and script calls.

---

{{Notetags MZ}}

{{VisuMZ Battle System OTB Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Battle System OTB Plugin Commands}}

== Script Calls ==

The following are Script Calls that can be used with this plugin. These are
made for JavaScript proficient users. We are not responsible if you use them
incorrectly or for unintended usage.

---

=== Add Action-Related Script Calls ===

---

<pre>
$otbAddBattlerToCurrentTurnEnd(battler, times)

- Adds a battler to current turn's end
- Replace 'battler' with a battler object or target
- Replace 'times' with a number representing the number of actions to add
</pre>

---

<pre>
$otbAddBattlerToNextTurnEnd(battler, times)

- Adds a battler to next turn's end
- Replace 'battler' with a battler object or target
- Replace 'times' with a number representing the number of actions to add
</pre>

---

== Plugin Parameters ==

=== Conversion Settings ===

[[File:BattleSysOTB_TurnOrderChange.png]]

[[File:BattleSysOTB_Params1.png]]

Automatically converts specific mechanics to fit OTB.

---

Buffs

AGI Buff => Current:
- Auto-convert AGI Buff effects for Items/Skills to speed up target's
current Turn Order?

AGI Buff => Next:
- Auto-convert AGI Buff effects for Items/Skills to speed up target's
next Turn Order?

---

Debuffs

AGI Debuff => Current:
- Auto-convert AGI Debuff effects for Items/Skills to slow down target's
current Turn Order?

AGI Debuff => Next:
- Auto-convert AGI Debuff effects for Items/Skills to slow down target's
next Turn Order?

---

States (AGI >= 105%)

Add State => Current:
- Auto-convert AGI Up States effects for Items/Skills to speed up target's
current Turn Order?

Add State => Next:
- Auto-convert AGI Up States effects for Items/Skills to speed up target's
current Turn Order?

---

States (AGI <= 95%)

Add State => Current:
- Auto-convert AGI Down States effects for Items/Skills to slow down
target's current Turn Order?

Add State => Next:
- Auto-convert AGI Down States effects for Items/Skills to slow down
target's current Turn Order?

---

=== Mechanics Settings ===

[[File:BattleSysOTB_Params2.png]]

Determines the mechanics of Battle System OTB. These range from how Action
Times are handled to speed.

---

[[File:BattleSysOTB_ActionTimes.png]]

Action Times+

Enable Action Times?:
- Enable Action Times+ to have an effect on OTB?

Randomize Order?:
- If enabled, randomize the action order for added actions?

---

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

Speed

Allow Random Speed?:
- Allow speed to be randomized base off the user's AGI?

Post-Stun Infinity?:
- After a 2+ turn stun states, battlers have infinity speed for their
recovery turn.
- Once again, this only applies to stun states that last 2+ turns.

Infinity Clamp?:
- Prevents turn order manipulation from going faster than infinity
speed battlers.

JS: Initial Speed:
- Code used to calculate initial speed at the start of battle.

JS: Speed => Order:
- Code used to calculate how action speeds alter next turn's order.

---

=== Turn Order Display ===

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

[[File:BattleSysOTB_Params3.png]]

Turn Order Display settings used for Battle System OTB. These adjust how the
two visible turn orders appears in-game.

---

General

Display Position:
- Select where the Turn Order will appear on the screen.
- Top
- Bottom

Offset X:
- How much to offset the X coordinate by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset the Y coordinate by.
- Negative: up. Positive: down.

Reposition for Help?:
- If the display position is at the top, reposition the display when the
help window is open?

Offset X:
- Reposition the display's X coordinates by this much when the Help
Window is visible.

Offset Y:
- Reposition the display's Y coordinates by this much when the Help
Window is visible.

Forward Direction:
- Decide on the direction of the Turn Order.
- Left to Right
- Right to Left

Subject Distance:
- How far do you want the currently active battler to distance itself from
the rest of the Turn Order?

Screen Buffer:
- What distance do you want the display to be away from the edge of the
screen by?

---

UI Background

Background Style:
- Select the style you want for the background.
- fill
- gradient
- image
- transparent

Image Filename:
- When using the "image" style, select an image from /img/system/ as the
background image.

Offset X:
- How much do you want to offset the Background Image's X position?

Offset Y:
- How much do you want to offset the Background Image's Y position?

---

UI Text

Font Size:
- The font size used for parameter values.

Active Battler Text:
- Text used to display the active battler.
- This text will always be center aligned.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Current Turn Text:
- Text used to display the current turn.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Next Turn Text:
- Text used to display the next turn.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Text Align:
- Text alignment for the Current and Next Turn texts?
- auto
- left
- center
- right

---

Slots

Width:
- How many pixels wide should the slots be on the Turn Order display?

Height:
- How many pixels tall should the slots be on the Turn Order display?

Preview Scale:
- How much do you want to scale the preview sprites by?
- Use a number between 0 and 1 for the best results.

Offset X:
- How much do you want to offset the Preview Sprites' X position?

Offset Y:
- How much do you want to offset the Preview Sprites' Y position?

Update Frames:
- How many frames should it take for the slots to update their
positions by?

---

Slot Border

Show Border?:
- Show borders for the slot sprites?

Border Thickness:
- How many pixels thick should the colored portion of the border be?

Actors
Enemies

Border Color:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Preview Version:
- A different setting is used for the preview version.

Border Skin:
- Optional. Place a skin on the actor/enemy borders instead of
rendering them?

Preview Version:
- A different setting is used for the preview version.

---

Slot Sprites

Actors

Sprite Type:
- Select the type of sprite used for the actor graphic.
- Face Graphic - Show the actor's face.
- Icon - Show a specified icon.
- Sideview Actor - Show the actor's sideview battler.

Default Icon:
- Which icon do you want to use for actors by default?

Enemies

Sprite Type:
- Select the type of sprite used for the enemy graphic.
- Face Graphic - Show a specified face graphic.
- Icon - Show a specified icon.
- Enemy - Show the enemy's graphic or sideview battler.

Default Face Name:
- Use this default face graphic if there is no specified face.

Default Face Index:
- Use this default face index if there is no specified index.

Default Icon:
- Which icon do you want to use for enemies by default?

Match Hue?:
- Match the hue for enemy battlers?
- Does not apply if there's a sideview battler.

---

Slot Letter

Show Enemy Letter?:
- Show the enemy's letter on the slot sprite?

Font Name:
- The font name used for the text of the Letter.
- Leave empty to use the default game's font.

Font Size:
- The font size used for the text of the Letter.

---

Slot Background

Show Background?:
- Show the background on the slot sprite?

Actors
Enemies

Background Color 1:
Background Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Preview Version:
- A different setting is used for the preview version.

Background Skin:
- Optional. Use a skin for the actor background instead of
rendering them?

Preview Version:
- A different setting is used for the preview version.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.22: April 20, 2026
* Bug Fixes!
** Fixed a bug where any appear mid-battle enemy appearances that occur on a Turn 0 event will not have their indicator sprite disappearing properly. Fix made by Olivia.
** Fixed a bug where reviving or making any enemy appear during end turn will no longer add them to the current turn order, causing visual bugs. Fix made by Olivia. Verison 1.21: March 16, 2026
* Compatibility Update!
** Updated better compatibility for Battle Grid System force action update. Update made by Olivia.

Verison 1.21: March 16, 2026
* Compatibility Update!
** Updated better compatibility for Battle Grid System force action update. Update made by Olivia.

Version 1.20: January 19, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Conversion Settings > States (AGI >= 105%)
*** Parameters > Conversion Settings > States (AGI <= 95%)
**** Added auto-conversion functionality for states with AGI modifiers to automatically manipulate turn orders for current and next.
**** Set this to false to not use.

Version 1.19: November 13, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New script calls added by Olivia:
*** $otbAddBattlerToCurrentTurnEnd(battler, times)
*** $otbAddBattlerToNextTurnEnd(battler, times)
**** Adds actions for target battler to the end of current/next turn.

Version 1.18: May 15, 2025
* Bug Fixes!
** Fixed a bug where adding states with Action Times+ would add too many actions. Fix made by Olivia.

Version 1.17: November 14, 2024
* Bug Fixes!
** Fixed a bug where the <OTB Target Follow Turn: +x> and similar notetags altered the following turn regardless of the presence of the target in current turn order. Fix made by Olivia.

Version 1.16: September 19, 2024
* Compatibility Update!
** Added better compatibility with Auto Skill Triggers. Update by Arisu.

Version 1.15: May 16, 2024
* Feature Update!
** Direct removal of stun states will restore actions for battlers for current turns and follow up turns. Update made by Olivia.

Version 1.14: May 18, 2023
* Bug Fixes!
** Fixed a bug that caused turn order glitches with Action Times+ that aren't at 100% value. Fix made by Olivia.
** Fixed a bug that caused added Action Times+ to not trigger on actors that have already exhausted their current turns if raised due to a state. Fix made by Olivia.

Version 1.13: January 20, 2023
* Bug Fixes!
** Fixed a bug where the Forced Action of a battler is not used properly. Fix made by Arisu.

Version 1.12: December 15, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: August 18, 2022
* Bug Fixes!
** Fixed bugs that caused the OTB Turn Order faces and icons to not change properly for actors and enemies.

Version 1.10: July 7, 2022
* Feature Update!
** When the "Recover All" event command revives a dead unit, that revived unit can gain actions back if all other conditions are met. Update made by Olivia.

Version 1.09: June 2, 2022
* Documentation Update!
** Added "Force Actions" to "Major Updates" section.
*** Due to how OTB behaves, Force Actions have be adjusted to fit the battle system. With other battle systems, force actions are added into a hidden queue that would act upon after the current battler finishes his/her current action. The new changes made with force actions is that they now appear on the queue visibly.
* Bug Fixes!
** Fixed a bug that caused Forced Actions to not work properly while in OTB. Changes made to Forced Actions will now insert new actions at the front of the current action queue. Fix made by Olivia.

Version 1.08: March 10, 2022
* Feature Update!
** OTB Instant Actions should now appear in the turn order in a more sensible fashion. Update made by Olivia.

Version 1.07: February 24, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.06: November 11, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia:
*** <OTB User Add Current Turn Actions: x>
*** <OTB User Add Next Turn Actions: x>
*** <OTB Target Add Current Turn Actions: x>
*** <OTB Target Add Next Turn Actions: x>
**** Adds extra actions for the user/target to perform during the current/next turn.
**** Added actions will go towards the back of the action list.
**** Multi-hit skills/items will trigger this effect multiple times.

Version 1.05: October 28, 2021
* Bug Fixes!
** Turn Order display will no longer appear at differing X and Y positions when using specific battle layouts. Update made by Olivia.

Version 1.04: August 6, 2021
* Bug Fixes!
** Enemies with multiple actions will no longer step forward when it's not their turn. Fix made by Olivia.

Version 1.03: June 25, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.02: April 16, 2021
* Bug Fixes!
** Post-stun infinity clamping should now be adjusted properly for previewing turn order changes.

Version 1.01: April 9, 2021
* Bug Fixes!
** Subsequent battles will properly reset the turn order. Fix by Olivia.

Version 1.00 Official Release Date: April 26, 2021
* Finished Plugin!

== See Also ==

* [[Battle System Differences VisuStella MZ]]
* [[Inspiration Behind Wave 8]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]




[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]

Battle Grid System VisuStella MZ

2026-04-19T11:40:19Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://youtu.be/swoS2bwVj0k</youtube>

|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/2546116" width="552" height="167"><a href="https://visustellamz.itch.io/battle-grid-system">Battle Grid System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Grande Vol 1}}

}}



[[File:BattleGridSystem_Preview1.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:VisuMZ.150.jpg|600px]]

This plugin changes battles to utilize a grid system. The grid will be
composed of nodes for each team and battlers can move amongst them. By being
on top of specific nodes, different strategies can be employed such as
making certain skills available to use while on such nodes or applying
unique passive state effects.

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

* Battles are changed to employ a grid system and places nodes across the battlefield for battlers to position themselves on top of.
* Battlers can move between their team's nodes and give themselves a better position for battle. Battlers cannot move to the opposing team's nodes.
* Ranks and Flanks determine each node's position. Depending on the Rank and Flank a node is on, different properties can be employed.
* Certain skills and items can only be used while standing on top of certain nodes as a new type of usage requirement.
* Skills and items can move the user and/or the targets around on the battle grid in a variety of ways, such as switching or crashing into other battlers and inflicting crash damage.
* Skills and items can have their range restricted to certain Ranks and Flanks declared by notetags.
* Some skills and items can have their range restricted based on the weapon equipped by the user, allow for melee-only targeting or the whole range of the battle field grid.
* Skills and items can directly select which nodes, Ranks, or Flanks to target for attacks or healing.
* Area of Effect notetags allow players to create skills and items that can affect more than one target based on positioning.
* Nodes can give passive state effects while battlers stand on top of them.
* Nodes can house triggers, which are skill actions that will set off once a battler stands on top of that node. Triggers can be used to deal damage, heal battlers, apply status ailments, and more.
* Skills and items can be used to plant passive states and/or action triggers on specific Nodes!
* Some skills and items can have special effects like teleporting to a specific Node, pulling all members of unit towards a specific Node, or even pushing them away.
* The Grid Tactics scene allows players to adjust where they want the party members to start. Let the player decide which nodes to start individual party members on.

== Requirements ==

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

=== Required Plugin List ===

* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Grid System Mechanics ==

This section explains the various changes and new mechanics regarding the
battle grid system.

---

=== Ranks, Flanks, and Nodes ===

[[File:BattleGridSystem_Preview1.png|600px]]

---

Each visually vertical column is called a "Rank". The name is from miliary
usage for rows of soldiers standing side by side, also sometimes known as
"files" or "lines". The numbering starts at the center of the grid going
outward for each team.

Enemy Team Ally Team
4 3 2 1 1 2 3 4
4 3 2 1 1 2 3 4
4 3 2 1 1 2 3 4

---

Each visually horizontal row is called a "Flank". The name is from military
usage to referance the sides of a formation, also sometimes known as the
"wings" of a formation. The number starts at the top of the grid going to
the bottom of the grid.

Enemy Team Ally Team
1 1 1 1 1 1 1 1
2 2 2 2 2 2 2 2
3 3 3 3 3 3 3 3

---

The points at which each Rank and Flank intersects is called a "Node". Every
battler will be positioned on a node and only one battler can be on a node
at any given time.

Enemy Team Ally Team
4,1 3,1 2,1 1,1 1,1 2,1 3,1 4,1
4,2 3,2 2,2 1,2 1,1 2,2 3,2 4,2
4,3 3,3 2,3 1,3 1,3 2,3 3,3 4,3

---

=== Battler Movement ===

[[File:BattleGridSystem_Movement.gif]]

---

==== Actors ====

Actors can use the "Move" command to move to any allowed node based on their
moveset rulings. By default, this means they can only move to adjacent nodes
relative to their current position.

Upon moving via the "Move" command, the command can undergo cooldown where
the actor must wait a set amount of turns before being able to "Move" again.
The cooldown amount can be adjusted through the Plugin Parameters.

Also upon moving via the "Move" command, the actor can also end their turn
immediately. This is an optional command and can be adjusted per actor with
notetags or by default through the Plugin Parameters.

Actors that are charmed, berserk, or on Auto-Battle will not use the "Move"
command. The move command requires the actor to be able to move, too.

---

==== Enemies ====

Enemies do not have a "Move" command and therefore, do not move by default.
Instead, the best way to have enemies move is to create movement Skills and
have their battle AI perform them. These skills are best left as enemy-only
skills that actors do not have access to.

Their accessibility and frequency of use to move skills have no bearing to
and from the nature of movement effects. However, certain effects may stop
the movement effects associated with the skills such as the Battle Core
notetag <Battler Sprite Cannot Move> for enemies.

---

==== Actors and Enemies Stay on Their Sides ====

Actors and enemies will not move onto the nodes belonging to the opposing
unit. This means actors will always be on the rightmost nodes while enemies
will be on the leftmost nodes. They CANNOT cross over into each other's
territory as this plugin does not support that grid gameplay style. The
nodes that belong to each unit's side will stay on those sides. Ownership of
a node's team cannot be switched.

---

=== Movement Features ===

---

==== Switching ====

[[File:BattleGridSystem_Switching.gif]]

If a battler moves onto a node that already has an allied battler on it,
then the two battlers can switch places. The place switching will only occur
if done on the acting battler's own intention or by another ally battler.
Switching can be disabled by Plugin Parameters.

Certain notetags can also prevent a battler from being able to switch such
as the <Battler Sprite Cannot Move> enemy-only notetag available from the
VisuMZ Battle Core.

However! If a battler is dead, regardless of all other notetag properties,
the corpse becomes node-switchable. The reason for this is because it helps
prevent a soft-lock state in which either the player or enemy side cannot
perform actions due to their current node location (think of melee battlers
being stuck behind a wall of corpses loaded on the front row). By being able
to move and switch nodes with corpses, soft lock scenarios can be solved.
This setting can also be adjusted as a Plugin Parameter for those who feel
confident in their ability to design their battles where soft locks are
impossible to happen with.

If the Plugin Parameter is changed to disallow switching with corpses, this
will only apply to corpses that remain visible. Corpses that fade away with
collapse effects will not apply and can still be switched (even though
invisible after).

---

==== Collision ====

[[File:BattleGridSystem_Crashback.gif]]

If a battler uses a skill that moves an opposing battler onto a node with
another opposing battler, then collision occurs. The target opposing battler
that should be knocked back will return to their original position while
both colliding battlers take knockback damage.

---

=== Battle Grid Tactics ===

[[File:BattleGridSystem_Preview2.png|600px]]

---

This is an optional feature.

You can turn on "Battle Grid Tactics" to allow for players to set up the
starting positions of where the individual members of the party will go when
a battle starts.

This adds a new command to the Main Menu, which takes the player to a scene
where they can customize their battle grid tactics layout.

If this feature is not used, then the starting positions of individual party
members will depend on the notetags used to determine their battle starting
ranks and flanks.

---

== Major Changes ==

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

---

=== Sideview Only ===

[[File:BattleGridSystem_Preview1.png|600px]]

If your game is NOT using sideview and you are using the Battle Grid System,
then the plugin will automatically enforce the sideview property. The reason
behind this is because the grid system is specifically made for sideview
visuals and controls. Therefore, it will not work without it.

As such, some visual properties are also changed with this. Battlers will no
longer step forward or backward when it's their turn to actively input a
command. The reason behind this is because it causes a visual discrepancy
with the grid node they're supposed to be standing at. And depending on the
size of the grid node, it may cause confusion as to where the battler is
actually standing. Therefore, the plugin will keep the battlers at their
node location while inputting or performing the start of their actions.

---

=== Max Battle Members ===

[[File:BattleGridSystem_Preview1.png|600px]]

There is a limit to how many battle members you can bring into battle based
off the number of available nodes (Ranks x Flanks). If you have too few,
then the plugin will warn you and then halt the game.

If you are using Battle Grid Tactics, the optional feature to let players
determine where they want the party members to start at, then a maximum of
20 party members can be used in order to match the Plugin Parameter limits.
If the max number becomes more than 20 members, it will be automatically
capped to 20 members.

---

=== Temporary Tactical Formations ===

[[File:BattleGridSystem_Preview2.png|600px]]

Temporary formations are very specific formations that will overwrite what
settings the player has made. These involve specific rank/flank positions
per party member (though some can be automatic). With temporary formations
in play, the player cannot change them outside of battle. However, once in
battle, the positions can be changed through the movement command and/or
action effects.

When a temporary formation is present, menu and battle commands involving
changing party members will be disabled.

Once a temporary formation is disbanded, the player's self-made formation
settings will be returned and the player can readjust tactical formations
once more.

---

== 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]] ===

[[File:VisuMZ.002.jpg|300px|link=Battle Core VisuStella MZ]]

When using the <Battle Commands> class notetag, you can manually position
the "Move" command by inserting "Grid Move" in between <Battle Commands> and
</Battle Commands>.

---

=== [[Aggro Control System VisuStella MZ]] ===

[[File:VisuMZ.025.jpg|300px|link=Aggro Control System VisuStella MZ]]

Certain features of the Battle Grid System are changed to behave slightly
different when there is the presence of a provoker or taunter. These changes
will be explained in the help file.

---

=== VisuStella Battle Systems ===

[[File:VisuMZ.066.jpg|300px|link=Battle System - OTB VisuStella MZ]]

All custom battle systems made by VisuStella MZ are compatible with the
battle grid system and can be used together. However, there are some
restrictions put into play with specific battle systems. More information
will be mentioned in detail in the "VisuStella MZ Compatibility" section
found below.

---

=== [[Party System VisuStella MZ]] ===

[[File:VisuMZ.019.jpg|300px|link=Party System VisuStella MZ]]

When the Party System is used together with the optional Battle Grid Tactics
feature, players can create empty spaces in their party to allow for the
positions of party members to go to specific nodes.

For example, if a party has members in slots 1, 2, and 4 while 3 is empty,
then those party members will go to tactical nodes 1, 2, and 4, instead of
moving 4 up to 3.

This only applies in-game and not through battle test if there are empty
slots in the battle test setup.

---

=== [[Battle AI VisuStella MZ]] ===

[[File:VisuMZ.026.jpg|300px|link=Battle AI VisuStella MZ]]

Certain AI behaviors will change depending on the limitations of what an
action is capable of affecting. The changes all involve factoring only what
is within the range of an action.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

=== [[Aggro Control System VisuStella MZ]] ===

[[File:VisuMZ.025.jpg|300px|link=Aggro Control System VisuStella MZ]]

In battle, if there are Provoke or Taunt targets on the field and an action
that needs target selection is attempted to be used, the Provoke or Taunt
targets must be within valid affected Ranks/Flanks that can be targeted by
the action or else the action can't be used.

Skills that do NOT need to select a target (usually skills with a "Random"
scope or "All" scope) can bypass this as they would normally without the
Battle Grid System.

As such, be careful about designing your skills with restrictive Rank/Flank
targeting that potential softlocks may occur if there are ever any Taunt or
Provoke targets on the field.

In regards to skills that target the highest aggro member, these will target
the highest aggro member within the required Ranks/Flanks made by the skill
as to not further restrict this skill's targeting ability.

---

=== [[Battle System - ATB VisuStella MZ]] ===

[[File:VisuMZ.022.jpg|300px|link=Battle System - ATB VisuStella MZ]]

If the ATB Battle System is currently being used with the active setting,
selecting the "Move" command during another battler's turn will queue up the
system, waiting for the current battler's turn to end before allowing the
inputting actor to move.

---

=== [[Battle System - BTB VisuStella MZ]] ===

[[File:VisuMZ.048.jpg|300px|link=Battle System - BTB VisuStella MZ]]

If the BTB Battle System is currently being used and the movement command
will pass turn, then the move command will be disabled if the actor is under
the effect of "Brave" as it becomes the same case scenario as "Guard".

On that note, during the command input phase, actors under the effect of
"Brave" can select skills and items outside of their required ranks/flanks.
If you wish to disable this, adjust the "Bypass Require Node?" setting in
the "Compatibility Settings" Plugin Parameters.

When the queued actions occur and the required rank/flank node positions
are NOT met, then the actions will be skipped.

---

=== Team-Based Battle Systems ===

[[File:VisuMZ.080.jpg|300px|link=Battle System - ETB VisuStella MZ]]

[[File:VisuMZ.057.jpg|300px|link=Battle System - FTB VisuStella MZ]]

[[File:VisuMZ.086.jpg|300px|link=Battle System - PTB VisuStella MZ]]

[[Battle System - ETB VisuStella MZ]]

[[Battle System - FTB VisuStella MZ]]

[[Battle System - PTB VisuStella MZ]]

If the ETB, FTB, or PTB Battle Systems are being used and the move command
will pass turn, and if no other actors can input for that turn, any
remaining actions will be forfeited for that turn.

---

=== [[Battle System - OTB VisuStella MZ]] ===

[[File:VisuMZ.066.jpg|300px|link=Battle System - OTB VisuStella MZ]]

If the OTB Battle System is being used and the movement command will pass
turn, the turn passing will only apply to the current action. Any follow up
actions on the same turn from that actor can be utilized.

---

=== [[Party System VisuStella MZ]] ===

[[File:VisuMZ.019.jpg|300px|link=Party System VisuStella MZ]]

In battle, the player cannot change entire parties at once from the Party
Command Window. The feature will be unaccessible while Battle Grid System is
in play. However, the player can still change party members through the
Actor Command Window by having actors replace other actors. Party changing
is also available through battle events, Common Events, and script calls.

---

{{Notetags MZ}}

{{VisuMZ Battle Grid System Notetags}}

== Action Sequence - Plugin Commands ==

The following are Plugin Commands that become usable with this plugin.
They can be accessed through the Plugin Command event command and selecting
the VisuMZ_1_BattleCore plugin where they are stored.

---

=== Action Sequences - Grid ===

These Action Sequences are Battle Grid System-related.

---

{{Battle Grid System Action Sequences}}

---

{{Plugin Commands MZ}}

{{VisuMZ Battle Grid System Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:BattleGridSystem_Preview1.png|600px]]

[[File:BattleGridSystem_Params1.png]]

General settings for this plugin including some mechanics.

---

Defaults

Default Grid?:
- Are battles grid-battles by default?
- Use <Grid> and <No Grid> in troop names otherwise.

Movement Duration:
- Default number of frames for movement duration.

User Silent Move?:
- Default setting for silent movement versus visual.
- Applies only to user movement notetag.

Target Silent Move?:
- Default setting for silent movement versus visual.
- Applies only to target movement notetag.

Weapon Range Melee?:
- Make weapon ranges melee by default?
- Only affects actions with <Use Weapon Range> notetag.

---

Crashing

Allow Crash Death?:
- Can battlers die from crashing into one another?

Damage Move Target?:
- Cause damage to the target that's being moved?

Animation ID:
- Play this animation when the effect activates.
- Use 0 to not play an animation.

Damage Crash Target?:
- Cause damage to the target that's moved into?

Animation ID:
- Play this animation when the effect activates.
- Use 0 to not play an animation.

JS: Crash DMG Formula:
- Formula used for calculating Crash Damage.

---

Switching Nodes

Can Dead Switch?:
- Can battlers switch Node positions with dead units?

---

Triggers

Show Popup?:
- Show popups when a battler activates a Trigger?

Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Flash Color:
- Adjust the popup's flash color.
- Format: [red, green, blue, alpha]

Flash Duration:
- What is the frame duration of the flash effect?

---

=== Grid Field Settings ===

[[File:BattleGridSystem_Preview1.png|600px]]

[[File:BattleGridSystem_Params2.png]]

Settings used for the overall grid field.

---

Size

Max Ranks:
- How many ranks are used for each team?
- Max: 10.
- Ranks are formation rows or columns visually.

Max Flanks:
- How many flanks are used for each team?
- Max: 10.
- Ranks are formation sides/wings or rows visually.

---

Field Appearance

Max Horz Distance:
- What is the maximum horizontal distance that the grid field spans across
the screen?
- Auto-shrinks if too big.

Top/Bottom Delta:
- What is the horizontal size difference from top to bottom of the field.
- This adds perspective.

Vertical Distance:
- What is the vertical distance that the grid field spans across the
screen from top to bottom?

Perspective Modifier:
- What is the perspective modifier? This is so that upper point distances
shrink and lower point distances expand.

Space Between:
- How many nodes between each unit's front rank?
- The space gives more room for movement animations.

---

Effects

Blink Input User?:
- Blink the input user for more clarity?

Blink Color:
- Adjust the blinking input color.
- Format: [red, green, blue, alpha]

---

Offsets

Grid Node Offsets:

Offset X:
- Offsets the node x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the node y position.
- Negative: up. Positive: down.

Actor Sprite Offset:

Offset X:
- Offsets the actor x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the actor y position.
- Negative: up. Positive: down.

Enemy Sprite Offset:

Offset X:
- Offsets the enemy x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the enemy y position.
- Negative: up. Positive: down.

---

Outline Filter

Show Outline Filter?:
- Show outline filter for nodes?
- Requires Pixi JS Filters.

Inner Color:
- System hex code color for inner color.
- Format: 0xRRGGBB
- Requires Pixi JS Filters.

Inner Thickness:
- What thickness do you want for inner outline?
- Requires Pixi JS Filters.

Outer Color:
- System hex code color for outer color.
- Format: 0xRRGGBB
- Requires Pixi JS Filters.

Outer Thickness:
- What thickness do you want for outer outline?
- Requires Pixi JS Filters.

---

=== Grid Node Settings ===

[[File:BattleGridSystem_Preview1.png|600px]]

[[File:BattleGridSystem_Params3.png]]

Settings used for specific grid Nodes.

---

Actor Nodes

Filename:
- Filename used for the actor Node image.
- Leave empty if you don't wish to use one.

Generated Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Generated Opacity:
- What is the opacity level of the generated actor node?

Differ Blend Color:
- Blend color used when differentiating nodes.
- Format: [red, green, blue, alpha]

---

Enemy Nodes

Filename:
- Filename used for the enemy Node image.
- Leave empty if you don't wish to use one.

Generated Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Generated Opacity:
- What is the opacity level of the generated enemy node?

Differ Blend Color:
- Blend color used when differentiating nodes.
- Format: [red, green, blue, alpha]

---

Opacity

Opacity Speed:
- Speed at which the opacity changes.

Disabled Opacity:
- Opacity level for disabled nodes.

---

Scale

Scale X:
- Scale X value for the node.

Scale Y:
- Scale Y value for the node.

---

Visibility

Active Blend Color:
- Blend color used by active battler.
- Format: [red, green, blue, alpha]

Global:

Always Visible?:
- Always make all grid Nodes visible?

Any Input?:
- Make all grid Nodes during input phase?

Targeting?:
- Make all grid Nodes during targeting?

Specific:

Inputting Actor?:
- Make inputting actor's grid Node visible?

Selected Target?:
- Make selected target's grid Node visible?

Active Battler?:
- Make active battler/subject's grid Node visible?

Action Target?:
- Make action target's grid Node visible?

---

=== Passive State Settings ===

[[File:BattleGridSystem_NodePassives.gif]]

[[File:BattleGridSystem_Params4.png]]

Settings used for Passive State Nodes.

---

Properties

Show Passive Icons?:
- Show the icons of the passive states attached to a Node?

Cycle Duration:
- How many frames should each icon cycle take?

Blend Mode:
- The blend mode used for these icons.

---

Opacity

Opacity Speed:
- Speed at which the opacity changes.

Fluctuation Maximum:
- Maximum opacity value for fluctuation effect.

Fluctuation Range:
- Fluctuation range of the opacity effect.

Fluctuation Rate:
- Fluctuation rate of the opacity effect.

---

Position

Offset X:
- Offsets the passive icon's x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the passive icon's y position.
- Negative: up. Positive: down.

---

Scale

Scale X:
- Scale X value for the icon.

Scale Y:
- Scale Y value for the icon.

---

=== Trigger Settings ===

[[File:BattleGridSystem_NodeTraps.gif]]

[[File:BattleGridSystem_Params5.png]]

Settings used for Trigger Nodes.

---

Properties

Show Trigger Icons?:
- Show the icons of the trigger actions attached to a Node?

Blend Mode:
- The blend mode used for these icons.

---

Opacity

Opacity Speed:
- Speed at which the opacity changes.

Fluctuation Maximum:
- Maximum opacity value for fluctuation effect.

Fluctuation Range:
- Fluctuation range of the opacity effect.

Fluctuation Rate:
- Fluctuation rate of the opacity effect.

---

Position

Offset X:
- Offsets the trigger icon's x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the trigger icon's y position.
- Negative: up. Positive: down.

---

Scale

Scale X:
- Scale X value for the icon.

Scale Y:
- Scale Y value for the icon.

---

=== Compatibility Settings ===

Settings used for the Move Command found in Window_ActorCommand. This has
both aesthetic and mechanical settings.

---

Items & Equips Core

Shop Status Window:
- Show grid node target and casting data in Shop Status Window?

Range: Target Node:
- Text used to label target nodes.

Range: Cast Node:
- Text used to label cast nodes.

Scope: Any Node:
Scope: Empty Node:
Scope: Actor Node:
Scope: Enemy Node:
- Text used to label node scopes.

---

Battle System - BTB

Bypass Require Node?:
- During input and under "Brave" effect, ignore rank/flank node
requirements for skills/items?

---

Party System

Removal Shortcut?:
- Add member removal shortcut for Extended Tactics scene?

---

=== Move Command Settings ===

[[File:BattleGridSystem_Movement.gif]]

[[File:BattleGridSystem_Params6.png]]

Settings used for the Move Command found in Window_ActorCommand. This has
both aesthetic and mechanical settings.

---

General

Auto Add "Move"?:
- Automatically add the "Move" command to the actor command window list?

Show "Move" Command?:
- Show the "Move" command in the actor command window list?

Command Icon:
- Icon used for the "Move" command.

Command Name:
- Text used for the "Move" command.

Queue Text:
- Used with Active ATB/TPB to display movement queue.

Command Queue:
- How many turns must the actor wait before moving again?
- If cooldown is 0, move range becomes global.

Grid Switch on Move?:
- Can actors switch Nodes when using the Move Command?

Pass Turn on Move?:
- Makes the actor pass the current turn if the Move Command is used?

Battler Opacity Rate:
- What opacity rate should battlers be adjusted by when the player has to
select a Grid Node

---

Cursor

Enabled:

Blend Mode:
- The blend mode used for an enabled cursor.

Tone Color:
- Adjust the tone color of an enabled cursor.
- Format: [red, green, blue, gray]

Opacity:
- What opacity level should the enabled cursor use?

Disabled:

Blend Mode:
- The blend mode used for an disabled cursor.

Tone Color:
- Adjust the tone color of an disabled cursor.
- Format: [red, green, blue, gray]

Opacity:
- What opacity level should the disabled cursor use?

---

Default Move Range

Global Range?:
- Give actors a global movement range by default?

Disable Range?:
- Disable actor movement ranges by default?

Allowed:

Square:
Radius:
Rank:
Flank:
Diagonal Forward:
Diagonal Backward:
Forward:
Backward:
Upward:
Downward:
- What setting distance is allowed by default?

Not Allowed:

Square:
Radius:
Rank:
Flank:
Diagonal Forward:
Diagonal Backward:
Forward:
Backward:
Upward:
Downward:
- What setting distance is disallowed by default?

---

=== Sound Settings ===

[[File:BattleGridSystem_Movement.gif]]

[[File:BattleGridSystem_Params7.png]]

These settings let you adjust the sound effects used for this plugin.

---

Move Command

Filename:
- Filename of the sound effect played.

Volume:
- Volume of the sound effect played.

Pitch:
- Pitch of the sound effect played.

Pan:
- Pan of the sound effect played.

---

=== Tactics Scene Settings ===

[[File:BattleGridSystem_Preview2.png|600px]]

[[File:BattleGridSystem_Params8.png]]

These settings adjust the Battle Grid Tactics Scene. This is an entirely
optional feature that does not need to be a part of your game. If you want
it, make sure the "Use Tactics System?" parameter is set to "true". If not,
set it to "false".

[[File:BattleGridSystem_ExtendedTactics.png|600px]]

The Extended Tactics scene option allows you to extend the functionality
of the tactics scene beyond just repositioning actors on the grid. If the
Extended Tactics option is enabled, the plugin then allows players to manage
their skills, equipment, and view their status, amongst many other functions
within the Tactics scene itself. Also depending on which plugins are
installed, the Extended Tactics scene will also allow changing classes,
adding and removing party members, and overall quicker access to individual
character submenus.

---

Mechanics Settings

Use Tactics System?:
- Use the battle tactics system?
- If not, actor positions are determined by notetags and algorithms.

Extended System?:
- Use extended scene? Extended scene allows for more actor management
instead of just positioning actors pre-battle.

---

Main Menu

Command Name:
- Name of the 'Battle Tactics' option in the Main Menu.

Show in Main Menu?:
- Add the 'Battle Tactics' option to the Main Menu by default?

Enable in Main Menu?:
- Enable the 'Battle Tactics' option to the Main Menu by default?

---

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.

---

Starting Positions

1st through 20th Member:
- Adjust the settings individually for each party member.

Rank:
- What is the starting rank for this party member?
- Use 0 to let plugin determine starting position.

Flank:
- What is the starting flank for this party member?
- Use 0 to let plugin determine starting position.

---

=== Window Settings ===

[[File:BattleGridSystem_Preview2.png|600px]]

[[File:BattleGridSystem_Params9.png]]

These settings let you adjust the window settings for this plugin.

---

Action Display

Adjust Pixel Radius:
- Adjust the pixel size of each node radius by this much.

Draw Usable Nodes?:
- Draws the nodes that the user can perform an action on.
- This is for general windows.

Usable Color:
Not Usable Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Draw Target Nodes?:
- Draws the nodes that the user can target with the action.
- This is for general windows.

Ally Color:
Enemy Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

---

Window_SkillList

Window_ItemList

Window_ActorCommand

Draw Usable Nodes?:
- Draws the nodes that the user can perform an action on.
- This is for those windows.

Draw Target Nodes?:
- Draws the nodes that the user can target with the action.
- This is for those windows.

---

Tactics Help Window

Background Type:
- Select background type for this window.

Help: Select Actor:
- Help description to tell player to select an actor.

Help: Select Node:

Help: Select Node Ext:
- Extended help description to tell player to select a node.
- Help description to tell player to select a node.

Help: Required Actor:
- Extended help saying which actor is required in party.
- %1 - Party Member's Name

---

Tactics Grid Window

Background Type:
- Select background type for this window.

Graphic Type:
- Choose how the actor graphics appear in tactics menu.
- None
- Face
- Map Sprite
- Sideview Battler

Switching:

Switching BG Color 1:
Switching BG Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Switching Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Party Leader:
- Text used for the tactics banner for the party leader.
- Do not use Text Codes.

Leader Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Party Member:
- Text used for the tactics banner for party member.
- %1 - Party Member Slot ID.
- Do not use Text Codes.

Member Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Empty Node:
- Text used for the tactics banner for empty node.
- Do not use Text Codes.

Empty Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

JS: Draw Empty Node:
- Code used to draw the contents of an empty node.

JS: Draw Actor Node:
- Code used to draw the contents of a node with an actor.

---

Tactics Command Window

Background Type:
- Select background type for this window.

Window Width:
- Width of the Tactics Command Window.

Command Order:
- The order in which tactics commands appear.

Command Settings:

Move:
Party Leader:
Skill:
Equips:
Status:
Class Change:
Swap Member:
Add Member:
Remove Member:

Command Name:
- Determines how this command appears in-game.
- You may use text codes.

Help Description:
- Help description used when this command is selected.

Show Command?:
- Show this command in the Tactics Command Window?
- Some commands may require other plugins.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella
* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.15: April 20, 2026
* Feature Update!
** Changed target selection to prevent unselectable targets via keyboard input only. Vertical selection (up and down) will only target members of that column while horizontal selection (left and right) will snap to the nearest target of the next column. Update made by Olivia.

Version 1.14: March 16, 2026
* Compatibility Update!
** Force Action should now works with skills that target nodes, ranks, and flanks. The skill will select the appropriate node/rank/flank of the target index. Update made by Olivia.

Version 1.13: November 13, 2025
* Bug Fixes!
** Fixed a bug where if VisuMZ_4_BreakShields were turned off from showing in the UI, they would still show up. This requires you to update the plugin parameters for this plugin and can be done in three ways:
*** #1 Method: Select "Window Settings" in the Plugin Parameter list and press "Delete" button on your keyboard. Then open it back up to repopulate it with the default settings. This will reset all of the settings within "Window Settings".
*** #2 Method: Delete the current copy of VisuMZ_2_BattleGridSystem from the Plugin Manager list and install a new copy of VisuMZ_2_BattleGridSystem into the Plugin Manager list. This will reset all your Plugin Parameter settings.
*** #3 Method: Install a fresh copy of VisuMZ_2_BattleGridSystem, copy the Parameters > Window Settings > Tactics Grid Window > JS: Draw Actor Node setting and paste it in your existing copy in the Plugin Manager list.

Version 1.12: August 14, 2025
* Bug Fixes!
** Fixed a bug where cancelling attack and then moving, despite having pass turn on, would still cause the attack to go through. Fix made by Irina.

Version 1.11: May 15, 2025
* Bug Fixes!
** Fixed a bug where certain notetag combinations would cause crashes. Fix made by Arisu.
** Fixed a bug where using aura or miasma effects from Skills & States Core would cause the game to crash if there were not enough battle grid node slots to accommodate all characters, even if they were in the reserve. As a result, aura and miasma effects now only affect battle members.
* Documentation Update!
** Added documentation for <nowiki><Aura Range: type></nowiki> <nowiki><Miasma Range: type></nowiki> notetags
*** Aura/Miasma effects do not affect characters not in active party.

Version 1.10: January 16, 2025
* Bug Fixes!
** Fixed a bug where certain grid node targeting scopes did not work properly. Fix made by Olivia.
* Compatibility Update!
** Added better compatibility with Battle A.I. regarding scopes.

Version 1.09: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia:
*** <nowiki><Aura Range: type></nowiki>
*** <nowiki><Miasma Range: type></nowiki>
**** Used together with <nowiki><Aura State: x></nowiki> and <nowiki><Miasma State: x></nowiki> from VisuMZ_1_SkillsStatesCore!
**** Restricts the range in which the aura/miasma passive is emitted from the user.
**** Read the help file for more information.
* Optimization Update!
** Plugin should run more optimized.

Version 1.08: November 14, 2024
* Compatibility Update!
** Added better compatibility with Main Menu Core's force show/hide and force enable/disable Plugin Commands for Class, Equip, Skills, and Status commands. Update made by Olivia.

Version 1.07: October 17, 2024
* Bug Fixes!
** Fixed a bug where switching positions with dead party members using notetag effects would not move the dead member. Fix made by Olivia.
* Documentation Update!
** Fixed the documentation error for <rule Move User Node direction: x> notetag's "Must Switch Mid" rule explanation.
* Optimization Update!
** Plugin should run more optimized.

Version 1.06: August 29, 2024
* Bug Fixes!
** Fixed a bug where for FTB, ETB, and PTB, movement would always count as passing a turn regardless of Plugin Parameter settings. Fixed by Olivia.
** Fixed a bug where adding a battler mid-battle would cause a crash. Fix made by Olivia.
** Fixed a bug where enemies could ignore grid targeting restrictions. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
** New section added to "Major Changes":
*** Temporary formations are very specific formations that will overwrite what settings the player has made. These involve specific rank/flank positions per party member (though some can be automatic). With temporary formations in play, the player cannot change them outside of battle. However, once in battle, the positions can be changed through the movement command and/or action effects.
*** When a temporary formation is present, menu and battle commands involving changing party members will be disabled.
*** Once a temporary formation is disbanded, the player's self-made formation settings will be returned and the player can readjust tactical formations once more.
* New Features!
** New Plugin Commands added by Olivia:
*** Temp: Create Temporary Tactics (Normal)
**** Creates a temporary tactical formation.
*** Temp: Create Temporary Tactics (JS)
**** Creates a temporary tactical formation with JavaScript.
*** Temp: Disband Temporary Tactics
**** Clears temporary tactical formations.

Version 1.05: July 18, 2024
* Bug Fixes!
** Fixed a bug where actors sharing the same name would cause clashes in how they select same rank/flank targets. Fix made by Olivia.
** Fixed a bug where weapon ranges for same rank/flank would cause crashes at the start of battle. Fix made by Olivia.
** Fixed bugs with AOE targeting for 'Upward', 'Downward', 'Forward', 'Backward', 'Diagonal Forward', and 'Diagonal Backward' being inverted. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Fixed a documentation bug where there is a 'Can' effect for self movement examples that actually doesn't exist.
* New Features!
** New notetags added by Olivia:
*** <Crash Self Damage Rate: x%>
*** <Crash Target Damage Rate: x%>
**** Alters the crash damage received by a percentile rate. Self refers to the moved enemy. Target refers to the enemy crashed into.
**** Example Usage: Rubber enemies have lower crash self damage.
**** Example Usage: Fluffy enemies have lower crash target damage.
*** <Crash Self Damage Bonus: +x>
*** <Crash Self Damage Bonus: -x>
*** <Crash Target Damage Bonus: +x>
*** <Crash Target Damage Bonus: -x>
**** Alters the crash damage received by a flat bonus amount. Self refers to the moved enemy. Target refers to the enemy crashed into.
**** Example Usage: Brittle enemies have higher flat bonus target damage.
**** Example Usage: Thorny enemies have higher flat bonus target damage.

Version 1.04: June 13, 2024
* Bug Fixes!
** Crash targets can no longer crash into themselves. Fix made by Olivia.
** Fixed a bug where AoE ranges did not accept the target located in the "center" of an AoE spread. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Passive State Settings > Position > Offset X/Y:
**** Adjusts passive icon's X/Y position.
*** Parameters > Trigger Settings > Position > Offset X/Y:
**** Adjusts trigger icon's X/Y position.
** Extended Tactics Scene:
*** The Extended Tactics scene option allows you to extend the functionality of the tactics scene beyond just repositioning actors on the grid. If the Extended Tactics option is enabled, the plugin then allows players to manage their skills, equipment, and view their status, amongst many other functions within the Tactics scene itself. Also depending on which plugins are installed, the Extended Tactics scene will also allow changing classes, adding and removing party members, and overall quicker access to individual character submenus.
*** With this extended scene comes a lot more new plugin parameters:
**** Parameters > Tactics Scene Settings > Extended System?
**** Parameters > Compatibility Settings > Party System > Removal Shortcut
**** Parameters > Window Settings > Help Window > Help: Select Node Ext
**** Parameters > Window Settings > Help Window > Help: Required Actor
**** Parameters > Window Settings > Tactics Command Window > Many Settings
***** Refer to the help file for more information.

Version 1.03: May 16, 2024
* Bug Fixes!
** Fixed a bug where <Area of Effect> notetags stopped working with regular selection skills.
** Fixed an incompatibility bug with Core Engine's screen repositioning messing up the grid positioning of enemies. This effect will now be disabled when using the battle grid system. Fix made by Irina.
** Fixed a bug where an enemy moving to a node that is previously occupied by a dead enemy could no longer by mouse-clicked on. Fix made by Olivia.
** Fixed a bug where distance between resolution UI and resolution size did not visually match for moving mode. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Action Sequences that target specific nodes for animations can now work with skills and items that target ranks and flanks. Update by Olivia.
** Added gap reduction for skills without visible grids. Update by Irina.
** Better enemy selection control with keyboard. Update by Olivia.
** Items and skills with the "Never" occassion won't show the target/range information in the Window_ShopStatus window anymore. Passives won't show target/range information either. Update by Irina.
** Help Window remains open when selecting a node, rank, or flank in order to remain consistent with selecting enemies and allies. Update by Olivia.
** In Battle Test mode, tactics positions are not used and instead, will use any starting rank/flank settings.
** When node triggers occur at the end of an action, the battle system will now wait for any node trigger animations to complete before continuing.
* New Features!
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Compatibility > Items & Equips Core
**** Shop Status Window
***** Show scope, grid node target and casting data in Shop Status Window?
**** Scope: Actor Node
**** Scope: Enemy Node
***** Vocabulary text used for these new Plugin Parameters.

Version 1.02: April 18, 2024
* Bug Fixes!
** Fixed a bug where nodes without triggers would have a faint line around them. Fix made by Olivia.
** Fixed a bug where displaying healing skills outside the battle scene would cause the game to freeze up. Fix made by Olivia.
** Fixed a bug where starting rank/flanks would not register properly. Fix made by Olivia.
** Fixed a bug where certain weapon range notetags would cause some enemies to not act properly. Fix made by Olivia.
** Fixed a bug where "Damage Crash Target?" was not working properly. Fix made by Olivia.
** Fixed a bug where area of effect notetags did not work properly. Fix made by Olivia.
** Fixed a bug where a crash would occur if a passive state was applied to an enemy node. Fix made by Olivia.
** Fixed a bug where the "Move" command name cannot be changed.
** Fixed a bug where <JS Targets> notetag causes a crash. Fix by Olivia.
** Fixed a bug where self movement would suddenly stop visually animating. Fix made by Olivia.
** Fixed a bug where enemies using grid rank and flank targeting would hit their own allies instead. Fix made by Olivia.
* Compatibility Update!
** Fixed a compatibility update with ETB and PTB causing movement to not work properly. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Fixed some example notetags that weren't working.
** Added extra note to <Add Trigger to Target Node> that it does not affect nodes with any battlers on it and only works on empty nodes.
* Feature Update!
** Items and skills with the "Never" usability occassion type will not show any grid ranges.
** Items and skills with target any or empty nodes are now able to be affected by area of effects.
* New Features!
** New Notetag added by Irina:
*** <Hide Grid Range>
**** Hides the grid target and usability ranges for this item/skill.
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Compatibility > Items & Equips Core
**** Shop Status Window
***** Show scope, grid node target and casting data in Shop Status Window?
**** Range: Target Node
**** Range: Cast Node
**** Scope: Any Node
**** Scope: Empty Node
***** Vocabulary text used for these new Plugin Parameters.

Version 1.01: March 14, 2024
* Bug Fixes!
** Fixed a bug that required the State Tooltips plugin and if it wasn't present, would cause a crash upon using mouse controls. Fix by Irina.
** Fixed a bug where the add trigger to node action sequence did not work properly. Fix made by Olivia.
* Feature Update!
** Movement actor sprite now reflects the actor's offset X and Y settings found in the Battle Core. Update made by Irina.

Version 1.00 Official Release Date: March 29, 2024
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Grande]]
* [[Area of Effect (YEP)]]
* [[Row Formation (YEP)]]

== End of Helpfile ==

|}



[[Category: RPG Maker MZ Battle Plugins]]

[[Category: RPG Maker MZ Skill Plugins]]


[[Category: RPG Maker MZ Gameplay Plugins]]





[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]

Skills and States Core VisuStella MZ

2026-04-19T11:40:07Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=uRde5_XWxkw</youtube>
|link1 = {{VisuStella Wave 1}}
|link2 = {{VisuStella All Waves Collection}}

}}



[[File:SkillsStatesCoreScreen.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{ExtensionPluginsMZ}}
* [[Active Chain Skills VisuStella MZ]]
* [[Anti-Damage Barriers VisuStella MZ]]
* [[Battle System - BTB VisuStella MZ]]
* [[Battle System - ETB VisuStella MZ]]
* [[Battle System - FTB VisuStella MZ]]
* [[Battle System - PTB VisuStella MZ]]
* [[Boost Action VisuStella MZ]]
* [[Challenge System VisuStella MZ]]
* [[Equip Battle Skills VisuStella MZ]]
* [[Equip Passive System VisuStella MZ]]
* [[Equipment Set Bonuses VisuStella MZ]]
* [[Evolution Matrix Skills VisuStella MZ]]
* [[Field Skills VisuStella MZ]]
* [[Input Combo Skills VisuStella MZ]]
* [[Life State Effects VisuStella MZ]]
* [[Limited Skill Uses VisuStella MZ]]
* [[Skill Cooldowns VisuStella MZ]]
* [[Skill Mastery VisuStella MZ]]
* [[State Tooltips VisuStella MZ]]
* [[Visual Gauge Styles VisuStella MZ]]
* [[Visual State Effects VisuStella MZ]]

{{Visustella MZ}}

== Introduction ==

The Skills & States Core plugin extends and builds upon the functionality of
RPG Maker MZ's inherent skill, state, and buff functionalities and allows
game devs to customize its various aspects.

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

* Assigning multiple Skill Types to Skills.
* Making custom Skill Cost Types (such as HP, Gold, and Items).
* Allowing Skill Costs to become percentile-based or dynamic either directly through the Skills themselves or through trait-like notetags.
* Replacing gauges for different classes to display different types of Skill Cost Type resources.
* Hiding/Showing and enabling/disabling skills based on switches, learned skills, and code.
* Setting rulings for states, including if they're cleared upon death, how reapplying the state affects their turn count, and more.
* Allowing states to be categorized and affected by categories, too.
* Displaying turn counts on states drawn in the window or on sprites.
* Manipulation of state, buff, and debuff turns through skill and item effect notetags.
* Create custom damage over time state calculations through notetags.
* Allow database objects to apply passive states to its user.
* Passive states can have conditions before they become active as well.
* Updated Skill Menu Scene layout to fit more modern appearances.
* Added bonus if Items & Equips Core is installed to utilize the Shop Status Window to display skill data inside the Skill Menu.
* Control over various aspects of the Skill Menu Scene.

== Requirements ==

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

{{MZ Tier 1}}

== Major Changes ==

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

---

=== Action End Removal for States ===

[[File:SkillsStatesCore_ActionEndStun.png]]

If your Plugin Parameter settings for "Action End Update" are enabled,
then "Action End" has been updated so that it actually applies per action
used instead of just being at the start of a battler's action set.

However, there are side effects to this: if a state has the "Cannot Move"
restriction along with the "Action End" removal timing, then unsurprisingly,
the state will never wear off because it's now based on actual actions
ending. To offset this and remove confusion, "Action End" auto-removal
timings for states with "Cannot Move" restrictions will be turned into
"Turn End" auto-removal timings while the "Action End Update" is enabled.

This automatic change won't make it behave like an "Action End" removal
timing would, but it's better than completely softlocking a battler.

EXAMPLE:

The new state: "Fiery Blade" will allow the affected battler to deal fire
elemental damage. With Action End, this means for 5 actions, those attacks
will deal fire damage.

This means that if no action is taken, due to a status effect like "Sleep"
or "Stun", then the duration count will not decrease.

On the flip side, if the battler performs multiple actions a turn, then
the duration count drops faster because more actions have been spent.

However, if this "Fiery Blade" state was using Turn End instead, it will
have its duration reduced by 1 each turn, regardless of "Sleep" or "Stun"
states, and regardless of how many actions are performed each turn.

---

=== Buff & Debuff Level Management ===

[[File:SkillsStatesBuffDebuffs.png|600px]]

In RPG Maker MZ, buffs and debuffs when applied to one another will shift
the buff modifier level up or down. This plugin will add an extra change to
the mechanic by making it so that once the buff modifier level reaches a
neutral point, the buff or debuff is removed altogether and resets the buff
and debuff turn counter for better accuracy.

---

=== Skill Costs ===

[[File:SkillsStatesSkillCosts.png|600px]]

In RPG Maker MZ, skill costs used to be hard-coded. Now, all Skill Cost
Types are now moved to the Plugin Parameters, including MP and TP. This
means that from payment to checking for them, it's all done through the
options available.

By default in RPG Maker MZ, displayed skill costs would only display only
one type: TP if available, then MP. If a skill costs both TP and MP, then
only TP was displayed. This plugin changes that aspect by displaying all the
cost types available in order of the Plugin Parameter Skill Cost Types.

By default in RPG Maker MZ, displayed skill costs were only color-coded.
This plugin changes that aspect by displaying the Skill Cost Type's name
alongside the cost. This is to help color-blind players distinguish what
costs a skill has.

---

=== Sprite Gauges ===

[[File:SkillsStatesSpriteGauges.png]]

Sprite Gauges in RPG Maker MZ by default are hard-coded and only work for
HP, MP, TP, and Time (used for ATB). This plugin makes it possible for them
to be customized through the use of Plugin Parameters under the Skill Cost
Types and their related-JavaScript entries.

---

=== State Displays ===

State Displays

To put values onto states and display them separately from the state turns
you can use the following script calls.

battler.getStateDisplay(stateId)
- This returns whatever value is stored for the specified battler under
that specific state value.
- If there is no value to be returned it will return an empty string.

battler.setStateDisplay(stateId, value)
- This sets the display for the battler's specific state to whatever you
declared as the value.
- The value is best used as a number or a string.

battler.clearStateDisplay(stateId)
- This clears the display for the battler's specific state.
- In short, this sets the stored display value to an empty string.

=== Window Functions Moved ===

Some functions found in RPG Maker MZ's default code for Window_StatusBase
and Window_SkillList are now moved to Window_Base to make the functions
available throughout all windows for usage.

---

== Slip Damage Popup Clarification ==

Slip Damage popups only show one popup for HP, MP, and TP each and it is the
grand total of all the states and effects combined regardless of the number
of states and effects on a battler. This is how it is in vanilla RPG Maker
MZ and this is how we intend for it to be with the VisuStella MZ library.

This is NOT a bug!

The reason we are not changing this is because it does not properly relay
information to the player accurately. When multiple popups appear, players
only have roughly a second and a half to calculate it all for any form of
information takeaway. We feel it is better suited for the player's overall
convenience to show a cummulative change and steer the experience towards a
more positive one.

== Passive State Clarification ==

[[File:SkillsStatesCorePassives.png]]

This section will explain various misconceptions regarding passive states.
No, passive states do not work the same way as states code-wise. Yes, they
use the same effects as states mechanically, but there are differences.

{{Skills and States Core Passive States Clarification}}

{{Notetags MZ}}

{{VisuMZ Skills and States Core Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Skills and States Core Plugin Commands}}

== Plugin Parameters ==

=== General Skill Settings ===

[[File:SkillsStatesCoreScreen.png|600px]]

[[File:SkillsStatesCoreParams01.png]]

These Plugin Parameters adjust various aspects of the game regarding skills
from the custom Skill Menu Layout to global custom effects made in code.

---

General

Use Updated Layout:
- Use the Updated Skill Menu Layout provided by this plugin?
- This will automatically enable the Status Window.
- This will override the Core Engine windows settings.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

Skill Type Window

Style:
- How do you wish to draw commands in the Skill Type Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Skill Type Window.

Window Width:
- What is the desired pixel width of this window?
- Default: 240

---

List Window

Columns:
- Number of maximum columns.

---

Shop Status Window

Show in Skill Menu?:
- Show the Shop Status Window in the Skill Menu?
- This is enabled if the Updated Layout is on.

Adjust List Window?:
- Automatically adjust the Skill List Window in the Skill Menu if using
the Shop Status Window?

Background Type:
- Select background type for this window.
- 0 - Window
- 1 - Dim
- 2 - Transparent

JS: X, Y, W, H:
- Code used to determine the dimensions for this Shop Status Window in the
Skill Menu.

---

Skill Types

Hidden Skill Types:
- Insert the ID's of the Skill Types you want hidden from view ingame.

Hidden During Battle:
- Insert the ID's of the Skill Types you want hidden during battle only.

Icon: Normal Type:
- Icon used for normal skill types that aren't assigned any icons.
- To assign icons to skill types, simply insert \I[x] into the
skill type's name in the Database > Types tab.

Icon: Magic Type:
- Icon used for magic skill types that aren't assigned any icons.
- To assign icons to skill types, simply insert \I[x] into the
skill type's name in the Database > Types tab.

Sort: Alphabetical:
- Insert the ID's of Skill Types you want sorted alphabetically.

---

Global JS Effects

JS: Skill Conditions:
- JavaScript code for a global-wide skill condition check.

---

=== Skill Cost Types ===

[[File:SkillsStatesSkillCosts.png|600px]]

[[File:SkillsStatesCoreParams02.png]]

Skill Cost Types are the resources that are used for your skills. These can
range from the default MP and TP resources to the newly added HP, Gold, and
Potion resources.

---

[[File:SkillsStatesCoreParams02a.png]]

Settings

Name:
- A name for this Skill Cost Type.

Icon:
- Icon used for this Skill Cost Type.
- Use 0 for no icon.

Font Color:
- Text Color used to display this cost.
- Use #rrggbb for a hex color.

Font Size:
- Font size used to display this cost.

---

Cost Processing

JS: Cost Calculation:
- Code on how to calculate this resource cost for the skill.

JS: Can Pay Cost?:
- Code on calculating whether or not the user is able to pay the cost.

JS: Paying Cost:
- Code for if met, this is the actual process of paying of the cost.

---

Window Display

JS: Show Cost?:
- Code for determining if the cost is shown or not.

JS: Cost Text:
- Code to determine the text (with Text Code support) used for the
displayed cost.

---

Gauge Display

JS: Maximum Value:
- Code to determine the maximum value used for this Skill Cost resource
for gauges.

JS: Current Value:
- Code to determine the current value used for this Skill Cost resource
for gauges.

JS: Draw Gauge:
- Code to determine how to draw the Skill Cost resource for this
gauge type.

---

=== Skill Toggle Settings ===

[[File:SkillToggle.gif]]

Skill toggles are a new type of skill. They do not perform any actions but
instead, will switch on/off any passive effects the skill has.

Skill Toggles do not take up actions, even in battle. They will not consume
an actor's current turn. A player can toggle multiple skill toggles at a
time.

Skill Toggles require the character to pay the skill cost ONLY when the
skill is toggled from OFF to ON, not when it is toggled ON to OFF.

Enemies are unable to switch Toggle Skills and the passive effects on a
Toggle Skill for an enemy will always be considered ON.

---

Default

Default Toggle:
- What is the default toggle setting for toggle skills?

Toggle Off Animation:
- Play this animation when a skill is toggled off.
- Requires VisuMZ_0_CoreEngine.
- Toggle On animation by default is whatever the skill animation is set to

---

Appearance

Toggle On Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.
- Applies for skill name, not the skill cost

---

Vocabulary

Toggle Type:
- Skill toggle displayed in the status window.

Toggle On:
- Text displayed for a skill that's toggled on

Toggle Off:
- Text displayed for a skill that's toggled off

Off Text Location:
- Where is the [OFF] text located in the skill cost?
- front
- back

---

=== Gauge Settings ===

[[File:SkillsStatesCore_GaugeSettings.png]]

[[File:SkillsStatesCore_GaugeParams.png]]

Settings in regards to how skill cost gauges function and appear.

---

Labels

Font Type:
- Which font type should be used for labels?

Match Label Color:
- Match the label color to the Gauge Color being used?

Match: Gauge # ?:
- Which Gauge Color should be matched?

Preset: Gauge Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Solid Outline:
- Make the label outline a solid black color?

Outline Width:
- What width do you wish to use for your outline?
- Use 0 to not use an outline.

---

Values

Font Type:
- Which font type should be used for values?

Solid Outline:
- Make the value outline a solid black color?

Outline Width:
- What width do you wish to use for your outline?
- Use 0 to not use an outline.

---

=== General State Settings ===

[[File:SkillsStatesCoreColors.png]]

[[File:SkillsStatesCoreParams03.png]]

These are general settings regarding RPG Maker MZ's state-related aspects
from how turns are reapplied to custom code that's ran whenever states are
added, erased, or expired.

---

General

Reapply Rules:
- These are the rules when reapplying states.
- Ignore: State doesn't get added.
- Reset: Turns get reset.
- Greater: Turns take greater value (current vs reset).
- Add: Turns add upon existing turns.

Maximum Turns:
- Maximum number of turns to let states go up to.
- This can be changed with the <Max Turns: x> notetag.

Action End Update:
- States with "Action End" auto-removal will also update turns at the end
of each action instead of all actions.

Turn End on Map:
- Update any state and buff turns on the map after this many steps.
- Use 0 to disable.

---

Turn Display

Show Turns?:
- Display state turns on top of window icons and sprites?

Turn Font Size:
- Font size used for displaying turns.

Offset X:
- Offset the X position of the turn display.

Offset Y:
- Offset the Y position of the turn display.

Turn Font Size:
- Font size used for displaying turns.

Turn Color: Neutral:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Turn Color: Positive:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Turn Color: Negative:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

---

Data Display

Show Data?:
- Display state data on top of window icons and sprites?

Data Font Size:
- Font size used for displaying state data.

Offset X:
- Offset the X position of the state data display.

Offset Y:
- Offset the Y position of the state data display.

---

Global JS Effects

JS: On Add State:
- JavaScript code for a global-wide custom effect whenever a state
is added.

JS: On Erase State:
- JavaScript code for a global-wide custom effect whenever a state
is erased.

JS: On Expire State:
- JavaScript code for a global-wide custom effect whenever a state
has expired.

---

=== General Buff/Debuff Settings ===

[[File:SkillsStatesBuffDebuffs.png|600px]]

[[File:SkillsStatesCoreParams04.png]]

Buffs and debuffs don't count as states by RPG Maker MZ's mechanics, but
they do function close enough for them to be added to this plugin for
adjusting. Change these settings to make buffs and debuffs work to your
game's needs.

---

General

Reapply Rules:
- These are the rules when reapplying buffs/debuffs.
- Ignore: Buff/Debuff doesn't get added.
- Reset: Turns get reset.
- Greater: Turns take greater value (current vs reset).
- Add: Turns add upon existing turns.

Maximum Turns:
- Maximum number of turns to let buffs and debuffs go up to.

---

Stacking

Max Stacks: Buff:
- Maximum number of stacks for buffs.

Max Stacks: Debuff:
- Maximum number of stacks for debuffs.

JS: Buff/Debuff Rate:
- Code to determine how much buffs and debuffs affect parameters.

---

Turn Display

Show Turns?:
- Display buff and debuff turns on top of window icons and sprites?

Turn Font Size:
- Font size used for displaying turns.

Offset X:
- Offset the X position of the turn display.

Offset Y:
- Offset the Y position of the turn display.

Turn Color: Buffs:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Turn Color: Debuffs:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

---

Rate Display

Show Rate?:
- Display buff and debuff rate on top of window icons and sprites?

Rate Font Size:
- Font size used for displaying rate.

Offset X:
- Offset the X position of the rate display.

Offset Y:
- Offset the Y position of the rate display.

---

Global JS Effects

JS: On Add Buff:
- JavaScript code for a global-wide custom effect whenever a
buff is added.

JS: On Add Debuff:
- JavaScript code for a global-wide custom effect whenever a
debuff is added.

JS: On Erase Buff:
- JavaScript code for a global-wide custom effect whenever a
buff is added.

JS: On Erase Debuff:
- JavaScript code for a global-wide custom effect whenever a
debuff is added.

JS: On Expire Buff:
- JavaScript code for a global-wide custom effect whenever a
buff is added.

JS: On Expire Debuff:
- JavaScript code for a global-wide custom effect whenever a
debuff is added.

---

=== Passive State Settings ===

[[File:SkillsStatesCorePassives.png]]

[[File:SkillsStatesCoreParams05.png]]

These Plugin Parameters adjust passive states that can affect all actors and
enemies as well as have global conditions.

{{Skills and States Core Passive States Clarification}}

List

Global Passives:
- A list of passive states to affect actors and enemies.

Actor-Only Passives:
- A list of passive states to affect actors only.

Enemy Passives:
- A list of passive states to affect enemies only.

---

Cache

Switch Refresh?:
- Refresh all battle members when switches are changed in battle?
- This is primarily used for passive state conditions involve parameters
that do not update due to cached data until a refresh occurs.
- If this is on, do not spam Switch changes during battle in order to
prevent lag spikes.

Variable Refresh?:
- Refresh all battle members when variables are changed in battle?
- This is primarily used for passive state conditions involve parameters
that do not update due to cached data until a refresh occurs.
- If this is on, do not spam Variable changes during battle in order to
prevent lag spikes.

---

Global JS Effects

JS: Condition Check:
- JavaScript code for a global-wide passive condition check.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.56: April 20, 2026
* Bug Fixes!
** Fixed a bug where <nowiki><param Buff Turns: +x></nowiki> and <nowiki><param Debuff Turns: +x></nowiki> would cause a crash. Fix made by Olivia.

Version 1.55: March 16, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Toggle></nowiki> notetag:
*** Just like with regular <nowiki><Passive State: x></nowiki> notetag:
*** If you plan on applying a passive state through a skill, it must be through a skill that has been learned by the target and not a skill that is given through a trait.

Version 1.54: December 15, 2025
* Documentation Update!
** Added extra clarity for <nowiki><List Name: name></nowiki> notetag:
*** If used with Battle Core's <nowiki><Command Text: x></nowiki>, the Command Text notetag will take priority in the command window, but the List Name notetag will appear in the skill list.
*** This does not change the display text. If you'd like to change that, use the Battle Core's <nowiki><Display Text: x></nowiki> notetag along with this notetag.

Version 1.53: September 18, 2025
* Bug Fixes!
** Fixed a bug where the "Preset: Gauge Color" Plugin Parameter was not accepting #rrggbb values. Fix made by Arisu.
* Documentation Update!
** Added extra clarity for <nowiki><Passive State: x></nowiki>:
*** If you are using VisuMZ's Equip Battle Skills, know that the notetag <nowiki><Passive State: x></nowiki> will always have the passive state be available no matter if the skill is equipped or not, as long as the skill is learned.
*** If you want the passive state to only appear while the skill is equipped then use the VisuMZ Equip Battle Skills notetag <nowiki><Equip State: x></nowiki> for this effect instead.

Version 1.52: August 14, 2025
* Feature Update!
** Passive States with custom JS conditions should be less prone to infinite loops. Update made by Irina.

Version 1.51: April 17, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Skill Toggle Settings
**** Skill toggles are a new type of skill. They do not perform any actions but instead, will switch on/off any passive effects the skill has.
**** Enemies are unable to switch Toggle Skills and the passive effects on a Toggle Skill for an enemy will always be considered ON.
**** See the help file for more information.
** New Notetags added by Olivia:
*** Skill Toggle Notetags:
**** <nowiki><Toggle></nowiki>
**** <nowiki><Initial Toggle: On/Off></nowiki>
**** <nowiki><Toggle Exclusion Group: key></nowiki>
**** <nowiki><Toggle On Animation: x></nowiki>
**** <nowiki><Toggle Off Animation: x></nowiki>
***** See the help file for more information.

Version 1.50: March 20, 2025
* Documentation Update!
** Changed the description of Plugin Parameter 'Action End Update' to 'Refer to "Major Changes" in Help File for explanation.'
** Added examples of "Action End Update" under "Major Changes"
*** The new state: "Fiery Blade" will allow the affected battler to deal fire elemental damage. With Action End, this means for 5 actions, those attacks will deal fire damage.
*** This means that if no action is taken, due to a status effect like "Sleep" or "Stun", then the duration count will not decrease.
*** On the flip side, if the battler performs multiple actions a turn, then the duration count drops faster because more actions have been spent.
*** However, if this "Fiery Blade" state was using Turn End instead, it will have its duration reduced by 1 each turn, regardless of "Sleep" or "Stun" states, and regardless of how many actions are performed each turn.

Version 1.49: February 20, 2025
* Bug Fixes!
** Fixed a bug where causing a dead battler to refresh afterwards would yield multiple death states on that battler. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

Version 1.48: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** Auras & Miasmas added by Olivia:
*** Auras are a type passive that affects an allied party. Miasmas are a type of passive that affects an opposing party. Auras and Miasmas only need to come from a single source to give an entire party or troop a passive provided that the battler emitting the aura/miasma is alive and in battle.
** New Notetags added by Olivia:
*** <nowiki><Aura State: x></nowiki>
**** Emits an aura that affects the battler's allies and gives each affected member passive state(s) 'x'.
*** <nowiki><Miasma State: x></nowiki>
**** Emits an aura that affects the battler's opponents and gives each affected member passive state(s) 'x'.
*** <nowiki><Not User Aura></nowiki>
**** Prevents the emitting user from being affected by the related aura.
*** <nowiki><Allow Dead Aura></nowiki>
*** <nowiki><Allow Dead Miasma></nowiki>
**** Allows aura/miasma to continue emitting even after the emitting user is in a dead state.
*** <nowiki><Dead Aura Only></nowiki>
*** <nowiki><Dead Miasma Only></nowiki>
**** Allows aura/miasma to only emit if the emitting user is in a dead state
* Optimization Update!
** Plugin should run more optimized.

Version 1.47: August 29, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Arisu:
*** <Bypass State Damage Removal: id/name>
**** When this skill/item is used to attack an enemy with the listed state that would normally have on damage removal (ie Sleep).
**** This can be used for attacks like "Dream Eater" that would prevent waking up a sleeping opponent.
*** <Bypass State Damage Removal as Attacker: id/name>
**** When an attacker with an associated trait object that has this notetag would attack an enemy with the listed state, bypass on damage removal.
**** This can be used for effects like "Sleep Striker" that would prevent the attacker from waking up a sleeping opponent.
*** <Bypass State Damage Removal as Target: id/name>
**** When a target with an associated trait object that has this notetag is attacked as the target with the listed state, bypass on damage removal.
**** This can be used for effects like "Deep Sleep" that would prevent the attacked target from waking up.

Version 1.46: July 18, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Irina:
*** Parameters > Skill Settings > Skill Types > Sort: Alphabetical
**** Insert the ID's of Skill Types you want sorted alphabetically.
** New notetags added by Irina:
*** <ID Sort Priority: x>
**** Used for Scene_Skill.
**** Changes sorting priority by ID for skill to 'x'.
**** Default priority level is '50'.
**** Skills with higher priority values will be sorted higher up on the list while lower values will be lower on the list.

Version 1.45: May 16, 2024
* Bug Fixes!
** Fixed a problem with passive state conditional notetags not working properly. Fix made by Irina.

Version 1.44: April 18, 2024
* Bug Fixes!
** Fixed a bug where passive states would not appear. Fix made by Olivia.
** Fixed a bug where a crash would occur if certain plugins cleared the passive state cache midway through trying to register it. Fix by Olivia.
* Optimization Update!
** Plugin should run more optimized.
** States with lots and lots of text data within their notes will no longer cause FPS drops.

Version 1.43: January 18, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Commands added by Arisu!
*** Skill Cost: Emulate Actor Pay
*** Skill Cost: Emulate Enemy Pay
**** Target actor(s)/enemy(s) emulates paying for skill cost.
*** State Turns: Actor State Turns Change By
*** State Turns: Actor State Turns Change To
*** State Turns: Enemy State Turns Change By
*** State Turns: Enemy State Turns Change To
**** Changes actor(s)/enemy(s) state turns to a specific value/by an amount.
**** Only works on states that can have turns.

Version 1.42: November 16, 2023
* Bug Fixes!
** 'origin' variable was not working properly for <JS On Expire State> JavaScript notetag. Should now be working properly. Fix made by Irina.

Version 1.41: September 14, 2023
* Bug Fixes!
** Fixed a bug that prevented <Max Turns: x> for states from working due to one of the recent updates. Fix made by Arisu.
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Apparently, we never put <Max Turns: x> in the help notetag section. Woops... It's there now.

Version 1.40: August 17, 2023
* Bug Fixes!
** Fixed a bug involving the "Item Cost" skill cost type found in the Plugin Parameters when involving consumable items.
*** If you want to acquire these settings for an already-existing project, do either of the following:
**** Delete the existing VisuMZ_1_SkillsStatesCore.js in the Plugin Manager list and install the newest version.
**** Or create a new project, install VisuMZ_1_SkillsStatesCore.js there, then copy over the "Item Cost" plugin parameters found in the "Skill Cost Types" plugin parameter settings to your current project.

Version 1.39: July 13, 2023
* Feature Update!
** Updated the "Item Cost" skill cost type found in the Plugin Parameters to no longer consume items that are key items or nonconsumable.
*** If you want to acquire these settings for an already-existing project, do either of the following:
**** Delete the existing VisuMZ_1_SkillsStatesCore.js in the Plugin Manager list and install the newest version.
**** Or create a new project, install VisuMZ_1_SkillsStatesCore.js there, then copy over the "Item Cost" plugin parameters found in the "Skill Cost Types" plugin parameter settings to your current project.

Version 1.38: March 16, 2023
* Documentation Update!
** Help file updated for new features.
** Added segment to <Replace x Gauge: type> in documentation:
*** Does not work with 'Item Cost', 'Weapon Cost', or 'Armor Cost'.
* New Features!
** New "Skill Cost Type" and notetags added by Arisu and sponsored by FAQ.
*** <Item Cost: x name>
*** <Weapon Cost: x name>
*** <Armor Cost: x name>
**** The skill will consume items, weapons, and/or armors in order to be used. Even non-consumable items will be consumed.
*** <Item Cost Max/Min: x name>
*** <Weapon Cost Max/Min: x name>
*** <Armor Cost Max/Min: x name>
**** Sets up a maximum/minimum cost for the item, weapon, armor type costs.
*** <Item Cost: x% name>
*** <Weapon Cost: x% name>
*** <Armor Cost: x% name>
**** Alters cost rate of skills that would consume item, weapon, or armor.
*** <Item Cost: +/-x name>
*** <Weapon Cost: +/-x name>
*** <Armor Cost: +/-x name>
**** Alters flat costs of skills that would consume item, weapon, or armor.
*** <Replace Item name1 Cost: name2>
*** <Replace Weapon name1 Cost: name2>
*** <Replace Armor name1 Cost: name2>
**** Replaces item, weapon, or armor to be consumed for another type.
*** Projects with the Skills and States Core already installed will not have this update, but you can copy over the settings from a new project with the following steps:
**** Create a new project. Install Skills and States Core. Open up the new project's 'Skill Cost Types'.
**** Right click the 'Item Cost' option(s) and click copy.
**** Go to the target project's Skills and States Core's 'Skill Cost Types' plugin parameter. Paste the command where you want it to go.
**** Only 'Item Cost' is needed as it encompasses all three types for item, weapon, and armor costs.

Version 1.38: February 16, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.37: January 20, 2023
* Bug Fixes!
** Fixed a bug that caused equipment to unequip if the needed equipment traits came from passive states upon learning new skills. Fix by Irina.

Version 1.36: December 15, 2022
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** When enemies are defeated with their entire party having a state with the <Group Defeat> notetag, then the party will gain EXP, Gold, and Drops before when they wouldn't. Update made by Irina.
* New Features!
** New Plugin Parameter added by Irina!
*** Plugin Parameters > Skill Settings > Skill Type Window > Window Width
**** What is the desired pixel width of this window? Default: 240

Verison 1.35: October 13, 2022
* Feature Update!
** Default values for Passive States > Cache > Switch Refresh? and Variable Refresh? are now set to "false" in order to prevent sudden lag spikes for those who are unfamiliar with how this setting works.
** Update made by Irina.

Version 1.34: September 29, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina and sponsored by AndyL:
*** Plugin Parameters > Gauge Settings
**** These settings allow you to make minor tweaks to how the gauges look ranging from the color used for the labels to the outline types used for the values.

Version 1.33: August 11, 2022
* Bug Fixes!
** Fixed a crash that occurs when performing a custom action sequence without a skill attached to it. Fix made by Olivia.

Version 1.32: June 16, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Passive State Settings > Cache > Switch Refresh?
*** Plugin Parameters > Passive State Settings > Cache > Variable Refresh?
**** Refresh all battle members when switches/variables are changed in battle?
**** This is primarily used for passive state conditions involve parameters that do not update due to cached data until a refresh occurs.
**** If this is on, do not spam Switch/Variable changes during battle in order to prevent lag spikes.

Version 1.31: April 28, 2022
* Bug Fixes!
** Custom Slip Damage JS is now totalled correctly into regular slip damage totals for damage popups. Fix made by Olivia.

Version 1.30: April 14, 2022
* Feature Update!
** Changed the state data removal timing to be after JS notetag effects take place in order for data such as origin data to remain intact. Update made by Irina.

Version 1.29: March 31, 2022
* Bug Fixes!
** Fixed an error with <State x Category Remove: y> not countaing correctly unless the state count matched the exact amount. The notetag effect should work properly now. Fix made by Olivia.

Version 1.28: March 10, 2022
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** <State x Category Remove: y> updated to allow multiple cases in a single notebox. Updated by Arisu.
* New Features!
** New Notetag added by Arisu and sponsored by Archeia!
*** <Remove Other x States>
**** When the state with this notetag is added, remove other 'x' category states from the battler (except for the state being added).
**** Useful for thing state types like stances and forms that there is usually only one active at a time.

Version 1.27: January 27, 2022
* Bug Fixes!
** Custom JS Slip Damage/Healing values should now be recalculated on demand. Fix made by Olivia.

Version 1.26: January 20, 2022
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Conditional Passive Bypass check is now stronger to prevent even more infinite loops from happening. Update made by Olivia.
* New Features!
** New Plugin Parameter added by Olivia:
*** Plugin Parameters > State Settings > General > Turn End on Map
**** Update any state and buff turns on the map after this many steps.
**** Use 0 to disable.

Version 1.25: November 11, 2021
* Bug Fixes!
** Hidden skill notetags should no longer crash upon not detecting actors for learned skills. Fix made by Olivia.

Version 1.24: November 4, 2021
* Documentation Update!
** Added section: "Slip Damage Popup Clarification"
*** Slip Damage popups only show one popup for HP, MP, and TP each and it is the grand total of all the states and effects combined regardless of the number of states and effects on a battler. This is how it is in vanilla RPG Maker MZ and this is how we intend for it to be with the VisuStella MZ library.
*** This is NOT a bug!
*** The reason we are not changing this is because it does not properly relay information to the player accurately. When multiple popups appear, players only have roughly a second and a half to calculate it all for any form of information takeaway. We feel it is better suited for the player's overall convenience to show a cummulative change and steer the experience towards a more positive one.
* Optimization Update!
** Plugin should run more optimized.

Version 1.23: September 17, 2021
* Compatibility Update!
** RPG Maker MZ 1.3.3 compatibility.
*** Updated how gauges are drawn.
*** Skill Cost Types Plugin Parameters need to be updated for those who want the updated gauges. This can be done easily with the following steps:
**** Step 1: Create a new project.
**** Step 2: Install Skills and States Core version 1.23 into it.
**** Step 3: Copy the Plugin Parameter Settings for "Skill Cost Types".
**** Step 4: Return back to your original project.
**** Step 5: Paste Plugin Parameter Settings on top of "Skill Cost Types".

Version 1.22: August 6, 2021
* Documentation Update!
** "Action End Removal for States" under Major Updates is changed to:
*** If your Plugin Parameter settings for "Action End Update" are enabled, then "Action End" has been updated so that it actually applies per action used instead of just being at the start of a battler's action set.
*** However, there are side effects to this: if a state has the "Cannot Move" restriction along with the "Action End" removal timing, then unsurprisingly, the state will never wear off because it's now based on actual actions ending. To offset this and remove confusion, "Action End" auto-removal timings for states with "Cannot Move" restrictions will be turned into "Turn End" auto-removal timings while the "Action End Update" is enabled.
*** This automatic change won't make it behave like an "Action End" removal timing would, but it's better than completely softlocking a battler.
* Feature Update!
** Those using "Cannot Move" states with "Action End" auto-removal will now have be automatically converted into "Turn End" auto-removal if the plugin parameter "Action End Update" is set to true. Update by Irina.

Version 1.21: July 30, 2021
* Documentation Update!
** Expanded "Action End Removal for States" section in Major Changes.
*** These changes have been in effect since Version 1.07 but have not been explained in excess detail in the documentation since.
**** Action End has been updated so that it actually applies per action used instead of just being at the start of a battler's action set. However, there are side effects to this: if a state has the "Cannot Move" restriction along with the "Action End" removal timing, then unsurprisingly, the state will never wear off because it's now based on actual actions ending. There are two solutions to this:
**** Don't make "Cannot Move" restriction states with "Action End". This is not a workaround. This is how the state removal is intended to work under the new change.
**** Go to the Skills & States Core Plugin Parameters, go to State Setttings, look for "Action End Update", and set it to false. You now reverted the removal timing system back to how it originally was in RPG Maker MZ's default battle system where it only updates based on an action set rather than per actual action ending.

Version 1.20: June 18, 2021
* Feature Update!
** Updated automatic caching for conditional passive states to update more efficiently. Update made by Arisu.

Version 1.19: June 4, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.18: May 21, 2021
* Documentation Update
** Added "Passive State Clarification" section.
*** As there is a lot of confusion regarding how passive states work and how people still miss the explanations found in the "Passive State Notetags" section AND the "Plugin Parameters: Passive State Settings", we are adding a third section to explain how they work.
*** All three sections will contain the full detailed explanation of how passive states work to clear common misconceptions about them.

Version 1.17: May 7, 2021
* Bug Fixes
** State category removal is now usable outside of battle. Fix by Irina.

Version 1.16: April 30, 2021
* Bug Fixes!
** When states with step removal have the <No Recover All Clear> or <No Death Clear> notetags, their step counter is no longer reset either. Fix made by Irina.
* New Features!
** New notetag added by Arisu!
*** <List Name: name>
**** Makes the name of the skill appear different when show in the skill list. Using \V[x] as a part of the name will display that variable.

Version 1.15: March 19, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.14: March 12, 2021
* Bug Fixes!
** Max HP Buff/Debuff should now display its turn counter. Fix by Yanfly.
* Documentation Update!
** For the <JS Passive Condition>, we've added documentation on the limitations of passive conditions since they have been reported as bug reports, when in reality, they are failsafes to prevent infinite loops. Such limitations include the following:
*** A passive state that requires another passive state
*** A passive state that requires a trait effect from another state
*** A passive state that requires a parameter value altered by another state
*** A passive state that requires equipment to be worn but its equipment type access is provided by another state.
*** Anything else that is similar in style.

Version 1.13: February 26, 2021
* Documentation Update!
** For <JS type Slip Damage> and <JS type Slip Heal> notetags, added the following notes:
*** When these states are applied via action effects, the slip calculations are one time calculations made upon applying and the damage is cached to be used for future on regeneration calculations.
*** For that reason, do not include game mechanics here such as adding states, buffs, debuffs, etc. as this notetag is meant for calculations only. Use the VisuStella Battle Core's <JS Pre-Regenerate> and <JS Post-Regenerate> notetags for game mechanics instead.
*** Passive states and states with the <JS Slip Refresh> notetag are exempt from the one time calculation and recalculated each regeneration phase.
* Feature Update!
** Changed slip refresh requirements to entail <JS Slip Refresh> notetag for extra clarity. Update made by Olivia.

Version 1.12: February 19, 2021
* Feature Update
** Changed the way passive state infinite stacking as a blanket coverage. Update made by Olivia.

Version 1.11: February 12, 2021
* Bug Fixes!
** Added a check to prevent passive states from infinitely stacking. Fix made by Olivia.

Version 1.10: January 15, 2021
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added
*** Plugin Parameters > Skill Settings > Background Type

Version 1.09: January 1, 2021
* Bug Fixes!
** Custom JS TP slip damage and healing should now work properly. Fix made by Yanfly.

Version 1.08: December 25, 2020
* Bug Fixes!
** <JS On Add State> should no longer trigger multiple times for the death state. Fix made by Yanfly.
* Documentation Update!
** Added documentation for updated feature(s)!
* Feature Update!
** <No Death Clear> can now allow the affected state to be added to an already dead battler. Update made by Yanfly.

Version 1.07: December 18, 2020
* Documentation Update!
** Added documentation for new feature(s)!
* New Features!
** New notetags added by Yanfly:
*** <Passive Condition Multiclass: id>
*** <Passive Condition Multiclass: id, id, id>
*** <Passive Condition Multiclass: name>
*** <Passive Condition Multiclass: name, name, name>
** New Plugin Parameter added by Yanfly.
*** Plugin Parameters > States > General > Action End Update
**** States with "Action End" auto-removal will also update turns at the end of each action instead of all actions.
***** Turn this off if you wish for state turn updates to function like they do by default for "Action End".

Version 1.06: December 4, 2020
* Optimization Update!
** Plugin should run more optimized.

Version 1.05: November 15, 2020
* Bug Fixes!
** The alignment of the Skill Type Window is now fixed and will reflect upon the default settings. Fix made by Yanfly.
* Documentation Update!
** Added documentation for new feature(s)!
* New Features!
** <State x Category Remove: All> notetag added by Yanfly.
* Optimization Update!
** Plugin should run more optimized.

Version 1.04: September 27, 2020
* Documentation Update
** "Use Updated Layout" plugin parameters now have the added clause: "This will override the Core Engine windows settings." to reduce confusion. Added by Irina.

Version 1.03: September 13, 2020
* Bug Fixes!
** <JS type Slip Damage> custom notetags now work for passive states. Fix made by Olivia.
** Setting the Command Window style to "Text Only" will no longer add in the icon text codes. Bug fixed by Yanfly.

Version 1.02: August 30, 2020
* Bug Fixes!
** The JS Notetags for Add, Erase, and Expire states are now fixed. Fix made by Yanfly.
* Documentation Update!
** <Show if learned Skill: x> and <Hide if learned Skill: x> notetags have the following added to their descriptions:
*** This does not apply to skills added by traits on actors, classes, any equipment, or states. These are not considered learned skills. They are considered temporary skills.
* New Features!
** Notetags added by Yanfly:
*** <Show if has Skill: x>
*** <Show if have All Skills: x,x,x>
*** <Show if have Any Skills: x,x,x>
*** <Show if has Skill: name>
*** <Show if have All Skills: name, name, name>
*** <Show if have Any Skills: name, name, name>
*** <Hide if has Skill: x>
*** <Hide if have All Skills: x,x,x>
*** <Hide if have Any Skills: x,x,x>
*** <Hide if has Skill: name>
*** <Hide if have All Skills: name, name, name>
*** <Hide if have Any Skills: name, name, name>
*** These have been added to remove the confusion regarding learned skills as skills added through trait effects are not considered learned skills by RPG Maker MZ.

Version 1.01: August 23, 2020
* Bug Fixes!
** Passive states from Elements & Status Menu Core are now functional. Fix made by Olivia.
* Compatibility Update
** Extended functions to allow for better compatibility.
* Updated documentation
** Explains that passive states are not directly applied and are therefore not affected by code such as "a.isStateAffected(10)".
** Instead, use "a.states().includes($dataStates[10])"
** "Use #rrggbb for a hex color." lines now replaced with "For a hex color, use #rrggbb with VisuMZ_1_MessageCore"

Version 1.00: August 20, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 1]]

== End of File ==

|}


[[Category: RPG Maker MZ Core Plugins]]
[[Category: RPG Maker MZ Battle Plugins]]

[[Category: RPG Maker MZ Skill Plugins]]


[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]


[[Category: RPG Maker MZ Quality of Life Plugins]]

Template:VisuMZ Changelog 141 to 160

2026-04-19T11:39:13Z

Irina:

<noinclude>[[Category:Display templates|VisuMZ Changelog 141 to 160]]</noinclude>






=== April 20, 2026 - Update #160 ===

-

Total Plugins Updated: 11

-

'''Tier 1 (1 Plugin Update)

-

[[Skills and States Core VisuStella MZ]]

Version 1.56: April 20, 2026
* Bug Fixes!
** Fixed a bug where <nowiki><param Buff Turns: +x></nowiki> and <nowiki><param Debuff Turns: +x></nowiki> would cause a crash. Fix made by Olivia.

-

'''Tier 2 (6 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.15: April 20, 2026
* Feature Update!
** Changed target selection to prevent unselectable targets via keyboard input only. Vertical selection (up and down) will only target members of that column while horizontal selection (left and right) will snap to the nearest target of the next column. Update made by Olivia.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.22: April 20, 2026
* Bug Fixes!
** Fixed a bug where any appear mid-battle enemy appearances that occur on a Turn 0 event will not have their indicator sprite disappearing properly. Fix made by Olivia.
** Fixed a bug where reviving or making any enemy appear during end turn will no longer add them to the current turn order, causing visual bugs. Fix made by Olivia. Verison 1.21: March 16, 2026
* Compatibility Update!
** Updated better compatibility for Battle Grid System force action update. Update made by Olivia.

-

[[Date and Time System VisuStella MZ]]

Version 1.07: April 20, 2026
* Bug Fixes!
** Loading a previous save would yield any potential time changes from any action committed afterwards that weren't saved. This should be fixed now. Fix made by Arisu.

-

[[Party System VisuStella MZ]]

Version 1.36: April 20, 2026
* Compatibility Update!
** Added better compatibility for other plugins that add extra commands to the party command window.

-

[[Tutorial Panel System VisuStella MZ]]

Version 1.03: April 20, 2026
* Bug Fixes!
** If the picture used in the tutorial page is too big, it would cover the Button Assist Window. This is now fixed and the picture would appear behind the Button Assist Window if available. Fix made by Irina.
** Previously, when multiple tutorials are shown in battle, there would be a frame or two of flicker between the tutorial images. This should now be fixed. Fix made by Irina.

-

[[Visual Battle Environment VisuStella MZ]]

Version 1.09: April 20, 2026
* Bug Fixes!
** Fixed a bug where upon returning from the options menu or any other similar menu while in battle, any previously removed battle environments would reappear. Fix made by Irina.

-

'''Tier 3 (2 Plugin Updates)

-

[[Auto Skill Triggers VisuStella MZ]]

Version 1.18: April 20, 2026
* Bug Fixes!
** Fixed a bug where battle start auto skill triggers would erase the bonus effects of preemptive and surprise attacks. Fix made by Olivia.

-

[[Message Keywords VisuStella MZ]]

Version 1.07: April 20, 2026
* Compatibility Update!
** Message Keywords now work properly with the Sideview Battle UI. Update made by Irina.

-

'''Tier 4 (2 Plugin Updates)

-

[[Visual Fogs VisuStella MZ]]

Version 1.13: April 20, 2026
* Bug Fixes!
** Fixed a bug where making editor changes to the current map a fog has been placed through plugin command will cause it all to be erased and reset. Fix made by Arisu.
* Documentation Update!
** Added an extra note to Fog: Add/Change Settings.
** Added an extra note to Fog: Fade Opacity.
** Added an extra note to Fog: Remove.
*** This is temporary and will be reset upon re-entering the map.

-

[[Visual Parallaxes VisuStella MZ]]

Version 1.14: April 20, 2026
* Bug Fixes!
** Fixed a bug where making editor changes to the current map a parallax has been placed through plugin command will cause it all to be erased and reset. Fix made by Arisu.
* Documentation Update!
** Added an extra note to Parallax: Add/Change Settings.
** Added an extra note to Parallax: Fade Opacity.
** Added an extra note to Parallax: Remove.
*** This is temporary and will be reset upon re-entering the map.

-







=== March 16, 2026 - Update #159 ===

-

Total Plugins Updated: 6

-

'''Tier 1 (2 Plugin Updates)

-

[[Items and Equips Core VisuStella MZ]]

Version 1.60: March 16, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Parameters > Item Menu Settings > Use Updated Layout > Disabled: Vanilla
**** If NOT using the updated layout, keep all settings to pure vanilla and ignore other Plugin Parameters.
**** Used for those who do not wish to fiddle with the Plugin Parameter settings to return the item menu back to default MZ vanilla.
**** Does not apply if using updated layout.
**** The following settings are disabled if using vanilla:
***** Categories: Only the default 4
***** Category Names only display text and no icons
***** No Shop Status Window
***** Modern Controls Disabled
***** Columns: Any -> 2

-

[[Skills and States Core VisuStella MZ]]

Version 1.55: March 16, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Toggle></nowiki> notetag:
*** Just like with regular <nowiki><Passive State: x></nowiki> notetag:
*** If you plan on applying a passive state through a skill, it must be through a skill that has been learned by the target and not a skill that is given through a trait.

-

'''Tier 2 (3 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.14: March 16, 2026
* Compatibility Update!
** Force Action should now works with skills that target nodes, ranks, and flanks. The skill will select the appropriate node/rank/flank of the target index. Update made by Olivia.

-

[[Battle System - OTB VisuStella MZ]]

Verison 1.21: March 16, 2026
* Compatibility Update!
** Updated better compatibility for Battle Grid System force action update. Update made by Olivia.

-

[[Equip Passive System VisuStella MZ]]

Version 1.06: March 16, 2026
* Bug Fixes!
** Fixed a bug where <nowiki><Learnable Equip Passives></nowiki> notetag was not parsing correctly. Fix made by Arisu.

-

'''Tier 3 (1 Plugin Update)

-

[[Chain Battles VisuStella MZ]]

Version 1.05: March 16, 2026
* Bug Fixes!
** Fixed a bug where EXP and Gold multipliers weren't calculating correctly based on the number of chain battles participated in.

-







=== February 16, 2026 - Update #158 ===

-

Total Plugins Updated: 5

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.90: February 16, 2026
* Feature Update!
** Battle System settings for "TPB Active" and "TPB Wait" will no longer conflict with VisuMZ_2_BattleSystemATB and VisuMZ_1_OptionsCore "Active" or "Wait" mode options set by the player.

-

'''Tier 1 (2 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.90: February 16, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Battle Layout Settings > List Style > Minimum Rows
**** How many rows minimum will the list style go to?
**** This is to prevent the list window from becoming too small.

-

[[Events and Movement Core VisuStella MZ]]

Version 1.63: February 16, 2026
* Feature Update!
** When moving by clicking and holding down the mouse button, the touch input will no longer lock onto any events with empty event lists or populated by just comments. Update made by Arisu.

-

'''Tier 2 (2 Plugin Updates)

-

[[Battle System - ATB VisuStella MZ]]

Version 1.37: February 16, 2026
* Bug Fixes!
** Fixed a bug where potential actions queued during Active ATB might get erased if used during the action of a enemy battler. Fix made by Olivia.

-

[[Battle System - STB VisuStella MZ]]

Version 1.22: February 16, 2026
* Bug Fixes!
** Fixed a bug where <nowiki><STB Cannot Be Exploited></nowiki> and <nowiki><STB Cannot Be Exploiter></nowiki> notetags were not working properly. Bug fixed by Olivia.

-







=== January 19, 2026 - Update #157 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (3 Plugin Updates)

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.31: January 19, 2026
* Bug Fixes!
** Trait sets with "Randomize for Actor?" weren't working properly. Fix made by Arisu.
* Documentation Update!
** Changed "Enemy: Change Trait Sets" Plugin Command parameter from "Target ID" to "Target Index" to reduce confusion. The parameter has always used Index values as per their description.

-

[[Events and Movement Core VisuStella MZ]]

Version 1.62: January 19, 2026
* Documentation Update!
** Help file updated for new features.
** New section added: Reference Switches and Reference Variables

-

[[Message Core VisuStella MZ]]

Version 1.55: January 19, 2026
* Documentation Update!
** \ChangeFace<nowiki><x,y></nowiki> text codegets a note added:
*** This text code is used under the assumption that you are using an existing face graphic to change from (doesn't matter which). The text code will not automatically shift text from no-face graphic to having a face graphic mid-message.

-

'''Tier 2 (3 Plugin Updates)

-

[[Aggro Control System VisuStella MZ]]

Version 1.23: January 19, 2026
* Documentation Update!
** Under "How Aggro, Provoke, and Taunts Work" > Aggro
*** Added this section:
**** The aggro gauge shows the value based on how much aggro that party member has relative to the rest of the party. Sometimes it will appear like the party member's aggro "resets" back to zero, when it fact, that's not what's happening. If that party member's aggro gauge is "empty", that means the aggro for that party member is the lowest of the party. if all party members appear to have their aggro gauge as "full", then that means the aggro for all party members is equal and that everybody is likely targeted for attack.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.20: January 19, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Conversion Settings > States (AGI >= 105%)
*** Parameters > Conversion Settings > States (AGI <= 95%)
**** Added auto-conversion functionality for states with AGI modifiers to automatically manipulate turn orders for current and next.
**** Set this to false to not use.

-

[[Bright Effects VisuStella MZ]]

Version 1.11: January 19, 2026
* Bug Fixes!
** Fixed a bug where entering the Options menu mid-battle will cause the Bright Effects plugin to be cleared. Fix made by Olivia.

-

'''Tier 3 (2 Plugin Updates)

-

[[Item Amplify Skills VisuStella MZ]]

Version 1.04: January 19, 2026
* Bug Fixes!
** Fixed a bug in the code that sets the incorrect defaults for min and max amplifications. Fix made by Arisu.

-

[[Message Keywords VisuStella MZ]]

Version 1.06: January 19, 2026
* Feature Update!
** Display and toggling of Message Keywords only occurs if the Help Window is visible. This is to prevent shortcut clashing with other plugins.

-

'''Tier 4 (1 Plugin Update)

-

[[Visual Item Inventory VisuStella MZ]]

Version 1.08: January 19, 2026
* Compatibility Update!
** When used together with the Battle Grid System, item slots will no longer be covered by the Battle Grid targeting and usage nodes. Update by Arisu.
** When used together with the More Currencies plugin, no longer display the extra currency count on item grid. Update by Arisu.

-







=== December 15, 2025 - Update #156 ===

-

Total Plugins Updated: 12

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.89: December 15, 2025
* Feature Update!
** Added extra failsafes to ensure TPB Charge Time does not become NaN or an illegal value. Update made by Arisu.

-

'''Tier 1 (4 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.89: December 15, 2025
* Bug Fixes!
** Fixed some bugs where translated text through the Message Core would incorrectly calculate the projected text size. Fix made by Irina.
* Feature Update!
** Added extra failsafes to ensure TPB Charge Time does not become NaN or an illegal value. Update made by Arisu.

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.30: December 15, 2025
* Bug Fixes!
** Fixed an incompatibility with TPB and Skills & States Core's Miasma effects, causing some parameters to appear and cache at 0. Fix made by Arisu.

-

[[Events and Movement Core VisuStella MZ]]

Version 1.61: December 15, 2025
* Bug Fixes!
** Fixed a bug where shadows would appear under lower-priority event sprites making usage of certain tiles awkward looking. This is corrected by the new Plugin Parameter. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Parameters > Movement Settings > Shadows > Shadow Z Layer
**** What is the sprite Z layer used for the shadow sprites?
**** By default, this layer will now be 0.5 instead of 0.
* Feature Update!
** If a event is made whose priority is "Below characters" and is a tile object (ie taking a sprite from the map tileset or a character sprite with "!" in front of the name), it will be automatically regulated to a custom Z layer of 0.

-

[[Skills and States Core VisuStella MZ]]

Version 1.54: December 15, 2025
* Documentation Update!
** Added extra clarity for <nowiki><List Name: name></nowiki> notetag:
*** If used with Battle Core's <nowiki><Command Text: x></nowiki>, the Command Text notetag will take priority in the command window, but the List Name notetag will appear in the skill list.
*** This does not change the display text. If you'd like to change that, use the Battle Core's <nowiki><Display Text: x></nowiki> notetag along with this notetag.

-

'''Tier 2 (6 Plugin Updates)

-

[[Aggro Control System VisuStella MZ]]

Version 1.22: December 15, 2025
* Bug Fixes!
** Fixed a bug where battlers can become immune to provoke effects. Fix made by Olivia.

-

[[Battle System - ATB VisuStella MZ]]

Version 1.36: December 15, 2025
* Feature Update!
** Added extra failsafes to ensure TPB Charge Time does not become NaN or an illegal value. Update made by Arisu.

-

[[Battle System - CTB VisuStella MZ]]

Version 1.25: December 15, 2025
* Feature Update!
** Added extra failsafes to ensure TPB Charge Time does not become NaN or an illegal value. Update made by Arisu.

-

[[Class Change System VisuStella MZ]]

Version 1.19: December 15, 2025
* Documentation Update!
** Added extra notes for clarity for the "Show in Menus?" plugin parameter for CP and JP.
*** For extra clarity:
**** Shows up if there is enough room on the screen. Make sure your game's screen resolution is large enough (ie. 1280x720).
**** Shows up in the Skill menu if 'Learn' is selected.
* Compatibility Update!
** Added better preloading functionality for Main Menu Core's options to utilize Map Sprites and SV Battlers for the visual actor graphic.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.22: December 15, 2025
* Documentation Update!
** Help file updated for new features.
* New Plugin Parameters added by Irina:
** Parameters > Scroll Wheel Settings
*** Emulates Eastern Visual Novel controls regarding mouse scroll wheel functionality. If enabled, the scroll wheel can be used to "continue" the current "Show Text" message by scrolling down on the mouse wheel or if the VisuStella MZ Message Log is installed, scrolling up will reveal the message log to show what was previously said.
*** This feature will be temporarily disabled whenever any supporting windows are visible and active, such as the "Show Choice", "Input Number", "Select Item" windows. This is because those windows typically have scroll wheel controls of their own and theirs will take priority. Even if they do not have scroll wheel controls temporarily, the function will remain disabled for control consistency.

-

[[Skill Learn System VisuStella MZ]]

Version 1.18: December 15, 2025
* Documentation Update!
** Added extra notes for clarity for the "Show in Menus?" plugin parameter for AP and SP.
*** For extra clarity:
**** Shows up if there is enough room on the screen. Make sure your game's screen resolution is large enough (ie. 1280x720).
**** Shows up in the Skill menu if 'Learn' is selected.

-

'''Tier 4 (1 Plugin Update)

-

[[Map Camera Zoom VisuStella MZ]]

Version 1.08: December 15, 2025
* Bug Fix!
** Fixed a bug where upon loading a saved game, any scrolling done by the "Scroll" event would be lost. This fix only applies to new saves made after the fix. Fix made by Arisu.
** Fixed a bug where upon using "Change Parallax" to adjust loop speeds and then zooming in would cause the parallax to jump an unpredictable amount. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > Compatibility > Zoom Round Up?
**** While zooming, change the rounding effect to round up or round down?
**** Depending on the artistic style your game is going for, you may prefer for sprite positions to round up or round down.

-







=== November 13, 2025 - Update #155 ===

-

Total Plugins Updated: 4

-

'''Tier 1 (1 Plugin Update)

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.29: November 13, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag added by Arisu:
*** <nowiki><Replace type Trait: name></nowiki>
**** Replaces the current 'type' Trait with 'name' Trait.
**** This allows things like changing an ice element type to fire element.

-

'''Tier 2 (3 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.13: November 13, 2025
* Bug Fixes!
** Fixed a bug where if VisuMZ_4_BreakShields were turned off from showing in the UI, they would still show up. This requires you to update the plugin parameters for this plugin and can be done in three ways:
*** #1 Method: Select "Window Settings" in the Plugin Parameter list and press "Delete" button on your keyboard. Then open it back up to repopulate it with the default settings. This will reset all of the settings within "Window Settings".
*** #2 Method: Delete the current copy of VisuMZ_2_BattleGridSystem from the Plugin Manager list and install a new copy of VisuMZ_2_BattleGridSystem into the Plugin Manager list. This will reset all your Plugin Parameter settings.
*** #3 Method: Install a fresh copy of VisuMZ_2_BattleGridSystem, copy the Parameters > Window Settings > Tactics Grid Window > JS: Draw Actor Node setting and paste it in your existing copy in the Plugin Manager list.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.19: November 13, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New script calls added by Olivia:
*** $otbAddBattlerToCurrentTurnEnd(battler, times)
*** $otbAddBattlerToNextTurnEnd(battler, times)
**** Adds actions for target battler to the end of current/next turn.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.21: November 13, 2025
* Compatibility Update!
** "Auto-Forward" functionality now plays nice with VisuMZ_2_VoiceActControl and waits for voice lines to finish before continuing.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > Auto-Forward Settings > Compatibility > Voice Act Padding
**** How many frames to wait after a voice line finishes?
**** Average: 60 frames per second.

-







=== October 16, 2025 - Update #154 ===

-

Total Plugins Updated: 5

-

'''Tier 1 (1 Plugin Update)

-

[[Items and Equips Core VisuStella MZ]]

Version 1.59: October 16, 2025
* Bug Fixes!
** Fixed a bug where a changed parameter in the equipment menu would accidentally highlight the next parameter's name. Fix made by Irina.

-

'''Tier 2 (4 Plugin Updates)

-

[[Aggro Control System VisuStella MZ]]

Version 1.21: October 16, 2025
* Bug Fixes!
** Fixed a bug where auto-battle would bypass Taunt and Provoke effects. Fix made by Olivia.

-

[[Battle System - ATB VisuStella MZ]]

Version 1.35: October 16, 2025
* Bug Fixes!
** Fixed a bug where if an actor dies in battle and is revived post-battle using "Recover All", that actor no longer gets stuck after their first action in following battles. Fix made by Olivia.

-

[[Equip Battle Skills VisuStella MZ]]

Version 1.11: October 16, 2025
* Compatibility Update!
** Added better compatibility with Equip Battle Skills when used together with enemy reference ID's. Update made by Olivia.

-

[[Item Crafting System VisuStella MZ]]

Version 1.25: October 16, 2025
* Compatibility Update!
** Added better compatibility checks for shop batches to make sure they don't give out free items. Fix made by Arisu.

-







=== September 18, 2025 - Update #153 ===

-

Total Plugins Updated: 11

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.88: September 18, 2025
* Documentation Update!
** Extra notes for <nowiki><JS param Plus/Rate/Flat: code></nowiki> notetags
*** Use 'user' to refer to the currently equipping actor.
*** If you use code to refer to an actor's other stats like 'atk' and 'def', there is the potential to cause an infinite loop.
*** Use 'user.paramBase(x)' instead of 'user.atk', 'user.def', etc.
*** Plugin Parameter setting Parameters > "Convert JS To Base?" will automatically convert any instances of 'user.mhp', 'user.mmp', 'user.atk', etc. to their base parameters.
*** Turn this off if you do not want it.
*** You are responsible for any infinite loops this may cause.
* Feature Update!
** <nowiki><JS param Plus/Rate/Flat: code></nowiki> now support 'user' as a variable.
* New Features!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > Parameters > Convert JS To Base?
**** Automatically convert <nowiki><JS param Plus/Rate/Flat: code></nowiki> to use base parameters to prevent infinite loops.

-

'''Tier 1 (2 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.88: September 18, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag added by Olivia:
*** <nowiki><Damage Flinch></nowiki>
**** Normally, MP and TP actions do not cause damage flinching. However, skills and items with this notetag will cause damage flinching if they hurt the target's MP or TP.
**** HP damage will always be affected and cause target to flinch.
** New Plugin Parameter added by Olivia:
*** Plugin Parameters > Damage Settings > Check Formulas?
**** It's usually bad practice to put in battle mechanics within damage formulas and this will check the damage formulas for skills and items to see if they contain any of the common battle mechanics that have the potential to cause problems.
**** Checks for illegal mechanics inside of damage formulas?
**** (ie. gainHp, loseHp, addBuff, addDebuff, addState, etc)
**** Read the following article for an explanation on why battle mechanics in damage formulas are undesirable and for an alternate solution:
**** [[Stop Putting Mechanics in Damage Formulas]]
**** Turn this off if you do not want to be alerted of which skills/items have battle mechanics in their damage formulas.

-

[[Skills and States Core VisuStella MZ]]

Version 1.53: September 18, 2025
* Bug Fixes!
** Fixed a bug where the "Preset: Gauge Color" Plugin Parameter was not accepting #rrggbb values. Fix made by Arisu.
* Documentation Update!
** Added extra clarity for <nowiki><Passive State: x></nowiki>:
*** If you are using VisuMZ's Equip Battle Skills, know that the notetag <nowiki><Passive State: x></nowiki> will always have the passive state be available no matter if the skill is equipped or not, as long as the skill is learned.
*** If you want the passive state to only appear while the skill is equipped then use the VisuMZ Equip Battle Skills notetag <nowiki><Equip State: x></nowiki> for this effect instead.

-

'''Tier 2 (6 Plugin Updates)

-

[[Animated Message Text Effects VisuStella MZ]]

Version 1.05: September 18, 2025
* Bug Fixes!
** Word Wrap no longer causes multiple text effects to not register. Fix made by Irina.

-

[[Bestiary VisuStella MZ]]

Version 1.08: September 18, 2025
** Bug Fixes!
*** Fixed a bug where the Bestiary Reveal Enemies Plugin Command would not work with deployed games. Fix made by Irina.

-

[[Date and Time System VisuStella MZ]]

Version 1.06: September 18, 2025
* Bug Fixes!
** Fixed a bug where manual game time updates made by Plugin Commands would not allow variables to update if Game Time was paused. Fix made by Arisu.

-

[[Enhanced TP System VisuStella MZ]]

Version 1.17: September 18, 2025
* Bug Fixes!
** Fixed a bug where TP was not properly preserved. Fix made by Arisu.

-

[[Equip Battle Skills VisuStella MZ]]

Version 1.10: September 18, 2025
* Compatibility Update!
** Added better compatibility with Skills & States Core's new <nowiki><Toggle></nowiki> functionality. <nowiki><Equip State: x></nowiki> can now have the passive state be toggled on and off. Update made by Arisu.

-

[[Equip Passive System VisuStella MZ]]

Version 1.05: September 18, 2025
* Bug Fixes!
** Upon actor/enemy deaths, death and kill counts won't trigger multiple times anymore. Kills will also only trigger once per battle per enemy. Fix made by Arisu.

-

'''Tier 4 (2 Plugin Updates)

-

[[Encounter Effects VisuStella MZ]]

Version 1.12: September 18, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags/comment tags added by Arisu:
*** <nowiki><Enable Diagonal Chase></nowiki>
*** <nowiki><Disable Diagonal Chase></nowiki>
**** If Events & Movement Core is installed, events can chase the player in diagonal directions if the player can move diagonally.
**** However, if you want the player to only move in 4-directions but the event can move diagonally, you can use <nowiki><Enable Diagonal Chase></nowiki>.
**** Alternatively, you want the player to be able to move diagonally while the event cannot, you can use <nowiki><Disable Diagonal Chase></nowiki>.

-

[[Multi-Layer HP Gauge VisuStella MZ]]

Version 1.06: September 18, 2025
* Compatibility Update!
** HP Gauges will no longer cover up Tutorial Panel System's windows. Update made by Olivia.

-







=== August 14, 2025 - Update #152 ===

-

Total Plugins Updated: 6

-

'''Tier 1 (1 Plugin Update)

-

[[Skills and States Core VisuStella MZ]]

Version 1.52: August 14, 2025
* Feature Update!
** Passive States with custom JS conditions should be less prone to infinite loops. Update made by Irina.

-

'''Tier 2 (4 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.12: August 14, 2025
* Bug Fixes!
** Fixed a bug where cancelling attack and then moving, despite having pass turn on, would still cause the attack to go through. Fix made by Irina.

-

[[Battle System - PTB VisuStella MZ]]

Version 1.16: August 14, 2025
* Bug Fixes!
** Fixed a bug where if an actor is newly added during battle, while the battle would compensate and give the party an extra action to work with, the newly added actor would not get a turn. Fix made by Olivia.

-

[[Date and Time System VisuStella MZ]]

Version 1.05: August 14, 2025
* Documentation Update!
** Added warning to these Plugin Commands:
*** Game Time: Record to Variable(s)
*** Real Time: Record to Variable(s)
**** Does NOT overwrite automatic variables used in Plugin Parameters.
** Added segment to Plugin Parameters: Game Time Variables & Switches
*** Changing these variables' values does not mean the Game Time will be changed in-game. These variables are just for automatically reading what the Game Time is. If you wish to change the Game Time, you will need to use the Plugin Commands "Change Date To" and "Change Time To" instead.
** Added segment to Plugin Parameters: Real Time Variables & Switches
*** Changing these variables' values does not mean the Real Time will be changed in-game. These variables are just for automatically reading what the Real Time is. Real Time value cannot be changed by the plugin.

-

[[Party System VisuStella MZ]]

Version 1.35: August 14, 2025
* Bug Fixes!
** Fixed a bug where if the battle had no battle back setting and is using a map snapshot, the snapshot would be overwritten if the player enters the party change menu from battle. This should no longer occur and the map snapshot will be preserved. Fix made by Olivia.

-

'''Tier 4 (1 Plugin Update)

-

[[Button Common Events VisuStella MZ]]

Version 1.11: August 14, 2025
* Bug Fixes!
** When "Forbid Default Bound Keys" is enabled, walking over below/above priority events with Player Touch or Event Touch can enable them over and over again if they do not have any kind of stop measure until the player fully steps on the tile. This should no longer happen. Fix made by Arisu.

-







=== July 17, 2025 - Update #151 ===

-

Total Plugins Updated: 7

-

'''Tier 2 (5 Plugin Updates)

-

[[Aggro Control System VisuStella MZ]]

Version 1.20: July 17, 2025
* Bug Fixes!
** Fixed a bug where if a party member who provoked an enemy decided to switch out, the provoke effect would be retained and cause the enemy to bug out and crash the game. Fix made by Arisu.

-

[[Character Creation System VisuStella MZ]]

Version 1.09: July 17, 2025
* Compatibility Update!
** If traits were turned off, there would be a crash. Crash is now fixed. Applies to retraining, too. Fix made by Arisu.

-

[[Item Crafting System VisuStella MZ]]

Version 1.24: July 17, 2025
* Bug Fixes!
** Fixed a name masking bug that would result in a crash. Fix made by Arisu.

-

[[Party System VisuStella MZ]]

Version 1.34: July 17, 2025
* Compatibility Update!
** Added better compatibility with TPB when using the in-battle Party switch command from the Party Command Window. Update made by Irina.

-

[[Weapon Swap System VisuStella MZ]]

Version 1.14: July 17, 2025
* Bug Fixes!
** Fixed a bug where the default status scene would not display the correct weapons. Fix made by Irina.

-

'''Tier 3 (1 Plugin Update)

-

[[Skill Mastery VisuStella MZ]]

Version 1.03: July 17, 2025
* Bug Fixes!
** Before, if a skill with a common event would defeat an enemy, it wouldn't grant the user any mastery EXP. Fix made by Arisu.
* Compatibility Update!
** Better compatibility with Equip Battle Skills!

-

'''Tier 4 (1 Plugin Update)

-

[[CG Gallery VisuStella MZ]]

Version 1.03: July 17, 2025
* Bug Fixes!
** Fixed a bug where the CG Gallery would crash if Completion or Progress displays were turned off. Fix made by Irina.

-







=== June 12, 2025 - Update #150 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (1 Plugin Update)

-

[[Battle Core VisuStella MZ]]

Version 1.87: June 12, 2025
* Bug Fixes!
** Fixed a bug where <nowiki><JS Accuracy></nowiki> and related notetags did not work. Fix made by Arisu.
** Fixed a bug where dual wielding weapons with HP/MP bonuses would cause the max cache values to fluctuate per hit. Fix made by Olivia.
* Compatibility Update!
** Added fail safes for plugins that would sometimes add null battlers to animation queues. This update prevents crashes for potential checks.
** Added better compatibility with Message Core's text language change. Enemy names did not convert prior to placing state icons and would cause misalignment.

-

'''Tier 2 (7 Plugin Updates)

-

[[Battle System - BTB VisuStella MZ]]

Version 1.19: June 12, 2025
* Bug Fixes!
** Fixed a bug where notetags like <nowiki><Target: Enemy or Ally></nowiki> would cause action fusions to not work properly. Fix made by Arisu.
** Fixed a bug where some special targeting cases were not preserved when performing action fusions. Fix made by Arisu.

-

[[Battle System - PTB VisuStella MZ]]

Version 1.15: June 12, 2025
* Bug Fixes!
** Fixed a bug where "Fastest AGI First" mechanic was always on under most conditions. When this plugin parameter is off, the party order will always go by party index instead. Fix made by Arisu.

-

[[Class Change System VisuStella MZ]]

Version 1.18: June 12, 2025
* Documentation Update!
** Help file updated for new features.
** Added new line for <nowiki><CP Rate: x%></nowiki>
*** CP Gain Formulation Calculation: (1 + Plus) * Rate + Flat
** Added new line for <nowiki><JP Rate: x%></nowiki>
*** JP Gain Formulation Calculation: (1 + Plus) * Rate + Flat
* New Features!
** New notetags added by Arisu:
*** <nowiki><CP Plus: +x%></nowiki>
*** <nowiki><CP Plus: -x%></nowiki>
*** <nowiki><CP Flat: +x%></nowiki>
*** <nowiki><CP Flat: -x%></nowiki>
*** <nowiki><JP Plus: +x%></nowiki>
*** <nowiki><JP Plus: -x%></nowiki>
*** <nowiki><JP Flat: +x%></nowiki>
*** <nowiki><JP Flat: -x%></nowiki>
**** These are the additive versions of <nowiki><CP Rate: x%></nowiki> and <nowiki><JP Rate: x%></nowiki>
**** See help file for more information.

-

[[Equip Battle Skills VisuStella MZ]]

Version 1.09: June 12, 2025
* Bug Fixes!
** Fixed a bug where Skill & States Core's <nowiki><Hide in Battle></nowiki> is bypassed if used together with "All Skills" in the Battle Command controller. Fix made by Arisu.

-

[[Furniture System VisuStella MZ]]

Version 1.10: June 12, 2025
* Bug Fixes!
** Fixed a bug where if a template is not the neutral center pattern, the furniture cursor would not display it correctly. Fix made by Arisu.

-

[[QTE and Trigger System VisuStella MZ]]

Version 1.03: June 12, 2025
* Bug Fixes!
** Fixed a bug where some QTE's did not work properly in battle. Fix made by Arisu.

-

[[Skill Learn System VisuStella MZ]]

Version 1.17: June 12, 2025
* Documentation Update!
** Help file updated for new features.
** Added new line for <nowiki><AP Rate: x%></nowiki>
*** AP Gain Formulation Calculation: (1 + Plus) * Rate + Flat
** Added new line for <nowiki><SP Rate: x%></nowiki>
*** SP Gain Formulation Calculation: (1 + Plus) * Rate + Flat
* New Features!
** New notetags added by Arisu:
*** <nowiki><AP Plus: +x%></nowiki>
*** <nowiki><AP Plus: -x%></nowiki>
*** <nowiki><AP Flat: +x%></nowiki>
*** <nowiki><AP Flat: -x%></nowiki>
*** <nowiki><SP Plus: +x%></nowiki>
*** <nowiki><SP Plus: -x%></nowiki>
*** <nowiki><SP Flat: +x%></nowiki>
*** <nowiki><SP Flat: -x%></nowiki>
**** These are the additive versions of <nowiki><AP Rate: x%></nowiki> and <nowiki><SP Rate: x%></nowiki>
**** See help file for more information.

-

'''Tier 4 (1 Plugin Update)

-

[[Database Inheritance VisuStella MZ]]

Version 1.04: June 12, 2025
* Bug Fixes!
** Fixed a bug where parameters for classes would be inherited when this notetag should only be for equipment and enemies. Fix made by Arisu.

-







=== May 15, 2025 - Update #149 ===

-

Total Plugins Updated: 16

-

'''Tier 1 (1 Plugin Update)

-

[[Message Core VisuStella MZ]]

Version 1.54: May 15, 2025
* Bug Fixes!
** Fixed a bug where the text width of translated text was not taken into account. Fix made by Arisu

-

'''Tier 2 (7 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.11: May 15, 2025
* Bug Fixes!
** Fixed a bug where certain notetag combinations would cause crashes. Fix made by Arisu.
** Fixed a bug where using aura or miasma effects from Skills & States Core would cause the game to crash if there were not enough battle grid node slots to accommodate all characters, even if they were in the reserve. As a result, aura and miasma effects now only affect battle members.
* Documentation Update!
** Added documentation for <nowiki><Aura Range: type></nowiki> <nowiki><Miasma Range: type></nowiki> notetags
*** Aura/Miasma effects do not affect characters not in active party.

-

[[Battle System - ETB VisuStella MZ]]

Version 1.11: May 15, 2025
* Bug Fixes!
** Fixed a bug where if an actor performs a forced action while "Maintain Same Actor?" plugin parameter is enabled, the forced action would double. This should now be fixed.

-

[[Battle System - FTB VisuStella MZ]]

Version 1.14: May 15, 2025
* Bug Fixes!
** Fixed a bug where if an actor performs a forced action while "Maintain Same Actor?" plugin parameter is enabled, the forced action would double. This should now be fixed.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.18: May 15, 2025
* Bug Fixes!
** Fixed a bug where adding states with Action Times+ would add too many actions. Fix made by Olivia.

-

[[Bestiary VisuStella MZ]]

Version 1.07: May 15, 2025
* Compatibility Update!
** Added better compatibility with Message Core's text language settings. Update made by Arisu.

-

[[Item Crafting System VisuStella MZ]]

Version 1.23: May 15, 2025
* Compatibility Update!
** Added better compatibility with Message Core's text language settings. Update made by Arisu.

-

[[Party System VisuStella MZ]]

Version 1.33: May 15, 2025
* Compatibility Update!
** Added better compatibility for $gameParty.swapOrder function to allow it to work on the map. Update made by Irina.

-

'''Tier 3 (4 Plugin Updates)

-

[[Active Chain Skills VisuStella MZ]]

Version 1.07: May 15, 2025
* Documentation Update
** Added under "Active Chain Skills":
*** Auto Battle Timing
**** If an actor with auto battle uses a skill that can chain, they will pick a chain skill within 200 milliseconds after the skill has started. If the active chain mechanic is disabled within this time frame (through an action sequence command) then no chain skill will be automatically selected.
* Feature Update!
** Added a 200 millisecond delay before a chain skill is automatically selected through Auto Battle. This is done to give action sequences enough time to disable the Active Chain Mechanic if they want to.

-

[[Boost Action VisuStella MZ]]

Version 1.13: May 15, 2025
* Bug Fixes!
** Fixed a bug that would cause Boost Points to not work properly. Fix made by Arisu.

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.16: May 15, 2025
* Compatibility Update!
** Better compatibility with Visual Item Inventory. Update made by Arisu.

-

[[Steal Items VisuStella MZ]]

Version 1.10: May 15, 2025
* Bug Fixes!
** Fixed a bug that would cause a crash if an enemy has no items that can be stolen when using snatch functionality. Fix made by Arisu.

-

'''Tier 4 (4 Plugin Updates)

-

[[Battle Cursor VisuStella MZ]]

Version 1.04: May 15, 2025
* Bug Fixes!
** Fixed a bug where the battle cursor position could appear on non-rounded numbers, causing pixel bleeding between frames. Fix made by Olivia.

-

[[Button Common Events VisuStella MZ]]

Version 1.10: May 15, 2025
* Bug Fixes!
** When a common event is launched while the player is moving onto a below or above priority event with Player Touch or Event Touch, the event action would be skipped. This should no longer happen. Fix made by Arisu.

-

[[Unique Tile Effects VisuStella MZ]]

Version 1.07: May 15, 2025
* Documentation Update!
** Help file updated for new features.
** Updated "Warning! RPG Maker MZ Version 1.5.0+ Water-Tile Bug!" section:
*** As of version 1.9.0+, these two methods no longer work to fix the problem. There is a Plugin Parameter added to disable the error message. However, this does not mean that the tileset flag data is fixed. Turn off the error message at your will.
* Added new Plugin Parameter:
** Plugin Parameters > Enable Error Message?
*** Display error message for tilesets with incomplete flag data?
*** Disabling does not fix the problem.

-

[[Visual Item Inventory VisuStella MZ]]

Version 1.07: May 15, 2025
* Compatibility Update!
** Tooltip window now accounts for target window's scaling (ie Frontview Battle UI). Update made by Arisu.

-







=== April 17, 2025 - Update #148 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (1 Plugin Update)

-

[[Skills and States Core VisuStella MZ]]

Version 1.51: April 17, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Skill Toggle Settings
**** Skill toggles are a new type of skill. They do not perform any actions but instead, will switch on/off any passive effects the skill has.
**** Enemies are unable to switch Toggle Skills and the passive effects on a Toggle Skill for an enemy will always be considered ON.
**** See the help file for more information.
** New Notetags added by Olivia:
*** Skill Toggle Notetags:
**** <nowiki><Toggle></nowiki>
**** <nowiki><Initial Toggle: On/Off></nowiki>
**** <nowiki><Toggle Exclusion Group: key></nowiki>
**** <nowiki><Toggle On Animation: x></nowiki>
**** <nowiki><Toggle Off Animation: x></nowiki>
***** See the help file for more information.

[[File:SkillToggle.gif]]

-

'''Tier 2 (2 Plugin Updates)

-

[[Battle System - BTB VisuStella MZ]]

Version 1.18: April 17, 2025
* Bug Fixes!
** Fixed a bug where flex fusion combinations did not work properly and where the strict fusion combinations would draw from flex fusions. Fix made by Olivia.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.20: April 17, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Message Tails > Auto-Position > Auto-Correct X
**** Auto-corrects Message Tail position X when used with Auto-Position but are too close to edge of screen.

-

'''Tier 3 (5 Plugin Updates)

-

[[Boost Action VisuStella MZ]]

Version 1.12: April 17, 2025
* Compatibility Update!
** Better compatibility with Message Core's wordwrap.
* Documentation Update!
** The follow text codes now have added notes to them:
*** \boost>=x[text]
*** \boost>x[text]
*** \boost=x[text]
*** \boost<x[text]
*** \boost<=x[text]
**** Added note: In battle use only!
* Feature Update!
** \boost=0[x] now functions the same as \boost0[x] and does not require being in battle. Update made by Arisu.

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.15: April 17, 2025
* Bug Fixes!
** Fixed a bug where if an actor does not have Preserve TP and their TP changes on the map scene, the TP gauge does not reflect the new changes. Fix made by Arisu.

-

[[Limited Skill Uses VisuStella MZ]]

Version 1.05: April 17, 2025
* Compatibility Update!
** Added better compatibility with Skills & States Core's new Skill Toggles.

-

[[Skill Cooldowns VisuStella MZ]]

Version 1.08: April 17, 2025
* Compatibility Update!
** Added better compatibility with Skills & States Core's new Skill Toggles.

-

[[Victory Aftermath VisuStella MZ]]

Version 1.23: April 17, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Command added by Olivia:
*** System: Change Victory BGM
**** Changes victory BGM.

-

'''Tier 4 (1 Plugin Update)

-

[[Full Field Recovery VisuStella MZ]]

Version 1.02: April 17, 2025
* Bug Fixes!
** Fixed a bug where items would get used on dead party members even if the item did not allow targeting dead party members in its scope. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > General > Mechanics > Heal HP? > Prioritize Lowest %?
**** Prioritize using healing items on lowest HP% member first?
**** If off, heal members in party order.
*** Parameters > General > Mechanics > Heal MP? > Prioritize Lowest %?
**** Prioritize using healing items on lowest MP% member first?
**** If off, heal members in party order.

-







=== March 20, 2025 - Update #147 ===

-

Total Plugins Updated: 11

-

'''Tier 1 (1 Plugin Update)

-

[[Skills and States Core VisuStella MZ]]

Version 1.50: March 20, 2025
* Documentation Update!
** Changed the description of Plugin Parameter 'Action End Update' to 'Refer to "Major Changes" in Help File for explanation.'
** Added examples of "Action End Update" under "Major Changes"
*** The new state: "Fiery Blade" will allow the affected battler to deal fire elemental damage. With Action End, this means for 5 actions, those attacks will deal fire damage.
*** This means that if no action is taken, due to a status effect like "Sleep" or "Stun", then the duration count will not decrease.
*** On the flip side, if the battler performs multiple actions a turn, then the duration count drops faster because more actions have been spent.
*** However, if this "Fiery Blade" state was using Turn End instead, it will have its duration reduced by 1 each turn, regardless of "Sleep" or "Stun" states, and regardless of how many actions are performed each turn.

-

'''Tier 2 (3 Plugin Updates)

-

[[Battle System - ATB VisuStella MZ]]

Version 1.34: March 20, 2025
* Bug Fixes!
** Field ATB Gauge no longer stays visible during victory sequence. Fix made by Olivia.

-

[[QTE and Trigger System VisuStella MZ]]

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > QTE Settings > Input Buffer Leeway
**** How many input buffer frames of leeway should be granted to Button Sequence QTE?

-

[[Tutorial Panel System VisuStella MZ]]

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added by Irina:
*** Plugin Parameters > Scene Battle > Button Assist Window
**** Button Assist Window > Background Type
**** Button Assist Window > JS: X, Y, W, H
***** Added menu button assist to the battle scene where it previously was not available.
***** Requires VisuMZ_0_CoreEngine!

-

'''Tier 3 (6 Plugin Updates)

-

[[Auto Skill Triggers VisuStella MZ]]

Version 1.17: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > General Settings:
**** These are general settings used for this plugin. These are primarily used to impose a limit on the number of auto skill triggers that can happen per battler per turn (meaning each member in battle has that limit individually and not as a whole). Generally speaking, we recommend imposing limits limits like MP costs, TP costs, cooldowns, and the like.
**** This is because auto skill triggers, when left unchecked and reacting to everything, can cause a runaway effect where the player no longer inputs anything. Instead, it is best to put a limit (even if high) on the number of auto triggers to prevent such a thing from happening.
**** If you still want seemingly unlimited auto skill triggers, change the numbers to 100 or something, but keep in mind that we're not responsible for runaway effects when the risk of it happening is already mentioned.
*** Plugin Parameters > Limit Per Turn (Turn-Based)
**** Turn-Based Only. How many triggers per battler per turn? Higher risk of runaway auto triggers at higher counts.
*** Plugin Parameters > Limit Per Turn (TPB-Based)
**** TPB-Only. How many triggers per battler per turn? Higher risk of runaway auto triggers at higher counts.

-

[[Battle AI VisuStella MZ]]

Version 1.29: March 20, 2025
* Bug Fixes!
** Fixed a problem with TPB actions causing conflicts in AI registration of certain abilities. This would lead to crashes. Should be no more. Fix made by Olivia.

-

[[Boost Action VisuStella MZ]]

Version 1.11: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Mechanics > Boost Animations > Mirror Animation
*** Parameters > Mechanics > Boost Animations > Mute Animation
**** Mirror/Mute the effect animation?
*** Parameters > Mechanics > Boost Animations > Repeat Animation?
*** Parameters > Mechanics > Boost Animations > Repeat > Repeat Cycle
*** Parameters > Mechanics > Boost Animations > Repeat > Mirror Animation
*** Parameters > Mechanics > Boost Animations > Repeat > Mute Animation
**** Allows repeating animations while boosted and inputting.
**** Only repeated during command input.

-

[[Skill Mastery VisuStella MZ]]

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > General > Window_ActorCommand > Show Level in Name?
**** Show the skill level in name for single skills?
**** Only applies to Window_ActorCommand!
**** Not all skill name displays will show skill levels.
*** Parameters > General > Window_ActorCommand > Show Mastery Gauge?
**** Show the mastery gauge for single skills?
**** Only applies to Window_ActorCommand!
**** Not all skill name displays will show skill levels.

-

[[Visual Cutin Effect VisuStella MZ]]

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Olivia:
*** Plugin Parameters > Cutin Layer
**** Where do you want the visual cutins layer placed?
***** Top - Above Everything Else
***** Below - Below UI Elements (Default)

-

[[Visual State Effects VisuStella MZ]]

Version 1.24: March 20, 2025
* Bug Fixes!
** Fixed a crash that would occur upon state removal regarding hovering. Fix made by Irina.

-

'''Tier 4 (1 Plugin Update)

-

[[Weakness Popups VisuStella MZ]]

Version 1.10: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Any Weakness > Animation ID
**** Play this animation when weakness effect activates.
**** Requires VisuMZ_0_CoreEngine.
*** Plugin Parameters > Any Weakness > Animation ID > Mirror Animation
*** Plugin Parameters > Any Weakness > Animation ID > Mute Animation
**** Mirrors/mutes the weakness effect animation?
**** Requires VisuMZ_0_CoreEngine.

-







=== February 20, 2025 - Update #146 ===

-

Total Plugins Updated: 33

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.87: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.
*** Better compatibility with different icon sizes.
* Documentation Update!
** Under Plugin Parameters: Menu Button Assist Window
*** Added text segments under Split "Escape"
**** This means you need to go to your own project's rmmz_core.js and modify Input.keyMapper to have buttons with "cancel" and "menu" instead of only "escape".
**** If there are none found, an error message will appear telling you to do so, or set the 'Split "Escape"' option to false.
**** If you are using Options Core's Rebind Keyboard option, be sure to have those have "cancel" and "menu" options inside there, too.
* Feature Update!
** Plugin Parameters > Button Assist > Split "Escape" will now show an error message if a custom Input.keyMapper is not found with the "cancel" and "menu" keys implemented. Update made by Irina.
** Updated Plugin Parameters > Button Assist > Split "Escape" description for Plugin Parameters to add in the following text: Requires custom Input.keyMapper with "cancel" and "menu".
** Added better compatibility with WASD controls as to prioritize showing the arrow keys rather than the W, A, S, D keys. Also applies to any other rebindings.

-

'''Tier 1 (7 Plugin Updates)

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.28: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.
* Documentation Update!
** Help file updated to add extra note to "Status Menu Settings"
*** Plugin Parameters > Status Menu Settings > Elements > IDs: Column 1/2
**** If you have a lot of elements and a single column does not have enough room to display them all, use these Plugin Parameters to split them up into two columns.
**** This can also be used for those who wish to separate their elements between physical and magical elements, major and minor, etc.

-

[[Items and Equips Core VisuStella MZ]]

Version 1.58: February 20, 2025
* Bug Fixes!
** Optimize no longer allows player to bypass the following notetags: <nowiki><Equip Copy Limit: x></nowiki>, <nowiki><Equip Weapon Type Limit: x></nowiki>, and <nowiki><Equip Armor Type Limit: x></nowiki>. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Main Menu Core VisuStella MZ]]

Version 1.27: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Message Core VisuStella MZ]]

Version 1.53: February 20, 2025, 2025
* Bug Fixes!
** Fixed an error with text language translations not working properly for the last listed language in the translation sheet. Fix made by Irina.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.
* Documentation Update!
** Help file updated for new features.
** Text Language Information section included for TSV.
** Updated text code note for \picture<nowiki><x></nowiki> and \CenterPicture<nowiki><x></nowiki>

-

[[Options Core VisuStella MZ]]

Version 1.28: February 20, 2025
* Feature Update!
** Added a fail safe to prevent crashes when pressing F4/Full Screen too early while the game is loading. Update made by Arisu.

-

[[Save Core VisuStella MZ]]

Version 1.14: February 20, 2025
* Feature Update!
** Whenever the background picture is now snapped for a screenshot (usually for a menu), the autosave confirmation window will no longer be included in it if the player reenters a menu immediately after going to map scene. Update made by Irina.

-

[[Skills and States Core VisuStella MZ]]

Version 1.49: February 20, 2025
* Bug Fixes!
** Fixed a bug where causing a dead battler to refresh afterwards would yield multiple death states on that battler. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

'''Tier 2 (14 Plugin Updates)

-

[[Animated Message Text Effects VisuStella MZ]]

Version 1.04: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Battle System - BTB VisuStella MZ]]

Version 1.17: February 20, 2025
* Bug Fixes!
** Fixed a bug where for certain battle layouts, the BTB Action Counter on the actor command window would start off center. Fix made by Olivia.

-

[[Character Creation System VisuStella MZ]]

Version 1.08: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Class Change System VisuStella MZ]]

Version 1.17: February 20, 2025
* Bug Fixes!
** Fixed a crash that would occur upon loading a save game that was made before Class Change System was installed. Fix made by Olivia.

-

[[Enhanced TP System VisuStella MZ]]

Version 1.16: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Equip Battle Skills VisuStella MZ]]

Version 1.08: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Equip Medal System VisuStella MZ]]

Version 1.06: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Equip Passive System VisuStella MZ]]

Version 1.04: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.19: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different face sizes.

-

[[Horror Effects VisuStella MZ]]

Version 1.05: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

[[Item Crafting System VisuStella MZ]]

Version 1.22: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.
* Documentation Update!
** Added extra clarity to <nowiki><Craft Batch></nowiki>
*** Items CANNOT add themselves!
*** ie. Item 'Super Potion' must not give Item 'Super Potion'.
* Feature Update!
** Add fail safes to prevent items from having batch entries add themselves. Added by Arisu.

-

[[More Currencies VisuStella MZ]]

Version 1.05: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Picture Choices VisuStella MZ]]

Version 1.02: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

[[Picture Effects VisuStella MZ]]

Version 1.01: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

'''Tier 3 (6 Plugin Updates)

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.14: February 20, 2025
* Documentation Update!
** Help file updated "Major Changes" section:
*** Face Dimensions
**** With the updated release of RPG Maker MZ 1.9.0, you can now change face sizes within the database's system settings. However, this plugin's default settings are geared towards the default face sizes of 144 x 144 pixels. If you do wish to change their sizes, you will need to adjust this plugin's Plugin Parameters accordingly to make the object offsets look correct. The plugin will not automatically adjust them for you.

-

[[Item Amplify Skills VisuStella MZ]]

Version 1.03: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Shop Batches VisuStella MZ]]

Version 1.03: February 20, 2025
* Documentation Update!
** Added extra clarity to <nowiki><Shop Batch></nowiki>
*** Items CANNOT add themselves!
*** ie. Item 'Super Potion' must not give Item 'Super Potion'.
* Feature Update!
** Add fail safes to prevent items from having batch entries add themselves. Added by Arisu.

-

[[Shop Listing Unlock VisuStella MZ]]

Version 1.01: February 20, 2025
* Optimization Update!
** Plugin should run more optimized.

-

[[Visual Gauge Styles VisuStella MZ]]

Version 1.03: February 20, 2025
* Bug Fixes!
** Fixed a bug where for certain gauges, the "sectioned" gauge style would not fill past the first section. Fix made by Arisu.

-

[[Visual Gold Display VisuStella MZ]]

Version 1.02: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

'''Tier 4 (5 Plugin Updates)

-

[[Animated Pictures VisuStella MZ]]

Version 1.05: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

[[Attached Pictures VisuStella MZ]]

Version 1.05: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

[[Break Shields VisuStella MZ]]

Version 1.07: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Message Visibility VisuStella MZ]]

Version 1.03: February 20, 2025
* Compatibility Update!
** Added better compatibility with some of the more recent Message Core additions.

-

[[Picture Common Events VisuStella MZ]]

Version 1.03: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-







=== January 16, 2025 - Update #145 ===

-

Total Plugins Updated: 21

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.86: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.

-

'''Tier 1 (3 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.86: January 16, 2025
* Bug Fixes!
** Fixed a bug where during Active TPB, actors were not showing damage motions. Fix made by Olivia.
** Fixed a bug regarding the in-battle status requiring that the Main Menu Core to be installed when other plugins are also present. Fix by Olivia.
** Fixed a bug where <nowiki><Exclude From Status Listing></nowiki> notetag was not working properly due to a documentation typo of <nowiki><Exclude From Status List></nowiki>. Both notetags should now work. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Added clarity for Plugin Parameters > Party Command Window Settings > Help Window
** Added clarity for Plugin Parameters > Actor Command Window Settings > Help Window
*** The Help Window will only appear for 'Border' and 'Frontview Battle UI' battle layouts.
* New Features!
** New notetag added by Irina:
*** <nowiki><Under></nowiki>
**** If this tag is found in an animation's name, the animation will appear under battlers while in battle.
***** This effect only applies to battlers in the battle scene.
***** Under effect is NOT applied to status window portraits.
***** Under effect is NOT applied to projectile animations.
** Added new Action Sequence Projectile settings:
*** Extra Settings > End Animation ID:
**** Plays an animation when projectile reaches target.

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.27: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.

-

[[Items and Equips Core VisuStella MZ]]

Version 1.57: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Added extra clarity for <nowiki><Status Info></nowiki> notetag:
*** For clarity regarding "Damage Multiplier" and "HP Recovery"/"HP Damage":
**** "Damage Multiplier" refers to the amount determined by damage formulas.
**** "HP Recovery"/"HP Damage" refers to the "Recover HP" database effect.
**** Likewise, the same will apply to "MP Recovery"/"MP Damage" if the damage formula type is to deal MP recovery/damage instead.
* New Features!
** New Notetags added by Arisu:
*** <nowiki><Status Style: type></nowiki>
**** Changes up the way the shop status window displays data for this database object in particular.
*** <nowiki><Custom Status Parameters: name, name, name></nowiki>
**** Customize which parameters are displayed for this equipment object's shop status window.
* Optimization Update!
** Plugin should run more optimized.

-

'''Tier 2 (11 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.10: January 16, 2025
* Bug Fixes!
** Fixed a bug where certain grid node targeting scopes did not work properly. Fix made by Olivia.
* Compatibility Update!
** Added better compatibility with Battle A.I. regarding scopes.

-

[[Battle System - ATB VisuStella MZ]]

Version 1.33: January 16, 2025
* Bug Fixes!
** Fixed an actor softlock issue where if charm, berserk, and confusion can lock a 100% charged actor for Active ATB.
* Documentation Update!
** Added extra clarification for Plugin Parameter "Stuns Reset Gauge?":
*** Charm, Berserk, and Confusion states will still reset the ATB Gauge.

-

[[Battle System - ETB VisuStella MZ]]

Version 1.10: January 16, 2025
* Bug Fixes!
** Fixed a bug where if the entire party is completely restricted via stun, charm, confusion, or berserk, entire turns would be skipped for both actors and enemies. Fix made by Irina.

-

[[Battle System - FTB VisuStella MZ]]

Version 1.13: January 16, 2025
* Bug Fixes!
** Fixed a bug where if the entire party is completely restricted via stun, charm, confusion, or berserk, entire turns would be skipped for both actors and enemies. Fix made by Irina.

-

[[Battle System - PTB VisuStella MZ]]

Version 1.14: January 16, 2025
* Bug Fixes!
** Fixed a bug where if the entire party is completely restricted via stun, charm, confusion, or berserk, entire turns would be skipped for both actors and enemies. Fix made by Irina.

-

[[Bright Effects VisuStella MZ]]

Version 1.10: January 16, 2025
* Bug Fixes!
** Fixed bug with Tilt Shift effect not applying correctly when exiting a menu upon reentering the map scene. Fix made by Olivia.

-

[[Character Creation System VisuStella MZ]]

Version 1.07: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different lineheight settings. Fix made by Olivia.

-

[[Lighting Effects VisuStella MZ]]

Version 1.10: January 16, 2025
* Documentation Update!
** Updated documentation for following notetags:
*** <nowiki><Conical Light Offset: +x, +y></nowiki>
**** Used with the <nowiki><Conical Light Center Offset></nowiki> tag if the Plugin Parameters dictate using hand offsets.
**** As of the v1.10 update of this plugin, the presence of this tag will also automatically include the <nowiki><Conical Light Center Offset></nowiki> tag.
*** <nowiki><Conical Light d Pattern p: +x, +y></nowiki>
**** Used with the <nowiki><Conical Light Hand Offset></nowiki> tag if the Plugin Parameters dictate using non-hand offsets.
**** As of the v1.10 update of this plugin, the presence of this tag will also automatically include the <nowiki><Conical Light Hand Offset></nowiki> tag.
* Feature Update!
** Using <nowiki><Conical Light Offset: +x, +y></nowiki> on an event will automaticaly use the <nowiki><Conical Light Center Offset></nowiki> tag as of this update.
** Using <nowiki><Conical Light d Pattern p: +x, +y></nowiki> on an event will automatically use the <nowiki><Conical Light Hand Offset></nowiki> tag as of this update.

-

[[Picture Choices VisuStella MZ]]

Version 1.01: January 16, 2025
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Plugin Commands "Picture Settings: Change ID(s)" and "Change Range" are updated to display an error message if On Select and On Deselect settings are the same.
* New Features!
** New Plugin Parameter added by Arisu:
*** Parameters > Same Check
**** Checks to see if On Select and On Deselect settings are the same and pops up an error message.
**** This is to prevent the impression that the plugin is unresponsive when the plugin command settings would have instructions for no change otherwise.

-

[[Skill Learn System VisuStella MZ]]

Version 1.16: January 16, 2025
* Bug Fixes!
** Fixed a compatibility bug that would cause the last skill of a list to be removed from learning. Fix made by Irina.

-

[[Weapon Swap System VisuStella MZ]]

Version 1.13: January 16, 2025
* Bug Fixes!
** Fixed a bug where if an actor does not have any weapons equipped, the "Swap" command will not appear. Fix made by Olivia.

-

'''Tier 3 (6 Plugin Updates)

-

[[Action Sequence Projectiles VisuStella MZ]]

Version 1.09: January 16, 2025
* Documentation Update!
** Help file updated for new features.
** Added new Action Sequence Projectile settings:
*** Extra Settings > End Animation ID:
**** Plays an animation when projectile reaches target.

-

[[Battle AI VisuStella MZ]]

Version 1.28: Version 1.10: January 16, 2025
* Compatibility Update!
** Added better compatibility with Battle Grid System regarding scopes.

-

[[Enemy Levels VisuStella MZ]]

Version 1.06: January 16, 2025
* Bug Fixes!
** Fixed a bug where this plugin would suppress Elements & Status Menu Core trait image properties.
* Documentation Update!
** Added notes for <nowiki><Level x Image: filename></nowiki> and <nowiki><Level Images></nowiki>
*** If using VisuMZ_1_ElementStatusCore and the enemy uses a custom trait- related notetag that alters its battler, this notetag will be suppressed unless it's the original battler name being used.

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.13: January 16, 2025
* Documentation Update!
** Help file updated for new features.
* Bug Fixes!
** Fixed a bug where graphical updates did not update properly for FTB/ETB battle systems. Fix made by Olivia.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > Battle Settings > Damage Offset
*** Parameters > Battle Settings > Damage Offset > Offset X
*** Parameters > Battle Settings > Damage Offset > Offset Y
**** How many pixels to offset the damage popup x/y position?

-

[[New Game Plus VisuStella MZ]]

Version 1.05: January 16, 2025
* Bug Fixes!
** Fixed a bug where New Game+ data did not carry over if the starting party did not have any actors in it. Fix made by Irina.

-

[[State Tooltips VisuStella MZ]]

Version 1.10: January 16, 2025
* Bug Fixes!
** Added a failsafe to prevent crashes from party members that left. Fix made by Olivia.

-







=== December 19, 2024 - Update #144 ===

-

Total Plugins Updated: 13

-

'''Tier 1 (4 Plugin Updates)

-

[[Items and Equips Core VisuStella MZ]]

Version 1.56: December 19, 2024
* Bug Fixes!
** Fixed a bug where newly added equipment would cause crashes upon interaction. Fix made by Irina.

-

[[Message Core VisuStella MZ]]

Version 1.52: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Text Codes added by Arisu:
*** <nowiki><left></nowiki>
*** <nowiki><center></nowiki>
*** <nowiki><right></nowiki>
**** When used in the Map Name, instead of aligning the text which is centered by default, the text code will align the horizontal position of the name displayed on the screen.
*** <nowiki><top></nowiki>
*** <nowiki><middle></nowiki>
*** <nowiki><bottom></nowiki>
**** When used in the Map Name, the text code will align the vertical position of the name displayed on the screen.
*** <nowiki><X: +n></nowiki>
*** <nowiki><X: -n></nowiki>
*** <nowiki><Y: +n></nowiki>
*** <nowiki><Y: -n></nowiki>
**** Adjusts the horizontal/vertical position of map name by 'n' value.
*** All of these text codes require VisuMZ_0_CoreEngine installed and its "Map Name Text Code" plugin parameter enabled.

-

[[Options Core VisuStella MZ]]

Version 1.27: December 19, 2024
* Documentation Update!
** Added new section in help file for "Keyboard/Controller Rebind Settings":
*** Late Retroactive Updating of WASD
**** If you've decided to enable Keyboard/Controller Rebind, decided to enable VisuMZ Core Engine's "WASD Movement" after your project has config.rmmzsave in your project's /save/ folder, then the newly added 'WASD Controls' will NOT be updated retroactively.
**** This can be remedied in one of two ways:
***** 1. Go into your keybindings and add them in manually (arrow keys still retain functionality). You may need to readjust the "Shift Right" option, too.
***** 2. Delete the config.rmmzsave file from /save/ and the game will generate you a new one with the updated "WASD Movement" controls.
**** This retroactive non-update will only affect your players if they've already begun playing your game with a version before "WASD Movement" was enabled and has a config.rmmzsave file already made. Players that are affected by this can just simply update and add the 'WASD controls' on their own.
**** Otherwise, a new player would not experience this at all.

-

[[Skills and States Core VisuStella MZ]]

Version 1.48: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** Auras & Miasmas added by Olivia:
*** Auras are a type passive that affects an allied party. Miasmas are a type of passive that affects an opposing party. Auras and Miasmas only need to come from a single source to give an entire party or troop a passive provided that the battler emitting the aura/miasma is alive and in battle.
** New Notetags added by Olivia:
*** <nowiki><Aura State: x></nowiki>
**** Emits an aura that affects the battler's allies and gives each affected member passive state(s) 'x'.
*** <nowiki><Miasma State: x></nowiki>
**** Emits an aura that affects the battler's opponents and gives each affected member passive state(s) 'x'.
*** <nowiki><Not User Aura></nowiki>
**** Prevents the emitting user from being affected by the related aura.
*** <nowiki><Allow Dead Aura></nowiki>
*** <nowiki><Allow Dead Miasma></nowiki>
**** Allows aura/miasma to continue emitting even after the emitting user is in a dead state.
*** <nowiki><Dead Aura Only></nowiki>
*** <nowiki><Dead Miasma Only></nowiki>
**** Allows aura/miasma to only emit if the emitting user is in a dead state
* Optimization Update!
** Plugin should run more optimized.

[[File:SkillsStatesCore_Aura.png|600px]]

-

'''Tier 2 (5 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.09: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia:
*** <nowiki><Aura Range: type></nowiki>
*** <nowiki><Miasma Range: type></nowiki>
**** Used together with <nowiki><Aura State: x></nowiki> and <nowiki><Miasma State: x></nowiki> from VisuMZ_1_SkillsStatesCore!
**** Restricts the range in which the aura/miasma passive is emitted from the user.
**** Read the help file for more information.
* Optimization Update!
** Plugin should run more optimized.

-

[[Battle System - ATB VisuStella MZ]]

Version 1.32: December 19, 2024
* Bug Fixes!
** Fixed a few features that bled over into CTB if the game project used both ATB and CTB battle systems simultaneously. Fix made by Olivia.
* Feature Update!
** "Stuns Reset Gauge" set to "Don't Reset" should now work as expected for both actors and enemies, instead of just actors, while they are in the casting state. Update made by Olivia.
* Optimization Update!
** Plugin should run more optimized.

-

[[Class Change System VisuStella MZ]]

Version 1.16: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New plugin parameters added by Irina:
*** Parameters > General Settings > Select Same Subclass?
**** Allow selecting the same subclass that's already equipped in that slot?
**** Mostly an aesthetic thing to allow/prevent the same subclass from being selected if that's what you want to control.
*** Parameters > Window Settings > Confirm Animation ID > Play for Unassign?
**** Play animation for unassigning a subclass?
**** Mostly an aesthetic thing to play/not play animations when unassigning a subclass if that's what you want to control.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.18: December 19, 2024
* Bug Fixes!
** Fixed a bug where if the button console was top positioned and the buttons were hidden, the rest of the text would not readjust. Fix made by Irina.

-

[[Party System VisuStella MZ]]

Version 1.32: December 19, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash upon adding new members if the VisuStella Core Engine wasn't installed. Fix made by Arisu.

-

'''Tier 3 (2 Plugin Updates)

-

[[Action Sequence Camera VisuStella MZ]]

Version 1.15: December 19, 2024
* Compatibility Update!
** Added better support for MV-style animations when used against frontview actors.

-

[[Visual State Effects VisuStella MZ]]

Version 1.23: December 19, 2024
* Documentation Update!
** Updated targets <nowiki><Repeat Animation: x></nowiki> and <nowiki><Repeat Animation Cycle: x></nowiki>.
* Feature Update!
** Expanded database targets for notetags: <nowiki><Repeat Animation: x></nowiki> and <nowiki><Repeat Animation Cycle: x></nowiki>.
*** From State Notetags only to Actor, Class, Skill, Weapon, Armor, Enemy, State Notetags

-

'''Tier 4 (2 Plugin Updates)

-

[[Gab Window VisuStella MZ]]

Version 1.05: December 19, 2024
* Bug Fixes!
** Fixed a bug where attached event gabs did not scale properly with zoom. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** Added new "Optional Settings" for various Gab Plugin Commands:
*** Sound Volume
*** Sound Pitch
*** Sound Pan
**** Previously, these were not available and defaulted to standard settings used by RPG Maker MZ.

-

[[Map Camera Zoom VisuStella MZ]]

Version 1.07: December 19, 2024
* Compatibility Update!
** Added better compatibility with outside plugins when doing battle transitions. Camera will automatically focus the player if the "Adapt Battle Encounter Ani" is enabled.
** Added better compatibility with VisuMZ's Event Title Scene plugin.

-







=== November 14, 2024 - Update #143 ===

-

Total Plugins Updated: 13

-

'''Tier 1 (1 Plugin Update)

-

[[Items and Equips Core VisuStella MZ]]

Version 1.55: November 14, 2024
* Bug Fixes!
** Fixed a bug where you can no longer attempt to equip an actor with zero equip slots and causing a crash. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
** Updated <Status Info>
*** Used for: Skill, Item, Weapon, Armor Notetags
**** Replace 'key' with one of the following for weapons and armors:
***** 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI', or 'LUK'
***** For those with VisuMZ_0_CoreEngine:
****** 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT', 'HRG', 'MRG', 'TRG'
****** 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR', 'MDR', 'FDR', 'EXR'
**** Only relevant if the Draw Style for equipment is "classic" or "double".
** Updated <Custom Status Info> notetag:
*** Used for: Skill, Item, Weapon, Armor Notetags
**** When used with weapon or armor database objects, this information is only relevant if the Draw Style for equipment is "classic" or "double".
* New Feature!
** New Plugin Parameters:
*** Parameters > Shop Status Window > Data Style:
**** How do you wish to display equipment data?
***** Compare - Compares selected equip to equipped gear
****** Lists all main party actors
****** Displays the parameter differences when equipped
****** Calculates custom JS values
***** Classic - Shows basic parameters of selected equip
***** Double - Shows basic parameters in double columns
****** Involves no actors, only shows the item's stats
****** Shows weapon or armor specific parameters
****** Does not show custom JS values as those are calculated per actor
****** Does not show custom parameters as those are calculated per actor
****** Use <Status Info> and <Custom Status Info> notetags to overwrite or add custom data to classic equip data
**** Data Style > Classic Style:
**** Data Style > Double Style:
***** Added Weapon Params
***** Added Armor Params
****** Display these parameters when a weapon/armor is selected.
****** Requires VisuMZ_0_CoreEngine!

[[File:ItemEquipCore_StatusWindowStyles.png|600px]]

-

'''Tier 2 (5 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.08: November 14, 2024
* Compatibility Update!
** Added better compatibility with Main Menu Core's force show/hide and force enable/disable Plugin Commands for Class, Equip, Skills, and Status commands. Update made by Olivia.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.17: November 14, 2024
* Bug Fixes!
** Fixed a bug where the <OTB Target Follow Turn: +x> and similar notetags altered the following turn regardless of the presence of the target in current turn order. Fix made by Olivia.

-

[[Date and Time System VisuStella MZ]]

Version 1.04: November 14, 2024
* Bug Fixes!
** Fixed a bug where turns were added to each state without using any of the notetag effects. Fix made by Olivia.

-

[[Horror Effects VisuStella MZ]]

Version 1.04: November 14, 2024
* Bug Fixes!
** Fixed a bug where some horror effects would reset upon leaving the screen and/or exiting the menu. Fix made by Olivia.

-

[[Lighting Effects VisuStella MZ]]

Version 1.09: November 14, 2024
* Documentation Update!
** Updated documentation for following notetags:
*** <Radial Light Flash Rate: x%>
*** <Radial Light Flare Rate: x%>
**** To include the following:
***** Must be used with a lower opacity setting.
****** Use with <Radial Light Opacity: x%> notetag.
****** If <Radial Light Opacity: x%> is not used, default to 50%.
*** <Conical Light Flash Rate: x%>
*** <Conical Light Flare Rate: x%>
**** To include the following:
***** Must be used with a lower opacity setting.
****** Use with <Conical Light Opacity: x%> notetag.
****** If <Conical Light Opacity: x%> is not used, default to 50%.
* Feature Updates!
** Notetags for flash/flare rates will now automatically default the opacity level of a light to 50% if the opacity notetag is not present. Update made by Arisu.

-

'''Tier 3 (4 Plugin Updates)

-

[[Battle AI VisuStella MZ]]

Version 1.27: November 14, 2024
* Compatibility Update!
** Added better compatibility with Skill Cooldowns' <Once Per Turn> notetag.

-

[[Evolution Matrix Skills VisuStella MZ]]

Version 1.06: November 14, 2024
* Compatibility Update!
** Added better compatibility between Evolution Matrix Skills and Battle Grid System's targeting for nodes. Update made by Olivia.

-

[[Skill Cooldowns VisuStella MZ]]

Version 1.07: November 14, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag added by Irina:
*** <Once Per Turn>
**** Makes the skill only usable once per turn. Cannot be used in TPB, ATB, or CTB. Does not apply outside of battle.
**** Best used with actors/enemies that perform multiple actions per turn.

-

[[State Tooltips VisuStella MZ]]

Version 1.09: November 14, 2024
* Documentation Update!
** Help file updated for new features.
** Updated <Help Description> notetag documentation:
*** This is used as a common notetag between Battle Core's state descriptions and State Tooltips' state descriptions.
* New Features!
** New Notetag added by Olivia:
*** <State Tooltip Description>
**** A prioritized help description used to separate from the common help description notetag shared with Battle Core's In-Battle Status.

-

'''Tier 4 (3 Plugin Updates)

-

[[Gab Window VisuStella MZ]]

Version 1.04: November 14, 2024
* Documentation Update!
** Added section "Clearing Up Misunderstandings":
*** Gabs are NOT part of the Event List
**** For events with Show Text messages, the game goes through the event list one by one until it reaches the end. This does not apply to Gabs. The Plugin Commands that add Gabs add them into a queue outside of the event list and therefore, any events that may be intended for gabs to be finished will launch immediately unless there are event commands or plugin commands that will cause the event list to wait for them.

-

[[Side Chatter VisuStella MZ]]

Version 1.02: November 14, 2024
* Documentation Update!
** Added section "Clearing Up Misunderstandings":
*** Side chatter is NOT part of the Event List
**** For events with Show Text messages, the game goes through the event list one by one until it reaches the end. This does not apply to side chatter. The Plugin Commands that add side chatter add them into a queue outside of the event list and therefore, any events that may be intended for side chatter to be finished will launch immediately unless there are event commands or plugin commands that will cause the event list to wait for them.
** Help file updated for new features.
* New Features!
** New Plugin Command added by Arisu:
*** Side Chatter: Wait
**** Causes the game to wait until there is no more side chatter.

-

[[Visual Parallaxes VisuStella MZ]]

Version 1.13: November 14, 2024
* Compatibility Update!
** Added reflection compatibility with spawned events.

-







=== October 17, 2024 - Update #142 ===

-

Total Plugins Updated: 18

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.85: October 17, 2024
* Feature Updates!
** Updated to fit RPG Maker MZ's updated 1.8.1 version better.

-

'''Tier 1 (4 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.85: October 17, 2024
* Bug Fixes!
** Fixed a bug where the enemy name's visibility would remain after an action has taken place and before inputting is done. Fix made by Olivia.
** Fixed a bug where the "Name Visibility As Target" plugin parameter did not work properly. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Updated <Help Description> notetag documentation:
*** This is used as a common notetag between Battle Core's state descriptions and State Tooltips' state descriptions.
* New Features!
** New Notetag added by Olivia:
*** <In-Battle Status Description>
**** A prioritized help description used to separate from the common help description notetag shared with State Tooltips.
** New Plugin Parameters added by Olivia:
*** Actor Battlers > Frontview > Portrait Animations > Each Target
*** Actor Battlers > Frontview > Portrait Animations > Center of All
*** Actor Battlers > Frontview > Portrait Animations > Center of Screen
**** Place animations on top or behind for these display types?
*** Battle Log > Action Changes > Show Counter? > Wait Frames
*** Battle Log > Action Changes > Show Reflect? > Wait Frames
*** Battle Log > Action Changes > Show Substitute? > Wait Frames
**** If devs allow the results of counters, reflects, and substitutes, there wasn't enough time before to allow the text to be visible on screen. You can now adjust how many frames are now visible if text is shown.
**** Default values are left at 0 as to not interrupt currently existing action sequences.

-

[[Items and Equips Core VisuStella MZ]]

Version 1.54: October 17, 2024
* Feature Update!
** If "Modern Controls" is selected while "Remove Equip" and "Optimize" are gone from the Equip Menu, right click will exit the menu. Feature added by Arisu.

-

[[Main Menu Core VisuStella MZ]]

Version 1.26: October 17, 2024
* Documentation Update!
** Help file updated for updated features.
* Feature Update!
** Due to conflicts with deployment, the Custom Mouse Cursor has its base location moved from /img/system/ to /icon/.
** Please move the cursor file(s) as well as update the Plugin Parameters.
** Sorry for the inconvenience.

-

[[Message Core VisuStella MZ]]

Version 1.51: October 17, 2024
* Bug Fixes!
** Fixed a bug where \LastGainObj text code did not work with text language key codes. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
** Added note to Text Language Information > How to Enable Switching
*** IMPORTANT! The separator used for the CSV file must be a semicolon (;) and not a comma (,) as to reduce the amount of punctuation conflicts. Keep this in mind as most CSV editors will default to comma (,) instead of the semicolon (;) for their separator.
** Added note to Text Language Information > Naming Weapon Types, etc:
*** You might have noticed that if you've decided to use \tl{keyName} for weapon or other database types, other parts of the game will error out. Don't worry, for these, you don't have to change the currently used database name. Go straight to the CSV and insert in a new key for that particular database name. For example, the equip type "Accessory" will use "Accessory" as the automatic key to look for a translated phrase. If there isn't any in the CSV file, then the default database text entry will be used.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > Text Language Settings > Language Fonts
**** Different default fonts used for different languages. This allows different stylistic choices to be made for different languages in case the current font you're using doesn't have support for other language types.
**** Keep in mind that players can override this with Options Core if they select a text option other than 'Default' for the 'Text Font' option.
**** Make sure any new custom fonts used for different languages are registered with the 'Custom Font Manager' found in this plugin's Plugin Parameters.
*** Parameters > Text Language Settings > Language Images
**** Allows different images to be used when different languages are used. This is for images that have text on it that you want to appear in different languages based on the text language selected by the player.

-

'''Tier 2 (5 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.07: October 17, 2024
* Bug Fixes!
** Fixed a bug where switching positions with dead party members using notetag effects would not move the dead member. Fix made by Olivia.
* Documentation Update!
** Fixed the documentation error for <rule Move User Node direction: x> notetag's "Must Switch Mid" rule explanation.
* Optimization Update!
** Plugin should run more optimized.

-

[[Bright Effects VisuStella MZ]]

Version 1.09: October 17, 2024
* Optimization Update!
** Plugin should run more optimized.

-

[[Equip Medal System VisuStella MZ]]

Version 1.05: October 17, 2024
* Bug Fixes!
** If both "Optimize" and "Remove Equipment" are removed from the equipment scene, the Equip Medal Window would lose some modern controls. This is now properly restored. Fix made by Arisu.

-

[[Equipment Set Bonuses VisuStella MZ]]

Version 1.05: October 17, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Notetags added by Arisu:
*** <Equip Set Wildcard>
**** Assigns a wildcard effect for this equipment piece.
**** This will add +1 to every currently equipped equipment set on actor.
**** See help file for more information.
*** <Equip Set Wildcards: name, name, name>
**** Assigns a limited wildcard effect for this equipment piece for specific equipment sets.
**** This will add +1 to every listed limited set that is currently equipped on the actor.
**** See help file for more information.
** New Plugin Parameters added by Arisu:
*** Parameters > Tooltip Settings > Vocabulary > Wildcard Format
*** Parameters > Tooltip Settings > Vocabulary > Wildcard: Any Set
**** See help file for more information.
* Optimization Update!
** Plugin should run more optimized.

[[File:EquipSetBonus_Wildcards.png|600px]]

-

[[Horror Effects VisuStella MZ]]

Version 1.03: October 17, 2024
* Optimization Update!
** Plugin should run more optimized.

-

'''Tier 3 (5 Plugin Updates)

-

[[Action Sequence Camera VisuStella MZ]]

Version 1.14: October 17, 2024
* Optimization Update!
** Plugin should run more optimized.

-

[[Battle Voices VisuStella MZ]]

Version 1.06: October 17, 2024
* Bug Fixes!
** Fixed a bug where "Allow Self Response?" setting was inverted. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Irina:
*** Plugin Parameters > Defeat Type
**** When should defeat-related battle voices by played?
***** 0 HP - Plays when target reaches 0 HP the first time.
***** When Collapse - Plays when target performs collapse animation.

-

[[Choice Common Events VisuStella MZ]]

Version 1.02: October 17, 2024
* Optimization Update!
** Plugin should run more optimized.

-

[[Visual Cutin Effect VisuStella MZ]]

Version 1.01: October 17, 2024
* Bug Fixes!
** Fixed a crash where clearing cutins under certain conditions would cause an error. Fix made by Arisu.

-

[[Visual State Effects VisuStella MZ]]

Version 1.22: October 17, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Response Popup Settings
**** Popup settings for response-type state effects (ie Counter, Reflect, Substitute).
**** See help file for more information.

-

'''Tier 4 (3 Plugin Updates)

-

[[Combat Log VisuStella MZ]]

Version 1.14: October 17, 2024
* Compatibility Update!
** Plugin should be more compatible with Battle System - OTB.

-

[[Map Camera Zoom VisuStella MZ]]

Version 1.06: October 17, 2024
* Compatibility Update!
** Added better compatibility with Visual Parallaxes when using plugin commands to focus scroll.

-

[[Multi-Layer HP Gauge VisuStella MZ]]

Version 1.05: October 17, 2024
* Compatibility Update!
** Added better compatibility with In-Battle Status feature for Battle Core as to not cover up the window.

-







=== September 19, 2024 - Update #141 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (3 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.84: September 19, 2024
* Bug Fixes!
** Fixed a bug where Action Sequence "MOVE: Change Home By Distance" would also be affected by the actor and enemy position offsets. Fixed by Irina.
** Fixed a bug where Action Sequence "MECH: STB Exploit Effect" caused a crash. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Command added by Arisu:
*** ANIM: Change Battle Portrait (JS)
**** Changes the battle portrait of the actor through JavaScript.
**** Can be used outside of battle/action sequences.
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > In-Battle Status Window
**** This new window allows the player to view the status of the current active party. If the actors have states and buffs, the player can scroll through them and read about their effects through the help window.
** New Notetags added by Olivia:
*** <Help Description>
**** Assigns a help description for the state that's displayed under the new "Status" actor command.
*** <Exclude From Status Listing>
**** Excludes the state from being displayed in the status listing.
*** <Aspect Name: x>
*** <Aspect Icon: x>
*** <Aspect Color: x>
*** <Aspect Description>
**** Used to define enemy aspect that will show up in the In-Battle Status as well as other supported plugins.
*** <Popup Position: Head>
*** <Popup Position: Center>
*** <Popup Position: Base>
**** Changes the popup starting position for this enemy.
*** <Popup Offset X: +x>
*** <Popup Offset X: -x>
*** <Popup Offset Y: +y>
*** <Popup Offset Y: -y>
**** Changes the popup X/Y position offset for this enemy.
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Party Command Window > Add Status?
**** Add the "Status" command to the Command Window?
*** Plugin Parameters > Actor Command Window > Command List
**** Updated to have the "Status" command.
*** Plugin Parameters > In-Battle Status Window
**** Completely new! View the help file for more information.
*** Plugin Parameters > Enemy > Aspects
**** Used for the In-Battle Status as well as other supported plugins.

[[File:BattleCore_InBattleStatus1.png|600px]]

[[File:BattleCore_InBattleStatus2.png|600px]]

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.26: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Olivia:
*** Parameters > Element Rulings > Reflect-Element Ruling
**** Ruling on how element reflect is handled for multi-elements.
***** All (All elements must be Reflected)
***** Any (Only one element must be Reflected)
** New Notetag added by Olivia:
*** <Element Reflect Rule: All>
**** Makes this skill/item require all of the action's elements to be considered "reflected" in order for this action to be actually reflected.
*** <Element Reflect Rule: All>
**** Makes this skill/item require only one of action's element to be considered "reflected" in order for this action to be actually reflected.

-

[[Main Menu Core VisuStella MZ]]

Version 1.25: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Custom Mouse Cursor
**** Add/enable a custom mouse cursor for your game.

[[File:MainMenuCore_CustomCursor.gif]]

-

'''Tier 2 (2 Plugin Updates)

-

[[Battle System - OTB VisuStella MZ]]

Version 1.16: September 19, 2024
* Compatibility Update!
** Added better compatibility with Auto Skill Triggers. Update by Arisu.

-

[[Bestiary VisuStella MZ]]

Version 1.06: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Window Settings > Skills Window > Show Aspects
*** Parameters > Window Settings > Skills Window > Show Passives
**** Show enemy aspect/passives if available?
**** Requires VisuMZ_1_BattleCore/VisuMZ_1_SkillsStatesCore!

-

'''Tier 3 (3 Plugin Updates)

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.12: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Window Settings > Window Widths > Command Windows
*** Parameters > Window Settings > Window Widths > Action Windows
**** Type in the numeric value you want this width to be.
**** Otherwise, type "auto" to let the plugin adjust them.

-

[[State Tooltips VisuStella MZ]]

Version 1.08: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** Keyboard-Select Show added by Arisu.
*** This allows showing enemy tooltips when selecting targets during battle while using the keyboard. Tooltip will appear after a brief pause while selecting the enemy.
** New Plugin Parameters added by Arisu:
*** Parameters > Tooltip Settings > Appearance > Centered?
**** Center the state tooltip when shown through hovering?
*** Parameters > Tooltip Settings > Keyboard-Select Show
**** See help file for more information.
*** Parameters > Vocabulary > Entries > Enemy Aspect Format
**** Used to support the Battle Core's new Enemy Aspect feature.

-

[[Steal Items VisuStella MZ]]

Version 1.09: September 19, 2024
* Compatibility Update!
** Added better compatibility with Frontview Battle UI.

-

'''Tier 4 (1 Plugin Update)

-

[[Encounter Effects VisuStella MZ]]

Version 1.11: September 19, 2024
* Documentation Update!
** Help file updated for new features.
** Added new section in Major Features section for new Battle Transitions.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > Default Battle Transition
**** Select the default battle transition (10 new ones, 1 MZ original).
*** Parameters > Default Battle Transition > Duration
**** What is the duration of every battle transition in frames?
*** Parameters > Default Battle Transition > Random List
**** Pick battle transition types used for "random".
** New Plugin Commands added by Irina:
*** Battle Transition: Change Type
**** Changes the battle transition type.
*** Battle Transition: Duration
**** Changes the battle transition duration.

[[File:EncEffect_Abberation.gif]]

[[File:EncEffect_Glitch.gif]]

[[File:EncEffect_Static.gif]]

[[File:EncEffect_Twirl.gif]]

[[File:EncEffect_Warp.gif]]

-

Template:MainPageLatestPlugins

2026-03-15T11:54:04Z

Irina:

<noinclude>__NOTOC__ 
{| style="width: 800px;" cellspacing="0" cellpadding="0"
|
</noinclude>
{| style="width: 100%;" cellspacing="5" cellpadding="0"

{{NewsEntry
|date = 2026 March 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #159]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 6 Plugins
: ‎
: Mostly bug fixes and compatibility updates!
}}

{{NewsEntry
|date = 2026 February 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #158]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 5 Plugins
: ‎
: Mostly bug fixes!
: Happy Lunar New Year!❤️
}}

{{NewsEntry
|date = 2026 January 19
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #157]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 9 Plugins
: ‎
: [[Events and Movement Core VisuStella MZ]]
; New Features: Reference Switches and Reference Variables
:
: [[Battle System - OTB VisuStella MZ]]
; New Features: Auto-Conversion for States
}}

{{NewsEntry
|date = 2025 December 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #156]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 12 Plugins
: ‎
: [[Events and Movement Core VisuStella MZ]]
; New Plugin Parameter
:
: [[Extended Message Functionality VisuStella MZ]]
; New Features/Plugin Parameters
:
: [[Map Camera Zoom VisuStella MZ]]
; New Plugin Parameter
}}

{{NewsEntry
|date = 2025 November 13
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #155]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 4 Plugins
: ‎
: [[Elements and Status Menu Core VisuStella MZ]]
; New notetag
:
: [[Battle System - OTB VisuStella MZ]]
; New script calls
:
: [[Extended Message Functionality VisuStella MZ]]
; New Voice Acting Plugin Parameters
}}

{{NewsEntry
|date = 2025 October 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #154]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 5 Plugins
: ‎
: This month's changes are bug fixes and compatibility patches!
}}

{{NewsEntry
|date = 2025 September 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #153]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 11 Plugins
: ‎
: Mostly bug fixes and compatibility patches this month!
}}







|}
<noinclude>== Archived ==
{| style="width: 800px;" cellspacing="0" cellpadding="0"
|







{{NewsEntry
|date = 2025 August 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #152]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 6 Plugins
: ‎
: All bug fixes and compatibility patches this month
}}

{{NewsEntry
|date = 2025 July 17
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #151]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 7 Plugins
: ‎
: All bug fixes and compatibility patches this month
}}

{{NewsEntry
|date = 2025 June 12
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #150]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 9 Plugins
: ‎
: AP, SP, CP, and JP got new notetags to give more options to gain bonuses.
}}

{{NewsEntry
|date = 2025 May 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #149]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 16 Plugins
: ‎
: Mostly bug fixes and compatibility patches
}}

{{NewsEntry
|date = 2025 May 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #149]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 16 Plugins
: ‎
: Mostly bug fixes and compatibility patches
}}

{{NewsEntry
|date = 2025 April 17
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #148]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 9 Plugins
: ‎
: Skill Toggles have been added
: [[File:SkillToggle.gif|228px|center|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2025 March 20
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #147]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 11 Plugins
: Many bug fixes and new features!
: [[File:WeaknessUpdate.png|228px|center|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2025 February 20
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #146]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 33 Plugins
: Mostly compatibility updates for RMMZ 1.9.0!
: ‎
: Read more about the RMMZ 1.9.0 changes here:
: [[File:RMMZ_190.png|228px|center|link=RMMZ Changelog]]
}}

{{NewsEntry
|date = 2025 January 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #145]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 21 Plugins
: Bug fixes and new features!
: ‎
: We wish you all a very Happy New Year!
: [[File:HappyNewYear2025.jpg|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 December 19
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #144]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 13 Plugins
: Bug fixes and new features!
: ‎
: Skills & States Core
: Aura and Miasma Passives
: [[File:SkillsStatesCore_Aura.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 November 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #143]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]
: Total Updated: 13 Plugins
: Bug fixes and new features!
: ‎
: Items & Equips Core
: Shop Status Window Styles
: [[File:ItemEquipCore_StatusWindowStyles.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 October 17
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #142]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 18 Plugins
: Bug fixes and new features!
: ‎-
: Equipment Set Bonuses
: Set Wildcards
: [[File:EquipSetBonus_Wildcards.png|300px|link=VisuStella MZ Changelog]]

}}

{{NewsEntry
|date = 2024 September 20
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustella.itch.io/visumz-sample Battle Core]:''' Fixed an error with in-battle status where buffed parameter value were visibly hidden.
:: '''[https://visustellamz.itch.io/multi-layer-hp-gauge Multi-Layer HP Gauge]:''' Fixed an error where multi-layer HP gauges would cover the in-battle status window.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 September 19
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #141]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 9 Plugins
: Bug fixes and new features!
: ‎-
: Battle Core
: In-Battle Status
: [[File:BattleCore_InBattleStatus1.png|300px|link=VisuStella MZ Changelog]]
: -
: Main Menu Core
: Custom Mouse Cursor
: [[File:MainMenuCore_CustomCursor.gif|300px|link=VisuStella MZ Changelog]]
: -
: Encounter Effects
: Battle Transition Effects
: [[File:EncEffect_Glitch.gif|300px|link=VisuStella MZ Changelog]]
: [[File:EncEffect_Twirl.gif|300px|link=VisuStella MZ Changelog]]
: [[File:EncEffect_Warp.gif|300px|link=VisuStella MZ Changelog]]

}}

{{NewsEntry
|date = 2024 August 29
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #140]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 16 Plugins
: Bug fixes and new features!
: ‎
: Core Engine
: Taller Tiles
: [[File:CoreEngine-TallerTiles.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 July 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #139]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 22 Plugins
: Lots of bug fixes and new features!
: ‎
: Options Core
: Rebind Keyboard/Controller
: [[File:OptionsCoreRebind1.png|300px|link=VisuStella MZ Changelog]]
: [[File:OptionsCoreRebind2.png|300px|link=VisuStella MZ Changelog]]
: [[File:OptionsCoreRebind3.png|300px|link=VisuStella MZ Changelog]]
: ‎
: Message Core
: Auto-Casing
: [[File:MessageCore-AutoCasing.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 June 13
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #138]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 18 Plugins
: Lots of bug fixes and new features!
: ‎
: Extended Tactics Menu
: [[File:BattleGridSystem_ExtendedTactics.png|300px|link=VisuStella MZ Changelog]]
: ‎
: Tile expansion!
: [[File:EventsMoveCore_TileExpand.png|300px|link=VisuStella MZ Changelog]]
: ‎
: Extinction Effect
: [[File:LifeStateEffects_Extinct.gif|300px|link=VisuStella MZ Changelog]]
: ‎
: Cascading Message Tooltips
: [[File:MessageKeywords_Cascades.png|300px|link=VisuStella MZ Changelog]]
}}

{{NewsEntry
|date = 2024 May 18
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustella.itch.io/visumz-sample Battle Core]:''' Fixed an error that would cause a crash with Show Animation on the map scene.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 May 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #137]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 28 Plugins
: Lots of bug fixes and new features!
: [[File:DmgComboWindow.png]]
: A damage combo window added to Battle Core!
}}

{{NewsEntry
|date = 2024 May 8
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustella.itch.io/visumz-sample Skills & States Core]:''' Fixed an error with conditional switches not working for passive states.
:: '''[https://visustellamz.itch.io/character-creation-system Character Creation System]:''' Fixed an error with BGM fading out after scene.
:: '''[https://visustellamz.itch.io/skill-learn-system Skill Learn System]:''' Fixed incompatibility problem with Equip Passive System and ID clashing.
:: '''[https://visustellamz.itch.io/item-amplify-skills Item Amplify Skills]:''' Fixed incompatibility problem with Sideview Battle UI.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 April 22
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustellamz.itch.io/battle-grid-system Battle Grid System]:''' Fixed ''Area of Effect'' notetags should now work with regular targeting again.
:: '''[https://visustellamz.itch.io/equip-medal-system Equip Medal System]:''' Fixed odd error when medals have MaxHP/MaxMP traits.
:: '''[https://visustellamz.itch.io/unique-tile-effects Unique Tile Effects]:''' ''Can Swim'' notetag can now work from inventory.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 April 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #136]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 30 Plugins
: Lots of bug fixes and new features!
}}

{{NewsEntry
|date = 2024 March 31
|align = left
|content =
<center>Hot Fix made for multiple plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustella.itch.io/visumz-sample Skills & States Core]:''' Non-show passive state fixes.
:: '''[https://visustellamz.itch.io/battle-grid-system Battle Grid System]:''' Lots of fixes.
:: '''[https://visustellamz.itch.io/date-time-system Date & Time System]:''' Fix HUD display plugin parameters.
:: '''[https://visustellamz.itch.io/equip-battle-skills Equip Battle Skills]:''' Better Command Remember support.
:: '''[https://visustellamz.itch.io/equip-passive-system Equip Passive States]:''' Fixed non-description crash.
:: '''[https://visustellamz.itch.io/event-chain-reactions Event Chain Reactions]:''' Non-heavy player fix.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 March 29
|align = center
|content =
; [[Battle Grid System VisuStella MZ]]

: [[File:VisuMZ.150.jpg|300px|link=Battle Grid System VisuStella MZ]]
: VisuStella MZ's '''Battle Grid System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/swoS2bwVj0k here]!
: This is VisuStella MZ's #150th plugin!
}}

{{NewsEntry
|date = 2024 March 27
|align = center
|content =
; [[Equip Medal System VisuStella MZ]]

: [[File:VisuMZ.149.jpg|300px|link=Equip Medal System VisuStella MZ]]
: VisuStella MZ's '''Equip Medal System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/guIvEDn_X3o here]!
: This is VisuStella MZ's #149th plugin!
}}

{{NewsEntry
|date = 2024 March 25
|align = center
|content =
; [[Equip Passive System VisuStella MZ]]

: [[File:VisuMZ.148.jpg|300px|link=Equip Passive System VisuStella MZ]]
: VisuStella MZ's '''Equip Passive System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/n_X2J2Q9FHQ here]!
: This is VisuStella MZ's #148th plugin!
}}

{{NewsEntry
|date = 2024 March 18 + 24
|align = left
|content =
<center>Hot Fix made for 1 plugin!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustellamz.itch.io/battle-grid-system Battle Grid System]:'''
::: Fixed a game freeze that would occur from displaying certain skill types within non-battle scenes.
::: Fixed a bug with weapon ranges used by enemies not registering correctly
::: Fixed a bug where crash targets did not register properly
::: Fixed a bug where starting ranks/flanks did not register properly
::: Fixed a notetag example that was just incorrect and wouldn't do anything

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 March 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #135]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 28 Plugins
: Lots of bug fixes!
}}

{{NewsEntry
|date = 2024 March 6
|align = left
|content =
<center>Hot Fix made for 5 plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustellamz.itch.io/equip-passive-system Equip Passive System]:''' Fixed some notetags that did not allow for numeric ID's.
:: '''[https://visustellamz.itch.io/equip-medal-system Equip Medal System]:''' Fixed some notetags that did not allow for numeric ID's. Also fixed the evolve into next notetag.
:: '''[https://visustellamz.itch.io/item-concoct-skills Item Concoction Skills]:''' Fixed masking not updating.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 February 24
|align = left
|content =
<center>Hot Fix made for 5 plugins!</center>
: [[File:HotFix.jpg|300px|center|link=]]
: A hot fix has been made for the following plugins:
:: '''[https://visustellamz.itch.io/aggro-control-system Aggro Control System]:''' Updated to better fit Battle Grid System
:: '''[https://visustellamz.itch.io/battle-grid-system Battle Grid System]:''' Fixed a bug where it required State Tooltips; Fixed a bug where the action sequence to add triggers to nodes did not work
:: '''[https://visustellamz.itch.io/item-crafting-system Item Crafting System]:''' Fixed a crash that would otherwise require the batch shop plugin.
:: '''[https://visustellamz.itch.io/equip-passive-system Equip Passive System]:''' Fixed a crash that required passives to have help descriptions
:: '''[https://visustellamz.itch.io/equip-medal-system Equip Medal System]:''' Fixed the inability to access the medal menu if "Optimize" and "Clear" were removed.

: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2024 February 24
|align = center
|content =
; [https://visustellamz.itch.io/grande Early Access for the Grande Series has begun!]

: [[File:Grande.jpg|300px|link=https://visustellamz.itch.io/grande]]

: Includes the following Plugins:

; [[Equip Passive System VisuStella MZ]]
; [[Equip Medal System VisuStella MZ]]
; [[Battle Grid System VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2024 February 23
|align = center
|content =
; [[Tile Grafter System VisuStella MZ]]

: [[File:VisuMZ.147.jpg|300px|link=Tile Grafter System VisuStella MZ]]
: VisuStella MZ's '''Tile Grafter System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/3bbNd1Z_pX8 here]!
: This is VisuStella MZ's #147th plugin!
}}

{{NewsEntry
|date = 2024 February 21
|align = center
|content =
; [[Picture Effects VisuStella MZ]]

: [[File:VisuMZ.146.jpg|300px|link=Picture Effects VisuStella MZ]]
: VisuStella MZ's '''Picture Effects VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/e_p8YAnEjbM here]!
: This is VisuStella MZ's #146th plugin!
}}

{{NewsEntry
|date = 2024 February 19
|align = center
|content =
; [[Date and Time System VisuStella MZ]]

: [[File:VisuMZ.145.jpg|300px|link=Date and Time System VisuStella MZ]]
: VisuStella MZ's '''Date and Time System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/qOF1qCMqqyU here]!
: This is VisuStella MZ's #145th plugin!
}}

{{NewsEntry
|date = 2024 February 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #134]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 21 Plugins
: Lots of new features added including Custom Font Manager!
}}

{{NewsEntry
|date = 2024 January 29
|align = center
|content =
; [https://visustellamz.itch.io/wanderlust-vol-2 Early Access for the Wanderlust Series Volume 2 has begun!]

: [[File:WanderlustVol2.jpg|300px|link=https://visustellamz.itch.io/wanderlust-vol-2]]

: Includes the following Plugins:

; [[Date and Time System VisuStella MZ]]
; [[Picture Effects VisuStella MZ]]
; [[Tile Grafter System VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2024 January 26
|align = center
|content =
; [[Dice Rolls and RNG Seeds VisuStella MZ]]

: [[File:VisuMZ.144.jpg|300px|link=Dice Rolls and RNG Seeds VisuStella MZ]]
: VisuStella MZ's '''Dice Rolls and RNG Seeds VisuStella MZ''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=EwwPnRvCrS4 here]!
: This is VisuStella MZ's #144th plugin!
}}

{{NewsEntry
|date = 2024 January 24
|align = center
|content =
; [[Event Signals VisuStella MZ]]

: [[File:VisuMZ.143.jpg|300px|link=Event Signals VisuStella MZ]]
: VisuStella MZ's '''Event Signals VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/lLCr7T93Ndw here]!
: This is VisuStella MZ's #143rd plugin!
}}

{{NewsEntry
|date = 2024 January 22
|align = center
|content =
; [[QTE and Trigger System VisuStella MZ]]

: [[File:VisuMZ.142.jpg|300px|link=QTE and Trigger System VisuStella MZ]]
: VisuStella MZ's '''QTE and Trigger System VisuStella MZ''' plugin for official release!
: Watch the preview video [https://youtu.be/UTak0ezYszI here]!
: This is VisuStella MZ's #142nd plugin!
}}

{{NewsEntry
|date = 2024 January 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #133]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 16 Plugins
: Lots of new features added including Text & Audio Language Switching!
}}

{{NewsEntry
|date = 2024 January 2
|align = center
|content =
; [https://visustellamz.itch.io/custom-construct-vol-4 Early Access for the Custom Construct Series Volume 4 has begun!]

: [[File:CustomConstructVol4.jpg|300px|link=https://visustellamz.itch.io/custom-construct-vol-4]]

: Includes the following Plugins:

; [[QTE and Trigger System VisuStella MZ]]
; [[Event Signals VisuStella MZ]]
; [[Dice Rolls and RNG Seeds VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 December 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #132]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 24 Plugins
}}

{{NewsEntry
|date = 2023 December 1
|align = center
|content =
; [[Shop Bust Style UI VisuStella MZ]]

: [[File:VisuMZ.141.jpg|300px|link=Shop Bust Style UI VisuStella MZ]]
: VisuStella MZ's '''Shop Bust Style UI''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=MDgeccpI3-0 here]!
: This is VisuStella MZ's #141st plugin!
}}

{{NewsEntry
|date = 2023 November 30
|align = center
|content =
; Hot Fix made for 3 plugins!
: [[File:HotFix.jpg|300px|link=]]
: A hot fix has been made for the following plugins:
: [https://visustella.itch.io/visumz-sample Message Core] (better Wordwrap Support for CN/JP)
: [https://visustella.itch.io/visumz-sample Items & Equips Core] (fixed Cursed Item message)
: [https://visustellamz.itch.io/skill-shop Skill Shop] (fixed crash at startup)
: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2023 November 29
|align = center
|content =
; [[Shop Batches VisuStella MZ]]

: [[File:VisuMZ.140.jpg|300px|link=Shop Batches VisuStella MZ]]
: VisuStella MZ's '''Shop Batches''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=fYBUbaifslU here]!
: This is VisuStella MZ's #140th plugin!
}}

{{NewsEntry
|date = 2023 November 27
|align = center
|content =
; [[Shop Listing Unlock VisuStella MZ]]

: [[File:VisuMZ.139.jpg|300px|link=Shop Listing Unlock VisuStella MZ]]
: VisuStella MZ's '''Shop Listing Unlock''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=D2PGsbSZUUY here]!
: This is VisuStella MZ's #139th plugin!
}}

{{NewsEntry
|date = 2023 November 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #131]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 17 Plugins
}}

{{NewsEntry
|date = 2023 October 30
|align = center
|content =
; [https://visustellamz.itch.io/merchant-manager-series-vol-4 Early Access for the Merchant Manager Series Volume 4 has begun!]

: [[File:MerchantManagerVol4.jpg|300px|link=https://visustellamz.itch.io/merchant-manager-series-vol-4]]

: Includes the following Plugins:

; [[Shop Listing Unlock VisuStella MZ]]
; [[Shop Batches VisuStella MZ]]
; [[Shop Bust Style UI VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 October 27
|align = center
|content =
; [[Item Amplify Skills VisuStella MZ]]

: [[File:VisuMZ.138.jpg|300px|link=Item Amplify Skills VisuStella MZ]]
: VisuStella MZ's '''Item Amplify Skills''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=o2uU2f08-oU here]!
: This is VisuStella MZ's #138th plugin!
}}

{{NewsEntry
|date = 2023 October 25
|align = center
|content =
; [[Item Concoction Skills VisuStella MZ]]

: [[File:VisuMZ.137.jpg|300px|link=Item Concoction Skills VisuStella MZ]]
: VisuStella MZ's '''Item Concoction Skills''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=BZ0AAnKa-cA here]!
: This is VisuStella MZ's #137th plugin!
}}

{{NewsEntry
|date = 2023 October 23
|align = center
|content =
; [[Item Throw Skills VisuStella MZ]]

: [[File:VisuMZ.136.jpg|300px|link=Item Throw Skills VisuStella MZ]]
: VisuStella MZ's '''Item Throw Skills''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=16yks-S7o_s here]!
: This is VisuStella MZ's #136th plugin!
}}

{{NewsEntry
|date = 2023 October 12
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #130]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 13 Plugins
}}

{{NewsEntry
|date = 2023 October 4
|align = center
|content =
; [https://visustellamz.itch.io/combat-crusaders-vol-2 Early Access for the Combat Crusaders Series Volume 2 has begun!]

: [[File:CombatCrusadersVol2.jpg|300px|link=https://visustellamz.itch.io/combat-crusaders-vol-2]]

: Includes the following Plugins:

: [[Item Throw Skills VisuStella MZ]]
: [[Item Concoction Skills VisuStella MZ]]
: [[Item Amplify Skills VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 September 29
|align = center
|content =
; [[Character Creation System VisuStella MZ]]

: [[File:VisuMZ.135.jpg|300px|link=Character Creation System VisuStella MZ]]
: VisuStella MZ's '''Character Creation System''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=BHMzb6UUgQM here]!
: This is VisuStella MZ's #135th plugin!
}}

{{NewsEntry
|date = 2023 September 27
|align = center
|content =
; [[Challenge System VisuStella MZ]]

: [[File:VisuMZ.134.jpg|300px|link=Challenge System VisuStella MZ]]
: VisuStella MZ's '''Challenge System''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=Iz1YjaMpeuc here]!
: This is VisuStella MZ's #134th plugin!
}}

{{NewsEntry
|date = 2023 September 25
|align = center
|content =
; [[Random Dungeon Maps VisuStella MZ]]

: [[File:VisuMZ.133.jpg|300px|link=Random Dungeon Maps VisuStella MZ]]
: VisuStella MZ's '''Random Dungeon Maps''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=ZEF2WyxDDSU here]!
: This is VisuStella MZ's #133nd plugin!
}}

{{NewsEntry
|date = 2023 September 14
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #129]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 19 Plugins
}}

{{NewsEntry
|date = 2023 September 2
|align = center
|content =
; [https://visustellamz.itch.io/dungeon-divers-vol-2 Early Access for the Dungeon Divers Series Volume 2 has begun!]

: [[File:DungeonDiversVol2.jpg|300px|link=https://visustellamz.itch.io/dungeon-divers-vol-2]]


: Includes the following Plugins:

: [[Random Dungeon Maps VisuStella MZ]]
: [[Challenge System VisuStella MZ]]
: [[Character Creation System VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 September 1
|align = center
|content =
; [[Side Chatter VisuStella MZ]]

: [[File:VisuMZ.132.jpg|300px|link=Side Chatter VisuStella MZ]]
: VisuStella MZ's '''Side Chatter''' plugin for official release!
: Watch the preview video [https://youtu.be/-BfMuGK4HAU here]!
: This is VisuStella MZ's #132nd plugin!
}}

{{NewsEntry
|date = 2023 August 30
|align = center
|content =
; [[Battle Voices VisuStella MZ]]

: [[File:VisuMZ.131.jpg|300px|link=Battle Voices VisuStella MZ]]
: VisuStella MZ's '''Battle Voices''' plugin for official release!
: Watch the preview video [https://youtu.be/3mBMJL4rbFc here]!
: This is VisuStella MZ's #131st plugin!
}}

{{NewsEntry
|date = 2023 August 28
|align = center
|content =
; [[Voice Acting Control VisuStella MZ]]

: [[File:VisuMZ.130.jpg|300px|link=Voice Acting Control VisuStella MZ]]
: VisuStella MZ's '''Voice Acting Control''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=cHlAP5bBJEY here]!
: This is VisuStella MZ's #130th plugin!
}}

{{NewsEntry
|date = 2023 August 17
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #128]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 26 Plugins
}}

{{NewsEntry
|date = 2023 July 29
|align = center
|content =
; [https://visustellamz.itch.io/visual-novel-vol-4 Early Access for the Visual Novel Series Volume 4 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/2193581" width="208" height="167"><a href="https://visustellamz.itch.io/visual-novel-vol-4">[Access Key] Visual Novel Series Vol. 4 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Voice Acting Control VisuStella MZ]]
: [[Battle Voices VisuStella MZ]]
: [[Side Chatter VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 July 28
|align = center
|content =
; [[Icon Balloons VisuStella MZ]]

: [[File:VisuMZ.129.jpg|300px|link=Icon Balloons VisuStella MZ]]
: VisuStella MZ's '''Icon Balloons''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=seSLVWpaaVc here]!
: This is VisuStella MZ's #129th plugin!
}}

{{NewsEntry
|date = 2023 July 26
|align = center
|content =
; [[Proximity Messages VisuStella MZ]]

: [[File:VisuMZ.128.jpg|300px|link=Proximity Messages VisuStella MZ]]
: VisuStella MZ's '''Proximity Messages''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=oLHPOoqg6kc here]!
: This is VisuStella MZ's #128th plugin!
}}

{{NewsEntry
|date = 2023 July 24
|align = center
|content =
; [[Map Event Effects VisuStella MZ]]

: [[File:VisuMZ.127.jpg|300px|link=Map Event Effects VisuStella MZ]]
: VisuStella MZ's '''Map Event Effects''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=Kk11pfa3v6w here]!
: This is VisuStella MZ's #127th plugin!
}}

{{NewsEntry
|date = 2023 July 13
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #127]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 23 Plugins
}}

{{NewsEntry
|date = 2023 July 1
|align = center
|content =
; [https://visustellamz.itch.io/enchanted-explorers-vol-2 Early Access for the Enchanted Explorers Series Volume 2 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/2142226" width="208" height="167"><a href="https://visustellamz.itch.io/enchanted-explorers-vol-2">[Access Key] Enchanted Explorers Series Volume 2 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Map Event Effects VisuStella MZ]]
: [[Proximity Messages VisuStella MZ]]
: [[Icon Balloons VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 June 30
|align = center
|content =
; [[Skill Stealer VisuStella MZ]]

: [[File:VisuMZ.126.jpg|300px|link=Skill Stealer VisuStella MZ]]
: VisuStella MZ's '''Skill Stealer''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=ab6cIhYMav8 here]!
: This is VisuStella MZ's #126th plugin!
}}

{{NewsEntry
|date = 2023 June 28
|align = center
|content =
; [[Skill Mastery VisuStella MZ]]

: [[File:VisuMZ.125.jpg|300px|link=Skill Mastery VisuStella MZ]]
: VisuStella MZ's '''Skill Mastery''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=hjAEq9xIuA4 here]!
: This is VisuStella MZ's #125th plugin!
}}

{{NewsEntry
|date = 2023 June 26
|align = center
|content =
; [[Equip Battle Skills VisuStella MZ]]

: [[File:VisuMZ.124.jpg|300px|link=Equip Battle Skills VisuStella MZ]]
: VisuStella MZ's '''Equip Battle Skills''' plugin for official release!
: Watch the preview video [https://youtu.be/EKaSYFdUdEE here]!
: This is VisuStella MZ's #124th plugin!
}}

{{NewsEntry
|date = 2023 June 15
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #126]]
: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 14 Plugins
}}

{{NewsEntry
|date = 2023 May 31
|align = center
|content =
; Hot Fix made for 2 plugins!
: [[File:HotFix.jpg|300px|link=]]
: A hot fix has been made for the following plugins:
: [https://visustellamz.itch.io/frontview-battle-ui Frontview Battle UI]
: [https://visustellamz.itch.io/furniture-system Furniture System]
: Please download them again.
: Thank you for your patience and sorry for the inconvenience.
}}

{{NewsEntry
|date = 2023 May 27
|align = center
|content =
; [https://visustellamz.itch.io/battle-technician-vol-4 Early Access for the Battle Technician Series Volume 4 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/2088596" width="208" height="167"><a href="https://visustellamz.itch.io/battle-technician-vol-4">[Access Key] Battle Technician Series Vol. 4 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Equip Battle Skills VisuStella MZ]]
: [[Skill Mastery VisuStella MZ]]
: [[Skill Stealer VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].
}}

{{NewsEntry
|date = 2023 May 26
|align = center
|content =
; [[Skill Shop VisuStella MZ]]

: [[File:VisuMZ.123.jpg|300px|link=Skill Shop VisuStella MZ]]
: VisuStella MZ's '''Skill Shop''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=jNZerP-1hXY here]!
: This is VisuStella MZ's #123 plugin!

}}

{{NewsEntry
|date = 2023 May 24
|align = center
|content =
; Hot Fix made for Battle System - ATB
: [[File:VisuMZ.022.jpg|300px|link=https://visustellamz.itch.io/battle-system-atb]]
: A hot fix has been made for the Battle System - ATB plugin.
: [https://visustellamz.itch.io/battle-system-atb Please download it again].
: Thank you and sorry for the inconvenience!
}}

{{NewsEntry
|date = 2023 May 24
|align = center
|content =
; [[Recruiting Board VisuStella MZ]]

: [[File:VisuMZ.122.jpg|300px|link=Recruiting Board VisuStella MZ]]
: VisuStella MZ's '''Recruiting Board''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=j-QoO5dSja8 here]!
: This is VisuStella MZ's #122 plugin!

}}

{{NewsEntry
|date = 2023 May 22
|align = center
|content =
; [[Hospital Shop VisuStella MZ]]

: [[File:VisuMZ.121.jpg|300px|link=Hospital Shop VisuStella MZ]]
: VisuStella MZ's '''Hospital Shop''' plugin for official release!
: Watch the preview video [https://www.youtube.com/watch?v=FdzG-ealtys here]!
: This is VisuStella MZ's #121 plugin!

}}

{{NewsEntry
|date = 2023 May 18
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #125]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 17 Plugins
}}

{{NewsEntry
|date = 2023 April 13
|align = center
|content =
; [https://visustellamz.itch.io/merchant-manager-series-vol-3 Early Access for the Merchant Manager Series Volume 3 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/2013860" width="208" height="167"><a href="https://visustellamz.itch.io/merchant-manager-series-vol-3">[Access Key] Merchant Manager Series Vol. 3 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Hospital Shop VisuStella MZ]]
: [[Recruiting Board VisuStella MZ]]
: [[Skill Shop VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].

; [[VisuStella MZ Changelog|Plugin Updates! Update #124]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 9 Plugins

}}

{{NewsEntry
|date = 2023 April 7
|align = center
|content =
; [[Multi-Layer HP Gauge VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=HgrL31Smu08</youtube>

}}

{{NewsEntry
|date = 2023 April 5
|align = center
|content =
; [[Visual Gauge Styles VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=J7r-Yx2MBSA</youtube>

}}

{{NewsEntry
|date = 2023 April 3
|align = center
|content =
; [[Bestiary VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=VGzXdawZ16M</youtube>

}}

{{NewsEntry
|date = 2023 March 16
|align = center
|content =
; Hot Fix!

Hot fixes have been made for plugin(s) below. Please download them again:

: [[Unique Tile Effects VisuStella MZ]]

; [[VisuStella MZ Changelog|Plugin Updates! Update #123]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 22 Plugins
}}

{{NewsEntry
|date = 2023 February 16
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #122]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 19 Plugins

}}

{{NewsEntry
|date = 2023 January 21
|align = center
|content =
; [https://visustellamz.itch.io/visual-novel-vol-3 Early Access for the Visual Novel Series Volume 3 has begun!]

: <html><center><iframe frameborder="0" src="https://itch.io/embed/1886739" width="208" height="167"><a href="https://visustellamz.itch.io/visual-novel-vol-3">[Access Key] Visual Novel Series Vol. 3 by VisuStellaMZ</a></iframe></center></html>

: Includes the following Plugins:

: [[Animated Message Text Effects VisuStella MZ]]
: [[Visual Cutin Effect VisuStella MZ]]
: [[CG Gallery VisuStella MZ]]

: These plugins are '''NOT''' a part of the [https://visustellamz.itch.io/waves-access-key-visustella-mz 8 Waves Bundle Collection].

}}

{{NewsEntry
|date = 2023 January 20
|align = center
|content =
; [[VisuStella MZ Changelog|Plugin Updates! Update #121]]

; [[VisuStella Sample Game Project]]

: [[File:VisuMZChangelog.png|300px|center|link=VisuStella MZ Changelog]]

: Total Updated: 23 Plugins

}}

{{NewsEntry
|date = 2023 January 6
|align = center
|content =
; [[Unique Tile Effects VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=lZesyw9DFdo</youtube>

}}

{{NewsEntry
|date = 2023 January 4
|align = center
|content =
; [[Event Chain Reactions VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=RY7rxwZTw0I</youtube>

}}

{{NewsEntry
|date = 2023 January 2
|align = center
|content =
; [[Tutorial Panel System VisuStella MZ]]

: <youtube width="320" height="180">https://www.youtube.com/watch?v=Y9CwVDMpOPc</youtube>

}}

{{Latest Plugins 2023}}
{{Latest Plugins 2022 Q4}}
{{Latest Plugins 2022 Q3}}
{{Latest Plugins 2022 Q2}}
{{Latest Plugins 2022 Q1}}
{{Latest Plugins 2021 Q4}}
{{Latest Plugins 2021 Q3}}
{{Latest Plugins 2021 Q2}}
{{Latest Plugins 2021 Q1}}
{{Latest Plugins 2020 Q4}}
{{Latest Plugins 2020 Q3}}
{{Latest Plugins 2020 Q2}}
{{Latest Plugins 2020 Q1}}
{{Latest Plugins 2019}}

[[Category:Display templates|MainPageLatestPlugins]]
</noinclude>
<noinclude>|}</noinclude>

Template:VisuMZ Skills and States Core Notetags

2026-03-15T02:03:45Z

Irina:

<noinclude>[[Category:Display templates|VisuMZ Skills and States Core Notetags]]</noinclude>
The following are notetags that have been added through this plugin. These
notetags will not work with your game if this plugin is OFF or not present.

=== General Skill Notetags ===

[[File:SkillsStatesCoreStype.png]]

The following are general notetags that are skill-related.

---

<pre>
<Skill Type: x>
<Skill Types: x,x,x>

<Skill Type: name>
<Skill Types: name, name, name>

- Used for: Skill Notetags
- Marks the skill to have multiple Skill Types, meaning they would appear
under different skill types without needing to create duplicate skills.
- Replace 'x' with a number value representing the Skill Type's ID.
- If using 'name' notetag variant, replace 'name' with the Skill Type(s)
name desired to be added.
</pre>

---

<pre>
<List Name: name>

- Used for: Skill Notetags
- Makes the name of the skill appear different when show in the skill list.
- Using \V[x] as a part of the name will display that variable.
- If used with Battle Core's <Command Text: x>, the Command Text notetag
will take priority in the command window, but the List Name notetag will
appear in the skill list.
- This does not change the display text. If you'd like to change that, use
the Battle Core's <Display Text: x> notetag along with this notetag.
</pre>

---

<pre>
<ID Sort Priority: x>

- Used for: Skill Notetags
- Used for Scene_Skill.
- Changes sorting priority by ID for skills to 'x'.
- Default priority level is '50'.
- Skills with higher priority values will be sorted higher up on the list
while lower values will be lower on the list.
</pre>

---

=== Skill Cost Notetags ===

[[File:SkillsStatesSkillCosts.png|600px]]

The following are notetags that can be used to adjust skill costs. Some of
these notetags are added through the Plugin Parameter: Skill Cost Types and
can be altered there. This also means that some of these notetags can have
their functionality altered and/or removed.

---

<pre>
<type Cost: x>
<type Cost: x%>

- Used for: Skill Notetags
- These notetags are used to designate costs of custom or already existing
types that cannot be made by the Database Editor.
- Replace 'type' with a resource type. Existing ones found in the Plugin
Parameters are 'HP', 'MP', 'TP', 'Gold', and 'Potion'. More can be added.
- Replace 'x' with a number value to determine the exact type cost value.
This lets you bypass the Database Editor's limit of 9,999 MP and 100 TP.
- The 'x%' version is replaced with a percentile value to determine a cost
equal to a % of the type's maximum quantity limit.
- Functionality for these notetags can be altered in the Plugin Parameters.

Examples:
<HP Cost: 500>
<MP Cost: 25%>
<Gold Cost: 3000>
<Potion Cost: 5>
</pre>

---

<pre>
<type Cost Max: x>
<type Cost Min: x>

- Used for: Skill Notetags
- These notetags are used to ensure conditional and % costs don't become too
large or too small.
- Replace 'type' with a resource type. Existing ones found in the Plugin
Parameters are 'HP', 'MP', 'TP', 'Gold', and 'Potion'. More can be added.
- Replace 'x' with a number value to determine the maximum or minimum values
that the cost can be.
- Functionality for these notetags can be altered in the Plugin Parameters.

Examples:
<HP Cost Max: 1500>
<MP Cost Min: 5>
<Gold Cost Max: 10000>
<Potion Cost Min: 3>
</pre>

---

<pre>
<type Cost: +x>
<type Cost: -x>

<type Cost: x%>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- The related actor will raise/lower the cost of any skill that uses the
'type' cost by a specified amount.
- Replace 'type' with a resource type. Existing ones found in the Plugin
Parameters are 'HP', 'MP', 'TP', 'Gold', and 'Potion'. More can be added.
- For % notetag variant: Replace 'x' with a number value to determine the
rate to adjust the Skill Cost Type by as a rate value. This is applied
before <type Cost: +x> and <type Cost: -x> notetags.
- For + and - notetag variants: Replace 'x' with a number value to determine
how much to adjust the Skill Cost Type by as a flat value. This is applied
after <type Cost: x%> notetags.
- Functionality for these notetags can be altered in the Plugin Parameters.

Examples:
<HP Cost: +20>
<MP Cost: -10>
<Gold Cost: 50%>
<Potion Cost: 200%>
</pre>

---

<pre>
<Custom Cost Text>
text
</Custom Cost Text>

- Used for: Skill Notetags
- Allows you to insert custom text into the skill's cost area towards the
end of the costs.
- Replace 'text' with the text you wish to display.
- Text codes may be used.
</pre>

---

=== JavaScript Notetags: Skill Costs ===

The following are notetags made for users with JavaScript knowledge to
determine any dynamic Skill Cost Types used for particular skills.

---

<pre>
<JS type Cost>
code
code
cost = code;
</JS type Cost>

- Used for: Skill Notetags
- Replace 'type' with a resource type. Existing ones found in the Plugin
Parameters are 'HP', 'MP', 'TP', 'Gold', and 'Potion'. More can be added.
- Replace 'code' to determine the type 'cost' of the skill.
- Insert the final type cost into the 'cost' variable.
- The 'user' variable refers to the user about to perform the skill.
- The 'skill' variable refers to the skill being used.
- Functionality for the notetag can be altered in the Plugin Parameters.
</pre>

---

=== Gauge Replacement Notetags ===

[[File:SkillsStatesSpriteGauges.png]]

Certain classes can have their gauges swapped out for other Skill Cost
Types. This is especially helpful for the classes that don't utilize those
Skill Cost Types. You can mix and match them however you want.

---

<pre>
<Replace HP Gauge: type>
<Replace MP Gauge: type>
<Replace TP Gauge: type>

- Used for: Class Notetags
- Replaces the HP (1st), MP (2nd), or TP (3rd) gauge with a different Skill
Cost Type.
- Replace 'type' with a resource type. Existing ones found in the Plugin
Parameters are 'HP', 'MP', 'TP', 'Gold', and 'Potion'. More can be added.
- Replace 'type' with 'none' to not display any gauges there.
- The <Replace TP Gauge: type> will require 'Display TP in Window' setting
to be on in the Database > System 1 tab.
- Functionality for the notetags can be altered by changes made to the
Skill & States Core Plugin Parameters.
</pre>

---

=== Item Cost-Related Notetags ===

[[File:SkillsStatesCore_Update123_Preview.png]]

---

<pre>
<Item Cost: x name>
<Weapon Cost: x name>
<Armor Cost: x name>

- Used for: Skill Notetags
- The skill will consume items, weapons, and/or armors in order to be used.
- Non-consumable items will not be consumed but their amounts will be
required.
- Replace 'x' with a number representing the respective item cost.
- Replace 'name' with text representing the respective item, weapon, or
armor to be consumed.
- Insert multiples of this notetag to consume multiple items, weapons,
and/or armors.
- Functionality for these notetags can be altered in the Plugin Parameters.

Examples:

<Item Cost: 5 Magic Water>
<Item Cost: 2 Antidote>
<Weapon Cost: 1 Short Sword>
<Armor Cost: 3 Cloth Armor>
</pre>

---

<pre>
<Item Cost Max: x name>
<Item Cost Min: x name>

<Weapon Cost Max: x name>
<Weapon Cost Min: x name>

<Armor Cost Max: x name>
<Armor Cost Min: x name>

- Used for: Skill Notetags
- Sets up a maximum/minimum cost for the item, weapon, armor type costs.
- Replace 'x' with a number representing the maximum or minimum cost.
- Replace 'name' with text representing the respective item, weapon, or
armor to be consumed.

Examples:

<Item Cost Max: 10 Magic Water>
<Item Cost Min: 2 Antidote>
<Weapon Cost Max: 3 Short Sword>
<Armor Cost Min: 1 Cloth Armor>
</pre>

---

<pre>
<Item Cost: +x name>
<Item Cost: -x name>

<Weapon Cost: +x name>
<Weapon Cost: -x name>

<Armor Cost: +x name>
<Armor Cost: -x name>

<Item Cost: x% name>
<Weapon Cost: x% name>
<Armor Cost: x% name>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- The related actor will raise/lower the item, weapon, and/or armor costs of
any skill that costs those items, weapons, and/or armors by x%.
- For % notetag variant: Replace 'x' with a number value to determine the
rate to adjust the Skill Cost Type by as a rate value. This is applied
before <type Cost: +x> and <type Cost: -x> notetags.
- For + and - notetag variants: Replace 'x' with a number value to determine
how much to adjust the Skill Cost Type by as a flat value. This is applied
after <type Cost: x%> notetags.
- Replace 'name' with text representing the respective item, weapon, or
armor to be consumed.
- Insert multiples of this notetag to consume multiple items, weapons,
and/or armors.
- Functionality for these notetags can be altered in the Plugin Parameters.

Examples:

<Item Cost: +1 Magic Water>
<Item Cost: -2 Antidote>
<Weapon Cost: 50% Short Sword>
<Armor Cost: 200% Cloth Armor>
</pre>

---

<pre>
<Replace Item name1 Cost: name2>
<Replace Weapon name1 Cost: name2>
<Replace Armor name1 Cost: name2>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- The related actor will not consume 'name1' items, weapons, or armors.
Instead, the cost will be redirected to 'name2' items, weapons, or armors.
- Even non-consumable items will be consumed.
- Replace 'name1' with text representing the respective item, weapon, or
armor that is the original cost type.
- Replace 'name2' with text representing the respective item, weapon, or
armor that will be consumed instead.

Examples:

<Replace Item Magic Water Cost: Potion>
<Replace Item Antidote Cost: Dispel Herb>
<Replace Weapon Short Sword Cost: Falchion>
<Replace Armor Cloth Armor Cost: Leather Armor>
</pre>

---

=== Skill Accessibility Notetags ===

Sometimes, you don't want all skills to be visible whether it be to hide
menu-only skills during battle, until certain switches are turned ON/OFF, or
until certain skills have been learned.

---

<pre>
<Hide in Battle>
<Hide outside Battle>

- Used for: Skill Notetags
- Makes the specific skill visible or hidden depending on whether or not the
player is currently in battle.
</pre>

---

<pre>
<Show Switch: x>

<Show All Switches: x,x,x>
<Show Any Switches: x,x,x>

- Used for: Skill Notetags
- Determines the visibility of the skill based on switches.
- Replace 'x' with the switch ID to determine the skill's visibility.
- If 'All' notetag variant is used, skill will be hidden until all switches
are ON. Then, it would be shown.
- If 'Any' notetag variant is used, skill will be shown if any of the
switches are ON. Otherwise, it would be hidden.
</pre>

---

<pre>
<Hide Switch: x>

<Hide All Switches: x,x,x>
<Hide Any Switches: x,x,x>

- Used for: Skill Notetags
- Determines the visibility of the skill based on switches.
- Replace 'x' with the switch ID to determine the skill's visibility.
- If 'All' notetag variant is used, skill will be shown until all switches
are ON. Then, it would be hidden.
- If 'Any' notetag variant is used, skill will be hidden if any of the
switches are ON. Otherwise, it would be shown.
</pre>

---

<pre>
<Show if learned Skill: x>

<Show if learned All Skills: x,x,x>
<Show if learned Any Skills: x,x,x>

<Show if learned Skill: name>

<Show if learned All Skills: name, name, name>
<Show if learned Any Skills: name, name, name>

- Used for: Skill Notetags
- Determines the visibility of the skill based on skills learned.
- Determines the visibility of the skill based on skills learned.
- This does not apply to skills added by traits on actors, classes, any
equipment, or states. These are not considered learned skills. They are
considered temporary skills.
- Replace 'x' with the skill ID to determine the skill's visibility.
- If 'name' notetag viarant is used, replace 'name' with the skill's name to
be checked for the notetag.
- If 'All' notetag variant is used, skill will be hidden until all skills
are learned. Then, it would be shown.
- If 'Any' notetag variant is used, skill will be shown if any of the skills
are learned. Otherwise, it would be hidden.
</pre>

---

<pre>
<Hide if learned Skill: x>

<Hide if learned All Skills: x,x,x>
<Hide if learned Any Skills: x,x,x>

<Hide if learned Skill: name>

<Hide if learned All Skills: name, name, name>
<Hide if learned Any Skills: name, name, name>

- Used for: Skill Notetags
- Determines the visibility of the skill based on skills learned.
- This does not apply to skills added by traits on actors, classes, any
equipment, or states. These are not considered learned skills. They are
considered temporary skills.
- Replace 'x' with the skill ID to determine the skill's visibility.
- If 'name' notetag viarant is used, replace 'name' with the skill's name to
be checked for the notetag.
- If 'All' notetag variant is used, skill will be shown until all skills
are learned. Then, it would be hidden.
- If 'Any' notetag variant is used, skill will be hidden if any of the
skills are learned. Otherwise, it would be shown.
</pre>

---

<pre>
<Show if has Skill: x>

<Show if have All Skills: x,x,x>
<Show if have Any Skills: x,x,x>

<Show if has Skill: name>

<Show if have All Skills: name, name, name>
<Show if have Any Skills: name, name, name>

- Used for: Skill Notetags
- Determines the visibility of the skill based on skills available.
- This applies to both skills that have been learned and/or temporarily
added through traits on actors, classes, equipment, or states.
- Replace 'x' with the skill ID to determine the skill's visibility.
- If 'name' notetag viarant is used, replace 'name' with the skill's name to
be checked for the notetag.
- If 'All' notetag variant is used, skill will be hidden until all skills
are learned. Then, it would be shown.
- If 'Any' notetag variant is used, skill will be shown if any of the skills
are learned. Otherwise, it would be hidden.
</pre>

---

<pre>
<Hide if has Skill: x>

<Hide if have All Skills: x,x,x>
<Hide if have Any Skills: x,x,x>

<Hide if has Skill: name>

<Hide if have All Skills: name, name, name>
<Hide if have Any Skills: name, name, name>

- Used for: Skill Notetags
- Determines the visibility of the skill based on skills available.
- This applies to both skills that have been learned and/or temporarily
added through traits on actors, classes, equipment, or states.
- Replace 'x' with the skill ID to determine the skill's visibility.
- If 'name' notetag viarant is used, replace 'name' with the skill's name to
be checked for the notetag.
- If 'All' notetag variant is used, skill will be shown until all skills
are learned. Then, it would be hidden.
- If 'Any' notetag variant is used, skill will be hidden if any of the
skills are learned. Otherwise, it would be shown.
</pre>

---

<pre>
<Enable Switch: x>

<Enable All Switches: x,x,x>
<Enable Any Switches: x,x,x>

- Used for: Skill Notetags
- Determines the enabled status of the skill based on switches.
- Replace 'x' with the switch ID to determine the skill's enabled status.
- If 'All' notetag variant is used, skill will be disabled until all
switches are ON. Then, it would be enabled.
- If 'Any' notetag variant is used, skill will be enabled if any of the
switches are ON. Otherwise, it would be disabled.
</pre>

---

<pre>
<Disable Switch: x>

<Disable All Switches: x,x,x>
<Disable Any Switches: x,x,x>

- Used for: Skill Notetags
- Determines the enabled status of the skill based on switches.
- Replace 'x' with the switch ID to determine the skill's enabled status.
- If 'All' notetag variant is used, skill will be enabled until all switches
are ON. Then, it would be disabled.
- If 'Any' notetag variant is used, skill will be disabled if any of the
switches are ON. Otherwise, it would be enabled.
</pre>

---

=== JavaScript Notetags: Skill Accessibility ===

The following are notetags made for users with JavaScript knowledge to
determine if a skill can be accessible visibly or through usage.

---

<pre>
<JS Skill Visible>
code
code
visible = code;
</JS Skill Visible>

- Used for: Skill Notetags
- Determines the visibility of the skill based on JavaScript code.
- Replace 'code' to determine the type visibility of the skill.
- The 'visible' variable returns a boolean (true/false) to determine if the
skill will be visible or not.
- The 'user' variable refers to the user with the skill.
- The 'skill' variable refers to the skill being checked.
- All other visibility conditions must be met for this code to count.
</pre>

---

<pre>
<JS Skill Enable>
code
code
enabled = code;
</JS Skill Enable>

- Used for: Skill Notetags
- Determines the enabled status of the skill based on JavaScript code.
- Replace 'code' to determine the type enabled status of the skill.
- The 'enabled' variable returns a boolean (true/false) to determine if the
skill will be enabled or not.
- The 'user' variable refers to the user with the skill.
- The 'skill' variable refers to the skill being checked.
- All other skill conditions must be met in order for this to code to count.
</pre>

---

=== General State-Related Notetags ===

[[File:SkillsStatesCoreColors.png]]

The following notetags are centered around states, such as how their turn
counts are displayed, items and skills that affect state turns, if the state
can avoid removal by death state, etc.

---

<pre>
<No Death Clear>

- Used for: State Notetags
- Prevents this state from being cleared upon death.
- This allows this state to be added to an already dead battler, too.
</pre>

---

<pre>
<No Recover All Clear>

- Used for: State Notetags
- Prevents this state from being cleared upon using the Recover All command.
</pre>

---

<pre>
<Group Defeat>

- Used for: State Notetags
- If an entire party is affected by states with the <Group Defeat> notetag,
they are considered defeated.
- Usage for this includes party-wide petrification, frozen, etc.
</pre>

---

<pre>
<Reapply Rules: Ignore>
<Reapply Rules: Reset>
<Reapply Rules: Greater>
<Reapply Rules: Add>

- Used for: State Notetags
- Choose what kind of rules this state follows if the state is being applied
to a target that already has the state. This affects turns specifically.
- 'Ignore' will bypass any turn changes.
- 'Reset' will recalculate the state's turns.
- 'Greater' will choose to either keep the current turn count if it's higher
than the reset amount or reset it if the current turn count is lower.
- 'Add' will add the state's turn count to the applied amount.
- If this notetag isn't used, it will use the rules set in the States >
Plugin Parameters.
</pre>

---

<pre>
<Positive State>
<Negative State>

- Used for: State Notetags
- Marks the state as a positive state or negative state, also altering the
state's turn count color to match the Plugin Parameter settings.
- This also puts the state into either the 'Positive' category or
'Negative' category.
</pre>

---

<pre>
<Category: name>
<Category: name, name, name>

- Used for: State Notetags
- Arranges states into certain/multiple categories.
- Replace 'name' with a category name to mark this state as.
- Insert multiples of this to mark the state with multiple categories.
</pre>

---

<pre>
<Categories>
name
name
</Categories>

- Used for: State Notetags
- Arranges states into certain/multiple categories.
- Replace each 'name' with a category name to mark this state as.
</pre>

---

<pre>
<Bypass State Damage Removal: id>
<Bypass State Damage Removal: id, id, id>

<Bypass State Damage Removal: name>
<Bypass State Damage Removal: name, name, name>

- Used for: Skill, Item Notetags
- When this skill/item is used to attack an enemy with the listed state that
would normally have on damage removal (ie Sleep).
- For 'id' variant, replace each 'id' with a number representing the state's
ID to bypass the damage removal for.
- For 'name' variant, replace each 'name' with the state's name to bypass
the damage removal for.
- This can be used for attacks like "Dream Eater" that would prevent waking
up a sleeping opponent.
</pre>

---

<pre>
<Bypass State Damage Removal as Attacker: id>
<Bypass State Damage Removal as Attacker: id, id, id>

<Bypass State Damage Removal as Attacker: name>
<Bypass State Damage Removal as Attacker: name, name, name>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- When an attacker with an associated trait object that has this notetag
would attack an enemy with the listed state, bypass on damage removal.
- For 'id' variant, replace each 'id' with a number representing the state's
ID to bypass the damage removal for.
- For 'name' variant, replace each 'name' with the state's name to bypass
the damage removal for.
- This can be used for effects like "Sleep Striker" that would prevent the
attacker from waking up a sleeping opponent.
</pre>

---

<pre>
<Bypass State Damage Removal as Target: id>
<Bypass State Damage Removal as Target: id, id, id>

<Bypass State Damage Removal as Target: name>
<Bypass State Damage Removal as Target: name, name, name>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- When a target with an associated trait object that has this notetag is
attacked as the target with the listed state, bypass on damage removal.
- For 'id' variant, replace each 'id' with a number representing the state's
ID to bypass the damage removal for.
- For 'name' variant, replace each 'name' with the state's name to bypass
the damage removal for.
- This can be used for effects like "Deep Sleep" that would prevent the
attacked target from waking up.
</pre>

---

<pre>
<Resist State Category: name>
<Resist State Categories: name, name, name>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Causes the affected battler resist the listed categories.
- Replace each 'name' with a category name to resist.
- Insert multiple 'name' entries to add more categories.
- This works exactly like how state resistances work in-game. If a battler
who was originally NOT resistant to "Poison" before gaining a
poison-resistant trait, the "Poison" state will remain because it was
applied before poison-resistance as enabled.
</pre>

---

<pre>
<Resist State Categories>
name
name
name
</Resist State Categories>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Causes the affected battler resist the listed categories.
- Replace each 'name' with a category name to resist.
- Insert multiple 'name' entries to add more categories.
- This works exactly like how state resistances work in-game. If a battler
who was originally NOT resistant to "Poison" before gaining a
poison-resistant trait, the "Poison" state will remain because it was
applied before poison-resistance as enabled.
</pre>

---

<pre>
<State x Category Remove: y>

<State x Category Remove: All>

- Used for: Skill, Item Notetags
- Allows the skill/item to remove 'y' states from specific category 'x'.
- Replace 'x' with a category name to remove from.
- Replace 'y' with the number of times to remove from that category.
- Use the 'All' variant to remove all of the states of that category.
- Insert multiples of this to remove different types of categories.
</pre>

---

<pre>
<Remove Other x States>

- Used for: State Notetags
- When the state with this notetag is added, remove other 'x' category
states from the battler (except for the state being added).
- Replace 'x' with a category name to remove from.
- Insert multiples of this to remove different types of categories.
- Useful for thing state types like stances and forms that there is usually
only one active at a time.
</pre>

---

<pre>
<Hide State Turns>

- Used for: State Notetags
- Hides the state turns from being shown at all.
- This will by pass any Plugin Parameter settings.
</pre>

---

<pre>
<Turn Color: x>
<Turn Color: #rrggbb>

- Used for: State Notetags
- Hides the state turns from being shown at all.
- Determines the color of the state's turn count.
- Replace 'x' with a number value depicting a window text color.
- Replace 'rrggbb' with a hex color code for a more custom color.
</pre>

---

<pre>
<Max Turns: x>

- Used for: State Notetags
- Determines the upper limit on the maximum number of turns for this state.
- Replace 'x' with a number representing the maximum number of turns used
for this state.
- If no notetag is used, refer to the default setting found in the Plugin
Parameters under "State Settings".
</pre>

---

<pre>
<State id Turns: +x>
<State id Turns: -x>

<Set State id Turns: x>

<State name Turns: +x>
<State name Turns: -x>

<Set State name Turns: x>

- Used for: Skill, Item Notetags
- If the target is affected by state 'id' or state 'name', change the state
turn duration for target.
- For 'id' variant, replace 'id' with the ID of the state to modify.
- For 'name' variant, replace 'name' with the name of the state to modify.
- Replace 'x' with the value you wish to increase, decrease, or set to.
- Insert multiples of this notetag to affect multiple states at once.
</pre>

---

<pre>
<param Buff Turns: +x>
<param Buff Turns: -x>

<Set param Buff Turns: x>

- Used for: Skill, Item Notetags
- If the target is affected by a 'param' buff, change that buff's turn
duration for target.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
or 'LUK' to determine which parameter buff to modify.
- Replace 'x' with the value you wish to increase, decrease, or set to.
- Insert multiples of this notetag to affect multiple parameters at once.
</pre>

---

<pre>
<param Debuff Turns: +x>
<param Debuff Turns: -x>

<Set param Debuff Turns: x>

- Used for: Skill, Item Notetags
- If the target is affected by a 'param' debuff, change that debuff's turn
duration for target.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
or 'LUK' to determine which parameter debuff to modify.
- Replace 'x' with the value you wish to increase, decrease, or set to.
- Insert multiples of this notetag to affect multiple parameters at once.
</pre>

---

=== JavaScript Notetags: On Add/Erase/Expire ===

Using JavaScript code, you can use create custom effects that occur when a
state has bee added, erased, or expired.

---

<pre>
<JS On Add State>
code
code
</JS On Add State>

- Used for: State Notetags
- When a state is added, run the code added by this notetag.
- The 'user' variable refers to the current active battler.
- The 'target' variable refers to the battler affected by this state.
- The 'origin' variable refers to the one who applied this state.
- The 'state' variable refers to the current state being affected.
</pre>

---

<pre>
<JS On Erase State>
code
code
</JS On Erase State>

- Used for: State Notetags
- When a state is erased, run the code added by this notetag.
- The 'user' variable refers to the current active battler.
- The 'target' variable refers to the battler affected by this state.
- The 'origin' variable refers to the one who applied this state.
- The 'state' variable refers to the current state being affected.
</pre>

---

<pre>
<JS On Expire State>
code
code
</JS On Expire State>

- Used for: State Notetags
- When a state has expired, run the code added by this notetag.
- The 'user' variable refers to the current active battler.
- The 'target' variable refers to the battler affected by this state.
- The 'origin' variable refers to the one who applied this state.
- The 'state' variable refers to the current state being affected.
</pre>

---

=== JavaScript Notetags: Slip Damage/Healing ===

Slip Damage, in RPG Maker vocabulary, refers to damage over time. The
following notetags allow you to perform custom slip damage/healing.

---

<pre>
<JS type Slip Damage>
code
code
damage = code;
</JS type Slip Damage>

- Used for: State Notetags
- Code used to determine how much slip damage is dealt to the affected unit
during each regeneration phase.
- Replace 'type' with 'HP', 'MP', or 'TP'.
- Replace 'code' with the calculations on what to determine slip damage.
- The 'user' variable refers to the origin of the state.
- The 'target' variable refers to the affected unit receiving the damage.
- The 'state' variable refers to the current state being affected.
- The 'damage' variable is the finalized slip damage to be dealt.
- When these states are applied via action effects, the slip calculations
are one time calculations made upon applying and the damage is cached to
be used for future on regeneration calculations.
- For that reason, do not include game mechanics here such as adding states,
buffs, debuffs, etc. as this notetag is meant for calculations only. Use
the VisuStella Battle Core's <JS Pre-Regenerate> and <JS Post-Regenerate>
notetags for game mechanics instead.
- Passive states and states with the <JS Slip Refresh> notetag are exempt
from the one time calculation and recalculated each regeneration phase.
</pre>

---

<pre>
<JS type Slip Heal>
code
code
heal = code;
</JS type Slip Heal>

- Used for: State Notetags
- Code used to determine how much slip healing is dealt to the affected unit
during each regeneration phase.
- Replace 'type' with 'HP', 'MP', or 'TP'.
- Replace 'code' with the calculations on what to determine slip healing.
- The 'user' variable refers to the origin of the state.
- The 'target' variable refers to the affected unit receiving the healing.
- The 'state' variable refers to the current state being affected.
- The 'heal' variable is the finalized slip healing to be recovered.
- When these states are applied via action effects, the slip calculations
are one time calculations made upon applying and the damage is cached to
be used for future on regeneration calculations.
- For that reason, do not include game mechanics here such as adding states,
buffs, debuffs, etc. as this notetag is meant for calculations only. Use
the VisuStella Battle Core's <JS Pre-Regenerate> and <JS Post-Regenerate>
notetags for game mechanics instead.
- Passive states and states with the <JS Slip Refresh> notetag are exempt
from the one time calculation and recalculated each regeneration phase.
</pre>

---

<pre>
<JS Slip Refresh>

- Used for: State Notetags
- Refreshes the calculations made for the JS Slip Damage/Heal amounts at the
start of each regeneration phase to allow for dynamic damage ranges.
</pre>

---

=== Passive State Notetags ===

[[File:SkillsStatesCorePassives.png]]

Passive States are states that are always applied to actors and enemies
provided that their conditions have been met. These can be granted through
database objects or through the Passive States Plugin Parameters.

{{Skills and States Core Passive States Clarification}}

<pre>
<Passive State: x>
<Passive States: x,x,x>

<Passive State: name>
<Passive States: name, name, name>

- Used for: Actor, Class, Skill, Weapon, Armor, Enemy Notetags
- Adds passive state(s) x to trait object, applying it to affected actor or
enemy unit(s).
- Replace 'x' with a number to determine which state to add as a passive.
- If using 'name' notetag variant, replace 'name' with the name of the
state(s) to add as a passive.
- Note: If you plan on applying a passive state through a skill, it must be
through a skill that has been learned by the target and not a skill that
is given through a trait.
- If you are using VisuMZ's Equip Battle Skills, know that the notetag
<Passive State: x> will always have the passive state be available no
matter if the skill is equipped or not, as long as the skill is learned.
- If you want the passive state to only appear while the skill is equipped
then use the VisuMZ Equip Battle Skills notetag <Equip State: x> for
this effect instead.
</pre>

---

<pre>
<Passive Stackable>

- Used for: State Notetags
- Makes it possible for this passive state to be added multiple times.
- Otherwise, only one instance of the passive state can be available.
</pre>

---

<pre>
<Passive Condition Class: id>
<Passive Condition Classes: id, id, id>

<Passive Condition Class: name>
<Passive Condition Classes: name, name, name>

- Used for: State Notetags
- Determines the passive condition of the passive state based on the actor's
current class. As long as the actor's current class matches one of the
data entries, the passive condition is considered passed.
- For 'id' variant, replace 'id' with a number representing class's ID.
- For 'name' variant, replace 'name' with the class's name.
- This does not affect enemies.
</pre>

---

<pre>
<Passive Condition Multiclass: id>
<Passive Condition Multiclass: id, id, id>

<Passive Condition Multiclass: name>
<Passive Condition Multiclass: name, name, name>

- Used for: State Notetags
- Requires VisuMZ_2_ClassChangeSystem!
- Determines the passive condition of the passive state based on the actor's
multiclasses. As long as the actor has any of the matching classes
assigned as a multiclass, the passive condition is considered passed.
- For 'id' variant, replace 'id' with a number representing class's ID.
- For 'name' variant, replace 'name' with the class's name.
- This does not affect enemies.
</pre>

---

<pre>
<Passive Condition Switch ON: x>

<Passive Condition All Switches ON: x,x,x>
<Passive Condition Any Switch ON: x,x,x>

- Used for: State Notetags
- Determines the passive condition of the passive state based on switches.
- Replace 'x' with the switch ID to determine the state's passive condition.
- If 'All' notetag variant is used, conditions will not be met until all
switches are ON. Then, it would be met.
- If 'Any' notetag variant is used, conditions will be met if any of the
switches are ON. Otherwise, it would not be met.
</pre>

---

<pre>
<Passive Condition Switch OFF: x>

<Passive Condition All Switches OFF: x,x,x>
<Passive Condition Any Switch OFF: x,x,x>

- Used for: State Notetags
- Determines the passive condition of the passive state based on switches.
- Replace 'x' with the switch ID to determine the state's passive condition.
- If 'All' notetag variant is used, conditions will not be met until all
switches are OFF. Then, it would be met.
- If 'Any' notetag variant is used, conditions will be met if any of the
switches are OFF. Otherwise, it would not be met.
</pre>

---

=== JavaScript Notetags: Passive State ===

The following is a notetag made for users with JavaScript knowledge to
determine if a passive state's condition can be met.

---

<pre>
<JS Passive Condition>
code
code
condition = code;
</JS Passive Condition>

- Used for: State Notetags
- Determines the passive condition of the state based on JavaScript code.
- Replace 'code' to determine if a passive state's condition has been met.
- The 'condition' variable returns a boolean (true/false) to determine if
the passive state's condition is met or not.
- The 'user' variable refers to the user affected by the passive state.
- The 'state' variable refers to the passive state being checked.
- All other passive conditions must be met for this code to count.

**NOTE** Not everything can be used as a custom JS Passive Condition due to
limitations of the code. There are failsafe checks to prevent infinite loops
and some passive conditions will not register for this reason and the
conditional checks will behave as if the passive states have NOT been
applied for this reason. Such examples include the following:

- A passive state that requires another passive state
- A passive state that requires a trait effect from another state
- A passive state that requires a parameter value altered by another state
- A passive state that requires equipment to be worn but its equipment type
access is provided by another state.
- Anything else that is similar in style.
</pre>

---

=== Skill Toggle Notetags ===

[[File:SkillToggle.gif]]

Skill Toggles are skills that can be toggled ON or OFF. If ON, then any
passive states on that skill will become enabled (assuming all other passive
conditions are met) and if toggled OFF, then that passive state will not
appear (even if all other conditions are met).

Skill Toggles do not take up actions, even in battle. They will not consume
an actor's current turn. A player can toggle multiple skill toggles at a
time.

Skill Toggles require the character to pay the skill cost ONLY when the
skill is toggled from OFF to ON, not when it is toggled ON to OFF.

Enemies are unable to switch Toggle Skills and the passive effects on a
Toggle Skill for an enemy will always be considered ON.

Otherwise, you can use JavaScript calls like the following for script call
checks, and the like:

$gameActors.actor(2).isSkillToggled($dataSkills[3])

---

<pre>
<Toggle>

- Used for: Skill Notetags
- Turns the skill into a toggle skill.
- Best used with a passive state.
- Just like with regular <Passive State: x> notetag:
- If you plan on applying a passive state through a skill, it must be
through a skill that has been learned by the target and not a skill that
is given through a trait.
- Toggle skills cannot be used with certain skill effects:
- Active Chain Skills, Evolution Matrix Skills, Input Combo Skills
- Field Skills
- Item Amplify Skills, Item Concoct Skills, Item Throw Skills
- Toggle skills cannot be Skill Containers
</pre>

---

<pre>
<Initial Toggle: On>
<Initial Toggle: Off>

- Used for: Skill Notetags
- Pair this notetag together with skill toggles.
- Sets the initial toggle for this skill to be ON/OFF.
- aka when an actor learns the skill for the first time and this
determines what toggle it will have
- If this notetag is not used, refer to the setting found in the
Plugin Parameters
</pre>

---

<pre>
<Toggle Exclusion Group: key>

- Used for: Skill Notetags
- Pair this notetag together with skill toggles.
- When this skill is toggled, all other toggle skills with a matching 'key'
will be turned off.
- For example, the skills Fire Force, Ice Force, and Thunder Force have
the <Toggle Exclusion Group: Force> notetag.
- When Fire Force is toggled ON, then Ice Force and Thunder Force will
automatically turn OFF.
- Replace 'key' with a toggle exclusion group name for this skill to use.
</pre>

---

<pre>
<Toggle On Animation: x>

- Used for: Skill Notetags
- Pair this notetag together with skill toggles.
- When a skill is turned off, this is the animation that plays.
- If this notetag is not used, refer to the skill's animation.
- Replace 'x' with a number representing the ID of the animation to play
when the skill is toggled on.
</pre>

---

<pre>
<Toggle Off Animation: x>

- Used for: Skill Notetags
- Pair this notetag together with skill toggles.
- When a skill is turned off, this is the animation that plays.
- If this notetag is not used, refer to the Plugin Parameters' animation.
- Replace 'x' with a number representing the ID of the animation to play
when the skill is toggled off.
</pre>

---

=== Aura & Miasma Notetags ===

[[File:SkillsStatesCore_Aura.png|600px|link=]]

Auras are a type passive that affects an allied party. Miasmas are a type of
passive that affects an opposing party. Auras and Miasmas only need to come
from a single source to give an entire party or troop a passive provided
that the battler emitting the aura/miasma is alive and in battle.

---

<pre>
<Aura State: x>
<Aura States: x, x, x>

<Aura State: name>
<Aura States: name, name, name>

- Used for: Actor, Class, Skill, Weapon, Armor, Enemy Notetags
- Emits an aura that affects the battler's allies and gives each affected
member passive state(s) 'x'.
- Replace 'x' with a number to determine which state to add as a passive
generated by this aura.
- If using 'name' notetag variant, replace 'name' with the name of the
state(s) to add as a passive generated by this aura.
- Note: If you plan on applying an aura effect through a skill, it must be
through a skill that has been learned by the target and not a skill that
is given through a trait.
</pre>

---

<pre>
<Miasma State: x>
<Miasma States: x, x, x>

<Miasma State: name>
<Miasma States: name, name, name>

- Used for: Actor, Class, Skill, Weapon, Armor, Enemy Notetags
- Emits an miasma that affects the battler's opponents and gives each
affected member passive state(s) 'x'.
- Miasmas do NOT apply outside of battle.
- Replace 'x' with a number to determine which state to add as a passive
generated by this miasma.
- If using 'name' notetag variant, replace 'name' with the name of the
state(s) to add as a passive generated by this miasma.
- Note: If you plan on applying a miasma effect through a skill, it must be
through a skill that has been learned by the target and not a skill that
is given through a trait.
</pre>

---

<pre>
<Not User Aura>
<Aura Not For User>

- Used for: Actor, Class, Skill, Weapon, Armor, Enemy, State Notetags
- Prevents the emitting user from being affected by the related aura.
</pre>

---

<pre>
<Allow Dead Aura>
<Allow Dead Miasma>

- Used for: Actor, Class, Skill, Weapon, Armor, Enemy, State Notetags
- Allows aura/miasma to continue emitting even after the emitting user is
in a dead state.
- When used with Actor, Class, Skill, Weapon, Armor, Enemy objects, it will
only affect the auras/miasmas emitted from that object.
- When used with States, the effect will take place as long as it is used
as an aura or miasma regardless of where it is emitting from.
- Takes priority over <Dead Aura Only> and <Dead Miasma Only> notetags.
</pre>

---

<pre>
<Dead Aura Only>
<Dead Miasma Only>

- Used for: Actor, Class, Skill, Weapon, Armor, Enemy, State Notetags
- Allows aura/miasma to only emit if the emitting user is in a dead state.
- When used with Actor, Class, Skill, Weapon, Armor, Enemy objects, it will
only affect the auras/miasmas emitted from that object.
- When used with States, the effect will take place as long as it is used
as an aura or miasma regardless of where it is emitting from.
</pre>

---

Items and Equips Core VisuStella MZ

2026-03-15T02:03:03Z

Irina:

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=R7ylHVC-ykE</youtube>
|link1 = {{VisuStella Wave 1}}
|link2 = {{VisuStella All Waves Collection}}

}}



{|
| [[File:ItemsEquipsCoreEquipTypes.png|400px]]
| [[File:ItemsEquipsCoreShopStatus.png|400px]]

|-

| [[File:ItemsEquipsCoreEquipChange.png|400px]]
| [[File:ItemsEquipsCoreShopEquip.png|400px]]

|}

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{ExtensionPluginsMZ}}
* [[Battle System - BTB VisuStella MZ]]
* [[Battle System - ETB VisuStella MZ]]
* [[Battle System - FTB VisuStella MZ]]
* [[Battle System - PTB VisuStella MZ]]
* [[Equip Medal System VisuStella MZ]]
* [[Equipment Set Bonuses VisuStella MZ]]
* [[Item Amplify Skills VisuStella MZ]]
* [[Item Crafting System VisuStella MZ]]
* [[Item Concoction Skills VisuStella MZ]]
* [[Item Throw Skills VisuStella MZ]]
* [[More Currencies VisuStella MZ]]
* [[One Time Purchase VisuStella MZ]]
* [[Shop Batches VisuStella MZ]]
* [[Shop Bust Style UI VisuStella MZ]]
* [[Shop Listing Unlock VisuStella MZ]]
* [[Weapon Swap System VisuStella MZ]]

{{Visustella MZ}}

== Introduction ==

The Items & Equips Core makes improvements to the RPG Maker MZ item and
equipment dedicated scenes (including the shop) and how they're handled.
From more item categories, better parameter control, rulings, and more, game
devs are able to take control over key aspects of their game's items.

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

* Modifying the appearances to the Item Scene, Equip Scene, and Shop Scene.
* Categorizing items in unique and multiple categories.
* Item Scene and Shop Scene will now display detailed information on items.
* NEW! marker can be displayed over recently acquired items in-game.
* Equipment notetags to adjust parameters past the editor limitations.
* Equipment Rulings to adjust what slot types can and can't be unequipped and/or optimized.
* Equipment Type Handling offers more control over equipment loadouts.
* Items sold in shops can be hidden/shown based on Switches.
* Items sold in shops can have varying prices adjusted by notetags.

== Requirements ==

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

{{MZ Tier 1}}

== Major Changes: New Hard-Coded Features ==

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

---

=== Equipment Type Handling ===

[[File:ItemsEquipsCoreEquipTypes.png|600px]]

Characters will no longer have one universal equipment slot setting.
Classes can have different equipment type loadouts, made possible through
the usage of notetags. Also, equipment types of matching names would be
treated as the same type, where previously, they would be different types.
This means if you have two "Accessory" slots, be it in the form of notetags
or through the Database > Types tab, they can both equip the same type of
accessories.

The Change Equip event command is now updated to reflect this new change.
When processing an equip change, the slot changed will go to the first
empty slot of matching type. If all of the actor's matching slot types are
equipped, then the equip will replace the last slot available.

---

=== Shop Status Window ===

[[File:ItemsEquipsCoreShopStatus.png|600px]]

The Status Window found in the Shop Scene was originally barren and did
not display much information at all. This is changed through this plugin's
new features. While the contents of the Shop Status Window can be customized
through the Plugin Parameters, it is a change that cannot be reversed and
for the better since it gives players the much needed information revolving
around the game's items.

---

=== Core Engine Compatibility: Modern Controls ===

[[File:ItemsEquipsCoreShopEquip.png|600px]]

If the [[Core Engine VisuStella MZ|VisuStella Core Engine]] is added to your game with Modern Controls
enabled, then the Item Menu Scene, Equip Menu Scene, and Shop Menu Scene's
controls will be changed a bit.

The Item Menu Scene will automatically have the Item List Window active,
with using the Left/Right (for single column) or Page Up/Page Down (for
multi-columns) to navigate between the Item Categories. Similar will occur
when trying to sell items in the Shop Menu Scene.

The Equip Menu Scene will automatically have the Equip Slots Window active
and only activate the command window upon moving up to it.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Battle Core VisuStella MZ]]

[[File:ItemsEquipsCore_37_Comp_1.png]]

Changing the "Damage Multiplier" or "Healing Multiplier" vocabulary for the
Item and Equip Core's Shop Status Window is not done with the Item and Equip
Core's Plugin Parameters if you have the Battle Core installed.

Instead, go to Battle Core's Plugin Parameters, Damage Settings, Damage
Styles, and adjust the style's version of the "Damage Multiplier" or
"Healing Multiplier" text instead.

Why does this work this way? Because not all damage styles work off
"Multipliers" so in order for it to convey the proper message to the player,
each damage style has its own vocabulary to be more accurate.

[[File:ItemsEquipsCore_37_Comp_2.png]]

In case you forget about that, when you visit the Item and Equip Core's
plugin parameters for these, it should also remind you in the parameter's
description on where to change it.

---

[[Weapon Swap System VisuStella MZ]]

The custom equip slots feature from the VisuStella MZ Items and Equips Core
allowed you to add in extra weapon slots. This is now curated up to a max
of one weapon slot per character. This needs to be done to make the Weapon
Swap System viable.

---

{{Notetags MZ}}

{{VisuMZ Items and Equips Core Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Items and Equips Core Plugin Commands}}

== Plugin Parameters ==

=== Item Menu Settings ===

[[File:ItemsEquipsCoreShopStatus.png|600px]]

[[File:ItemsEquipsCoreParams01.png]]

The Item Menu Settings allow you to adjust specifics on how key objects and
windows in the Item Menu Scene operate.

---

General Window

Use Updated Layout:
- Use the Updated Item Menu Layout provided by this plugin?
- This will automatically enable the Status Window.
- This will override the Core Engine windows settings.

Disabled: Vanilla:
- If NOT using the updated layout, keep all settings to pure vanilla and
ignore other Plugin Parameters.
- Used for those who do not wish to fiddle with the Plugin Parameter
settings to return the item menu back to default MZ vanilla.
- Does not apply if using updated layout.
- The following settings are disabled if using vanilla:
- Categories: Only the default 4
- Category Names only display text and no icons
- No Shop Status Window
- Modern Controls Disabled
- Columns: Any -> 2

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

List Window

Columns:
- Number of maximum columns.
- If you are using the VisuStella MZ Core Engine and the "Modern Controls"
Plugin Parameter, please read through that section in case you have any
questions about how to switch between categories when using multiple
columns of items at a time.

---

Item Quantity

Item Max:
Weapon Max:
Armor Max:
- The default maximum quantity for items, weapons, and/or armors.

Quantity Format:
- How to display an item's quantity.
- %1 - Item Quantity

Font Size:
- Default font size for item quantity.

---

Shop Status Window

Show in Item Menu?:
- Show the Shop Status Window in the Item Menu?
- This is enabled if the Updated Layout is on.

Adjust List Window?:
- Automatically adjust the Item List Window in the Item Menu if using the
Shop Status Window?

Background Type:
- Select background type for this window.
- 0 - Window
- 1 - Dim
- 2 - Transparent

JS: X, Y, W, H:
- Code used to determine the dimensions for this Status Window in the
Item Menu.

---

Button Assist Window

Switch Category:
- Button assist text used for switching categories.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Item Categories ===

[[File:ItemsEquipsCoreCategories.png|600px]]

[[File:ItemsEquipsCoreParams02.png]]

Item Categories appear both in the Item Menu Scene and Shop Menu Scene (but
only under the Sell command). These Plugin Parameters give you the ability
to add in the specific categories you want displayed, remove the ones you
don't, and associate them with icons.

---

List

Category List
- A list of the item categories displayed in the Item/Shop menus.

Type:
- A list of the item categories displayed in the Item/Shop menus.
- Replace x with ID numbers or text.
- AllItems, RegularItems, KeyItems
- HiddenItemA, HiddenItemB
- Consumable, Nonconsumable
- AlwaysUsable, BattleUsable, FieldUsable, NeverUsable
- AllWeapons, WType:x
- AllArmors, AType:x, EType:x
- Category:x

Icon:
- Icon used for this category.
- Use 0 for no icon.

Visibility Switch:
- This Switch must be turned ON in order for the category to show.
- Use 0 for no Switch requirement.

Sort By:
- Sort this category (in Scene_Item and Scene_Shop only) this way.

Style:
- How do you wish to draw categorie entries in the Category Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Alignment
- Decide how you want the text to be aligned.

---

Vocabulary

Hidden Item A
Hidden Item B
Consumable
Nonconsumable
Always Usable
Battle Usable
Field Usable
Never Usable
- How these categories are named in the Item Menu.

---

=== NEW! Labels ===

[[File:ItemsEquipsCoreNew.png]]

[[File:ItemsEquipsCoreParams03.png]]

Whenever the player receives a new item(s), a NEW! Label can be placed on
top of the item's icon when browsing a menu displaying the item(s). This is
a quality of life addition from more modern RPG's to help players figure out
what they've recently received. The following are Plugin Parameters made to
adjust how the NEW! Labels are handled in-game.

---

NEW! Labels

Use NEW! Labels?:
- Use the NEW! Labels or not?

Icon:
- The icon index used to represent the NEW! text.
- Use 0 to not draw any icons.

Text:
- The text written on the NEW! Label.

Font Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Font Size:
- The font size used for the NEW! text.

Fade Limit:
- What's the upper opaque limit before reversing?

Fade Speed:
- What's the fade speed of the NEW! Label?

Offset X:
- How much to offset the NEW! Label's X position by.

Offset Y:
- How much to offset the NEW! Label's Y position by.

---

=== Equip Menu Settings ===

[[File:ItemsEquipsCoreEquipTypes.png|600px]]

[[File:ItemsEquipsCoreParams04.png]]

These Plugin Parameters adjust the Equipment Menu Scene, ranging from using
a more updated and modern layout, changing the styles of other windows, and
other key visual aspects of the Equip Menu Scene. Other settings here allow
you to adjust how equipment operate under certain rulings, too.

---

General

Use Updated Layout:
- Use the Updated Equip Layout provided by this plugin?
- This will override the Core Engine windows settings.

Param Font Size:
- The font size used for parameter values.

Show Menu Portraits?:
- If Main Menu Core is installed, display the Menu Portraits instead of
the actor's face in the status window?

JS: Portrait Upper:
- If Menu Portraits are available, this is code used to draw the upper
data like this in the Status Window.

JS: Face Upper:
- If faces used used, this is code used to draw the upper data like this
in the Status Window.

JS: Parameter Lower:
- Code to determine how parameters are drawn in the Status Window.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

Status Window Width:
- The usual width of the status window if using the non-Updated Equip
Menu Layout.

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.

Cursed Equip Popup:
- Text popup appears when an actor equips a cursed weapon/armor.
- Text codes allowed.
- Requires VisuMZ_0_CoreEngine!
- Empty to not use.
- %1 - Actor, %2 - Equip, %3 - Icon.

---

Command Window

Style:
- How do you wish to draw commands in the Command Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Command Window.

Equip Icon:
- The icon used for the Equip command.

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Add Optimize Command?:
- Add the "Optimize" command to the Command Window?

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Optimize Icon:
- The icon used for the Optimize command.

Add Clear Command?:
- Add the "Clear" command to the Command Window?

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Clear Icon:
- The icon used for the Clear command.

---

Remove Equip

Icon:
- Icon used for equipment removal.

Text:
- Text used for equipment removal.

Use SHIFT Shortcut?:
- Add the "Shift" button as a shortcut key to removing items?

---

Rulings

Equip-Adjust HP/MP:
- Adjust HP/MP differences after changing equips with MaxHP/MaxMP values.

Non-Removable Types:
- Insert ID's of the Equipment Types that must always have an item
equipped and cannot be empty.

Non-Optimized Types:
- Insert ID's of the Equipment Types that will be ignored when equipment
is being optimized.

---

Button Assist Window

SHIFT: Remove:
- Button assist text used for the SHIFT Remove Shortcut.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Shop Menu Settings ===

[[File:ItemsEquipsCoreShopEquip.png|600px]]

[[File:ItemsEquipsCoreParams05.png]]

These Plugin Parameters allow you a number of options to adjust the Shop
Menu Scene. These options range from enabling an updated and modern layout,
adjust how various key visual aspects appear, and determine how prices can
be affected when it comes to selling them or buying them (for coders).

---

General

Use Updated Layout:
- Use the Updated Shop Layout provided by this plugin?
- This will override the Core Engine windows settings.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

[[File:ItemsEquipsCore_Update28_Params1.png]]

Switches

Switch: Buy:
- Buying items in the Shop Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Shop Scene opens.

Switch: Sell
- Selling items in the Shop Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Shop Scene opens.

---

Command Window

Hide Unavailable?:
- Hide all unavailable commands like when a shop is set to Purchase Only?

Style:
- How do you wish to draw commands in the Command Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Command Window.

Buy Icon:
- The icon used for the Buy command.

Sell Icon:
- The icon used for the Sell command.

Cancel Icon:
- The icon used for the Cancel command.

Rename "Cancel":
- Rename Cancel to something more logical for the Shop Menu Scene.

---

Prices

Sell Price Rate:
- The default sell price rate.

JS: Buy Price:
- Modificatons made to the buy price before finalizing it.

JS: Sell Price:
- Modificatons made to the sell price before finalizing it.

---

Button Assist Window

Small Increment:
Large Increment:
- Text used for changing amount bought/sold.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Shop Status Window ===

[[File:ItemsEquipsCoreShopStatusWindow.png]]

[[File:ItemsEquipsCoreParams06.png]]

These Plugin Parameters focuses on the Shop Status Window and determines how
its data is displayed.

---

General

Window Width:
- The usual width of the status window.

Parameter Font Size:
- Font size used for parameter changes.

Translucent Opacity:
- Opacity setting used for translucent window objects.

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.

---

Equipment Data

[[File:ItemEquipCore_StatusWindowStyles.png|600px]]

Data Style:
- How do you wish to display equipment data?
- Compare - Compares selected equip to equipped gear
- Lists all main party actors
- Displays the parameter differences when equipped
- Calculates custom JS values
- Classic - Shows basic parameters of selected equip
- Involves no actors, only shows the item's stats
- Shows weapon or armor specific parameters
- Does not show custom JS values as those are calculated per actor
- Does not show custom parameters as those are calculated per actor
- Use <Status Info> and <Custom Status Info> notetags to overwrite or
add custom data to classic equip data
- Double - Shows basic parameters in double columns
- Involves no actors, only shows the item's stats
- Shows weapon or armor specific parameters
- Does not show custom JS values as those are calculated per actor
- Does not show custom parameters as those are calculated per actor
- Use <Status Info> and <Custom Status Info> notetags to overwrite or
add custom data to classic equip data

Compare Style:

Already Equipped:
- Marker used to show an actor cannot equip an item.

Can't Equip:
- Marker used to show an actor cannot equip an item.

No Changes:
- Marker used to show no changes have occurred.

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Classic Style:

Added Weapon Params:
Added Armor Params:
- Display these parameters when a weapon/armor is selected.
- Requires VisuMZ_0_CoreEngine!

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Double Style:

Added Weapon Params:
Added Armor Params:
- Display these parameters when a weapon/armor is selected.
- Requires VisuMZ_0_CoreEngine!

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Delay MS:
- How many milliseconds (MS) to delay the preview update?
- This is to prevent lag spikes for equips only.

---

Item Data

Max State/Buff Icons:
- Maximum number of icons that can be displayed for Add/Remove
States/Buffs.

Multiplier Standard:
- Constant standard to filter out random values when calculating the
damage multiplier.

JS: Draw Item Data:
- Code used to draw the item data for the Shop Status Window.

---

Vocabulary

Consumable:
Occasions:
Scope:
Speed:
Success Rate:
Repeats:
Hit Type:
Element:
Damage Type:
Effects:
- Vocabulary used for these data entries.
- Some of these have Plugin Parameters have sub-entries.

NOTE: Regarding Damage Labels

If Visu_1_BattleCore is installed, priority goes to its Damage Style
settings. The label displayed is based on the damage style settings in
place for that specific skill or item.

Go to Battle Core > Plugin Parameters > Damage Settings > Style List >
pick the damage style you want to edit > Damage Label and change the
text settings you'd like there.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* Yanfly
* Arisu
* Olivia
* Irina

== Changelog ==

Version 1.60: March 16, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Parameters > Item Menu Settings > Use Updated Layout > Disabled: Vanilla
**** If NOT using the updated layout, keep all settings to pure vanilla and ignore other Plugin Parameters.
**** Used for those who do not wish to fiddle with the Plugin Parameter settings to return the item menu back to default MZ vanilla.
**** Does not apply if using updated layout.
**** The following settings are disabled if using vanilla:
***** Categories: Only the default 4
***** Category Names only display text and no icons
***** No Shop Status Window
***** Modern Controls Disabled
***** Columns: Any -> 2

Version 1.59: October 16, 2025
* Bug Fixes!
** Fixed a bug where a changed parameter in the equipment menu would accidentally highlight the next parameter's name. Fix made by Irina.

Version 1.58: February 20, 2025
* Bug Fixes!
** Optimize no longer allows player to bypass the following notetags: <nowiki><Equip Copy Limit: x></nowiki>, <nowiki><Equip Weapon Type Limit: x></nowiki>, and <nowiki><Equip Armor Type Limit: x></nowiki>. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

Version 1.57: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Added extra clarity for <nowiki><Status Info></nowiki> notetag:
*** For clarity regarding "Damage Multiplier" and "HP Recovery"/"HP Damage":
**** "Damage Multiplier" refers to the amount determined by damage formulas.
**** "HP Recovery"/"HP Damage" refers to the "Recover HP" database effect.
**** Likewise, the same will apply to "MP Recovery"/"MP Damage" if the damage formula type is to deal MP recovery/damage instead.
* New Features!
** New Notetags added by Arisu:
*** <nowiki><Status Style: type></nowiki>
**** Changes up the way the shop status window displays data for this database object in particular.
*** <nowiki><Custom Status Parameters: name, name, name></nowiki>
**** Customize which parameters are displayed for this equipment object's shop status window.
* Optimization Update!
** Plugin should run more optimized.

Version 1.56: December 19, 2024
* Bug Fixes!
** Fixed a bug where newly added equipment would cause crashes upon interaction. Fix made by Irina.

Version 1.55: November 14, 2024
* Bug Fixes!
** Fixed a bug where you can no longer attempt to equip an actor with zero equip slots and causing a crash. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
** Updated <Status Info>
*** Used for: Skill, Item, Weapon, Armor Notetags
**** Replace 'key' with one of the following for weapons and armors:
***** 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI', or 'LUK'
***** For those with VisuMZ_0_CoreEngine:
****** 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT', 'HRG', 'MRG', 'TRG'
****** 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR', 'MDR', 'FDR', 'EXR'
**** Only relevant if the Draw Style for equipment is "classic" or "double".
** Updated <Custom Status Info> notetag:
*** Used for: Skill, Item, Weapon, Armor Notetags
**** When used with weapon or armor database objects, this information is only relevant if the Draw Style for equipment is "classic" or "double".
* New Feature!
** New Plugin Parameters:
*** Parameters > Shop Status Window > Data Style:
**** How do you wish to display equipment data?
***** Compare - Compares selected equip to equipped gear
****** Lists all main party actors
****** Displays the parameter differences when equipped
****** Calculates custom JS values
***** Classic - Shows basic parameters of selected equip
***** Double - Shows basic parameters in double columns
****** Involves no actors, only shows the item's stats
****** Shows weapon or armor specific parameters
****** Does not show custom JS values as those are calculated per actor
****** Does not show custom parameters as those are calculated per actor
****** Use <Status Info> and <Custom Status Info> notetags to overwrite or add custom data to classic equip data
**** Data Style > Classic Style:
**** Data Style > Double Style:
***** Added Weapon Params
***** Added Armor Params
****** Display these parameters when a weapon/armor is selected.
****** Requires VisuMZ_0_CoreEngine!

Version 1.54: October 17, 2024
* Feature Update!
** If "Modern Controls" is selected while "Remove Equip" and "Optimize" are gone from the Equip Menu, right click will exit the menu. Feature added by Arisu.

Version 1.53: July 18, 2024
* Documentation Update!
** Help file updated for new features.
** Added warning to <JS Parameters>:
*** If you are trying to calculate a value based off a full parameter value, such as "ATK = user.atk * 0.10", it's going to break and will cause an infinite loop. Use base parameter values instead.
* New Features!
** New notetags added by Irina:
*** <ID Sort Priority: x>
**** Used for Scene_Item, Scene_Equip, Scene_Battle, and Scene_Shop's sell option (only when selling).
**** Changes sorting priority by ID for item, weapon, or armor to 'x'.
**** Default priority level is '50'.
**** Items, weapons, and armors with higher priority values will be sorted higher up on the list while lower values will be lower on the list.

Version 1.52: May 16, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Irina:
*** Parameters > Item Categories > Category List > Category > Sorted By:
**** You can now sort specific item categories by ID or Name.
**** Only usable within Scene_Item and Scene_Shop.
* Optimization Update!
** Plugin should run more optimized.

Version 1.51: December 14, 2023
* Bug Fixes!
** Fixed a bug where if an item is unequipped, it may cause a crash. Fix made by Arisu.
** Fixed a bug where <Proxy: id> did not properly give the proxy item. Fix made by Arisu.

Version 1.50: November 16, 2023
* Bug Fixes!
** <JS Buy Price> and <JS Sell Price> was not working properly. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
* Optimization Update!
** Plugin should run more optimized.
* New Features!
** New Notetags added by Arisu:
*** <Cursed>
**** If this weapon or armor is equipped, it cannot manually be removed by the player until it is purified.
**** To remove it, it must be done by event commands, script calls, or through the Purify-related Plugin Commands provided by this plugin.
**** Once purified, the weapon or armor will become unequipped unless it has a purify transformation.
**** If the newly transformed weapon/armor is equippable, it will remain in the actor's equipment slots.
**** If you are using VisuMZ_2_WeaponSwapSystem, weapons cannot become cursed in order to allow free weapon swapping. Weaponry will not be cursed if VisuMZ_2_WeaponSwapSystem is installed.
*** <Purify Transform: id>
*** <Purify Transform: name>
**** If this notetag is present on a <Cursed> weapon or armor, then upon the actor receiving purification, the weapon or armor will transform into a different item.
** New Plugin Commands added by Arisu:
*** Purify: Target Actor(s)
**** Purifies target actor(s) of any cursed weapons or armors.
*** Purify: Whole Party
**** Purifies whole party of any cursed weapons or armors.
** Added "Cursed Equip Popup" to Equip Scene Plugin Parameters.
*** Text popup appears when an actor equips a cursed weapon/armor.
** Added "Ally or Enemy" or "Enemy or Ally" scopes to Shop Status Window Plugin Parameters.
*** If unused, will default to "1 Ally" or "1 Enemy" like usual. Added by Irina.

Version 1.49: October 12, 2023
* Bug Fixes!
** Fixed a problem where for weapon types, all weapon types are listed in the equip menu even when the actor cannot equip them (though they would be disabled). Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia and sponsored by AndyL:
*** <Added EType: x>
*** <Added ETypes: x, x, x>
**** This is for armors only and does NOT work with weapons!
**** Allows a piece of armor to belong to multiple ETypes. This means a glove can be equipped as "Armgear" or as an "Accessory" if you so choose.

Version 1.48: September 14, 2023
* Bug Fixes!
** Fixed a problem where the help window position of the non-updated layout would appear in the wrong position. Fix made by Irina.
* Optimization Update!
** Plugin should run more optimized when weapons and armors exceed 2000 in database quantity.

Version 1.47: July 13, 2023
* Bug Fixes!
** Fixed a bug that would cause the shop status window to display incorrect removed buffs and debuffs. Fix made by Olivia.
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Help file updated for new features.
* Feature Updates!
** Changes made to dynamic shop listings in order to update upon listing changes rather than having to enter and exit the shop again. Update made by Arisu.
* New Features!
** New notetag effects added by Arisu and sponsored by AndyL:
*** <Conserve: x%>
**** Gives the item a percent chance when used to not consume the item.
*** <Buy Turn On Switches: x, x, x>
*** <Buy Turn Off Switches: x, x, x>
*** <Sell Turn On Switches: x, x, x>
*** <Sell Turn Off Switches: x, x, x>
**** When buying/selling an item, weapon, or armor with these notetags, turn on/off switch(es) 'x'.
*** New Plugin Parameters added by Arisu:
**** Params > Settings > Shop Status Window > Equipment Data > Delay MS:
***** How many milliseconds (MS) to delay the preview update?
***** This is to prevent lag spikes for equips only.

Version 1.46: June 15, 2023
* Bug Fixes!
** Fixed a problem where the help and input modes are not adequately adjusted when not used with the updated layout or without the Options Core custom UI placement. Fix made by Arisu.

Version 1.45: May 18, 2023
* Bug Fixes!
** Fixed a bug that would cause equip slots to not be recognized properly if the equip slot name ends in a space.

Version 1.44: April 13, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag effects added by Arisu and sponsored by Anon:
*** <Equip For Class Only: x>
*** <Equip For Classes Only: x, x, x>
*** <Equip For Class Only: name>
*** <Equip For Classes Only: name, name, name>
**** The piece of equipment can only be worn by the listed classes.
*** <Equip Requirements> notetag added.
**** Define multiple requirements that the actor needs to meet in order for this equip item to be equippable.
**** See help file for more information on the types of requirements that can be added.

Version 1.43: March 16, 2023
* Bug Fixes!
** Artifact armors should now update and refresh the party members' cache upon acquisition. Fix made by Olivia.

Version 1.42: February 16, 2023
* Bug Fixes!
** Proxy items should no longer cause infinite loops if they're made to reference other proxy items in a circular fashion. Instead, they just give the exact first found proxy instead of cycling through others. Fix made by Arisu.

Version 1.41: December 15, 2022
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu and sponsored by Anon:
*** Equip Scene > Equip Command > Help Description
*** Equip Scene > Optimize Command > Help Description
*** Equip Scene > Clear Command > Help Description
**** Help description used when these commands are selected.

Version 1.40: October 20, 2022
* Feature Update!
** For the shop status window, when comparing equipment of a type where there are multiple equipment slots (such as accessories), the plugin will now check for an empty equipment slot first and then make calculations there. Otherwise, it will use the first available equipment slot of that type regardless of the equipped item. Update made by Arisu.
* Optimization Update!
** Plugin should run more optimized.

Version 1.39: September 29, 2022:
* Feature Update!
** Changed the default code for the equip scene's status window display to prevent the face graphic and basic actor stats from going above the window boundaries if there are too many parameters displayed in the status window at a time.
** If you already have this plugin installed the changes will not be reflected unless you do the following:
**** BACKUP your game project.
**** REMOVE this plugin from the Plugin Manager list.
**** REINSTALL this plugin into the Plugin Manager list.
**** SAVE the game project.

Version 1.38: March 3, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New mechanics and notetags added by Olivia and sponsored by Anon:
*** <Party Artifact>
*** <Troop Artifact>
*** <Stackable Party Artifact>
*** <Stackable Troop Artifact>
**** Armors only! This armor cannot be equipped at all. However, by simply being in the party's inventory, its parameter bonuses and traits will be applied globally throughout the whole party or troop (depending on the notetag). Add both notetags to affect both groups.
**** The normal versions of the notetag is only applied once regardless of the number of copies are found in the party's inventory.
**** The stackable versions of the notetag will have the bonuses and traits stacked multiple times relative to the number of copies found in the party's inventory.
**** This item will NOT be added during the setup phase for Battle Tests.
***** If you want to add the item, do it manually.

Version 1.37: December 23, 2021
* Compatibility Update
** Created foundation for proxy items to be used in any applicable system and extension plugins. Update made by Arisu.

Version 1.36: December 2, 2021
* Feature Update!
** For those using custom parameters from the Core Engine and do not have the parameters all-capitalized, the plugin will automatically do it for you to prevent errors. Update made by Olivia.

Version 1.35: November 18, 2021
* Compatibility Update!
** If this plugin's updated scene is disabled, the Help Window locations for the Item, Equip, and Shop Scenes should now be at their designated locations as calculated by the VisuMZ Core Engine instead of the RMMZ default location. Update made by Irina.

Version 1.34: October 28, 2021
* Feature Update
** Added fail safe checks for projects that are using old data for starting equipment that no longer exist, thus preventing the game from opening. Update made by Arisu.

Version 1.33: August 6, 2021
* Documentation Update!
** Removed "Weapon" and "Armor" from "Used For" for <Status Info>. This was an unintended piece of documentation.

Version 1.32: July 23, 2021
* Bug Fixes!
** Fixed a bug that would cause armor duplication when changing to classes with unaligned equipment slot types. Fix made by Arisu.

Version 1.31: July 9, 2021
* Feature Update!
** Added a failsafe for price manipulation JavaScript to never have prices drop below 0 if possible. Update made by Arisu.

Version 1.30: July 2, 2021
* Documentation Update!
** Added an extra note to the help file for the following: Plugin Parameters > Item Menu Settings > List Window > Columns
*** If you are using the VisuStella MZ Core Engine and the "Modern Controls" Plugin Parameter, please read through that section in case you have any questions about how to switch between categories when using multiple columns of items at a time.

Version 1.29: June 25, 2021
* Compatibility Update
** Compatibility update with RPG Maker MZ 1.3.0+.
* Feature Update!
** Phantom data when changing equipment types in the database should no longer affect actors with cached equip ID's. Update made by Arisu.

Version 1.28: June 4, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.27: May 21, 2021
* Bug Fixes!
** Using the mouse right click in the Equip Scene while inside of the item to slot window will no longer exit the Equip Scene. Fix made by Yanfly.

Version 1.26: April 30, 2021
* Documentation Update!
** Help file updated for new features.
** "VisuStella MZ Compatibility" added VisuMZ_1_BattleCore section regarding Damage Multiplier and Healing Multiplier vocabulary settings to reduce commonly asked questions.
* New Features!
** New notetags added by Irina and sponsored by Archeia:
*** <Shop Picture Name: filename>
*** <Shop Picture Layer: x>
*** <Shop Picture Max Width: x>
*** <Shop Picture Max Height: y>
*** <Shop Picture Max Dimensions: x, y>
*** <Shop Picture Alignment: x>
*** <Shop Picture Position: y>
*** <Shop Picture Offset X: +x>
*** <Shop Picture Offset X: -x>
*** <Shop Picture Offset Y: +y>
*** <Shop Picture Offset Y: -y>
*** <Shop Picture Offset: +x, +y>
*** <Shop Picture Offset: -x, -y>
*** <Shop Picture Opacity: x>
*** <Shop Picture Opacity: x%>
**** Add images from the game project's img/pictures/ folder to display in the Shop Status Window.

Version 1.25: April 23, 2021
* Documentation Update!
** Added clarity to the <param: +x> and <param: -x> notetags:
*** These notetags do NOT work with X Parameters, S Parameters, or any custom parameters. These notetags ONLY work with the base parameters.

Version 1.24: April 16, 2021
* Bug Fixes!
** Changing an actor's equipment slots to past their original amount will no longer yield errors with duplicate slot types. Fix made by Arisu.
** Completely selling an item should now refresh the help window to the new selected item's help description. Fix made by Arisu.
* Optimization Update!
** Non-removable equipment restrictions for the equipment scene are now better optimized. Update made by Olivia.

Version 1.23: April 2, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.22: March 26, 2021
* Documentation Update!
** Added "VisuStella MZ Compatibility" section for detailed compatibility explanations with the VisuMZ_4_BreakShields plugin.

Version 1.21: March 5, 2021
* Feature Update!
** Custom equipment slots are disabled during Battle Testing for better accuracy and results.

Version 1.20: February 26, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina and sponsored by AndyL:
*** Plugin Parameters > Shop Menu Settings > Switches > Switch: Buy
*** Plugin Parameters > Shop Menu Settings > Switches > Switch: Sell
**** Buying/selling items in the Shop Scene turns this Switch to ON.
**** Switch reverts to OFF whenever the Shop Scene opens.
**** These switches can be used after a "Shop Processing" event command to determine if the player has bought an item, bought and sold an item, sold an item, or neither.

Version 1.19: January 29, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Irina.
*** <Equip Copy Limit: x>
**** Sets a maximum number of copies that the actor can wear of this equipment. Usage Example: Actors can only equip one copy of the "One-of-a-Kind Ring" on at any time despite having empty accessory slots because the ring has a <Equip Copy Limit: 1> notetag.
*** <Equip Weapon Type Limit: x>
**** This weapon cannot be equipped with other weapons of the same type once the limited amount has been reached. Usage Example: A dualwielding warrior who can only equip one sword and a dagger but never two swords or two daggers because the swords and daggers all have the <Equip Weapon Type Limit: 1> notetags on them.
*** <Equip Armor Type Limit: x>
**** This armor cannot be equipped with other armors of the same type once the limited amount has been reached. Usage Example: People cannot equip more than two glove accessories on at a time because the glove is a "Glove" armor-type and each glove item has the <Equip Armor Type Limit: 2> notetags on them.

Version 1.18: January 15, 2021
* Bug Fixes!
** Pressing "Shift" to remove equipment will now refresh the status window unlike before. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added
*** Plugin Parameters > Item Menu Settings > Background Type

Version 1.17: January 1, 2021
* Bug Fixes!
** Equipping should be working properly again. Fix made by Yanfly.

Version 1.16: December 25, 2020
* Bug Fixes!
** Equip-Adjust HP/MP should work properly now. Fix made by Yanfly.
* Documentation Update!
** Added more clarity for <JS Item Enable> to state that if the VisuStella Battle Core is installed, then all battle scope items are visible, but not necessarily enabled if they are disabled otherwise.

Version 1.15: December 18, 2020
* Bug Fixes!
** RPG Maker MZ Bug: Unusable items on an individual-actor basis will no longer be overwritten by party-based usability for battle. Fix by Yanfly.
* Documentation Update!
** Added more clarity for <JS Item Enable> to state that it removes the usable item from visibility as well if the actor unable to use it is the only person in the party.

Version 1.14: December 11, 2020
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.13: December 4, 2020
* Documentation Update!
** Added documentation for new feature(s)!
* New Features!
** New Plugin Commands added by Arisu!
*** Actor: Change Equip Slots
*** Actor: Reset Equip Slots
**** These plugin commands allow you to forcefully change the equip slots available to an actor regardless of the slots provided by its class as well as reset them.

Version 1.12: November 15, 2020
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: November 8, 2020
* Bug Fix!
** Font size ratio for the shop status window now scales to a hard coded value to prevent smaller font sizes from expanding icon sizes. Fix made by Arisu.
* Feature Update!
** Currency display in the shop menu is now reflected upon how the plugin parameters set them to display. Update made by Arisu.

Version 1.10: November 1, 2020
* Feature Update!
** Modern Controls compatibility with Core Engine no longer enables the Item Categories window and child classes to utilize the Home/End keys.

Version 1.09: October 25, 2020
* Bug Fixes!
** "All Items" category should now display the "Items" text. Fix by Irina.
** WType, AType, and EType categories now work with text. Fix by Irina.

Version 1.08: October 18, 2020
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.07: October 11, 2020
* Bug Fixes!
** XParams and SParams in the Window_EquipStatus window will no longer show a non-percentile difference if the original value is not a whole value. Fix made by Yanfly.

Version 1.06: October 4, 2020
* Bug Fixes!
** Select Item event command now displays the default amount of columns instead of whatever setting is made with the plugin parameters.

Version 1.05: September 27, 2020
* Bug Fixes!
** When using the updated shop layout, leaving the sell option will no longer cause the dummy window to appear.
* Documentation Update
** "Use Updated Layout" plugin parameters now have the added clause: "This will override the Core Engine windows settings." to reduce confusion. Added by Irina.

Version 1.04: September 13, 2020
* Bug Fixes!
** Pressing Shift to quickly remove equipment should no longer crash the game. This will also clear the help window text. Fix made by Arisu.

Version 1.03: September 6, 2020
* Bug Fixes!
** If both Optimize and Clear commands have been removed and using modern controls, pressing up at the top of the slot window list will not go to the window. Fix made by Yanfly.
** If both Optimize and Clear commands have been removed, the window will no longer appear and the slot window will be moved upward to fill any empty spaces. Fix made by Yanfly.
* New Features!
** New Plugin Parameter added in NEW! Label to let you adjust the font face.
** New Plugin Parameters added in Equip Menu Scene Settings for disabling the back rectangles and/or changing their colors.
** New Plugin Parameters added in Shop Status Window Settings for disabling the back rectangles and/or changing their colors.

Version 1.02: August 30, 2020
* Documentation Fix!
** Added: NOTE: Regarding Damage Labels
*** If Visu_1_BattleCore is installed, priority goes to its Damage Style settings. The label displayed is based on the damage style settings in place for that specific skill or item.
*** Go to Battle Core > Plugin Parameters > Damage Settings > Style List > pick the damage style you want to edit > Damage Label and change the text settings you'd like there.
*** Documentation update added by Yanfly.

Version 1.01: August 23, 2020
* Added failsafe to prevent non-existent equipment (because the database entries have been deleted) from being equipped as initial equipment. Fix made by Olivia.

Version 1.00: August 20, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 1]]

|}

== End of File ==


[[Category: RPG Maker MZ Core Plugins]]

[[Category: RPG Maker MZ Item Plugins]]

[[Category: RPG Maker MZ Equip Plugins]]

[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]

[[Category: RPG Maker MZ Quality of Life Plugins]]

Chain Battles VisuStella MZ

2026-03-15T02:02:11Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=dZ9FqKKWgL8</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/1157898" width="552" height="167"><a href="https://visustellamz.itch.io/chain-battles">Chain Battles plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Battle Technician Vol 1}}

}}



[[File:ChainBattles_Preview1.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:ChainBattles_Preview1.png|600px]]

Ever wanted to have a continuous stream of battles without the victory
sequence appearing until the very end? The Chain Battles plugin will allow
RPG Maker MZ to do just that. As the player's party progresses forward, they
maintain their states, buffs, and debuffs. The such effects will keep their
stacks and turns. Chain Battles will make creating a marathon of battles
a possibility.

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

* Queue up battles to be chained one after the other. This can be done in or out of battle. An unlimited amount of battles can be chained.
* Chained battles can be randomized across a pool of Troop ID's, based off the random encounter pool, or calculated through JavaScript.
* Battlebacks can be changed as chain battles continue to give a scenary change and a sense of progression.
* Any states, buffs, and/or debuffs that are applied to battlers as they transition from one battle to another will be carried over with their turn durations intact.
* Battle rewards such as EXP, Gold, and Drop Rates can be affected by the total number of chain battles, increasing the overall multiplier (or decreasing it if you so wish).

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 3}}

== Chain Battle Carry Over ==

[[File:ChainBattles_Preview1.png|600px]]

The following section will explain what happens whenever chain battles
occur and describe exactly what is carried over.

---

=== HP, MP, and TP ===

HP and MP, by default, are static across battles and will not reset
themselves at the start of each chained battle.

TP, however, will depend. If TP is preserved, then the TP values will be
maintained as chain battles progress. If TP is not preserved, then, by
default, the battler will gain a random amount of TP at the start of each
chained battle.

---

=== Turn Count ===

When chaining into the next battle, the turn count will be preserved and
then increased by 1. This means if you end the first battle at Turn 10, then
you will start the second battle at Turn 11. This applies to TPB battle
systems as well.

---

=== Troop Event Page Span ===

If a troop event page's span is set to "battle", it will be reset at the
start of each chain battle. This means even if you are utilizing the same
conditions as before for the same page, the same page's span will be reset.

---

=== Next Victory ===

You can setup certain Common Events to run upon achieving Victory but before
the battle ends or moves onto the next chain. These are achieved through the
new Plugin Commands added through this plugin. If multiple Common Events are
queued, then all of them will run before the next victory phase.

If enemies revive in the middle of the Common Event queue, the queue is
paused and resumed after the enemies are defeated once again.

For example:

# Common Events A, B, C, D, E are queued.
# Enemies are set to revive on Common Event B.
# When the player achieves battle victory, Common Events A and B run.
# The enemies will revive.
# The player has to defeat the enemies again.
# Once the enemies are defeated, Common Events C, D, and E then run.
# Afterwards, any chain battles will occur.

---

== Extra Features ==

[[File:ChainBattles_Preview1.png|600px]]

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

---

=== [[Class Change System VisuStella MZ]] ===

This plugin offers bonus reward multipliers for the Class Change System's
CP and JP resource points earned from battle.

---

=== [[Skill Learn System VisuStella MZ]] ===

This plugin offers bonus reward multipliers for the Skill Learn System's
AP and SP resource points earned from battle.

---

== VisuStella MZ Compatibility ==

[[File:ChainBattles_Preview1.png|600px]]

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

=== [[Extra Enemy Drops VisuStella MZ]] ===

Extra Rewards will be carried over into subsequently chained battles instead
of being cleared. However, Forced Rewards will still overwrite everything.
Keep this in mind as you use these Extra Enemy Drops Plugin Commands.

---

{{Plugin Commands MZ}}

{{VisuMZ Chain Battles Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:ChainBattles_Preview1.png|600px]]

[[File:ChainBattles_Param1.png]]

General settings related to Chain Battles.

---

Animation

Chain Walk Forward?
- Does player party perform walk up animation for chain battles?

---

Delay

Frames:
- How many frames should be delayed on average?

Allow Fast Forward?:
- Allow fast forwarding the delay by holding down the OK or Cancel
buttons?

---

Tracking

Variable: Chains:
- Automatically tracks total chained battles.
- Insert Variable ID '0' to not use.

---

=== Reward Multipliers ===

[[File:ChainBattles_Param2.png]]

Reward multipliers based on the number of Chain Battles in total.

---

Settings

Enable Multipliers?:
- Enable victory reward multipliers?

---

General

EXP Rates:
Gold Rates:
Drop Rates:
- What rates do you want per total chain battles?
- 1.0 = 100%, 1.5 = 150%

---

Compatibility > Class Change System

CP Rates:
JP Rates:
- What rates do you want per total chain battles?
- 1.0 = 100%, 1.5 = 150%

---

Compatibility > Skill Learn System

AP Rates:
SP Rates:
- What rates do you want per total chain battles?
- 1.0 = 100%, 1.5 = 150%

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Olivia]]
* [[Arisu]]
* [[Irina]]
* [[Yanfly]]

== Changelog ==

Version 1.05: March 16, 2026
* Bug Fixes!
** Fixed a bug where EXP and Gold multipliers weren't calculating correctly based on the number of chain battles participated in.

Version 1.04: July 13, 2023
* Documentation Update!
** Added extra clarity for "Next Victory: Queue Common Event" Plugin Command in the help file:
*** The "Next Victory: Queue Common Event" Plugin Command will always refer to the immediate next victory sequence.
*** Even if you put it after a "Chain Battle: Queue Troop ID(s)", it does not mean it will occur for that next queued troop's victory.
*** Instead, the common event will run for the immediate next victory sequence regardless.
*** If you would like for the queued troop ID's to have a "Next Victory" effect, run this Plugin Command AFTER the queued troop ID has been initiated in battle first.

Version 1.03: May 18, 2023
* Compatibility Update!
** Added better compatibility with Boost Action and Skill Cooldowns. Update made by Olivia.

Version 1.02: February 17, 2022
* Documentation Update!
** Help file updated for new features.
** Updated features list in Introduction.
** Added "Next Victory" segment to "Chain Battle Carry Over" section.
*** Next Victory
*** You can setup certain Common Events to run upon achieving Victory but before the battle ends or moves onto the next chain. These are achieved through the new Plugin Commands added through this plugin. If multiple Common Events are queued, then all of them will run before the next victory phase.
*** If enemies revive in the middle of the Common Event queue, the queue is paused and resumed after the enemies are defeated once again.
**** Example provided inside segment.
* New Features!
** New Plugin Commands added by Olivia and sponsored by AndyL:
*** Next Victory: Queue Common Event
**** Queue a Common Event(s) to run next victory. If multiple, Common Events run in queued order. The Common Events will run before the next queued chain battle.
*** Next Victory: Clear Common Event Queue
**** Clear queued Common Event(s) for next victory.

Version 1.01: October 21, 2021
* Bug Fixes!
** Battle win/lose branches should now carry over. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > General > Animation > Chain Walk Forward?
**** Does player party perform walk up animation for chain battles?

Version 1.00 Official Release Date: September 8, 2021
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Battle Technician Volume 1]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]








[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]



[[Category: RPG Maker MZ Quality of Life Plugins]]

Equip Passive System VisuStella MZ

2026-03-15T02:02:04Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://youtu.be/n_X2J2Q9FHQ</youtube>

|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/2546114" width="552" height="167"><a href="https://visustellamz.itch.io/equip-passive-system">Equip Passive System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Grande Vol 1}}

}}



[[File:EquipPassiveSys_Preview1.png|600px]]

[[File:EquipPassiveSys_Preview2.png|600px]]

[[File:EquipPassiveSys_Preview3.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Skills and States Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:VisuMZ.148.jpg|600px]]

Actors can now equip passive states to further enhance their battle
potential. With how flexible states are, equippable passive states can boost
actors in numerous ways. Equippable passive states can be learned in many
different ways and add further customization potential to your actors.

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

* Passive states can be accessed and equipped from the skill scene.
* Passive states are limited to the passive capacity that an actor has and the amount of capacity that passive state costs.
* As passive are states at the fundamental level, they take on all the advantages and traits that states have like motions and overlays.
* Dictate which passives an actor can learn through notetags.
* Some passives can be linked to when skills are learned.
* Passives can have a variety of conditions before they are learned.
* Branch out passives so that when they're learned, more passives can be unlocked for that actor.
* Some of these conditions include leveling, winning battles, escaping, being afflicted by states, attacking a certain amount of times, and more!
* Globally learn and remove passive states across all actors.
* Optionally combines with the Skill Learn System to allow actors to learn equippable passives using the Skill Learn System's notetags and AP/SP.

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Skills and States Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== How Equippable Passives Work ==

This section explains how Equippable Passives work in detail.

---

=== States at the Core ===

[[File:EquipPassiveSys_Preview1.png|600px]]

Equippable Passives are states that actors can toggle ON/OFF as long as the
actors have enough "Passive Capacity" to support the passives. As these are
states, they have all of the traits that states have access to in addition
to their motion and overlay related aspects.

---

=== Unlock Conditions ===

[[File:EquipPassiveSys_Preview2.png|600px]]

If an actor has unlearned Equippable Passives listed, that actor can attempt
to meet the conditions of those passive states and learn them. Actors will
not be able to learn passive states that aren't listed, regardless of the
actor fulfilling the unlock conditions for the unlisted Equippable Passives.

Unlock conditions can range from things like fighting 5 battles since the
time the Equippable Passive has been listed to things like casting 8 magical
skills. There is a huge list of unlock conditions that can be used found in
the notetags section.

---

=== Skill Learn System ===

[[File:EquipPassiveSys_Preview3.png|600px]]

If unlock conditions are not your thing, actors can bypass all of them and
just straight up pay for them in the Skill Learn System as long as the
Equippable Passives are listed there. Naturally, this will require VisuMZ's
Skill Learn System plugin installed for this integration to work out.

Actors can pay for Equippable Passives in the Skill Learn System using AP,
CP, JP, SP, items, weapons, armors, just about anything that normal skills
can be used to pay with.

Once again, Equippable Passives through the Skill Learn System will not
require unlock conditions to be fulfilled in order to be bought and learned.
This functions as an alternative way for players to acquire Equippable
Passives if they're not a fan of the unlock system.

This does not mean that all Equippable Passives have to be placed through
the Skill Learn System while being condition unlockable or vice versa. You
can have some passives exclusive to the Skill Learn System while others are
exclusive to the unlocking mechanisms at play.

---

== Extra Features ==

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

---

=== [[Elements and Status Menu Core VisuStella MZ]] ===

[[File:VisuMZ.008.jpg|300px|link=Elements and Status Menu Core VisuStella MZ]]

Certain notetags will become available if the VisuStella MZ Elements and
Status Menu Core plugin is installed in addition to this plugin. This
notetag is the <Equip Passive Learn Defeat name Trait: x> notetag.

---

=== [[Skill Learn System VisuStella MZ]] ===

[[File:VisuMZ.042.jpg|300px|link=Skill Learn System VisuStella MZ]]

If you have the VisuStella MZ Skill Learn System installed in addition to
this plugin, you can integrate the passive learning aspect into the skill
learn system itself and pay for passives using AP, SP (as well as CP and JP
if the VisuStella MZ Class Change System is installed).

Unlock conditions do NOT need to be fulfilled if passives are learned
through the Skill Learn System. This is because the normal unlocking passive
conditions are made specifically for learning passives organically through
playing the game while the Skill Learn System allows for players to
carefully choose their options and buy them on the spot.

Passives placed through the Skill Learn System will use a different set of
notetags which will be listed in the notetags section of this plugin.

Unlearned passives listed in the Skill Learn System will not necessarily
appear in the unlearned passives list of the Passives window unless you
have the organic notetags used to list them there.

---

{{Notetags MZ}}

{{VisuMZ Equip Passive System Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Equip Passive System Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:EquipPassiveSys_Preview1.png|600px]]

[[File:EquipPassiveSys_Params1.png]]

General settings for the Equip Passive System.

---

General Settings:

Default Show Command:
- Shows Passive Command by default?

Auto-Equip on Learn:
- Automatically equips newly learned Passives.

Text Popup on Learn:
- Produce a text popup when a Passive is learned?

Text Popup Format:
- Text format used for text popup.
- %1 - Actor, %2 - Passive, %3 - Icon

---

Capacity Settings:

Capacity Formula:
- What is the formula used to determine current max capacity?

Default Capacity Cost:
- What is the default capacity cost of equipping a Passive?

Minimum Capacity Cap:
- What is the minimum capacity value?

Maximum Capacity Cap:
- What is the maximum capacity value?

Check Over-Capacity:
- Checks over-capacity when EXP changes.

---

=== Vocabulary Settings ===

[[File:EquipPassiveSys_Preview2.png|600px]]

[[File:EquipPassiveSys_Params2.png]]

These settings let you adjust the text displayed for this plugin.

---

Scene_Skill:

Command Name:
- Text used for the Passives Command.

Command Icon:
- Icon used for the Passives command and for any passives that are
displayed without any icon.

Capacity Text:
- Text used for Passives Capacity.

Capacity Icon:
- Icon used to represent Passives Capacity when displayed as a limited
resource.

Capacity Format:
- Text format used to representing Capacity.
- %1 - Current, %2 - Max, %3 - Icon

Cost Format:
- Text format used for Capacity Cost.
- %1 - Cost, %2 - Icon

Unlearned Text:
- Text displayed instead of cost for unlearned Passives.

---

Shop Status Window:

Shop Status Text:
- Text used to representing Passives in shop status.
- Requires VisuMZ_1_ItemsEquipsCore!

---

Help Window:

Description Format:
- Text format used to create help descriptions.
- %1 - Unlocking Conditions

Word Wrap?:
- Apply word wrap to unlock conditions?
- Requires VisuMZ_1_MessageCore!

Spacing?:
- Add spacing between conditions?

Spacer:
- Text inserted between conditions.

Empty Descriptions:
- Text used when no condition text is made.

---

Unlock Condition Text:

Condition Met Color:
- Use text colors from the Window Skin only.

Progress Format:
- Text format used to indicate progress amount.
- %1 - Progress Text

Fraction Format:
- Text format used for progress fraction.
- %1 - Current, %2 - Goal

Percent Format:
- Text format used for percentile value.
- %1 - Percent

Length Limit:
- What is the character limit before a percentage is used instead
fractions for progress text?

Complete:
- Progress text used when unlock condition is fulfilled.

Level Format:
- Text format used for level conditions.
- %1 - Level, %2 - Progress

Battle Format:
- Text format used for fought battles.
* %1 - Needed, %2 - Progress

Victory Format:
- Text format used for victorious battles.
- %1 - Needed, %2 - Progress

Escape Format:
- Text format used for escaped battles.
- %1 - Needed, %2 - Progress

Defeat Format:
- Text format used for lost battles.
- %1 - Needed, %2 - Progress

Attack Format:
- Text format used for attack times.
- %1 - Needed, %2 - Progress

Guard Format:
- Text format used for guard times.
- %1 - Needed, %2 - Progress

Skill Format:
- Text format used for skill times.
- %1 - Needed, %2 - Progress

Physical Skills:
- Text format used for physical skills.
- %1 - Needed, %2 - Progress

Magical Skills:
- Text format used for magical skills.
- %1 - Needed, %2 - Progress

Certain Hit Skills:
- Text format used for certain hit skills.
- %1 - Needed, %2 - Progress

Item Format:
- Text format used for item uses.
- %1 - Needed, %2 - Progress

Deal Criticals:
- Text format used for dealing criticals.
- %1 - Needed, %2 - Progress

Take Criticals:
- Text format used for taking criticals.
- %1 - Needed, %2 - Progress

Miss Format:
- Text format for missing attacks.
- %1 - Needed, %2 - Progress

Evade Format:
- Text format for evading attacks.
- %1 - Needed, %2 - Progress

SType Use:
- Text format for using SType Skills.
- %1 - Needed, %2 - Progress, %3 - Type Text

Deal Element DMG:
- Text format used for inflicting element damage.
- %1 - Needed, %2 - Progress, %3 - Element

Take Element DMG:
- Text format used for receiving element damage.
- %1 - Needed, %2 - Progress, %3 - Element

Deal State:
- Text format used for inflicting states.
- %1 - Needed, %2 - Progress, %3 - State

Take State:
- Text format used for receiving states.
- %1 - Needed, %2 - Progress, %3 - State

Trait Slayer:
- Text format for slaying trait types.
- %1 - Needed, %2 - Progress, %3 - Type Text

Total Damage Dealt:
- Text format for total damage dealt.
- %1 - Needed, %2 - Progress

Total Damage Taken:
- Text format for total damage received.
- %1 - Needed, %2 - Progress

Total Healing Dealt:
- Text format for total healing given.
- %1 - Needed, %2 - Progress

Total Healing Taken:
- Text format for total healing taken.
- %1 - Needed, %2 - Progress

Kills Format:
- Text format for kills performed.
- %1 - Needed, %2 - Progress

Deaths Format:
- Text format for deaths in battle.
- %1 - Needed, %2 - Progress

Assists Format:
- Text format for assists made.
- %1 - Needed, %2 - Progress

Reach Gold Total:
- Text format for reaching gold quantity.
- %1 - Needed, %2 - Progress, %3 - Gold

Reach Item Total:
- Text format for reaching item quantity.
- %1 - Needed, %2 - Progress, %3 - Item

Reach Weapon Total:
- Text format for reaching weapon quantity.
- %1 - Needed, %2 - Progress, %3 - Weapon

Reach Armor Total:
- Text format for reaching armor quantity.
- %1 - Needed, %2 - Progress, %3 - Armor

Reach Base Param:
- Text format for reaching base Param amount.
- %1 - Needed, %2 - Progress, %3 - Param Name

Reach XParam Amount:
- Text format for reaching X Param amount.
- %1 - Needed, %2 - Progress, %3 - XParam Name

Reach SParam Amount:
- Text format for reaching S Param amount.
- %1 - Needed, %2 - Progress, %3 - SParam Name

---

=== Window Settings ===

[[File:EquipPassiveSys_Preview1.png|600px]]

[[File:EquipPassiveSys_Params3.png]]

These settings let you adjust the windows displayed for this plugin.

---

Equip Passive List:

Background Type:
- Select background type for this window.

Equipped Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Show Capacity Costs?:
- Shows capacity costs on Passives?

Show 0 Costs?:
- Shows capacity costs if they cost 0?

Show 1 Costs?:
- Shows capacity costs if they only cost 1?

Show Cost Numbers?:
- Shows capacity cost values?
- If not, displays multiple icons instead.

Cost Icon Limit:
- If "Show Cost Numbers" is false, this is how many icons can be
displayed max before showing number costs.

Sort Style:
- How do you wish to sort passives by?

Show Unlearned?:
- Shows unlearned passives in the list window?

Separate Unlearned?:
- Separate unlearned passives from learned passives?

Mask Unlearned?:
- Masks unlearned passives in list window?

Mask Icon:
- What is the icon used for masked passives?

Mask Character:
- Text used for masking per individual character.

Italics?:
- Use italics for masked names?

---

Passive Status Window:

Show Window?:
- Shows this window in the scene?

Background Type:
- Select background type for this window.

Max Capacity Color:
- Use text colors from the Window Skin only.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella
* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.06: March 16, 2026
* Bug Fixes!
** Fixed a bug where <nowiki><Learnable Equip Passives></nowiki> notetag was not parsing correctly. Fix made by Arisu.

Version 1.05: September 18, 2025
* Bug Fixes!
** Upon actor/enemy deaths, death and kill counts won't trigger multiple times anymore. Kills will also only trigger once per battle per enemy. Fix made by Arisu.

Version 1.04: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

Version 1.03: June 13, 2024
* Bug Fixes!
** Fixed a crash made by having link learned skills available to level 1 skills upon initializing. Fix made by Olivia.
* Compatibility Update!
** Added compatibility with new Skills and States Core features!

Version 1.02: April 18, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash with the help description of a passive state not having anything to show. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag added by Irina from other plugins:
*** <Help Description>
**** Assigns a help description for the passive state.
**** This is so you don't need other unrelated plugins to add a help description for your psasive states.

Version 1.01: March 14, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash if the passive state did not have a help description. Fix made by Arisu.
** Fixed a bug where elemental damage, states, and stypes, taken and dealt was not making progress for learning new medals. Fix by Arisu.
* Feature Update!
** If a passive becomes hidden, it is no longer considered equipped.
** Inflict and Receive State effects no longer require the target to be unaffilicted by the state before to count.

Version 1.00 Official Release Date: March 25, 2024
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Grande]]

== End of Helpfile ==

|}





[[Category: RPG Maker MZ Skill Plugins]]


[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]

Battle System - OTB VisuStella MZ

2026-03-15T02:01:56Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=ASwfGzpyznQ</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/990013" width="552" height="167"><a href="https://visustellamz.itch.io/battle-system-otb">Battle System - OTB plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 8}}
|link3 = {{VisuStella All Waves Collection}}

}}



[[File:BattleSysOTB_Ani.gif]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:BattleSysOTB_Preview.png|600px]]

This plugin changes the RPG Maker MZ battle system to "Order Turn Battle",
a turn-based battle system where actions are executed immediately and the
orders for both the current and next turn are not only visible, but also
malleable. New mechanics are introduced where the player can manipulate the
turn order of an action's user or action's target in various ways they want.

The two Turn Orders are displayed at the top of the top of the screen to
give the player a clear understanding of who's turn it will be when it
becomes time to act, making it easier and viable for the player to formulate
strategies and adapt to the situation in battle.

*NOTE* To use this battle system, you will need the updated version of
VisuStella's Core Engine. Go into its Plugin Parameters and change the
"Battle System" plugin parameter to "otb".

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

* Utilizes the balanced AGI nature of the Default Turn Battle system.
* Allows for actions to execute immediately upon selection.
* Two Turn Order Displays appear at the top of the screen, giving the player an idea of who's turn it will be and when, for both the current turn and the next turn.
* Skills and Items can have an "Instant Use" effect, which allows them to perform an action immediately without using up a turn.
* Skills and Items can manipulate the turn order of the action's user or the action's target(s). This can apply to either the current turn or the next turn, depending on the notetags and/or action effects used.
* The Turn Order Display will give a preview on how turn orders will change upon specific skills and/or items being used.

== Requirements ==

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

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

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

---

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

=== Turn Order Displays ===

The Two Turn Order Displays will capture the battle's current and next turn
orders determined by the BattleManager. This feature does not overwrite any
functions, but the Turn Order Displays may or may not conflict with any
existing HUD elements that are already positioned on the screen. If so, you
can choose to offset the Turn Order Display or move it to a different part
of the screen through the plugin parameters.

---

=== Agility ===

Agility behaves slightly different from normal when it comes to the Order
Turn Battle system. Aside from the first turn in battle, agility will always
calculate the turn order for the "Next Turn" when conducted. This means that
any changes to agility values will not have any effect on the next turn's
already established turn order.

However, this can be remedied by utilizing the notetags provided by this
plugin to alter the Next Turn orders for specific targets. In fact, for
skill and item "effects" that add AGI Buffs and/or Debuffs, the target's
turn position on the Turn Order Display will be manipulated in accordance.
This auto-conversion feature can be disabled in the Plugin Parameters.

---

=== Action Speed ===

[[File:BattleSysOTB_TurnOrderChange.png]]

Because the Order Turn Battle system already calculates agility speeds
before selecting an action to perform, the effects of the action speed will
not work the same way it did with the default battle system. Instead, the
Action Speed will be sent through a formula to determine its effect on the
following turn, either pushing the user ahead in next turn's turn order
(with a positive speed value) or back (with a negative speed value).

This option can have its formula altered or straight up disabled in the
Plugin Parameters.

---

=== Infinity Speed and Clamping ===

Since Action Speeds are decided in such a way, enemies that will survive a
stun state past two turns will have "Infinity" speed on the recovery turn,
allowing them to act first relative to the rest of the battle participants
in order to balance out the turns they've lost.

Enemies with "Infinity" speed cannot be overtaken through turn order
manipulation while they are on the "Next Turn" order. If anything, battlers
who shift their turn order faster will be just trailing behind them, thus
the "clamping" effect. However if this occurs during the "Current Turn"
order, all is fair game and any battler can overtake them. Plan out your
battle system effects carefully with these rules in mind.

If you do not like the idea of Infinity Speed and/or Clamping, you can turn
them off in the Plugin Parameters.

This effect does not affect stun states that last only one turn. The effect
will only occur with stun states that last 2 turns or more.

---

=== Instant Use ===

Skills and Items can have an "Instant Use" property which allows them to be
used immediately without consuming a turn. This can be used for actions that
otherwise do not warrant a whole turn. These can be used for minor buffs,
debuffs, toggles, etc.

---

=== Force Actions ===

Due to how OTB behaves, Force Actions have be adjusted to fit the battle
system. With other battle systems, force actions are added into a hidden
queue that would act upon after the current battler finishes his/her current
action. The new changes made with force actions is that they now appear on
the queue visibly.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Party System VisuStella MZ]]

In battle, the player cannot change entire parties at once from the Party
Command Window. The feature will be unaccessible while Order Turn Battle is
in play. However, the player can still change party members through the
Actor Command Window by having actors replace other actors. Party changing
is also available through battle events, Common Events, and script calls.

---

{{Notetags MZ}}

{{VisuMZ Battle System OTB Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Battle System OTB Plugin Commands}}

== Script Calls ==

The following are Script Calls that can be used with this plugin. These are
made for JavaScript proficient users. We are not responsible if you use them
incorrectly or for unintended usage.

---

=== Add Action-Related Script Calls ===

---

<pre>
$otbAddBattlerToCurrentTurnEnd(battler, times)

- Adds a battler to current turn's end
- Replace 'battler' with a battler object or target
- Replace 'times' with a number representing the number of actions to add
</pre>

---

<pre>
$otbAddBattlerToNextTurnEnd(battler, times)

- Adds a battler to next turn's end
- Replace 'battler' with a battler object or target
- Replace 'times' with a number representing the number of actions to add
</pre>

---

== Plugin Parameters ==

=== Conversion Settings ===

[[File:BattleSysOTB_TurnOrderChange.png]]

[[File:BattleSysOTB_Params1.png]]

Automatically converts specific mechanics to fit OTB.

---

Buffs

AGI Buff => Current:
- Auto-convert AGI Buff effects for Items/Skills to speed up target's
current Turn Order?

AGI Buff => Next:
- Auto-convert AGI Buff effects for Items/Skills to speed up target's
next Turn Order?

---

Debuffs

AGI Debuff => Current:
- Auto-convert AGI Debuff effects for Items/Skills to slow down target's
current Turn Order?

AGI Debuff => Next:
- Auto-convert AGI Debuff effects for Items/Skills to slow down target's
next Turn Order?

---

States (AGI >= 105%)

Add State => Current:
- Auto-convert AGI Up States effects for Items/Skills to speed up target's
current Turn Order?

Add State => Next:
- Auto-convert AGI Up States effects for Items/Skills to speed up target's
current Turn Order?

---

States (AGI <= 95%)

Add State => Current:
- Auto-convert AGI Down States effects for Items/Skills to slow down
target's current Turn Order?

Add State => Next:
- Auto-convert AGI Down States effects for Items/Skills to slow down
target's current Turn Order?

---

=== Mechanics Settings ===

[[File:BattleSysOTB_Params2.png]]

Determines the mechanics of Battle System OTB. These range from how Action
Times are handled to speed.

---

[[File:BattleSysOTB_ActionTimes.png]]

Action Times+

Enable Action Times?:
- Enable Action Times+ to have an effect on OTB?

Randomize Order?:
- If enabled, randomize the action order for added actions?

---

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

Speed

Allow Random Speed?:
- Allow speed to be randomized base off the user's AGI?

Post-Stun Infinity?:
- After a 2+ turn stun states, battlers have infinity speed for their
recovery turn.
- Once again, this only applies to stun states that last 2+ turns.

Infinity Clamp?:
- Prevents turn order manipulation from going faster than infinity
speed battlers.

JS: Initial Speed:
- Code used to calculate initial speed at the start of battle.

JS: Speed => Order:
- Code used to calculate how action speeds alter next turn's order.

---

=== Turn Order Display ===

[[File:BattleSysOTB_TurnOrderDisplay.png|600px]]

[[File:BattleSysOTB_Params3.png]]

Turn Order Display settings used for Battle System OTB. These adjust how the
two visible turn orders appears in-game.

---

General

Display Position:
- Select where the Turn Order will appear on the screen.
- Top
- Bottom

Offset X:
- How much to offset the X coordinate by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset the Y coordinate by.
- Negative: up. Positive: down.

Reposition for Help?:
- If the display position is at the top, reposition the display when the
help window is open?

Offset X:
- Reposition the display's X coordinates by this much when the Help
Window is visible.

Offset Y:
- Reposition the display's Y coordinates by this much when the Help
Window is visible.

Forward Direction:
- Decide on the direction of the Turn Order.
- Left to Right
- Right to Left

Subject Distance:
- How far do you want the currently active battler to distance itself from
the rest of the Turn Order?

Screen Buffer:
- What distance do you want the display to be away from the edge of the
screen by?

---

UI Background

Background Style:
- Select the style you want for the background.
- fill
- gradient
- image
- transparent

Image Filename:
- When using the "image" style, select an image from /img/system/ as the
background image.

Offset X:
- How much do you want to offset the Background Image's X position?

Offset Y:
- How much do you want to offset the Background Image's Y position?

---

UI Text

Font Size:
- The font size used for parameter values.

Active Battler Text:
- Text used to display the active battler.
- This text will always be center aligned.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Current Turn Text:
- Text used to display the current turn.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Next Turn Text:
- Text used to display the next turn.

Offset X:
- How much do you want to offset the text's X position?

Offset Y:
- How much do you want to offset the text's Y position?

Text Align:
- Text alignment for the Current and Next Turn texts?
- auto
- left
- center
- right

---

Slots

Width:
- How many pixels wide should the slots be on the Turn Order display?

Height:
- How many pixels tall should the slots be on the Turn Order display?

Preview Scale:
- How much do you want to scale the preview sprites by?
- Use a number between 0 and 1 for the best results.

Offset X:
- How much do you want to offset the Preview Sprites' X position?

Offset Y:
- How much do you want to offset the Preview Sprites' Y position?

Update Frames:
- How many frames should it take for the slots to update their
positions by?

---

Slot Border

Show Border?:
- Show borders for the slot sprites?

Border Thickness:
- How many pixels thick should the colored portion of the border be?

Actors
Enemies

Border Color:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Preview Version:
- A different setting is used for the preview version.

Border Skin:
- Optional. Place a skin on the actor/enemy borders instead of
rendering them?

Preview Version:
- A different setting is used for the preview version.

---

Slot Sprites

Actors

Sprite Type:
- Select the type of sprite used for the actor graphic.
- Face Graphic - Show the actor's face.
- Icon - Show a specified icon.
- Sideview Actor - Show the actor's sideview battler.

Default Icon:
- Which icon do you want to use for actors by default?

Enemies

Sprite Type:
- Select the type of sprite used for the enemy graphic.
- Face Graphic - Show a specified face graphic.
- Icon - Show a specified icon.
- Enemy - Show the enemy's graphic or sideview battler.

Default Face Name:
- Use this default face graphic if there is no specified face.

Default Face Index:
- Use this default face index if there is no specified index.

Default Icon:
- Which icon do you want to use for enemies by default?

Match Hue?:
- Match the hue for enemy battlers?
- Does not apply if there's a sideview battler.

---

Slot Letter

Show Enemy Letter?:
- Show the enemy's letter on the slot sprite?

Font Name:
- The font name used for the text of the Letter.
- Leave empty to use the default game's font.

Font Size:
- The font size used for the text of the Letter.

---

Slot Background

Show Background?:
- Show the background on the slot sprite?

Actors
Enemies

Background Color 1:
Background Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

Preview Version:
- A different setting is used for the preview version.

Background Skin:
- Optional. Use a skin for the actor background instead of
rendering them?

Preview Version:
- A different setting is used for the preview version.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Verison 1.21: March 16, 2026
* Compatibility Update!
** Updated better compatibility for Battle Grid System force action update. Update made by Olivia.

Version 1.20: January 19, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Conversion Settings > States (AGI >= 105%)
*** Parameters > Conversion Settings > States (AGI <= 95%)
**** Added auto-conversion functionality for states with AGI modifiers to automatically manipulate turn orders for current and next.
**** Set this to false to not use.

Version 1.19: November 13, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New script calls added by Olivia:
*** $otbAddBattlerToCurrentTurnEnd(battler, times)
*** $otbAddBattlerToNextTurnEnd(battler, times)
**** Adds actions for target battler to the end of current/next turn.

Version 1.18: May 15, 2025
* Bug Fixes!
** Fixed a bug where adding states with Action Times+ would add too many actions. Fix made by Olivia.

Version 1.17: November 14, 2024
* Bug Fixes!
** Fixed a bug where the <OTB Target Follow Turn: +x> and similar notetags altered the following turn regardless of the presence of the target in current turn order. Fix made by Olivia.

Version 1.16: September 19, 2024
* Compatibility Update!
** Added better compatibility with Auto Skill Triggers. Update by Arisu.

Version 1.15: May 16, 2024
* Feature Update!
** Direct removal of stun states will restore actions for battlers for current turns and follow up turns. Update made by Olivia.

Version 1.14: May 18, 2023
* Bug Fixes!
** Fixed a bug that caused turn order glitches with Action Times+ that aren't at 100% value. Fix made by Olivia.
** Fixed a bug that caused added Action Times+ to not trigger on actors that have already exhausted their current turns if raised due to a state. Fix made by Olivia.

Version 1.13: January 20, 2023
* Bug Fixes!
** Fixed a bug where the Forced Action of a battler is not used properly. Fix made by Arisu.

Version 1.12: December 15, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: August 18, 2022
* Bug Fixes!
** Fixed bugs that caused the OTB Turn Order faces and icons to not change properly for actors and enemies.

Version 1.10: July 7, 2022
* Feature Update!
** When the "Recover All" event command revives a dead unit, that revived unit can gain actions back if all other conditions are met. Update made by Olivia.

Version 1.09: June 2, 2022
* Documentation Update!
** Added "Force Actions" to "Major Updates" section.
*** Due to how OTB behaves, Force Actions have be adjusted to fit the battle system. With other battle systems, force actions are added into a hidden queue that would act upon after the current battler finishes his/her current action. The new changes made with force actions is that they now appear on the queue visibly.
* Bug Fixes!
** Fixed a bug that caused Forced Actions to not work properly while in OTB. Changes made to Forced Actions will now insert new actions at the front of the current action queue. Fix made by Olivia.

Version 1.08: March 10, 2022
* Feature Update!
** OTB Instant Actions should now appear in the turn order in a more sensible fashion. Update made by Olivia.

Version 1.07: February 24, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.06: November 11, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia:
*** <OTB User Add Current Turn Actions: x>
*** <OTB User Add Next Turn Actions: x>
*** <OTB Target Add Current Turn Actions: x>
*** <OTB Target Add Next Turn Actions: x>
**** Adds extra actions for the user/target to perform during the current/next turn.
**** Added actions will go towards the back of the action list.
**** Multi-hit skills/items will trigger this effect multiple times.

Version 1.05: October 28, 2021
* Bug Fixes!
** Turn Order display will no longer appear at differing X and Y positions when using specific battle layouts. Update made by Olivia.

Version 1.04: August 6, 2021
* Bug Fixes!
** Enemies with multiple actions will no longer step forward when it's not their turn. Fix made by Olivia.

Version 1.03: June 25, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.02: April 16, 2021
* Bug Fixes!
** Post-stun infinity clamping should now be adjusted properly for previewing turn order changes.

Version 1.01: April 9, 2021
* Bug Fixes!
** Subsequent battles will properly reset the turn order. Fix by Olivia.

Version 1.00 Official Release Date: April 26, 2021
* Finished Plugin!

== See Also ==

* [[Battle System Differences VisuStella MZ]]
* [[Inspiration Behind Wave 8]]

== End of File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]




[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]

Battle Grid System VisuStella MZ

2026-03-15T02:01:48Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://youtu.be/swoS2bwVj0k</youtube>

|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/2546116" width="552" height="167"><a href="https://visustellamz.itch.io/battle-grid-system">Battle Grid System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Grande Vol 1}}

}}



[[File:BattleGridSystem_Preview1.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Battle Core VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:VisuMZ.150.jpg|600px]]

This plugin changes battles to utilize a grid system. The grid will be
composed of nodes for each team and battlers can move amongst them. By being
on top of specific nodes, different strategies can be employed such as
making certain skills available to use while on such nodes or applying
unique passive state effects.

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

* Battles are changed to employ a grid system and places nodes across the battlefield for battlers to position themselves on top of.
* Battlers can move between their team's nodes and give themselves a better position for battle. Battlers cannot move to the opposing team's nodes.
* Ranks and Flanks determine each node's position. Depending on the Rank and Flank a node is on, different properties can be employed.
* Certain skills and items can only be used while standing on top of certain nodes as a new type of usage requirement.
* Skills and items can move the user and/or the targets around on the battle grid in a variety of ways, such as switching or crashing into other battlers and inflicting crash damage.
* Skills and items can have their range restricted to certain Ranks and Flanks declared by notetags.
* Some skills and items can have their range restricted based on the weapon equipped by the user, allow for melee-only targeting or the whole range of the battle field grid.
* Skills and items can directly select which nodes, Ranks, or Flanks to target for attacks or healing.
* Area of Effect notetags allow players to create skills and items that can affect more than one target based on positioning.
* Nodes can give passive state effects while battlers stand on top of them.
* Nodes can house triggers, which are skill actions that will set off once a battler stands on top of that node. Triggers can be used to deal damage, heal battlers, apply status ailments, and more.
* Skills and items can be used to plant passive states and/or action triggers on specific Nodes!
* Some skills and items can have special effects like teleporting to a specific Node, pulling all members of unit towards a specific Node, or even pushing them away.
* The Grid Tactics scene allows players to adjust where they want the party members to start. Let the player decide which nodes to start individual party members on.

== Requirements ==

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

=== Required Plugin List ===

* [[Battle Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Grid System Mechanics ==

This section explains the various changes and new mechanics regarding the
battle grid system.

---

=== Ranks, Flanks, and Nodes ===

[[File:BattleGridSystem_Preview1.png|600px]]

---

Each visually vertical column is called a "Rank". The name is from miliary
usage for rows of soldiers standing side by side, also sometimes known as
"files" or "lines". The numbering starts at the center of the grid going
outward for each team.

Enemy Team Ally Team
4 3 2 1 1 2 3 4
4 3 2 1 1 2 3 4
4 3 2 1 1 2 3 4

---

Each visually horizontal row is called a "Flank". The name is from military
usage to referance the sides of a formation, also sometimes known as the
"wings" of a formation. The number starts at the top of the grid going to
the bottom of the grid.

Enemy Team Ally Team
1 1 1 1 1 1 1 1
2 2 2 2 2 2 2 2
3 3 3 3 3 3 3 3

---

The points at which each Rank and Flank intersects is called a "Node". Every
battler will be positioned on a node and only one battler can be on a node
at any given time.

Enemy Team Ally Team
4,1 3,1 2,1 1,1 1,1 2,1 3,1 4,1
4,2 3,2 2,2 1,2 1,1 2,2 3,2 4,2
4,3 3,3 2,3 1,3 1,3 2,3 3,3 4,3

---

=== Battler Movement ===

[[File:BattleGridSystem_Movement.gif]]

---

==== Actors ====

Actors can use the "Move" command to move to any allowed node based on their
moveset rulings. By default, this means they can only move to adjacent nodes
relative to their current position.

Upon moving via the "Move" command, the command can undergo cooldown where
the actor must wait a set amount of turns before being able to "Move" again.
The cooldown amount can be adjusted through the Plugin Parameters.

Also upon moving via the "Move" command, the actor can also end their turn
immediately. This is an optional command and can be adjusted per actor with
notetags or by default through the Plugin Parameters.

Actors that are charmed, berserk, or on Auto-Battle will not use the "Move"
command. The move command requires the actor to be able to move, too.

---

==== Enemies ====

Enemies do not have a "Move" command and therefore, do not move by default.
Instead, the best way to have enemies move is to create movement Skills and
have their battle AI perform them. These skills are best left as enemy-only
skills that actors do not have access to.

Their accessibility and frequency of use to move skills have no bearing to
and from the nature of movement effects. However, certain effects may stop
the movement effects associated with the skills such as the Battle Core
notetag <Battler Sprite Cannot Move> for enemies.

---

==== Actors and Enemies Stay on Their Sides ====

Actors and enemies will not move onto the nodes belonging to the opposing
unit. This means actors will always be on the rightmost nodes while enemies
will be on the leftmost nodes. They CANNOT cross over into each other's
territory as this plugin does not support that grid gameplay style. The
nodes that belong to each unit's side will stay on those sides. Ownership of
a node's team cannot be switched.

---

=== Movement Features ===

---

==== Switching ====

[[File:BattleGridSystem_Switching.gif]]

If a battler moves onto a node that already has an allied battler on it,
then the two battlers can switch places. The place switching will only occur
if done on the acting battler's own intention or by another ally battler.
Switching can be disabled by Plugin Parameters.

Certain notetags can also prevent a battler from being able to switch such
as the <Battler Sprite Cannot Move> enemy-only notetag available from the
VisuMZ Battle Core.

However! If a battler is dead, regardless of all other notetag properties,
the corpse becomes node-switchable. The reason for this is because it helps
prevent a soft-lock state in which either the player or enemy side cannot
perform actions due to their current node location (think of melee battlers
being stuck behind a wall of corpses loaded on the front row). By being able
to move and switch nodes with corpses, soft lock scenarios can be solved.
This setting can also be adjusted as a Plugin Parameter for those who feel
confident in their ability to design their battles where soft locks are
impossible to happen with.

If the Plugin Parameter is changed to disallow switching with corpses, this
will only apply to corpses that remain visible. Corpses that fade away with
collapse effects will not apply and can still be switched (even though
invisible after).

---

==== Collision ====

[[File:BattleGridSystem_Crashback.gif]]

If a battler uses a skill that moves an opposing battler onto a node with
another opposing battler, then collision occurs. The target opposing battler
that should be knocked back will return to their original position while
both colliding battlers take knockback damage.

---

=== Battle Grid Tactics ===

[[File:BattleGridSystem_Preview2.png|600px]]

---

This is an optional feature.

You can turn on "Battle Grid Tactics" to allow for players to set up the
starting positions of where the individual members of the party will go when
a battle starts.

This adds a new command to the Main Menu, which takes the player to a scene
where they can customize their battle grid tactics layout.

If this feature is not used, then the starting positions of individual party
members will depend on the notetags used to determine their battle starting
ranks and flanks.

---

== Major Changes ==

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

---

=== Sideview Only ===

[[File:BattleGridSystem_Preview1.png|600px]]

If your game is NOT using sideview and you are using the Battle Grid System,
then the plugin will automatically enforce the sideview property. The reason
behind this is because the grid system is specifically made for sideview
visuals and controls. Therefore, it will not work without it.

As such, some visual properties are also changed with this. Battlers will no
longer step forward or backward when it's their turn to actively input a
command. The reason behind this is because it causes a visual discrepancy
with the grid node they're supposed to be standing at. And depending on the
size of the grid node, it may cause confusion as to where the battler is
actually standing. Therefore, the plugin will keep the battlers at their
node location while inputting or performing the start of their actions.

---

=== Max Battle Members ===

[[File:BattleGridSystem_Preview1.png|600px]]

There is a limit to how many battle members you can bring into battle based
off the number of available nodes (Ranks x Flanks). If you have too few,
then the plugin will warn you and then halt the game.

If you are using Battle Grid Tactics, the optional feature to let players
determine where they want the party members to start at, then a maximum of
20 party members can be used in order to match the Plugin Parameter limits.
If the max number becomes more than 20 members, it will be automatically
capped to 20 members.

---

=== Temporary Tactical Formations ===

[[File:BattleGridSystem_Preview2.png|600px]]

Temporary formations are very specific formations that will overwrite what
settings the player has made. These involve specific rank/flank positions
per party member (though some can be automatic). With temporary formations
in play, the player cannot change them outside of battle. However, once in
battle, the positions can be changed through the movement command and/or
action effects.

When a temporary formation is present, menu and battle commands involving
changing party members will be disabled.

Once a temporary formation is disbanded, the player's self-made formation
settings will be returned and the player can readjust tactical formations
once more.

---

== 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]] ===

[[File:VisuMZ.002.jpg|300px|link=Battle Core VisuStella MZ]]

When using the <Battle Commands> class notetag, you can manually position
the "Move" command by inserting "Grid Move" in between <Battle Commands> and
</Battle Commands>.

---

=== [[Aggro Control System VisuStella MZ]] ===

[[File:VisuMZ.025.jpg|300px|link=Aggro Control System VisuStella MZ]]

Certain features of the Battle Grid System are changed to behave slightly
different when there is the presence of a provoker or taunter. These changes
will be explained in the help file.

---

=== VisuStella Battle Systems ===

[[File:VisuMZ.066.jpg|300px|link=Battle System - OTB VisuStella MZ]]

All custom battle systems made by VisuStella MZ are compatible with the
battle grid system and can be used together. However, there are some
restrictions put into play with specific battle systems. More information
will be mentioned in detail in the "VisuStella MZ Compatibility" section
found below.

---

=== [[Party System VisuStella MZ]] ===

[[File:VisuMZ.019.jpg|300px|link=Party System VisuStella MZ]]

When the Party System is used together with the optional Battle Grid Tactics
feature, players can create empty spaces in their party to allow for the
positions of party members to go to specific nodes.

For example, if a party has members in slots 1, 2, and 4 while 3 is empty,
then those party members will go to tactical nodes 1, 2, and 4, instead of
moving 4 up to 3.

This only applies in-game and not through battle test if there are empty
slots in the battle test setup.

---

=== [[Battle AI VisuStella MZ]] ===

[[File:VisuMZ.026.jpg|300px|link=Battle AI VisuStella MZ]]

Certain AI behaviors will change depending on the limitations of what an
action is capable of affecting. The changes all involve factoring only what
is within the range of an action.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

=== [[Aggro Control System VisuStella MZ]] ===

[[File:VisuMZ.025.jpg|300px|link=Aggro Control System VisuStella MZ]]

In battle, if there are Provoke or Taunt targets on the field and an action
that needs target selection is attempted to be used, the Provoke or Taunt
targets must be within valid affected Ranks/Flanks that can be targeted by
the action or else the action can't be used.

Skills that do NOT need to select a target (usually skills with a "Random"
scope or "All" scope) can bypass this as they would normally without the
Battle Grid System.

As such, be careful about designing your skills with restrictive Rank/Flank
targeting that potential softlocks may occur if there are ever any Taunt or
Provoke targets on the field.

In regards to skills that target the highest aggro member, these will target
the highest aggro member within the required Ranks/Flanks made by the skill
as to not further restrict this skill's targeting ability.

---

=== [[Battle System - ATB VisuStella MZ]] ===

[[File:VisuMZ.022.jpg|300px|link=Battle System - ATB VisuStella MZ]]

If the ATB Battle System is currently being used with the active setting,
selecting the "Move" command during another battler's turn will queue up the
system, waiting for the current battler's turn to end before allowing the
inputting actor to move.

---

=== [[Battle System - BTB VisuStella MZ]] ===

[[File:VisuMZ.048.jpg|300px|link=Battle System - BTB VisuStella MZ]]

If the BTB Battle System is currently being used and the movement command
will pass turn, then the move command will be disabled if the actor is under
the effect of "Brave" as it becomes the same case scenario as "Guard".

On that note, during the command input phase, actors under the effect of
"Brave" can select skills and items outside of their required ranks/flanks.
If you wish to disable this, adjust the "Bypass Require Node?" setting in
the "Compatibility Settings" Plugin Parameters.

When the queued actions occur and the required rank/flank node positions
are NOT met, then the actions will be skipped.

---

=== Team-Based Battle Systems ===

[[File:VisuMZ.080.jpg|300px|link=Battle System - ETB VisuStella MZ]]

[[File:VisuMZ.057.jpg|300px|link=Battle System - FTB VisuStella MZ]]

[[File:VisuMZ.086.jpg|300px|link=Battle System - PTB VisuStella MZ]]

[[Battle System - ETB VisuStella MZ]]

[[Battle System - FTB VisuStella MZ]]

[[Battle System - PTB VisuStella MZ]]

If the ETB, FTB, or PTB Battle Systems are being used and the move command
will pass turn, and if no other actors can input for that turn, any
remaining actions will be forfeited for that turn.

---

=== [[Battle System - OTB VisuStella MZ]] ===

[[File:VisuMZ.066.jpg|300px|link=Battle System - OTB VisuStella MZ]]

If the OTB Battle System is being used and the movement command will pass
turn, the turn passing will only apply to the current action. Any follow up
actions on the same turn from that actor can be utilized.

---

=== [[Party System VisuStella MZ]] ===

[[File:VisuMZ.019.jpg|300px|link=Party System VisuStella MZ]]

In battle, the player cannot change entire parties at once from the Party
Command Window. The feature will be unaccessible while Battle Grid System is
in play. However, the player can still change party members through the
Actor Command Window by having actors replace other actors. Party changing
is also available through battle events, Common Events, and script calls.

---

{{Notetags MZ}}

{{VisuMZ Battle Grid System Notetags}}

== Action Sequence - Plugin Commands ==

The following are Plugin Commands that become usable with this plugin.
They can be accessed through the Plugin Command event command and selecting
the VisuMZ_1_BattleCore plugin where they are stored.

---

=== Action Sequences - Grid ===

These Action Sequences are Battle Grid System-related.

---

{{Battle Grid System Action Sequences}}

---

{{Plugin Commands MZ}}

{{VisuMZ Battle Grid System Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:BattleGridSystem_Preview1.png|600px]]

[[File:BattleGridSystem_Params1.png]]

General settings for this plugin including some mechanics.

---

Defaults

Default Grid?:
- Are battles grid-battles by default?
- Use <Grid> and <No Grid> in troop names otherwise.

Movement Duration:
- Default number of frames for movement duration.

User Silent Move?:
- Default setting for silent movement versus visual.
- Applies only to user movement notetag.

Target Silent Move?:
- Default setting for silent movement versus visual.
- Applies only to target movement notetag.

Weapon Range Melee?:
- Make weapon ranges melee by default?
- Only affects actions with <Use Weapon Range> notetag.

---

Crashing

Allow Crash Death?:
- Can battlers die from crashing into one another?

Damage Move Target?:
- Cause damage to the target that's being moved?

Animation ID:
- Play this animation when the effect activates.
- Use 0 to not play an animation.

Damage Crash Target?:
- Cause damage to the target that's moved into?

Animation ID:
- Play this animation when the effect activates.
- Use 0 to not play an animation.

JS: Crash DMG Formula:
- Formula used for calculating Crash Damage.

---

Switching Nodes

Can Dead Switch?:
- Can battlers switch Node positions with dead units?

---

Triggers

Show Popup?:
- Show popups when a battler activates a Trigger?

Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Flash Color:
- Adjust the popup's flash color.
- Format: [red, green, blue, alpha]

Flash Duration:
- What is the frame duration of the flash effect?

---

=== Grid Field Settings ===

[[File:BattleGridSystem_Preview1.png|600px]]

[[File:BattleGridSystem_Params2.png]]

Settings used for the overall grid field.

---

Size

Max Ranks:
- How many ranks are used for each team?
- Max: 10.
- Ranks are formation rows or columns visually.

Max Flanks:
- How many flanks are used for each team?
- Max: 10.
- Ranks are formation sides/wings or rows visually.

---

Field Appearance

Max Horz Distance:
- What is the maximum horizontal distance that the grid field spans across
the screen?
- Auto-shrinks if too big.

Top/Bottom Delta:
- What is the horizontal size difference from top to bottom of the field.
- This adds perspective.

Vertical Distance:
- What is the vertical distance that the grid field spans across the
screen from top to bottom?

Perspective Modifier:
- What is the perspective modifier? This is so that upper point distances
shrink and lower point distances expand.

Space Between:
- How many nodes between each unit's front rank?
- The space gives more room for movement animations.

---

Effects

Blink Input User?:
- Blink the input user for more clarity?

Blink Color:
- Adjust the blinking input color.
- Format: [red, green, blue, alpha]

---

Offsets

Grid Node Offsets:

Offset X:
- Offsets the node x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the node y position.
- Negative: up. Positive: down.

Actor Sprite Offset:

Offset X:
- Offsets the actor x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the actor y position.
- Negative: up. Positive: down.

Enemy Sprite Offset:

Offset X:
- Offsets the enemy x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the enemy y position.
- Negative: up. Positive: down.

---

Outline Filter

Show Outline Filter?:
- Show outline filter for nodes?
- Requires Pixi JS Filters.

Inner Color:
- System hex code color for inner color.
- Format: 0xRRGGBB
- Requires Pixi JS Filters.

Inner Thickness:
- What thickness do you want for inner outline?
- Requires Pixi JS Filters.

Outer Color:
- System hex code color for outer color.
- Format: 0xRRGGBB
- Requires Pixi JS Filters.

Outer Thickness:
- What thickness do you want for outer outline?
- Requires Pixi JS Filters.

---

=== Grid Node Settings ===

[[File:BattleGridSystem_Preview1.png|600px]]

[[File:BattleGridSystem_Params3.png]]

Settings used for specific grid Nodes.

---

Actor Nodes

Filename:
- Filename used for the actor Node image.
- Leave empty if you don't wish to use one.

Generated Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Generated Opacity:
- What is the opacity level of the generated actor node?

Differ Blend Color:
- Blend color used when differentiating nodes.
- Format: [red, green, blue, alpha]

---

Enemy Nodes

Filename:
- Filename used for the enemy Node image.
- Leave empty if you don't wish to use one.

Generated Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Generated Opacity:
- What is the opacity level of the generated enemy node?

Differ Blend Color:
- Blend color used when differentiating nodes.
- Format: [red, green, blue, alpha]

---

Opacity

Opacity Speed:
- Speed at which the opacity changes.

Disabled Opacity:
- Opacity level for disabled nodes.

---

Scale

Scale X:
- Scale X value for the node.

Scale Y:
- Scale Y value for the node.

---

Visibility

Active Blend Color:
- Blend color used by active battler.
- Format: [red, green, blue, alpha]

Global:

Always Visible?:
- Always make all grid Nodes visible?

Any Input?:
- Make all grid Nodes during input phase?

Targeting?:
- Make all grid Nodes during targeting?

Specific:

Inputting Actor?:
- Make inputting actor's grid Node visible?

Selected Target?:
- Make selected target's grid Node visible?

Active Battler?:
- Make active battler/subject's grid Node visible?

Action Target?:
- Make action target's grid Node visible?

---

=== Passive State Settings ===

[[File:BattleGridSystem_NodePassives.gif]]

[[File:BattleGridSystem_Params4.png]]

Settings used for Passive State Nodes.

---

Properties

Show Passive Icons?:
- Show the icons of the passive states attached to a Node?

Cycle Duration:
- How many frames should each icon cycle take?

Blend Mode:
- The blend mode used for these icons.

---

Opacity

Opacity Speed:
- Speed at which the opacity changes.

Fluctuation Maximum:
- Maximum opacity value for fluctuation effect.

Fluctuation Range:
- Fluctuation range of the opacity effect.

Fluctuation Rate:
- Fluctuation rate of the opacity effect.

---

Position

Offset X:
- Offsets the passive icon's x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the passive icon's y position.
- Negative: up. Positive: down.

---

Scale

Scale X:
- Scale X value for the icon.

Scale Y:
- Scale Y value for the icon.

---

=== Trigger Settings ===

[[File:BattleGridSystem_NodeTraps.gif]]

[[File:BattleGridSystem_Params5.png]]

Settings used for Trigger Nodes.

---

Properties

Show Trigger Icons?:
- Show the icons of the trigger actions attached to a Node?

Blend Mode:
- The blend mode used for these icons.

---

Opacity

Opacity Speed:
- Speed at which the opacity changes.

Fluctuation Maximum:
- Maximum opacity value for fluctuation effect.

Fluctuation Range:
- Fluctuation range of the opacity effect.

Fluctuation Rate:
- Fluctuation rate of the opacity effect.

---

Position

Offset X:
- Offsets the trigger icon's x position.
- Negative: left. Positive: right.

Offset Y:
- Offsets the trigger icon's y position.
- Negative: up. Positive: down.

---

Scale

Scale X:
- Scale X value for the icon.

Scale Y:
- Scale Y value for the icon.

---

=== Compatibility Settings ===

Settings used for the Move Command found in Window_ActorCommand. This has
both aesthetic and mechanical settings.

---

Items & Equips Core

Shop Status Window:
- Show grid node target and casting data in Shop Status Window?

Range: Target Node:
- Text used to label target nodes.

Range: Cast Node:
- Text used to label cast nodes.

Scope: Any Node:
Scope: Empty Node:
Scope: Actor Node:
Scope: Enemy Node:
- Text used to label node scopes.

---

Battle System - BTB

Bypass Require Node?:
- During input and under "Brave" effect, ignore rank/flank node
requirements for skills/items?

---

Party System

Removal Shortcut?:
- Add member removal shortcut for Extended Tactics scene?

---

=== Move Command Settings ===

[[File:BattleGridSystem_Movement.gif]]

[[File:BattleGridSystem_Params6.png]]

Settings used for the Move Command found in Window_ActorCommand. This has
both aesthetic and mechanical settings.

---

General

Auto Add "Move"?:
- Automatically add the "Move" command to the actor command window list?

Show "Move" Command?:
- Show the "Move" command in the actor command window list?

Command Icon:
- Icon used for the "Move" command.

Command Name:
- Text used for the "Move" command.

Queue Text:
- Used with Active ATB/TPB to display movement queue.

Command Queue:
- How many turns must the actor wait before moving again?
- If cooldown is 0, move range becomes global.

Grid Switch on Move?:
- Can actors switch Nodes when using the Move Command?

Pass Turn on Move?:
- Makes the actor pass the current turn if the Move Command is used?

Battler Opacity Rate:
- What opacity rate should battlers be adjusted by when the player has to
select a Grid Node

---

Cursor

Enabled:

Blend Mode:
- The blend mode used for an enabled cursor.

Tone Color:
- Adjust the tone color of an enabled cursor.
- Format: [red, green, blue, gray]

Opacity:
- What opacity level should the enabled cursor use?

Disabled:

Blend Mode:
- The blend mode used for an disabled cursor.

Tone Color:
- Adjust the tone color of an disabled cursor.
- Format: [red, green, blue, gray]

Opacity:
- What opacity level should the disabled cursor use?

---

Default Move Range

Global Range?:
- Give actors a global movement range by default?

Disable Range?:
- Disable actor movement ranges by default?

Allowed:

Square:
Radius:
Rank:
Flank:
Diagonal Forward:
Diagonal Backward:
Forward:
Backward:
Upward:
Downward:
- What setting distance is allowed by default?

Not Allowed:

Square:
Radius:
Rank:
Flank:
Diagonal Forward:
Diagonal Backward:
Forward:
Backward:
Upward:
Downward:
- What setting distance is disallowed by default?

---

=== Sound Settings ===

[[File:BattleGridSystem_Movement.gif]]

[[File:BattleGridSystem_Params7.png]]

These settings let you adjust the sound effects used for this plugin.

---

Move Command

Filename:
- Filename of the sound effect played.

Volume:
- Volume of the sound effect played.

Pitch:
- Pitch of the sound effect played.

Pan:
- Pan of the sound effect played.

---

=== Tactics Scene Settings ===

[[File:BattleGridSystem_Preview2.png|600px]]

[[File:BattleGridSystem_Params8.png]]

These settings adjust the Battle Grid Tactics Scene. This is an entirely
optional feature that does not need to be a part of your game. If you want
it, make sure the "Use Tactics System?" parameter is set to "true". If not,
set it to "false".

[[File:BattleGridSystem_ExtendedTactics.png|600px]]

The Extended Tactics scene option allows you to extend the functionality
of the tactics scene beyond just repositioning actors on the grid. If the
Extended Tactics option is enabled, the plugin then allows players to manage
their skills, equipment, and view their status, amongst many other functions
within the Tactics scene itself. Also depending on which plugins are
installed, the Extended Tactics scene will also allow changing classes,
adding and removing party members, and overall quicker access to individual
character submenus.

---

Mechanics Settings

Use Tactics System?:
- Use the battle tactics system?
- If not, actor positions are determined by notetags and algorithms.

Extended System?:
- Use extended scene? Extended scene allows for more actor management
instead of just positioning actors pre-battle.

---

Main Menu

Command Name:
- Name of the 'Battle Tactics' option in the Main Menu.

Show in Main Menu?:
- Add the 'Battle Tactics' option to the Main Menu by default?

Enable in Main Menu?:
- Enable the 'Battle Tactics' option to the Main Menu by default?

---

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.

---

Starting Positions

1st through 20th Member:
- Adjust the settings individually for each party member.

Rank:
- What is the starting rank for this party member?
- Use 0 to let plugin determine starting position.

Flank:
- What is the starting flank for this party member?
- Use 0 to let plugin determine starting position.

---

=== Window Settings ===

[[File:BattleGridSystem_Preview2.png|600px]]

[[File:BattleGridSystem_Params9.png]]

These settings let you adjust the window settings for this plugin.

---

Action Display

Adjust Pixel Radius:
- Adjust the pixel size of each node radius by this much.

Draw Usable Nodes?:
- Draws the nodes that the user can perform an action on.
- This is for general windows.

Usable Color:
Not Usable Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Draw Target Nodes?:
- Draws the nodes that the user can target with the action.
- This is for general windows.

Ally Color:
Enemy Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

---

Window_SkillList

Window_ItemList

Window_ActorCommand

Draw Usable Nodes?:
- Draws the nodes that the user can perform an action on.
- This is for those windows.

Draw Target Nodes?:
- Draws the nodes that the user can target with the action.
- This is for those windows.

---

Tactics Help Window

Background Type:
- Select background type for this window.

Help: Select Actor:
- Help description to tell player to select an actor.

Help: Select Node:

Help: Select Node Ext:
- Extended help description to tell player to select a node.
- Help description to tell player to select a node.

Help: Required Actor:
- Extended help saying which actor is required in party.
- %1 - Party Member's Name

---

Tactics Grid Window

Background Type:
- Select background type for this window.

Graphic Type:
- Choose how the actor graphics appear in tactics menu.
- None
- Face
- Map Sprite
- Sideview Battler

Switching:

Switching BG Color 1:
Switching BG Color 2:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Switching Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Party Leader:
- Text used for the tactics banner for the party leader.
- Do not use Text Codes.

Leader Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Party Member:
- Text used for the tactics banner for party member.
- %1 - Party Member Slot ID.
- Do not use Text Codes.

Member Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Empty Node:
- Text used for the tactics banner for empty node.
- Do not use Text Codes.

Empty Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

JS: Draw Empty Node:
- Code used to draw the contents of an empty node.

JS: Draw Actor Node:
- Code used to draw the contents of a node with an actor.

---

Tactics Command Window

Background Type:
- Select background type for this window.

Window Width:
- Width of the Tactics Command Window.

Command Order:
- The order in which tactics commands appear.

Command Settings:

Move:
Party Leader:
Skill:
Equips:
Status:
Class Change:
Swap Member:
Add Member:
Remove Member:

Command Name:
- Determines how this command appears in-game.
- You may use text codes.

Help Description:
- Help description used when this command is selected.

Show Command?:
- Show this command in the Tactics Command Window?
- Some commands may require other plugins.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella
* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.14: March 16, 2026
* Compatibility Update!
** Force Action should now works with skills that target nodes, ranks, and flanks. The skill will select the appropriate node/rank/flank of the target index. Update made by Olivia.

Version 1.13: November 13, 2025
* Bug Fixes!
** Fixed a bug where if VisuMZ_4_BreakShields were turned off from showing in the UI, they would still show up. This requires you to update the plugin parameters for this plugin and can be done in three ways:
*** #1 Method: Select "Window Settings" in the Plugin Parameter list and press "Delete" button on your keyboard. Then open it back up to repopulate it with the default settings. This will reset all of the settings within "Window Settings".
*** #2 Method: Delete the current copy of VisuMZ_2_BattleGridSystem from the Plugin Manager list and install a new copy of VisuMZ_2_BattleGridSystem into the Plugin Manager list. This will reset all your Plugin Parameter settings.
*** #3 Method: Install a fresh copy of VisuMZ_2_BattleGridSystem, copy the Parameters > Window Settings > Tactics Grid Window > JS: Draw Actor Node setting and paste it in your existing copy in the Plugin Manager list.

Version 1.12: August 14, 2025
* Bug Fixes!
** Fixed a bug where cancelling attack and then moving, despite having pass turn on, would still cause the attack to go through. Fix made by Irina.

Version 1.11: May 15, 2025
* Bug Fixes!
** Fixed a bug where certain notetag combinations would cause crashes. Fix made by Arisu.
** Fixed a bug where using aura or miasma effects from Skills & States Core would cause the game to crash if there were not enough battle grid node slots to accommodate all characters, even if they were in the reserve. As a result, aura and miasma effects now only affect battle members.
* Documentation Update!
** Added documentation for <nowiki><Aura Range: type></nowiki> <nowiki><Miasma Range: type></nowiki> notetags
*** Aura/Miasma effects do not affect characters not in active party.

Version 1.10: January 16, 2025
* Bug Fixes!
** Fixed a bug where certain grid node targeting scopes did not work properly. Fix made by Olivia.
* Compatibility Update!
** Added better compatibility with Battle A.I. regarding scopes.

Version 1.09: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia:
*** <nowiki><Aura Range: type></nowiki>
*** <nowiki><Miasma Range: type></nowiki>
**** Used together with <nowiki><Aura State: x></nowiki> and <nowiki><Miasma State: x></nowiki> from VisuMZ_1_SkillsStatesCore!
**** Restricts the range in which the aura/miasma passive is emitted from the user.
**** Read the help file for more information.
* Optimization Update!
** Plugin should run more optimized.

Version 1.08: November 14, 2024
* Compatibility Update!
** Added better compatibility with Main Menu Core's force show/hide and force enable/disable Plugin Commands for Class, Equip, Skills, and Status commands. Update made by Olivia.

Version 1.07: October 17, 2024
* Bug Fixes!
** Fixed a bug where switching positions with dead party members using notetag effects would not move the dead member. Fix made by Olivia.
* Documentation Update!
** Fixed the documentation error for <rule Move User Node direction: x> notetag's "Must Switch Mid" rule explanation.
* Optimization Update!
** Plugin should run more optimized.

Version 1.06: August 29, 2024
* Bug Fixes!
** Fixed a bug where for FTB, ETB, and PTB, movement would always count as passing a turn regardless of Plugin Parameter settings. Fixed by Olivia.
** Fixed a bug where adding a battler mid-battle would cause a crash. Fix made by Olivia.
** Fixed a bug where enemies could ignore grid targeting restrictions. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
** New section added to "Major Changes":
*** Temporary formations are very specific formations that will overwrite what settings the player has made. These involve specific rank/flank positions per party member (though some can be automatic). With temporary formations in play, the player cannot change them outside of battle. However, once in battle, the positions can be changed through the movement command and/or action effects.
*** When a temporary formation is present, menu and battle commands involving changing party members will be disabled.
*** Once a temporary formation is disbanded, the player's self-made formation settings will be returned and the player can readjust tactical formations once more.
* New Features!
** New Plugin Commands added by Olivia:
*** Temp: Create Temporary Tactics (Normal)
**** Creates a temporary tactical formation.
*** Temp: Create Temporary Tactics (JS)
**** Creates a temporary tactical formation with JavaScript.
*** Temp: Disband Temporary Tactics
**** Clears temporary tactical formations.

Version 1.05: July 18, 2024
* Bug Fixes!
** Fixed a bug where actors sharing the same name would cause clashes in how they select same rank/flank targets. Fix made by Olivia.
** Fixed a bug where weapon ranges for same rank/flank would cause crashes at the start of battle. Fix made by Olivia.
** Fixed bugs with AOE targeting for 'Upward', 'Downward', 'Forward', 'Backward', 'Diagonal Forward', and 'Diagonal Backward' being inverted. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Fixed a documentation bug where there is a 'Can' effect for self movement examples that actually doesn't exist.
* New Features!
** New notetags added by Olivia:
*** <Crash Self Damage Rate: x%>
*** <Crash Target Damage Rate: x%>
**** Alters the crash damage received by a percentile rate. Self refers to the moved enemy. Target refers to the enemy crashed into.
**** Example Usage: Rubber enemies have lower crash self damage.
**** Example Usage: Fluffy enemies have lower crash target damage.
*** <Crash Self Damage Bonus: +x>
*** <Crash Self Damage Bonus: -x>
*** <Crash Target Damage Bonus: +x>
*** <Crash Target Damage Bonus: -x>
**** Alters the crash damage received by a flat bonus amount. Self refers to the moved enemy. Target refers to the enemy crashed into.
**** Example Usage: Brittle enemies have higher flat bonus target damage.
**** Example Usage: Thorny enemies have higher flat bonus target damage.

Version 1.04: June 13, 2024
* Bug Fixes!
** Crash targets can no longer crash into themselves. Fix made by Olivia.
** Fixed a bug where AoE ranges did not accept the target located in the "center" of an AoE spread. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Passive State Settings > Position > Offset X/Y:
**** Adjusts passive icon's X/Y position.
*** Parameters > Trigger Settings > Position > Offset X/Y:
**** Adjusts trigger icon's X/Y position.
** Extended Tactics Scene:
*** The Extended Tactics scene option allows you to extend the functionality of the tactics scene beyond just repositioning actors on the grid. If the Extended Tactics option is enabled, the plugin then allows players to manage their skills, equipment, and view their status, amongst many other functions within the Tactics scene itself. Also depending on which plugins are installed, the Extended Tactics scene will also allow changing classes, adding and removing party members, and overall quicker access to individual character submenus.
*** With this extended scene comes a lot more new plugin parameters:
**** Parameters > Tactics Scene Settings > Extended System?
**** Parameters > Compatibility Settings > Party System > Removal Shortcut
**** Parameters > Window Settings > Help Window > Help: Select Node Ext
**** Parameters > Window Settings > Help Window > Help: Required Actor
**** Parameters > Window Settings > Tactics Command Window > Many Settings
***** Refer to the help file for more information.

Version 1.03: May 16, 2024
* Bug Fixes!
** Fixed a bug where <Area of Effect> notetags stopped working with regular selection skills.
** Fixed an incompatibility bug with Core Engine's screen repositioning messing up the grid positioning of enemies. This effect will now be disabled when using the battle grid system. Fix made by Irina.
** Fixed a bug where an enemy moving to a node that is previously occupied by a dead enemy could no longer by mouse-clicked on. Fix made by Olivia.
** Fixed a bug where distance between resolution UI and resolution size did not visually match for moving mode. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Action Sequences that target specific nodes for animations can now work with skills and items that target ranks and flanks. Update by Olivia.
** Added gap reduction for skills without visible grids. Update by Irina.
** Better enemy selection control with keyboard. Update by Olivia.
** Items and skills with the "Never" occassion won't show the target/range information in the Window_ShopStatus window anymore. Passives won't show target/range information either. Update by Irina.
** Help Window remains open when selecting a node, rank, or flank in order to remain consistent with selecting enemies and allies. Update by Olivia.
** In Battle Test mode, tactics positions are not used and instead, will use any starting rank/flank settings.
** When node triggers occur at the end of an action, the battle system will now wait for any node trigger animations to complete before continuing.
* New Features!
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Compatibility > Items & Equips Core
**** Shop Status Window
***** Show scope, grid node target and casting data in Shop Status Window?
**** Scope: Actor Node
**** Scope: Enemy Node
***** Vocabulary text used for these new Plugin Parameters.

Version 1.02: April 18, 2024
* Bug Fixes!
** Fixed a bug where nodes without triggers would have a faint line around them. Fix made by Olivia.
** Fixed a bug where displaying healing skills outside the battle scene would cause the game to freeze up. Fix made by Olivia.
** Fixed a bug where starting rank/flanks would not register properly. Fix made by Olivia.
** Fixed a bug where certain weapon range notetags would cause some enemies to not act properly. Fix made by Olivia.
** Fixed a bug where "Damage Crash Target?" was not working properly. Fix made by Olivia.
** Fixed a bug where area of effect notetags did not work properly. Fix made by Olivia.
** Fixed a bug where a crash would occur if a passive state was applied to an enemy node. Fix made by Olivia.
** Fixed a bug where the "Move" command name cannot be changed.
** Fixed a bug where <JS Targets> notetag causes a crash. Fix by Olivia.
** Fixed a bug where self movement would suddenly stop visually animating. Fix made by Olivia.
** Fixed a bug where enemies using grid rank and flank targeting would hit their own allies instead. Fix made by Olivia.
* Compatibility Update!
** Fixed a compatibility update with ETB and PTB causing movement to not work properly. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Fixed some example notetags that weren't working.
** Added extra note to <Add Trigger to Target Node> that it does not affect nodes with any battlers on it and only works on empty nodes.
* Feature Update!
** Items and skills with the "Never" usability occassion type will not show any grid ranges.
** Items and skills with target any or empty nodes are now able to be affected by area of effects.
* New Features!
** New Notetag added by Irina:
*** <Hide Grid Range>
**** Hides the grid target and usability ranges for this item/skill.
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Compatibility > Items & Equips Core
**** Shop Status Window
***** Show scope, grid node target and casting data in Shop Status Window?
**** Range: Target Node
**** Range: Cast Node
**** Scope: Any Node
**** Scope: Empty Node
***** Vocabulary text used for these new Plugin Parameters.

Version 1.01: March 14, 2024
* Bug Fixes!
** Fixed a bug that required the State Tooltips plugin and if it wasn't present, would cause a crash upon using mouse controls. Fix by Irina.
** Fixed a bug where the add trigger to node action sequence did not work properly. Fix made by Olivia.
* Feature Update!
** Movement actor sprite now reflects the actor's offset X and Y settings found in the Battle Core. Update made by Irina.

Version 1.00 Official Release Date: March 29, 2024
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Grande]]
* [[Area of Effect (YEP)]]
* [[Row Formation (YEP)]]

== End of Helpfile ==

|}



[[Category: RPG Maker MZ Battle Plugins]]

[[Category: RPG Maker MZ Skill Plugins]]


[[Category: RPG Maker MZ Gameplay Plugins]]





[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]

Skills and States Core VisuStella MZ

2026-03-15T02:01:38Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=uRde5_XWxkw</youtube>
|link1 = {{VisuStella Wave 1}}
|link2 = {{VisuStella All Waves Collection}}

}}



[[File:SkillsStatesCoreScreen.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{ExtensionPluginsMZ}}
* [[Active Chain Skills VisuStella MZ]]
* [[Anti-Damage Barriers VisuStella MZ]]
* [[Battle System - BTB VisuStella MZ]]
* [[Battle System - ETB VisuStella MZ]]
* [[Battle System - FTB VisuStella MZ]]
* [[Battle System - PTB VisuStella MZ]]
* [[Boost Action VisuStella MZ]]
* [[Challenge System VisuStella MZ]]
* [[Equip Battle Skills VisuStella MZ]]
* [[Equip Passive System VisuStella MZ]]
* [[Equipment Set Bonuses VisuStella MZ]]
* [[Evolution Matrix Skills VisuStella MZ]]
* [[Field Skills VisuStella MZ]]
* [[Input Combo Skills VisuStella MZ]]
* [[Life State Effects VisuStella MZ]]
* [[Limited Skill Uses VisuStella MZ]]
* [[Skill Cooldowns VisuStella MZ]]
* [[Skill Mastery VisuStella MZ]]
* [[State Tooltips VisuStella MZ]]
* [[Visual Gauge Styles VisuStella MZ]]
* [[Visual State Effects VisuStella MZ]]

{{Visustella MZ}}

== Introduction ==

The Skills & States Core plugin extends and builds upon the functionality of
RPG Maker MZ's inherent skill, state, and buff functionalities and allows
game devs to customize its various aspects.

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

* Assigning multiple Skill Types to Skills.
* Making custom Skill Cost Types (such as HP, Gold, and Items).
* Allowing Skill Costs to become percentile-based or dynamic either directly through the Skills themselves or through trait-like notetags.
* Replacing gauges for different classes to display different types of Skill Cost Type resources.
* Hiding/Showing and enabling/disabling skills based on switches, learned skills, and code.
* Setting rulings for states, including if they're cleared upon death, how reapplying the state affects their turn count, and more.
* Allowing states to be categorized and affected by categories, too.
* Displaying turn counts on states drawn in the window or on sprites.
* Manipulation of state, buff, and debuff turns through skill and item effect notetags.
* Create custom damage over time state calculations through notetags.
* Allow database objects to apply passive states to its user.
* Passive states can have conditions before they become active as well.
* Updated Skill Menu Scene layout to fit more modern appearances.
* Added bonus if Items & Equips Core is installed to utilize the Shop Status Window to display skill data inside the Skill Menu.
* Control over various aspects of the Skill Menu Scene.

== Requirements ==

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

{{MZ Tier 1}}

== Major Changes ==

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

---

=== Action End Removal for States ===

[[File:SkillsStatesCore_ActionEndStun.png]]

If your Plugin Parameter settings for "Action End Update" are enabled,
then "Action End" has been updated so that it actually applies per action
used instead of just being at the start of a battler's action set.

However, there are side effects to this: if a state has the "Cannot Move"
restriction along with the "Action End" removal timing, then unsurprisingly,
the state will never wear off because it's now based on actual actions
ending. To offset this and remove confusion, "Action End" auto-removal
timings for states with "Cannot Move" restrictions will be turned into
"Turn End" auto-removal timings while the "Action End Update" is enabled.

This automatic change won't make it behave like an "Action End" removal
timing would, but it's better than completely softlocking a battler.

EXAMPLE:

The new state: "Fiery Blade" will allow the affected battler to deal fire
elemental damage. With Action End, this means for 5 actions, those attacks
will deal fire damage.

This means that if no action is taken, due to a status effect like "Sleep"
or "Stun", then the duration count will not decrease.

On the flip side, if the battler performs multiple actions a turn, then
the duration count drops faster because more actions have been spent.

However, if this "Fiery Blade" state was using Turn End instead, it will
have its duration reduced by 1 each turn, regardless of "Sleep" or "Stun"
states, and regardless of how many actions are performed each turn.

---

=== Buff & Debuff Level Management ===

[[File:SkillsStatesBuffDebuffs.png|600px]]

In RPG Maker MZ, buffs and debuffs when applied to one another will shift
the buff modifier level up or down. This plugin will add an extra change to
the mechanic by making it so that once the buff modifier level reaches a
neutral point, the buff or debuff is removed altogether and resets the buff
and debuff turn counter for better accuracy.

---

=== Skill Costs ===

[[File:SkillsStatesSkillCosts.png|600px]]

In RPG Maker MZ, skill costs used to be hard-coded. Now, all Skill Cost
Types are now moved to the Plugin Parameters, including MP and TP. This
means that from payment to checking for them, it's all done through the
options available.

By default in RPG Maker MZ, displayed skill costs would only display only
one type: TP if available, then MP. If a skill costs both TP and MP, then
only TP was displayed. This plugin changes that aspect by displaying all the
cost types available in order of the Plugin Parameter Skill Cost Types.

By default in RPG Maker MZ, displayed skill costs were only color-coded.
This plugin changes that aspect by displaying the Skill Cost Type's name
alongside the cost. This is to help color-blind players distinguish what
costs a skill has.

---

=== Sprite Gauges ===

[[File:SkillsStatesSpriteGauges.png]]

Sprite Gauges in RPG Maker MZ by default are hard-coded and only work for
HP, MP, TP, and Time (used for ATB). This plugin makes it possible for them
to be customized through the use of Plugin Parameters under the Skill Cost
Types and their related-JavaScript entries.

---

=== State Displays ===

State Displays

To put values onto states and display them separately from the state turns
you can use the following script calls.

battler.getStateDisplay(stateId)
- This returns whatever value is stored for the specified battler under
that specific state value.
- If there is no value to be returned it will return an empty string.

battler.setStateDisplay(stateId, value)
- This sets the display for the battler's specific state to whatever you
declared as the value.
- The value is best used as a number or a string.

battler.clearStateDisplay(stateId)
- This clears the display for the battler's specific state.
- In short, this sets the stored display value to an empty string.

=== Window Functions Moved ===

Some functions found in RPG Maker MZ's default code for Window_StatusBase
and Window_SkillList are now moved to Window_Base to make the functions
available throughout all windows for usage.

---

== Slip Damage Popup Clarification ==

Slip Damage popups only show one popup for HP, MP, and TP each and it is the
grand total of all the states and effects combined regardless of the number
of states and effects on a battler. This is how it is in vanilla RPG Maker
MZ and this is how we intend for it to be with the VisuStella MZ library.

This is NOT a bug!

The reason we are not changing this is because it does not properly relay
information to the player accurately. When multiple popups appear, players
only have roughly a second and a half to calculate it all for any form of
information takeaway. We feel it is better suited for the player's overall
convenience to show a cummulative change and steer the experience towards a
more positive one.

== Passive State Clarification ==

[[File:SkillsStatesCorePassives.png]]

This section will explain various misconceptions regarding passive states.
No, passive states do not work the same way as states code-wise. Yes, they
use the same effects as states mechanically, but there are differences.

{{Skills and States Core Passive States Clarification}}

{{Notetags MZ}}

{{VisuMZ Skills and States Core Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Skills and States Core Plugin Commands}}

== Plugin Parameters ==

=== General Skill Settings ===

[[File:SkillsStatesCoreScreen.png|600px]]

[[File:SkillsStatesCoreParams01.png]]

These Plugin Parameters adjust various aspects of the game regarding skills
from the custom Skill Menu Layout to global custom effects made in code.

---

General

Use Updated Layout:
- Use the Updated Skill Menu Layout provided by this plugin?
- This will automatically enable the Status Window.
- This will override the Core Engine windows settings.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

Skill Type Window

Style:
- How do you wish to draw commands in the Skill Type Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Skill Type Window.

Window Width:
- What is the desired pixel width of this window?
- Default: 240

---

List Window

Columns:
- Number of maximum columns.

---

Shop Status Window

Show in Skill Menu?:
- Show the Shop Status Window in the Skill Menu?
- This is enabled if the Updated Layout is on.

Adjust List Window?:
- Automatically adjust the Skill List Window in the Skill Menu if using
the Shop Status Window?

Background Type:
- Select background type for this window.
- 0 - Window
- 1 - Dim
- 2 - Transparent

JS: X, Y, W, H:
- Code used to determine the dimensions for this Shop Status Window in the
Skill Menu.

---

Skill Types

Hidden Skill Types:
- Insert the ID's of the Skill Types you want hidden from view ingame.

Hidden During Battle:
- Insert the ID's of the Skill Types you want hidden during battle only.

Icon: Normal Type:
- Icon used for normal skill types that aren't assigned any icons.
- To assign icons to skill types, simply insert \I[x] into the
skill type's name in the Database > Types tab.

Icon: Magic Type:
- Icon used for magic skill types that aren't assigned any icons.
- To assign icons to skill types, simply insert \I[x] into the
skill type's name in the Database > Types tab.

Sort: Alphabetical:
- Insert the ID's of Skill Types you want sorted alphabetically.

---

Global JS Effects

JS: Skill Conditions:
- JavaScript code for a global-wide skill condition check.

---

=== Skill Cost Types ===

[[File:SkillsStatesSkillCosts.png|600px]]

[[File:SkillsStatesCoreParams02.png]]

Skill Cost Types are the resources that are used for your skills. These can
range from the default MP and TP resources to the newly added HP, Gold, and
Potion resources.

---

[[File:SkillsStatesCoreParams02a.png]]

Settings

Name:
- A name for this Skill Cost Type.

Icon:
- Icon used for this Skill Cost Type.
- Use 0 for no icon.

Font Color:
- Text Color used to display this cost.
- Use #rrggbb for a hex color.

Font Size:
- Font size used to display this cost.

---

Cost Processing

JS: Cost Calculation:
- Code on how to calculate this resource cost for the skill.

JS: Can Pay Cost?:
- Code on calculating whether or not the user is able to pay the cost.

JS: Paying Cost:
- Code for if met, this is the actual process of paying of the cost.

---

Window Display

JS: Show Cost?:
- Code for determining if the cost is shown or not.

JS: Cost Text:
- Code to determine the text (with Text Code support) used for the
displayed cost.

---

Gauge Display

JS: Maximum Value:
- Code to determine the maximum value used for this Skill Cost resource
for gauges.

JS: Current Value:
- Code to determine the current value used for this Skill Cost resource
for gauges.

JS: Draw Gauge:
- Code to determine how to draw the Skill Cost resource for this
gauge type.

---

=== Skill Toggle Settings ===

[[File:SkillToggle.gif]]

Skill toggles are a new type of skill. They do not perform any actions but
instead, will switch on/off any passive effects the skill has.

Skill Toggles do not take up actions, even in battle. They will not consume
an actor's current turn. A player can toggle multiple skill toggles at a
time.

Skill Toggles require the character to pay the skill cost ONLY when the
skill is toggled from OFF to ON, not when it is toggled ON to OFF.

Enemies are unable to switch Toggle Skills and the passive effects on a
Toggle Skill for an enemy will always be considered ON.

---

Default

Default Toggle:
- What is the default toggle setting for toggle skills?

Toggle Off Animation:
- Play this animation when a skill is toggled off.
- Requires VisuMZ_0_CoreEngine.
- Toggle On animation by default is whatever the skill animation is set to

---

Appearance

Toggle On Text Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.
- Applies for skill name, not the skill cost

---

Vocabulary

Toggle Type:
- Skill toggle displayed in the status window.

Toggle On:
- Text displayed for a skill that's toggled on

Toggle Off:
- Text displayed for a skill that's toggled off

Off Text Location:
- Where is the [OFF] text located in the skill cost?
- front
- back

---

=== Gauge Settings ===

[[File:SkillsStatesCore_GaugeSettings.png]]

[[File:SkillsStatesCore_GaugeParams.png]]

Settings in regards to how skill cost gauges function and appear.

---

Labels

Font Type:
- Which font type should be used for labels?

Match Label Color:
- Match the label color to the Gauge Color being used?

Match: Gauge # ?:
- Which Gauge Color should be matched?

Preset: Gauge Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Solid Outline:
- Make the label outline a solid black color?

Outline Width:
- What width do you wish to use for your outline?
- Use 0 to not use an outline.

---

Values

Font Type:
- Which font type should be used for values?

Solid Outline:
- Make the value outline a solid black color?

Outline Width:
- What width do you wish to use for your outline?
- Use 0 to not use an outline.

---

=== General State Settings ===

[[File:SkillsStatesCoreColors.png]]

[[File:SkillsStatesCoreParams03.png]]

These are general settings regarding RPG Maker MZ's state-related aspects
from how turns are reapplied to custom code that's ran whenever states are
added, erased, or expired.

---

General

Reapply Rules:
- These are the rules when reapplying states.
- Ignore: State doesn't get added.
- Reset: Turns get reset.
- Greater: Turns take greater value (current vs reset).
- Add: Turns add upon existing turns.

Maximum Turns:
- Maximum number of turns to let states go up to.
- This can be changed with the <Max Turns: x> notetag.

Action End Update:
- States with "Action End" auto-removal will also update turns at the end
of each action instead of all actions.

Turn End on Map:
- Update any state and buff turns on the map after this many steps.
- Use 0 to disable.

---

Turn Display

Show Turns?:
- Display state turns on top of window icons and sprites?

Turn Font Size:
- Font size used for displaying turns.

Offset X:
- Offset the X position of the turn display.

Offset Y:
- Offset the Y position of the turn display.

Turn Font Size:
- Font size used for displaying turns.

Turn Color: Neutral:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Turn Color: Positive:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Turn Color: Negative:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

---

Data Display

Show Data?:
- Display state data on top of window icons and sprites?

Data Font Size:
- Font size used for displaying state data.

Offset X:
- Offset the X position of the state data display.

Offset Y:
- Offset the Y position of the state data display.

---

Global JS Effects

JS: On Add State:
- JavaScript code for a global-wide custom effect whenever a state
is added.

JS: On Erase State:
- JavaScript code for a global-wide custom effect whenever a state
is erased.

JS: On Expire State:
- JavaScript code for a global-wide custom effect whenever a state
has expired.

---

=== General Buff/Debuff Settings ===

[[File:SkillsStatesBuffDebuffs.png|600px]]

[[File:SkillsStatesCoreParams04.png]]

Buffs and debuffs don't count as states by RPG Maker MZ's mechanics, but
they do function close enough for them to be added to this plugin for
adjusting. Change these settings to make buffs and debuffs work to your
game's needs.

---

General

Reapply Rules:
- These are the rules when reapplying buffs/debuffs.
- Ignore: Buff/Debuff doesn't get added.
- Reset: Turns get reset.
- Greater: Turns take greater value (current vs reset).
- Add: Turns add upon existing turns.

Maximum Turns:
- Maximum number of turns to let buffs and debuffs go up to.

---

Stacking

Max Stacks: Buff:
- Maximum number of stacks for buffs.

Max Stacks: Debuff:
- Maximum number of stacks for debuffs.

JS: Buff/Debuff Rate:
- Code to determine how much buffs and debuffs affect parameters.

---

Turn Display

Show Turns?:
- Display buff and debuff turns on top of window icons and sprites?

Turn Font Size:
- Font size used for displaying turns.

Offset X:
- Offset the X position of the turn display.

Offset Y:
- Offset the Y position of the turn display.

Turn Color: Buffs:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Turn Color: Debuffs:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

---

Rate Display

Show Rate?:
- Display buff and debuff rate on top of window icons and sprites?

Rate Font Size:
- Font size used for displaying rate.

Offset X:
- Offset the X position of the rate display.

Offset Y:
- Offset the Y position of the rate display.

---

Global JS Effects

JS: On Add Buff:
- JavaScript code for a global-wide custom effect whenever a
buff is added.

JS: On Add Debuff:
- JavaScript code for a global-wide custom effect whenever a
debuff is added.

JS: On Erase Buff:
- JavaScript code for a global-wide custom effect whenever a
buff is added.

JS: On Erase Debuff:
- JavaScript code for a global-wide custom effect whenever a
debuff is added.

JS: On Expire Buff:
- JavaScript code for a global-wide custom effect whenever a
buff is added.

JS: On Expire Debuff:
- JavaScript code for a global-wide custom effect whenever a
debuff is added.

---

=== Passive State Settings ===

[[File:SkillsStatesCorePassives.png]]

[[File:SkillsStatesCoreParams05.png]]

These Plugin Parameters adjust passive states that can affect all actors and
enemies as well as have global conditions.

{{Skills and States Core Passive States Clarification}}

List

Global Passives:
- A list of passive states to affect actors and enemies.

Actor-Only Passives:
- A list of passive states to affect actors only.

Enemy Passives:
- A list of passive states to affect enemies only.

---

Cache

Switch Refresh?:
- Refresh all battle members when switches are changed in battle?
- This is primarily used for passive state conditions involve parameters
that do not update due to cached data until a refresh occurs.
- If this is on, do not spam Switch changes during battle in order to
prevent lag spikes.

Variable Refresh?:
- Refresh all battle members when variables are changed in battle?
- This is primarily used for passive state conditions involve parameters
that do not update due to cached data until a refresh occurs.
- If this is on, do not spam Variable changes during battle in order to
prevent lag spikes.

---

Global JS Effects

JS: Condition Check:
- JavaScript code for a global-wide passive condition check.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.55: March 16, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Toggle></nowiki> notetag:
*** Just like with regular <nowiki><Passive State: x></nowiki> notetag:
*** If you plan on applying a passive state through a skill, it must be through a skill that has been learned by the target and not a skill that is given through a trait.

Version 1.54: December 15, 2025
* Documentation Update!
** Added extra clarity for <nowiki><List Name: name></nowiki> notetag:
*** If used with Battle Core's <nowiki><Command Text: x></nowiki>, the Command Text notetag will take priority in the command window, but the List Name notetag will appear in the skill list.
*** This does not change the display text. If you'd like to change that, use the Battle Core's <nowiki><Display Text: x></nowiki> notetag along with this notetag.

Version 1.53: September 18, 2025
* Bug Fixes!
** Fixed a bug where the "Preset: Gauge Color" Plugin Parameter was not accepting #rrggbb values. Fix made by Arisu.
* Documentation Update!
** Added extra clarity for <nowiki><Passive State: x></nowiki>:
*** If you are using VisuMZ's Equip Battle Skills, know that the notetag <nowiki><Passive State: x></nowiki> will always have the passive state be available no matter if the skill is equipped or not, as long as the skill is learned.
*** If you want the passive state to only appear while the skill is equipped then use the VisuMZ Equip Battle Skills notetag <nowiki><Equip State: x></nowiki> for this effect instead.

Version 1.52: August 14, 2025
* Feature Update!
** Passive States with custom JS conditions should be less prone to infinite loops. Update made by Irina.

Version 1.51: April 17, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Skill Toggle Settings
**** Skill toggles are a new type of skill. They do not perform any actions but instead, will switch on/off any passive effects the skill has.
**** Enemies are unable to switch Toggle Skills and the passive effects on a Toggle Skill for an enemy will always be considered ON.
**** See the help file for more information.
** New Notetags added by Olivia:
*** Skill Toggle Notetags:
**** <nowiki><Toggle></nowiki>
**** <nowiki><Initial Toggle: On/Off></nowiki>
**** <nowiki><Toggle Exclusion Group: key></nowiki>
**** <nowiki><Toggle On Animation: x></nowiki>
**** <nowiki><Toggle Off Animation: x></nowiki>
***** See the help file for more information.

Version 1.50: March 20, 2025
* Documentation Update!
** Changed the description of Plugin Parameter 'Action End Update' to 'Refer to "Major Changes" in Help File for explanation.'
** Added examples of "Action End Update" under "Major Changes"
*** The new state: "Fiery Blade" will allow the affected battler to deal fire elemental damage. With Action End, this means for 5 actions, those attacks will deal fire damage.
*** This means that if no action is taken, due to a status effect like "Sleep" or "Stun", then the duration count will not decrease.
*** On the flip side, if the battler performs multiple actions a turn, then the duration count drops faster because more actions have been spent.
*** However, if this "Fiery Blade" state was using Turn End instead, it will have its duration reduced by 1 each turn, regardless of "Sleep" or "Stun" states, and regardless of how many actions are performed each turn.

Version 1.49: February 20, 2025
* Bug Fixes!
** Fixed a bug where causing a dead battler to refresh afterwards would yield multiple death states on that battler. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

Version 1.48: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** Auras & Miasmas added by Olivia:
*** Auras are a type passive that affects an allied party. Miasmas are a type of passive that affects an opposing party. Auras and Miasmas only need to come from a single source to give an entire party or troop a passive provided that the battler emitting the aura/miasma is alive and in battle.
** New Notetags added by Olivia:
*** <nowiki><Aura State: x></nowiki>
**** Emits an aura that affects the battler's allies and gives each affected member passive state(s) 'x'.
*** <nowiki><Miasma State: x></nowiki>
**** Emits an aura that affects the battler's opponents and gives each affected member passive state(s) 'x'.
*** <nowiki><Not User Aura></nowiki>
**** Prevents the emitting user from being affected by the related aura.
*** <nowiki><Allow Dead Aura></nowiki>
*** <nowiki><Allow Dead Miasma></nowiki>
**** Allows aura/miasma to continue emitting even after the emitting user is in a dead state.
*** <nowiki><Dead Aura Only></nowiki>
*** <nowiki><Dead Miasma Only></nowiki>
**** Allows aura/miasma to only emit if the emitting user is in a dead state
* Optimization Update!
** Plugin should run more optimized.

Version 1.47: August 29, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Arisu:
*** <Bypass State Damage Removal: id/name>
**** When this skill/item is used to attack an enemy with the listed state that would normally have on damage removal (ie Sleep).
**** This can be used for attacks like "Dream Eater" that would prevent waking up a sleeping opponent.
*** <Bypass State Damage Removal as Attacker: id/name>
**** When an attacker with an associated trait object that has this notetag would attack an enemy with the listed state, bypass on damage removal.
**** This can be used for effects like "Sleep Striker" that would prevent the attacker from waking up a sleeping opponent.
*** <Bypass State Damage Removal as Target: id/name>
**** When a target with an associated trait object that has this notetag is attacked as the target with the listed state, bypass on damage removal.
**** This can be used for effects like "Deep Sleep" that would prevent the attacked target from waking up.

Version 1.46: July 18, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Irina:
*** Parameters > Skill Settings > Skill Types > Sort: Alphabetical
**** Insert the ID's of Skill Types you want sorted alphabetically.
** New notetags added by Irina:
*** <ID Sort Priority: x>
**** Used for Scene_Skill.
**** Changes sorting priority by ID for skill to 'x'.
**** Default priority level is '50'.
**** Skills with higher priority values will be sorted higher up on the list while lower values will be lower on the list.

Version 1.45: May 16, 2024
* Bug Fixes!
** Fixed a problem with passive state conditional notetags not working properly. Fix made by Irina.

Version 1.44: April 18, 2024
* Bug Fixes!
** Fixed a bug where passive states would not appear. Fix made by Olivia.
** Fixed a bug where a crash would occur if certain plugins cleared the passive state cache midway through trying to register it. Fix by Olivia.
* Optimization Update!
** Plugin should run more optimized.
** States with lots and lots of text data within their notes will no longer cause FPS drops.

Version 1.43: January 18, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Commands added by Arisu!
*** Skill Cost: Emulate Actor Pay
*** Skill Cost: Emulate Enemy Pay
**** Target actor(s)/enemy(s) emulates paying for skill cost.
*** State Turns: Actor State Turns Change By
*** State Turns: Actor State Turns Change To
*** State Turns: Enemy State Turns Change By
*** State Turns: Enemy State Turns Change To
**** Changes actor(s)/enemy(s) state turns to a specific value/by an amount.
**** Only works on states that can have turns.

Version 1.42: November 16, 2023
* Bug Fixes!
** 'origin' variable was not working properly for <JS On Expire State> JavaScript notetag. Should now be working properly. Fix made by Irina.

Version 1.41: September 14, 2023
* Bug Fixes!
** Fixed a bug that prevented <Max Turns: x> for states from working due to one of the recent updates. Fix made by Arisu.
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Apparently, we never put <Max Turns: x> in the help notetag section. Woops... It's there now.

Version 1.40: August 17, 2023
* Bug Fixes!
** Fixed a bug involving the "Item Cost" skill cost type found in the Plugin Parameters when involving consumable items.
*** If you want to acquire these settings for an already-existing project, do either of the following:
**** Delete the existing VisuMZ_1_SkillsStatesCore.js in the Plugin Manager list and install the newest version.
**** Or create a new project, install VisuMZ_1_SkillsStatesCore.js there, then copy over the "Item Cost" plugin parameters found in the "Skill Cost Types" plugin parameter settings to your current project.

Version 1.39: July 13, 2023
* Feature Update!
** Updated the "Item Cost" skill cost type found in the Plugin Parameters to no longer consume items that are key items or nonconsumable.
*** If you want to acquire these settings for an already-existing project, do either of the following:
**** Delete the existing VisuMZ_1_SkillsStatesCore.js in the Plugin Manager list and install the newest version.
**** Or create a new project, install VisuMZ_1_SkillsStatesCore.js there, then copy over the "Item Cost" plugin parameters found in the "Skill Cost Types" plugin parameter settings to your current project.

Version 1.38: March 16, 2023
* Documentation Update!
** Help file updated for new features.
** Added segment to <Replace x Gauge: type> in documentation:
*** Does not work with 'Item Cost', 'Weapon Cost', or 'Armor Cost'.
* New Features!
** New "Skill Cost Type" and notetags added by Arisu and sponsored by FAQ.
*** <Item Cost: x name>
*** <Weapon Cost: x name>
*** <Armor Cost: x name>
**** The skill will consume items, weapons, and/or armors in order to be used. Even non-consumable items will be consumed.
*** <Item Cost Max/Min: x name>
*** <Weapon Cost Max/Min: x name>
*** <Armor Cost Max/Min: x name>
**** Sets up a maximum/minimum cost for the item, weapon, armor type costs.
*** <Item Cost: x% name>
*** <Weapon Cost: x% name>
*** <Armor Cost: x% name>
**** Alters cost rate of skills that would consume item, weapon, or armor.
*** <Item Cost: +/-x name>
*** <Weapon Cost: +/-x name>
*** <Armor Cost: +/-x name>
**** Alters flat costs of skills that would consume item, weapon, or armor.
*** <Replace Item name1 Cost: name2>
*** <Replace Weapon name1 Cost: name2>
*** <Replace Armor name1 Cost: name2>
**** Replaces item, weapon, or armor to be consumed for another type.
*** Projects with the Skills and States Core already installed will not have this update, but you can copy over the settings from a new project with the following steps:
**** Create a new project. Install Skills and States Core. Open up the new project's 'Skill Cost Types'.
**** Right click the 'Item Cost' option(s) and click copy.
**** Go to the target project's Skills and States Core's 'Skill Cost Types' plugin parameter. Paste the command where you want it to go.
**** Only 'Item Cost' is needed as it encompasses all three types for item, weapon, and armor costs.

Version 1.38: February 16, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.37: January 20, 2023
* Bug Fixes!
** Fixed a bug that caused equipment to unequip if the needed equipment traits came from passive states upon learning new skills. Fix by Irina.

Version 1.36: December 15, 2022
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** When enemies are defeated with their entire party having a state with the <Group Defeat> notetag, then the party will gain EXP, Gold, and Drops before when they wouldn't. Update made by Irina.
* New Features!
** New Plugin Parameter added by Irina!
*** Plugin Parameters > Skill Settings > Skill Type Window > Window Width
**** What is the desired pixel width of this window? Default: 240

Verison 1.35: October 13, 2022
* Feature Update!
** Default values for Passive States > Cache > Switch Refresh? and Variable Refresh? are now set to "false" in order to prevent sudden lag spikes for those who are unfamiliar with how this setting works.
** Update made by Irina.

Version 1.34: September 29, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina and sponsored by AndyL:
*** Plugin Parameters > Gauge Settings
**** These settings allow you to make minor tweaks to how the gauges look ranging from the color used for the labels to the outline types used for the values.

Version 1.33: August 11, 2022
* Bug Fixes!
** Fixed a crash that occurs when performing a custom action sequence without a skill attached to it. Fix made by Olivia.

Version 1.32: June 16, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Passive State Settings > Cache > Switch Refresh?
*** Plugin Parameters > Passive State Settings > Cache > Variable Refresh?
**** Refresh all battle members when switches/variables are changed in battle?
**** This is primarily used for passive state conditions involve parameters that do not update due to cached data until a refresh occurs.
**** If this is on, do not spam Switch/Variable changes during battle in order to prevent lag spikes.

Version 1.31: April 28, 2022
* Bug Fixes!
** Custom Slip Damage JS is now totalled correctly into regular slip damage totals for damage popups. Fix made by Olivia.

Version 1.30: April 14, 2022
* Feature Update!
** Changed the state data removal timing to be after JS notetag effects take place in order for data such as origin data to remain intact. Update made by Irina.

Version 1.29: March 31, 2022
* Bug Fixes!
** Fixed an error with <State x Category Remove: y> not countaing correctly unless the state count matched the exact amount. The notetag effect should work properly now. Fix made by Olivia.

Version 1.28: March 10, 2022
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** <State x Category Remove: y> updated to allow multiple cases in a single notebox. Updated by Arisu.
* New Features!
** New Notetag added by Arisu and sponsored by Archeia!
*** <Remove Other x States>
**** When the state with this notetag is added, remove other 'x' category states from the battler (except for the state being added).
**** Useful for thing state types like stances and forms that there is usually only one active at a time.

Version 1.27: January 27, 2022
* Bug Fixes!
** Custom JS Slip Damage/Healing values should now be recalculated on demand. Fix made by Olivia.

Version 1.26: January 20, 2022
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Conditional Passive Bypass check is now stronger to prevent even more infinite loops from happening. Update made by Olivia.
* New Features!
** New Plugin Parameter added by Olivia:
*** Plugin Parameters > State Settings > General > Turn End on Map
**** Update any state and buff turns on the map after this many steps.
**** Use 0 to disable.

Version 1.25: November 11, 2021
* Bug Fixes!
** Hidden skill notetags should no longer crash upon not detecting actors for learned skills. Fix made by Olivia.

Version 1.24: November 4, 2021
* Documentation Update!
** Added section: "Slip Damage Popup Clarification"
*** Slip Damage popups only show one popup for HP, MP, and TP each and it is the grand total of all the states and effects combined regardless of the number of states and effects on a battler. This is how it is in vanilla RPG Maker MZ and this is how we intend for it to be with the VisuStella MZ library.
*** This is NOT a bug!
*** The reason we are not changing this is because it does not properly relay information to the player accurately. When multiple popups appear, players only have roughly a second and a half to calculate it all for any form of information takeaway. We feel it is better suited for the player's overall convenience to show a cummulative change and steer the experience towards a more positive one.
* Optimization Update!
** Plugin should run more optimized.

Version 1.23: September 17, 2021
* Compatibility Update!
** RPG Maker MZ 1.3.3 compatibility.
*** Updated how gauges are drawn.
*** Skill Cost Types Plugin Parameters need to be updated for those who want the updated gauges. This can be done easily with the following steps:
**** Step 1: Create a new project.
**** Step 2: Install Skills and States Core version 1.23 into it.
**** Step 3: Copy the Plugin Parameter Settings for "Skill Cost Types".
**** Step 4: Return back to your original project.
**** Step 5: Paste Plugin Parameter Settings on top of "Skill Cost Types".

Version 1.22: August 6, 2021
* Documentation Update!
** "Action End Removal for States" under Major Updates is changed to:
*** If your Plugin Parameter settings for "Action End Update" are enabled, then "Action End" has been updated so that it actually applies per action used instead of just being at the start of a battler's action set.
*** However, there are side effects to this: if a state has the "Cannot Move" restriction along with the "Action End" removal timing, then unsurprisingly, the state will never wear off because it's now based on actual actions ending. To offset this and remove confusion, "Action End" auto-removal timings for states with "Cannot Move" restrictions will be turned into "Turn End" auto-removal timings while the "Action End Update" is enabled.
*** This automatic change won't make it behave like an "Action End" removal timing would, but it's better than completely softlocking a battler.
* Feature Update!
** Those using "Cannot Move" states with "Action End" auto-removal will now have be automatically converted into "Turn End" auto-removal if the plugin parameter "Action End Update" is set to true. Update by Irina.

Version 1.21: July 30, 2021
* Documentation Update!
** Expanded "Action End Removal for States" section in Major Changes.
*** These changes have been in effect since Version 1.07 but have not been explained in excess detail in the documentation since.
**** Action End has been updated so that it actually applies per action used instead of just being at the start of a battler's action set. However, there are side effects to this: if a state has the "Cannot Move" restriction along with the "Action End" removal timing, then unsurprisingly, the state will never wear off because it's now based on actual actions ending. There are two solutions to this:
**** Don't make "Cannot Move" restriction states with "Action End". This is not a workaround. This is how the state removal is intended to work under the new change.
**** Go to the Skills & States Core Plugin Parameters, go to State Setttings, look for "Action End Update", and set it to false. You now reverted the removal timing system back to how it originally was in RPG Maker MZ's default battle system where it only updates based on an action set rather than per actual action ending.

Version 1.20: June 18, 2021
* Feature Update!
** Updated automatic caching for conditional passive states to update more efficiently. Update made by Arisu.

Version 1.19: June 4, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.18: May 21, 2021
* Documentation Update
** Added "Passive State Clarification" section.
*** As there is a lot of confusion regarding how passive states work and how people still miss the explanations found in the "Passive State Notetags" section AND the "Plugin Parameters: Passive State Settings", we are adding a third section to explain how they work.
*** All three sections will contain the full detailed explanation of how passive states work to clear common misconceptions about them.

Version 1.17: May 7, 2021
* Bug Fixes
** State category removal is now usable outside of battle. Fix by Irina.

Version 1.16: April 30, 2021
* Bug Fixes!
** When states with step removal have the <No Recover All Clear> or <No Death Clear> notetags, their step counter is no longer reset either. Fix made by Irina.
* New Features!
** New notetag added by Arisu!
*** <List Name: name>
**** Makes the name of the skill appear different when show in the skill list. Using \V[x] as a part of the name will display that variable.

Version 1.15: March 19, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.14: March 12, 2021
* Bug Fixes!
** Max HP Buff/Debuff should now display its turn counter. Fix by Yanfly.
* Documentation Update!
** For the <JS Passive Condition>, we've added documentation on the limitations of passive conditions since they have been reported as bug reports, when in reality, they are failsafes to prevent infinite loops. Such limitations include the following:
*** A passive state that requires another passive state
*** A passive state that requires a trait effect from another state
*** A passive state that requires a parameter value altered by another state
*** A passive state that requires equipment to be worn but its equipment type access is provided by another state.
*** Anything else that is similar in style.

Version 1.13: February 26, 2021
* Documentation Update!
** For <JS type Slip Damage> and <JS type Slip Heal> notetags, added the following notes:
*** When these states are applied via action effects, the slip calculations are one time calculations made upon applying and the damage is cached to be used for future on regeneration calculations.
*** For that reason, do not include game mechanics here such as adding states, buffs, debuffs, etc. as this notetag is meant for calculations only. Use the VisuStella Battle Core's <JS Pre-Regenerate> and <JS Post-Regenerate> notetags for game mechanics instead.
*** Passive states and states with the <JS Slip Refresh> notetag are exempt from the one time calculation and recalculated each regeneration phase.
* Feature Update!
** Changed slip refresh requirements to entail <JS Slip Refresh> notetag for extra clarity. Update made by Olivia.

Version 1.12: February 19, 2021
* Feature Update
** Changed the way passive state infinite stacking as a blanket coverage. Update made by Olivia.

Version 1.11: February 12, 2021
* Bug Fixes!
** Added a check to prevent passive states from infinitely stacking. Fix made by Olivia.

Version 1.10: January 15, 2021
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added
*** Plugin Parameters > Skill Settings > Background Type

Version 1.09: January 1, 2021
* Bug Fixes!
** Custom JS TP slip damage and healing should now work properly. Fix made by Yanfly.

Version 1.08: December 25, 2020
* Bug Fixes!
** <JS On Add State> should no longer trigger multiple times for the death state. Fix made by Yanfly.
* Documentation Update!
** Added documentation for updated feature(s)!
* Feature Update!
** <No Death Clear> can now allow the affected state to be added to an already dead battler. Update made by Yanfly.

Version 1.07: December 18, 2020
* Documentation Update!
** Added documentation for new feature(s)!
* New Features!
** New notetags added by Yanfly:
*** <Passive Condition Multiclass: id>
*** <Passive Condition Multiclass: id, id, id>
*** <Passive Condition Multiclass: name>
*** <Passive Condition Multiclass: name, name, name>
** New Plugin Parameter added by Yanfly.
*** Plugin Parameters > States > General > Action End Update
**** States with "Action End" auto-removal will also update turns at the end of each action instead of all actions.
***** Turn this off if you wish for state turn updates to function like they do by default for "Action End".

Version 1.06: December 4, 2020
* Optimization Update!
** Plugin should run more optimized.

Version 1.05: November 15, 2020
* Bug Fixes!
** The alignment of the Skill Type Window is now fixed and will reflect upon the default settings. Fix made by Yanfly.
* Documentation Update!
** Added documentation for new feature(s)!
* New Features!
** <State x Category Remove: All> notetag added by Yanfly.
* Optimization Update!
** Plugin should run more optimized.

Version 1.04: September 27, 2020
* Documentation Update
** "Use Updated Layout" plugin parameters now have the added clause: "This will override the Core Engine windows settings." to reduce confusion. Added by Irina.

Version 1.03: September 13, 2020
* Bug Fixes!
** <JS type Slip Damage> custom notetags now work for passive states. Fix made by Olivia.
** Setting the Command Window style to "Text Only" will no longer add in the icon text codes. Bug fixed by Yanfly.

Version 1.02: August 30, 2020
* Bug Fixes!
** The JS Notetags for Add, Erase, and Expire states are now fixed. Fix made by Yanfly.
* Documentation Update!
** <Show if learned Skill: x> and <Hide if learned Skill: x> notetags have the following added to their descriptions:
*** This does not apply to skills added by traits on actors, classes, any equipment, or states. These are not considered learned skills. They are considered temporary skills.
* New Features!
** Notetags added by Yanfly:
*** <Show if has Skill: x>
*** <Show if have All Skills: x,x,x>
*** <Show if have Any Skills: x,x,x>
*** <Show if has Skill: name>
*** <Show if have All Skills: name, name, name>
*** <Show if have Any Skills: name, name, name>
*** <Hide if has Skill: x>
*** <Hide if have All Skills: x,x,x>
*** <Hide if have Any Skills: x,x,x>
*** <Hide if has Skill: name>
*** <Hide if have All Skills: name, name, name>
*** <Hide if have Any Skills: name, name, name>
*** These have been added to remove the confusion regarding learned skills as skills added through trait effects are not considered learned skills by RPG Maker MZ.

Version 1.01: August 23, 2020
* Bug Fixes!
** Passive states from Elements & Status Menu Core are now functional. Fix made by Olivia.
* Compatibility Update
** Extended functions to allow for better compatibility.
* Updated documentation
** Explains that passive states are not directly applied and are therefore not affected by code such as "a.isStateAffected(10)".
** Instead, use "a.states().includes($dataStates[10])"
** "Use #rrggbb for a hex color." lines now replaced with "For a hex color, use #rrggbb with VisuMZ_1_MessageCore"

Version 1.00: August 20, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 1]]

== End of File ==

|}


[[Category: RPG Maker MZ Core Plugins]]
[[Category: RPG Maker MZ Battle Plugins]]

[[Category: RPG Maker MZ Skill Plugins]]


[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]


[[Category: RPG Maker MZ Quality of Life Plugins]]

Items and Equips Core VisuStella MZ

2026-03-15T02:01:30Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=R7ylHVC-ykE</youtube>
|link1 = {{VisuStella Wave 1}}
|link2 = {{VisuStella All Waves Collection}}

}}



{|
| [[File:ItemsEquipsCoreEquipTypes.png|400px]]
| [[File:ItemsEquipsCoreShopStatus.png|400px]]

|-

| [[File:ItemsEquipsCoreEquipChange.png|400px]]
| [[File:ItemsEquipsCoreShopEquip.png|400px]]

|}

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{ExtensionPluginsMZ}}
* [[Battle System - BTB VisuStella MZ]]
* [[Battle System - ETB VisuStella MZ]]
* [[Battle System - FTB VisuStella MZ]]
* [[Battle System - PTB VisuStella MZ]]
* [[Equip Medal System VisuStella MZ]]
* [[Equipment Set Bonuses VisuStella MZ]]
* [[Item Amplify Skills VisuStella MZ]]
* [[Item Crafting System VisuStella MZ]]
* [[Item Concoction Skills VisuStella MZ]]
* [[Item Throw Skills VisuStella MZ]]
* [[More Currencies VisuStella MZ]]
* [[One Time Purchase VisuStella MZ]]
* [[Shop Batches VisuStella MZ]]
* [[Shop Bust Style UI VisuStella MZ]]
* [[Shop Listing Unlock VisuStella MZ]]
* [[Weapon Swap System VisuStella MZ]]

{{Visustella MZ}}

== Introduction ==

The Items & Equips Core makes improvements to the RPG Maker MZ item and
equipment dedicated scenes (including the shop) and how they're handled.
From more item categories, better parameter control, rulings, and more, game
devs are able to take control over key aspects of their game's items.

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

* Modifying the appearances to the Item Scene, Equip Scene, and Shop Scene.
* Categorizing items in unique and multiple categories.
* Item Scene and Shop Scene will now display detailed information on items.
* NEW! marker can be displayed over recently acquired items in-game.
* Equipment notetags to adjust parameters past the editor limitations.
* Equipment Rulings to adjust what slot types can and can't be unequipped and/or optimized.
* Equipment Type Handling offers more control over equipment loadouts.
* Items sold in shops can be hidden/shown based on Switches.
* Items sold in shops can have varying prices adjusted by notetags.

== Requirements ==

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

{{MZ Tier 1}}

== Major Changes: New Hard-Coded Features ==

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

---

=== Equipment Type Handling ===

[[File:ItemsEquipsCoreEquipTypes.png|600px]]

Characters will no longer have one universal equipment slot setting.
Classes can have different equipment type loadouts, made possible through
the usage of notetags. Also, equipment types of matching names would be
treated as the same type, where previously, they would be different types.
This means if you have two "Accessory" slots, be it in the form of notetags
or through the Database > Types tab, they can both equip the same type of
accessories.

The Change Equip event command is now updated to reflect this new change.
When processing an equip change, the slot changed will go to the first
empty slot of matching type. If all of the actor's matching slot types are
equipped, then the equip will replace the last slot available.

---

=== Shop Status Window ===

[[File:ItemsEquipsCoreShopStatus.png|600px]]

The Status Window found in the Shop Scene was originally barren and did
not display much information at all. This is changed through this plugin's
new features. While the contents of the Shop Status Window can be customized
through the Plugin Parameters, it is a change that cannot be reversed and
for the better since it gives players the much needed information revolving
around the game's items.

---

=== Core Engine Compatibility: Modern Controls ===

[[File:ItemsEquipsCoreShopEquip.png|600px]]

If the [[Core Engine VisuStella MZ|VisuStella Core Engine]] is added to your game with Modern Controls
enabled, then the Item Menu Scene, Equip Menu Scene, and Shop Menu Scene's
controls will be changed a bit.

The Item Menu Scene will automatically have the Item List Window active,
with using the Left/Right (for single column) or Page Up/Page Down (for
multi-columns) to navigate between the Item Categories. Similar will occur
when trying to sell items in the Shop Menu Scene.

The Equip Menu Scene will automatically have the Equip Slots Window active
and only activate the command window upon moving up to it.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

[[Battle Core VisuStella MZ]]

[[File:ItemsEquipsCore_37_Comp_1.png]]

Changing the "Damage Multiplier" or "Healing Multiplier" vocabulary for the
Item and Equip Core's Shop Status Window is not done with the Item and Equip
Core's Plugin Parameters if you have the Battle Core installed.

Instead, go to Battle Core's Plugin Parameters, Damage Settings, Damage
Styles, and adjust the style's version of the "Damage Multiplier" or
"Healing Multiplier" text instead.

Why does this work this way? Because not all damage styles work off
"Multipliers" so in order for it to convey the proper message to the player,
each damage style has its own vocabulary to be more accurate.

[[File:ItemsEquipsCore_37_Comp_2.png]]

In case you forget about that, when you visit the Item and Equip Core's
plugin parameters for these, it should also remind you in the parameter's
description on where to change it.

---

[[Weapon Swap System VisuStella MZ]]

The custom equip slots feature from the VisuStella MZ Items and Equips Core
allowed you to add in extra weapon slots. This is now curated up to a max
of one weapon slot per character. This needs to be done to make the Weapon
Swap System viable.

---

{{Notetags MZ}}

{{VisuMZ Items and Equips Core Notetags}}

{{Plugin Commands MZ}}

{{VisuMZ Items and Equips Core Plugin Commands}}

== Plugin Parameters ==

=== Item Menu Settings ===

[[File:ItemsEquipsCoreShopStatus.png|600px]]

[[File:ItemsEquipsCoreParams01.png]]

The Item Menu Settings allow you to adjust specifics on how key objects and
windows in the Item Menu Scene operate.

---

General Window

Use Updated Layout:
- Use the Updated Item Menu Layout provided by this plugin?
- This will automatically enable the Status Window.
- This will override the Core Engine windows settings.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

List Window

Columns:
- Number of maximum columns.
- If you are using the VisuStella MZ Core Engine and the "Modern Controls"
Plugin Parameter, please read through that section in case you have any
questions about how to switch between categories when using multiple
columns of items at a time.

---

Item Quantity

Item Max:
Weapon Max:
Armor Max:
- The default maximum quantity for items, weapons, and/or armors.

Quantity Format:
- How to display an item's quantity.
- %1 - Item Quantity

Font Size:
- Default font size for item quantity.

---

Shop Status Window

Show in Item Menu?:
- Show the Shop Status Window in the Item Menu?
- This is enabled if the Updated Layout is on.

Adjust List Window?:
- Automatically adjust the Item List Window in the Item Menu if using the
Shop Status Window?

Background Type:
- Select background type for this window.
- 0 - Window
- 1 - Dim
- 2 - Transparent

JS: X, Y, W, H:
- Code used to determine the dimensions for this Status Window in the
Item Menu.

---

Button Assist Window

Switch Category:
- Button assist text used for switching categories.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Item Categories ===

[[File:ItemsEquipsCoreCategories.png|600px]]

[[File:ItemsEquipsCoreParams02.png]]

Item Categories appear both in the Item Menu Scene and Shop Menu Scene (but
only under the Sell command). These Plugin Parameters give you the ability
to add in the specific categories you want displayed, remove the ones you
don't, and associate them with icons.

---

List

Category List
- A list of the item categories displayed in the Item/Shop menus.

Type:
- A list of the item categories displayed in the Item/Shop menus.
- Replace x with ID numbers or text.
- AllItems, RegularItems, KeyItems
- HiddenItemA, HiddenItemB
- Consumable, Nonconsumable
- AlwaysUsable, BattleUsable, FieldUsable, NeverUsable
- AllWeapons, WType:x
- AllArmors, AType:x, EType:x
- Category:x

Icon:
- Icon used for this category.
- Use 0 for no icon.

Visibility Switch:
- This Switch must be turned ON in order for the category to show.
- Use 0 for no Switch requirement.

Sort By:
- Sort this category (in Scene_Item and Scene_Shop only) this way.

Style:
- How do you wish to draw categorie entries in the Category Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Alignment
- Decide how you want the text to be aligned.

---

Vocabulary

Hidden Item A
Hidden Item B
Consumable
Nonconsumable
Always Usable
Battle Usable
Field Usable
Never Usable
- How these categories are named in the Item Menu.

---

=== NEW! Labels ===

[[File:ItemsEquipsCoreNew.png]]

[[File:ItemsEquipsCoreParams03.png]]

Whenever the player receives a new item(s), a NEW! Label can be placed on
top of the item's icon when browsing a menu displaying the item(s). This is
a quality of life addition from more modern RPG's to help players figure out
what they've recently received. The following are Plugin Parameters made to
adjust how the NEW! Labels are handled in-game.

---

NEW! Labels

Use NEW! Labels?:
- Use the NEW! Labels or not?

Icon:
- The icon index used to represent the NEW! text.
- Use 0 to not draw any icons.

Text:
- The text written on the NEW! Label.

Font Color:
- Use #rrggbb for custom colors or regular numbers for text colors from
the Window Skin.

Font Size:
- The font size used for the NEW! text.

Fade Limit:
- What's the upper opaque limit before reversing?

Fade Speed:
- What's the fade speed of the NEW! Label?

Offset X:
- How much to offset the NEW! Label's X position by.

Offset Y:
- How much to offset the NEW! Label's Y position by.

---

=== Equip Menu Settings ===

[[File:ItemsEquipsCoreEquipTypes.png|600px]]

[[File:ItemsEquipsCoreParams04.png]]

These Plugin Parameters adjust the Equipment Menu Scene, ranging from using
a more updated and modern layout, changing the styles of other windows, and
other key visual aspects of the Equip Menu Scene. Other settings here allow
you to adjust how equipment operate under certain rulings, too.

---

General

Use Updated Layout:
- Use the Updated Equip Layout provided by this plugin?
- This will override the Core Engine windows settings.

Param Font Size:
- The font size used for parameter values.

Show Menu Portraits?:
- If Main Menu Core is installed, display the Menu Portraits instead of
the actor's face in the status window?

JS: Portrait Upper:
- If Menu Portraits are available, this is code used to draw the upper
data like this in the Status Window.

JS: Face Upper:
- If faces used used, this is code used to draw the upper data like this
in the Status Window.

JS: Parameter Lower:
- Code to determine how parameters are drawn in the Status Window.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

Status Window Width:
- The usual width of the status window if using the non-Updated Equip
Menu Layout.

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.

Cursed Equip Popup:
- Text popup appears when an actor equips a cursed weapon/armor.
- Text codes allowed.
- Requires VisuMZ_0_CoreEngine!
- Empty to not use.
- %1 - Actor, %2 - Equip, %3 - Icon.

---

Command Window

Style:
- How do you wish to draw commands in the Command Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Command Window.

Equip Icon:
- The icon used for the Equip command.

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Add Optimize Command?:
- Add the "Optimize" command to the Command Window?

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Optimize Icon:
- The icon used for the Optimize command.

Add Clear Command?:
- Add the "Clear" command to the Command Window?

Help Description:
- Help description used when this command is selected.
- Text codes allowed.

Clear Icon:
- The icon used for the Clear command.

---

Remove Equip

Icon:
- Icon used for equipment removal.

Text:
- Text used for equipment removal.

Use SHIFT Shortcut?:
- Add the "Shift" button as a shortcut key to removing items?

---

Rulings

Equip-Adjust HP/MP:
- Adjust HP/MP differences after changing equips with MaxHP/MaxMP values.

Non-Removable Types:
- Insert ID's of the Equipment Types that must always have an item
equipped and cannot be empty.

Non-Optimized Types:
- Insert ID's of the Equipment Types that will be ignored when equipment
is being optimized.

---

Button Assist Window

SHIFT: Remove:
- Button assist text used for the SHIFT Remove Shortcut.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Shop Menu Settings ===

[[File:ItemsEquipsCoreShopEquip.png|600px]]

[[File:ItemsEquipsCoreParams05.png]]

These Plugin Parameters allow you a number of options to adjust the Shop
Menu Scene. These options range from enabling an updated and modern layout,
adjust how various key visual aspects appear, and determine how prices can
be affected when it comes to selling them or buying them (for coders).

---

General

Use Updated Layout:
- Use the Updated Shop Layout provided by this plugin?
- This will override the Core Engine windows settings.

Layout Style:
- If using an updated layout, how do you want to style the menu scene?
- Upper Help, Left Input
- Upper Help, Right Input
- Lower Help, Left Input
- Lower Help, Right Input

---

[[File:ItemsEquipsCore_Update28_Params1.png]]

Switches

Switch: Buy:
- Buying items in the Shop Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Shop Scene opens.

Switch: Sell
- Selling items in the Shop Scene turns this Switch to ON.
- Switch reverts to OFF whenever the Shop Scene opens.

---

Command Window

Hide Unavailable?:
- Hide all unavailable commands like when a shop is set to Purchase Only?

Style:
- How do you wish to draw commands in the Command Window?
- Text Only: Display only the text.
- Icon Only: Display only the icon.
- Icon + Text: Display the icon first, then the text.
- Auto: Determine which is better to use based on the size of the cell.

Text Align:
- Text alignment for the Command Window.

Buy Icon:
- The icon used for the Buy command.

Sell Icon:
- The icon used for the Sell command.

Cancel Icon:
- The icon used for the Cancel command.

Rename "Cancel":
- Rename Cancel to something more logical for the Shop Menu Scene.

---

Prices

Sell Price Rate:
- The default sell price rate.

JS: Buy Price:
- Modificatons made to the buy price before finalizing it.

JS: Sell Price:
- Modificatons made to the sell price before finalizing it.

---

Button Assist Window

Small Increment:
Large Increment:
- Text used for changing amount bought/sold.
- For VisuStella MZ's Core Engine's Button Assist Window.

---

=== Shop Status Window ===

[[File:ItemsEquipsCoreShopStatusWindow.png]]

[[File:ItemsEquipsCoreParams06.png]]

These Plugin Parameters focuses on the Shop Status Window and determines how
its data is displayed.

---

General

Window Width:
- The usual width of the status window.

Parameter Font Size:
- Font size used for parameter changes.

Translucent Opacity:
- Opacity setting used for translucent window objects.

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.

---

Equipment Data

[[File:ItemEquipCore_StatusWindowStyles.png|600px]]

Data Style:
- How do you wish to display equipment data?
- Compare - Compares selected equip to equipped gear
- Lists all main party actors
- Displays the parameter differences when equipped
- Calculates custom JS values
- Classic - Shows basic parameters of selected equip
- Involves no actors, only shows the item's stats
- Shows weapon or armor specific parameters
- Does not show custom JS values as those are calculated per actor
- Does not show custom parameters as those are calculated per actor
- Use <Status Info> and <Custom Status Info> notetags to overwrite or
add custom data to classic equip data
- Double - Shows basic parameters in double columns
- Involves no actors, only shows the item's stats
- Shows weapon or armor specific parameters
- Does not show custom JS values as those are calculated per actor
- Does not show custom parameters as those are calculated per actor
- Use <Status Info> and <Custom Status Info> notetags to overwrite or
add custom data to classic equip data

Compare Style:

Already Equipped:
- Marker used to show an actor cannot equip an item.

Can't Equip:
- Marker used to show an actor cannot equip an item.

No Changes:
- Marker used to show no changes have occurred.

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Classic Style:

Added Weapon Params:
Added Armor Params:
- Display these parameters when a weapon/armor is selected.
- Requires VisuMZ_0_CoreEngine!

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Double Style:

Added Weapon Params:
Added Armor Params:
- Display these parameters when a weapon/armor is selected.
- Requires VisuMZ_0_CoreEngine!

JS: Draw Equip Data:
- Code used to draw the equipment data for the Shop Status Window.

Delay MS:
- How many milliseconds (MS) to delay the preview update?
- This is to prevent lag spikes for equips only.

---

Item Data

Max State/Buff Icons:
- Maximum number of icons that can be displayed for Add/Remove
States/Buffs.

Multiplier Standard:
- Constant standard to filter out random values when calculating the
damage multiplier.

JS: Draw Item Data:
- Code used to draw the item data for the Shop Status Window.

---

Vocabulary

Consumable:
Occasions:
Scope:
Speed:
Success Rate:
Repeats:
Hit Type:
Element:
Damage Type:
Effects:
- Vocabulary used for these data entries.
- Some of these have Plugin Parameters have sub-entries.

NOTE: Regarding Damage Labels

If Visu_1_BattleCore is installed, priority goes to its Damage Style
settings. The label displayed is based on the damage style settings in
place for that specific skill or item.

Go to Battle Core > Plugin Parameters > Damage Settings > Style List >
pick the damage style you want to edit > Damage Label and change the
text settings you'd like there.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

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

Team VisuStella

* Yanfly
* Arisu
* Olivia
* Irina

== Changelog ==

Version 1.60: March 16, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Parameters > Item Menu Settings > Use Updated Layout > Disabled: Vanilla
**** If NOT using the updated layout, keep all settings to pure vanilla and ignore other Plugin Parameters.
**** Used for those who do not wish to fiddle with the Plugin Parameter settings to return the item menu back to default MZ vanilla.
**** Does not apply if using updated layout.
**** The following settings are disabled if using vanilla:
***** Categories: Only the default 4
***** Category Names only display text and no icons
***** No Shop Status Window
***** Modern Controls Disabled
***** Columns: Any -> 2

Version 1.59: October 16, 2025
* Bug Fixes!
** Fixed a bug where a changed parameter in the equipment menu would accidentally highlight the next parameter's name. Fix made by Irina.

Version 1.58: February 20, 2025
* Bug Fixes!
** Optimize no longer allows player to bypass the following notetags: <nowiki><Equip Copy Limit: x></nowiki>, <nowiki><Equip Weapon Type Limit: x></nowiki>, and <nowiki><Equip Armor Type Limit: x></nowiki>. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

Version 1.57: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Added extra clarity for <nowiki><Status Info></nowiki> notetag:
*** For clarity regarding "Damage Multiplier" and "HP Recovery"/"HP Damage":
**** "Damage Multiplier" refers to the amount determined by damage formulas.
**** "HP Recovery"/"HP Damage" refers to the "Recover HP" database effect.
**** Likewise, the same will apply to "MP Recovery"/"MP Damage" if the damage formula type is to deal MP recovery/damage instead.
* New Features!
** New Notetags added by Arisu:
*** <nowiki><Status Style: type></nowiki>
**** Changes up the way the shop status window displays data for this database object in particular.
*** <nowiki><Custom Status Parameters: name, name, name></nowiki>
**** Customize which parameters are displayed for this equipment object's shop status window.
* Optimization Update!
** Plugin should run more optimized.

Version 1.56: December 19, 2024
* Bug Fixes!
** Fixed a bug where newly added equipment would cause crashes upon interaction. Fix made by Irina.

Version 1.55: November 14, 2024
* Bug Fixes!
** Fixed a bug where you can no longer attempt to equip an actor with zero equip slots and causing a crash. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
** Updated <Status Info>
*** Used for: Skill, Item, Weapon, Armor Notetags
**** Replace 'key' with one of the following for weapons and armors:
***** 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI', or 'LUK'
***** For those with VisuMZ_0_CoreEngine:
****** 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT', 'HRG', 'MRG', 'TRG'
****** 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR', 'MDR', 'FDR', 'EXR'
**** Only relevant if the Draw Style for equipment is "classic" or "double".
** Updated <Custom Status Info> notetag:
*** Used for: Skill, Item, Weapon, Armor Notetags
**** When used with weapon or armor database objects, this information is only relevant if the Draw Style for equipment is "classic" or "double".
* New Feature!
** New Plugin Parameters:
*** Parameters > Shop Status Window > Data Style:
**** How do you wish to display equipment data?
***** Compare - Compares selected equip to equipped gear
****** Lists all main party actors
****** Displays the parameter differences when equipped
****** Calculates custom JS values
***** Classic - Shows basic parameters of selected equip
***** Double - Shows basic parameters in double columns
****** Involves no actors, only shows the item's stats
****** Shows weapon or armor specific parameters
****** Does not show custom JS values as those are calculated per actor
****** Does not show custom parameters as those are calculated per actor
****** Use <Status Info> and <Custom Status Info> notetags to overwrite or add custom data to classic equip data
**** Data Style > Classic Style:
**** Data Style > Double Style:
***** Added Weapon Params
***** Added Armor Params
****** Display these parameters when a weapon/armor is selected.
****** Requires VisuMZ_0_CoreEngine!

Version 1.54: October 17, 2024
* Feature Update!
** If "Modern Controls" is selected while "Remove Equip" and "Optimize" are gone from the Equip Menu, right click will exit the menu. Feature added by Arisu.

Version 1.53: July 18, 2024
* Documentation Update!
** Help file updated for new features.
** Added warning to <JS Parameters>:
*** If you are trying to calculate a value based off a full parameter value, such as "ATK = user.atk * 0.10", it's going to break and will cause an infinite loop. Use base parameter values instead.
* New Features!
** New notetags added by Irina:
*** <ID Sort Priority: x>
**** Used for Scene_Item, Scene_Equip, Scene_Battle, and Scene_Shop's sell option (only when selling).
**** Changes sorting priority by ID for item, weapon, or armor to 'x'.
**** Default priority level is '50'.
**** Items, weapons, and armors with higher priority values will be sorted higher up on the list while lower values will be lower on the list.

Version 1.52: May 16, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Irina:
*** Parameters > Item Categories > Category List > Category > Sorted By:
**** You can now sort specific item categories by ID or Name.
**** Only usable within Scene_Item and Scene_Shop.
* Optimization Update!
** Plugin should run more optimized.

Version 1.51: December 14, 2023
* Bug Fixes!
** Fixed a bug where if an item is unequipped, it may cause a crash. Fix made by Arisu.
** Fixed a bug where <Proxy: id> did not properly give the proxy item. Fix made by Arisu.

Version 1.50: November 16, 2023
* Bug Fixes!
** <JS Buy Price> and <JS Sell Price> was not working properly. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
* Optimization Update!
** Plugin should run more optimized.
* New Features!
** New Notetags added by Arisu:
*** <Cursed>
**** If this weapon or armor is equipped, it cannot manually be removed by the player until it is purified.
**** To remove it, it must be done by event commands, script calls, or through the Purify-related Plugin Commands provided by this plugin.
**** Once purified, the weapon or armor will become unequipped unless it has a purify transformation.
**** If the newly transformed weapon/armor is equippable, it will remain in the actor's equipment slots.
**** If you are using VisuMZ_2_WeaponSwapSystem, weapons cannot become cursed in order to allow free weapon swapping. Weaponry will not be cursed if VisuMZ_2_WeaponSwapSystem is installed.
*** <Purify Transform: id>
*** <Purify Transform: name>
**** If this notetag is present on a <Cursed> weapon or armor, then upon the actor receiving purification, the weapon or armor will transform into a different item.
** New Plugin Commands added by Arisu:
*** Purify: Target Actor(s)
**** Purifies target actor(s) of any cursed weapons or armors.
*** Purify: Whole Party
**** Purifies whole party of any cursed weapons or armors.
** Added "Cursed Equip Popup" to Equip Scene Plugin Parameters.
*** Text popup appears when an actor equips a cursed weapon/armor.
** Added "Ally or Enemy" or "Enemy or Ally" scopes to Shop Status Window Plugin Parameters.
*** If unused, will default to "1 Ally" or "1 Enemy" like usual. Added by Irina.

Version 1.49: October 12, 2023
* Bug Fixes!
** Fixed a problem where for weapon types, all weapon types are listed in the equip menu even when the actor cannot equip them (though they would be disabled). Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia and sponsored by AndyL:
*** <Added EType: x>
*** <Added ETypes: x, x, x>
**** This is for armors only and does NOT work with weapons!
**** Allows a piece of armor to belong to multiple ETypes. This means a glove can be equipped as "Armgear" or as an "Accessory" if you so choose.

Version 1.48: September 14, 2023
* Bug Fixes!
** Fixed a problem where the help window position of the non-updated layout would appear in the wrong position. Fix made by Irina.
* Optimization Update!
** Plugin should run more optimized when weapons and armors exceed 2000 in database quantity.

Version 1.47: July 13, 2023
* Bug Fixes!
** Fixed a bug that would cause the shop status window to display incorrect removed buffs and debuffs. Fix made by Olivia.
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Help file updated for new features.
* Feature Updates!
** Changes made to dynamic shop listings in order to update upon listing changes rather than having to enter and exit the shop again. Update made by Arisu.
* New Features!
** New notetag effects added by Arisu and sponsored by AndyL:
*** <Conserve: x%>
**** Gives the item a percent chance when used to not consume the item.
*** <Buy Turn On Switches: x, x, x>
*** <Buy Turn Off Switches: x, x, x>
*** <Sell Turn On Switches: x, x, x>
*** <Sell Turn Off Switches: x, x, x>
**** When buying/selling an item, weapon, or armor with these notetags, turn on/off switch(es) 'x'.
*** New Plugin Parameters added by Arisu:
**** Params > Settings > Shop Status Window > Equipment Data > Delay MS:
***** How many milliseconds (MS) to delay the preview update?
***** This is to prevent lag spikes for equips only.

Version 1.46: June 15, 2023
* Bug Fixes!
** Fixed a problem where the help and input modes are not adequately adjusted when not used with the updated layout or without the Options Core custom UI placement. Fix made by Arisu.

Version 1.45: May 18, 2023
* Bug Fixes!
** Fixed a bug that would cause equip slots to not be recognized properly if the equip slot name ends in a space.

Version 1.44: April 13, 2023
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag effects added by Arisu and sponsored by Anon:
*** <Equip For Class Only: x>
*** <Equip For Classes Only: x, x, x>
*** <Equip For Class Only: name>
*** <Equip For Classes Only: name, name, name>
**** The piece of equipment can only be worn by the listed classes.
*** <Equip Requirements> notetag added.
**** Define multiple requirements that the actor needs to meet in order for this equip item to be equippable.
**** See help file for more information on the types of requirements that can be added.

Version 1.43: March 16, 2023
* Bug Fixes!
** Artifact armors should now update and refresh the party members' cache upon acquisition. Fix made by Olivia.

Version 1.42: February 16, 2023
* Bug Fixes!
** Proxy items should no longer cause infinite loops if they're made to reference other proxy items in a circular fashion. Instead, they just give the exact first found proxy instead of cycling through others. Fix made by Arisu.

Version 1.41: December 15, 2022
* Compatibility Update!
** Added compatibility functionality for future plugins.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu and sponsored by Anon:
*** Equip Scene > Equip Command > Help Description
*** Equip Scene > Optimize Command > Help Description
*** Equip Scene > Clear Command > Help Description
**** Help description used when these commands are selected.

Version 1.40: October 20, 2022
* Feature Update!
** For the shop status window, when comparing equipment of a type where there are multiple equipment slots (such as accessories), the plugin will now check for an empty equipment slot first and then make calculations there. Otherwise, it will use the first available equipment slot of that type regardless of the equipped item. Update made by Arisu.
* Optimization Update!
** Plugin should run more optimized.

Version 1.39: September 29, 2022:
* Feature Update!
** Changed the default code for the equip scene's status window display to prevent the face graphic and basic actor stats from going above the window boundaries if there are too many parameters displayed in the status window at a time.
** If you already have this plugin installed the changes will not be reflected unless you do the following:
**** BACKUP your game project.
**** REMOVE this plugin from the Plugin Manager list.
**** REINSTALL this plugin into the Plugin Manager list.
**** SAVE the game project.

Version 1.38: March 3, 2022
* Documentation Update!
** Help file updated for new features.
* New Features!
** New mechanics and notetags added by Olivia and sponsored by Anon:
*** <Party Artifact>
*** <Troop Artifact>
*** <Stackable Party Artifact>
*** <Stackable Troop Artifact>
**** Armors only! This armor cannot be equipped at all. However, by simply being in the party's inventory, its parameter bonuses and traits will be applied globally throughout the whole party or troop (depending on the notetag). Add both notetags to affect both groups.
**** The normal versions of the notetag is only applied once regardless of the number of copies are found in the party's inventory.
**** The stackable versions of the notetag will have the bonuses and traits stacked multiple times relative to the number of copies found in the party's inventory.
**** This item will NOT be added during the setup phase for Battle Tests.
***** If you want to add the item, do it manually.

Version 1.37: December 23, 2021
* Compatibility Update
** Created foundation for proxy items to be used in any applicable system and extension plugins. Update made by Arisu.

Version 1.36: December 2, 2021
* Feature Update!
** For those using custom parameters from the Core Engine and do not have the parameters all-capitalized, the plugin will automatically do it for you to prevent errors. Update made by Olivia.

Version 1.35: November 18, 2021
* Compatibility Update!
** If this plugin's updated scene is disabled, the Help Window locations for the Item, Equip, and Shop Scenes should now be at their designated locations as calculated by the VisuMZ Core Engine instead of the RMMZ default location. Update made by Irina.

Version 1.34: October 28, 2021
* Feature Update
** Added fail safe checks for projects that are using old data for starting equipment that no longer exist, thus preventing the game from opening. Update made by Arisu.

Version 1.33: August 6, 2021
* Documentation Update!
** Removed "Weapon" and "Armor" from "Used For" for <Status Info>. This was an unintended piece of documentation.

Version 1.32: July 23, 2021
* Bug Fixes!
** Fixed a bug that would cause armor duplication when changing to classes with unaligned equipment slot types. Fix made by Arisu.

Version 1.31: July 9, 2021
* Feature Update!
** Added a failsafe for price manipulation JavaScript to never have prices drop below 0 if possible. Update made by Arisu.

Version 1.30: July 2, 2021
* Documentation Update!
** Added an extra note to the help file for the following: Plugin Parameters > Item Menu Settings > List Window > Columns
*** If you are using the VisuStella MZ Core Engine and the "Modern Controls" Plugin Parameter, please read through that section in case you have any questions about how to switch between categories when using multiple columns of items at a time.

Version 1.29: June 25, 2021
* Compatibility Update
** Compatibility update with RPG Maker MZ 1.3.0+.
* Feature Update!
** Phantom data when changing equipment types in the database should no longer affect actors with cached equip ID's. Update made by Arisu.

Version 1.28: June 4, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.27: May 21, 2021
* Bug Fixes!
** Using the mouse right click in the Equip Scene while inside of the item to slot window will no longer exit the Equip Scene. Fix made by Yanfly.

Version 1.26: April 30, 2021
* Documentation Update!
** Help file updated for new features.
** "VisuStella MZ Compatibility" added VisuMZ_1_BattleCore section regarding Damage Multiplier and Healing Multiplier vocabulary settings to reduce commonly asked questions.
* New Features!
** New notetags added by Irina and sponsored by Archeia:
*** <Shop Picture Name: filename>
*** <Shop Picture Layer: x>
*** <Shop Picture Max Width: x>
*** <Shop Picture Max Height: y>
*** <Shop Picture Max Dimensions: x, y>
*** <Shop Picture Alignment: x>
*** <Shop Picture Position: y>
*** <Shop Picture Offset X: +x>
*** <Shop Picture Offset X: -x>
*** <Shop Picture Offset Y: +y>
*** <Shop Picture Offset Y: -y>
*** <Shop Picture Offset: +x, +y>
*** <Shop Picture Offset: -x, -y>
*** <Shop Picture Opacity: x>
*** <Shop Picture Opacity: x%>
**** Add images from the game project's img/pictures/ folder to display in the Shop Status Window.

Version 1.25: April 23, 2021
* Documentation Update!
** Added clarity to the <param: +x> and <param: -x> notetags:
*** These notetags do NOT work with X Parameters, S Parameters, or any custom parameters. These notetags ONLY work with the base parameters.

Version 1.24: April 16, 2021
* Bug Fixes!
** Changing an actor's equipment slots to past their original amount will no longer yield errors with duplicate slot types. Fix made by Arisu.
** Completely selling an item should now refresh the help window to the new selected item's help description. Fix made by Arisu.
* Optimization Update!
** Non-removable equipment restrictions for the equipment scene are now better optimized. Update made by Olivia.

Version 1.23: April 2, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.22: March 26, 2021
* Documentation Update!
** Added "VisuStella MZ Compatibility" section for detailed compatibility explanations with the VisuMZ_4_BreakShields plugin.

Version 1.21: March 5, 2021
* Feature Update!
** Custom equipment slots are disabled during Battle Testing for better accuracy and results.

Version 1.20: February 26, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina and sponsored by AndyL:
*** Plugin Parameters > Shop Menu Settings > Switches > Switch: Buy
*** Plugin Parameters > Shop Menu Settings > Switches > Switch: Sell
**** Buying/selling items in the Shop Scene turns this Switch to ON.
**** Switch reverts to OFF whenever the Shop Scene opens.
**** These switches can be used after a "Shop Processing" event command to determine if the player has bought an item, bought and sold an item, sold an item, or neither.

Version 1.19: January 29, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Irina.
*** <Equip Copy Limit: x>
**** Sets a maximum number of copies that the actor can wear of this equipment. Usage Example: Actors can only equip one copy of the "One-of-a-Kind Ring" on at any time despite having empty accessory slots because the ring has a <Equip Copy Limit: 1> notetag.
*** <Equip Weapon Type Limit: x>
**** This weapon cannot be equipped with other weapons of the same type once the limited amount has been reached. Usage Example: A dualwielding warrior who can only equip one sword and a dagger but never two swords or two daggers because the swords and daggers all have the <Equip Weapon Type Limit: 1> notetags on them.
*** <Equip Armor Type Limit: x>
**** This armor cannot be equipped with other armors of the same type once the limited amount has been reached. Usage Example: People cannot equip more than two glove accessories on at a time because the glove is a "Glove" armor-type and each glove item has the <Equip Armor Type Limit: 2> notetags on them.

Version 1.18: January 15, 2021
* Bug Fixes!
** Pressing "Shift" to remove equipment will now refresh the status window unlike before. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added
*** Plugin Parameters > Item Menu Settings > Background Type

Version 1.17: January 1, 2021
* Bug Fixes!
** Equipping should be working properly again. Fix made by Yanfly.

Version 1.16: December 25, 2020
* Bug Fixes!
** Equip-Adjust HP/MP should work properly now. Fix made by Yanfly.
* Documentation Update!
** Added more clarity for <JS Item Enable> to state that if the VisuStella Battle Core is installed, then all battle scope items are visible, but not necessarily enabled if they are disabled otherwise.

Version 1.15: December 18, 2020
* Bug Fixes!
** RPG Maker MZ Bug: Unusable items on an individual-actor basis will no longer be overwritten by party-based usability for battle. Fix by Yanfly.
* Documentation Update!
** Added more clarity for <JS Item Enable> to state that it removes the usable item from visibility as well if the actor unable to use it is the only person in the party.

Version 1.14: December 11, 2020
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.13: December 4, 2020
* Documentation Update!
** Added documentation for new feature(s)!
* New Features!
** New Plugin Commands added by Arisu!
*** Actor: Change Equip Slots
*** Actor: Reset Equip Slots
**** These plugin commands allow you to forcefully change the equip slots available to an actor regardless of the slots provided by its class as well as reset them.

Version 1.12: November 15, 2020
* Optimization Update!
** Plugin should run more optimized.

Version 1.11: November 8, 2020
* Bug Fix!
** Font size ratio for the shop status window now scales to a hard coded value to prevent smaller font sizes from expanding icon sizes. Fix made by Arisu.
* Feature Update!
** Currency display in the shop menu is now reflected upon how the plugin parameters set them to display. Update made by Arisu.

Version 1.10: November 1, 2020
* Feature Update!
** Modern Controls compatibility with Core Engine no longer enables the Item Categories window and child classes to utilize the Home/End keys.

Version 1.09: October 25, 2020
* Bug Fixes!
** "All Items" category should now display the "Items" text. Fix by Irina.
** WType, AType, and EType categories now work with text. Fix by Irina.

Version 1.08: October 18, 2020
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.07: October 11, 2020
* Bug Fixes!
** XParams and SParams in the Window_EquipStatus window will no longer show a non-percentile difference if the original value is not a whole value. Fix made by Yanfly.

Version 1.06: October 4, 2020
* Bug Fixes!
** Select Item event command now displays the default amount of columns instead of whatever setting is made with the plugin parameters.

Version 1.05: September 27, 2020
* Bug Fixes!
** When using the updated shop layout, leaving the sell option will no longer cause the dummy window to appear.
* Documentation Update
** "Use Updated Layout" plugin parameters now have the added clause: "This will override the Core Engine windows settings." to reduce confusion. Added by Irina.

Version 1.04: September 13, 2020
* Bug Fixes!
** Pressing Shift to quickly remove equipment should no longer crash the game. This will also clear the help window text. Fix made by Arisu.

Version 1.03: September 6, 2020
* Bug Fixes!
** If both Optimize and Clear commands have been removed and using modern controls, pressing up at the top of the slot window list will not go to the window. Fix made by Yanfly.
** If both Optimize and Clear commands have been removed, the window will no longer appear and the slot window will be moved upward to fill any empty spaces. Fix made by Yanfly.
* New Features!
** New Plugin Parameter added in NEW! Label to let you adjust the font face.
** New Plugin Parameters added in Equip Menu Scene Settings for disabling the back rectangles and/or changing their colors.
** New Plugin Parameters added in Shop Status Window Settings for disabling the back rectangles and/or changing their colors.

Version 1.02: August 30, 2020
* Documentation Fix!
** Added: NOTE: Regarding Damage Labels
*** If Visu_1_BattleCore is installed, priority goes to its Damage Style settings. The label displayed is based on the damage style settings in place for that specific skill or item.
*** Go to Battle Core > Plugin Parameters > Damage Settings > Style List > pick the damage style you want to edit > Damage Label and change the text settings you'd like there.
*** Documentation update added by Yanfly.

Version 1.01: August 23, 2020
* Added failsafe to prevent non-existent equipment (because the database entries have been deleted) from being equipped as initial equipment. Fix made by Olivia.

Version 1.00: August 20, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 1]]

|}

== End of File ==


[[Category: RPG Maker MZ Core Plugins]]

[[Category: RPG Maker MZ Item Plugins]]

[[Category: RPG Maker MZ Equip Plugins]]

[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]

[[Category: RPG Maker MZ Quality of Life Plugins]]

Template:VisuMZ Changelog 141 to 160

2026-03-15T02:00:48Z

Irina:

<noinclude>[[Category:Display templates|VisuMZ Changelog 141 to 160]]</noinclude>






=== March 16, 2026 - Update #159 ===

-

Total Plugins Updated: 6

-

'''Tier 1 (2 Plugin Updates)

-

[[Items and Equips Core VisuStella MZ]]

Version 1.60: March 16, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Arisu:
*** Parameters > Item Menu Settings > Use Updated Layout > Disabled: Vanilla
**** If NOT using the updated layout, keep all settings to pure vanilla and ignore other Plugin Parameters.
**** Used for those who do not wish to fiddle with the Plugin Parameter settings to return the item menu back to default MZ vanilla.
**** Does not apply if using updated layout.
**** The following settings are disabled if using vanilla:
***** Categories: Only the default 4
***** Category Names only display text and no icons
***** No Shop Status Window
***** Modern Controls Disabled
***** Columns: Any -> 2

-

[[Skills and States Core VisuStella MZ]]

Version 1.55: March 16, 2026
* Documentation Update!
** Added extra clarity for <nowiki><Toggle></nowiki> notetag:
*** Just like with regular <nowiki><Passive State: x></nowiki> notetag:
*** If you plan on applying a passive state through a skill, it must be through a skill that has been learned by the target and not a skill that is given through a trait.

-

'''Tier 2 (3 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.14: March 16, 2026
* Compatibility Update!
** Force Action should now works with skills that target nodes, ranks, and flanks. The skill will select the appropriate node/rank/flank of the target index. Update made by Olivia.

-

[[Battle System - OTB VisuStella MZ]]

Verison 1.21: March 16, 2026
* Compatibility Update!
** Updated better compatibility for Battle Grid System force action update. Update made by Olivia.

-

[[Equip Passive System VisuStella MZ]]

Version 1.06: March 16, 2026
* Bug Fixes!
** Fixed a bug where <nowiki><Learnable Equip Passives></nowiki> notetag was not parsing correctly. Fix made by Arisu.

-

'''Tier 3 (1 Plugin Update)

-

[[Chain Battles VisuStella MZ]]

Version 1.05: March 16, 2026
* Bug Fixes!
** Fixed a bug where EXP and Gold multipliers weren't calculating correctly based on the number of chain battles participated in.

-







=== February 16, 2026 - Update #158 ===

-

Total Plugins Updated: 5

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.90: February 16, 2026
* Feature Update!
** Battle System settings for "TPB Active" and "TPB Wait" will no longer conflict with VisuMZ_2_BattleSystemATB and VisuMZ_1_OptionsCore "Active" or "Wait" mode options set by the player.

-

'''Tier 1 (2 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.90: February 16, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Battle Layout Settings > List Style > Minimum Rows
**** How many rows minimum will the list style go to?
**** This is to prevent the list window from becoming too small.

-

[[Events and Movement Core VisuStella MZ]]

Version 1.63: February 16, 2026
* Feature Update!
** When moving by clicking and holding down the mouse button, the touch input will no longer lock onto any events with empty event lists or populated by just comments. Update made by Arisu.

-

'''Tier 2 (2 Plugin Updates)

-

[[Battle System - ATB VisuStella MZ]]

Version 1.37: February 16, 2026
* Bug Fixes!
** Fixed a bug where potential actions queued during Active ATB might get erased if used during the action of a enemy battler. Fix made by Olivia.

-

[[Battle System - STB VisuStella MZ]]

Version 1.22: February 16, 2026
* Bug Fixes!
** Fixed a bug where <nowiki><STB Cannot Be Exploited></nowiki> and <nowiki><STB Cannot Be Exploiter></nowiki> notetags were not working properly. Bug fixed by Olivia.

-







=== January 19, 2026 - Update #157 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (3 Plugin Updates)

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.31: January 19, 2026
* Bug Fixes!
** Trait sets with "Randomize for Actor?" weren't working properly. Fix made by Arisu.
* Documentation Update!
** Changed "Enemy: Change Trait Sets" Plugin Command parameter from "Target ID" to "Target Index" to reduce confusion. The parameter has always used Index values as per their description.

-

[[Events and Movement Core VisuStella MZ]]

Version 1.62: January 19, 2026
* Documentation Update!
** Help file updated for new features.
** New section added: Reference Switches and Reference Variables

-

[[Message Core VisuStella MZ]]

Version 1.55: January 19, 2026
* Documentation Update!
** \ChangeFace<nowiki><x,y></nowiki> text codegets a note added:
*** This text code is used under the assumption that you are using an existing face graphic to change from (doesn't matter which). The text code will not automatically shift text from no-face graphic to having a face graphic mid-message.

-

'''Tier 2 (3 Plugin Updates)

-

[[Aggro Control System VisuStella MZ]]

Version 1.23: January 19, 2026
* Documentation Update!
** Under "How Aggro, Provoke, and Taunts Work" > Aggro
*** Added this section:
**** The aggro gauge shows the value based on how much aggro that party member has relative to the rest of the party. Sometimes it will appear like the party member's aggro "resets" back to zero, when it fact, that's not what's happening. If that party member's aggro gauge is "empty", that means the aggro for that party member is the lowest of the party. if all party members appear to have their aggro gauge as "full", then that means the aggro for all party members is equal and that everybody is likely targeted for attack.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.20: January 19, 2026
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Conversion Settings > States (AGI >= 105%)
*** Parameters > Conversion Settings > States (AGI <= 95%)
**** Added auto-conversion functionality for states with AGI modifiers to automatically manipulate turn orders for current and next.
**** Set this to false to not use.

-

[[Bright Effects VisuStella MZ]]

Version 1.11: January 19, 2026
* Bug Fixes!
** Fixed a bug where entering the Options menu mid-battle will cause the Bright Effects plugin to be cleared. Fix made by Olivia.

-

'''Tier 3 (2 Plugin Updates)

-

[[Item Amplify Skills VisuStella MZ]]

Version 1.04: January 19, 2026
* Bug Fixes!
** Fixed a bug in the code that sets the incorrect defaults for min and max amplifications. Fix made by Arisu.

-

[[Message Keywords VisuStella MZ]]

Version 1.06: January 19, 2026
* Feature Update!
** Display and toggling of Message Keywords only occurs if the Help Window is visible. This is to prevent shortcut clashing with other plugins.

-

'''Tier 4 (1 Plugin Update)

-

[[Visual Item Inventory VisuStella MZ]]

Version 1.08: January 19, 2026
* Compatibility Update!
** When used together with the Battle Grid System, item slots will no longer be covered by the Battle Grid targeting and usage nodes. Update by Arisu.
** When used together with the More Currencies plugin, no longer display the extra currency count on item grid. Update by Arisu.

-







=== December 15, 2025 - Update #156 ===

-

Total Plugins Updated: 12

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.89: December 15, 2025
* Feature Update!
** Added extra failsafes to ensure TPB Charge Time does not become NaN or an illegal value. Update made by Arisu.

-

'''Tier 1 (4 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.89: December 15, 2025
* Bug Fixes!
** Fixed some bugs where translated text through the Message Core would incorrectly calculate the projected text size. Fix made by Irina.
* Feature Update!
** Added extra failsafes to ensure TPB Charge Time does not become NaN or an illegal value. Update made by Arisu.

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.30: December 15, 2025
* Bug Fixes!
** Fixed an incompatibility with TPB and Skills & States Core's Miasma effects, causing some parameters to appear and cache at 0. Fix made by Arisu.

-

[[Events and Movement Core VisuStella MZ]]

Version 1.61: December 15, 2025
* Bug Fixes!
** Fixed a bug where shadows would appear under lower-priority event sprites making usage of certain tiles awkward looking. This is corrected by the new Plugin Parameter. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Parameters > Movement Settings > Shadows > Shadow Z Layer
**** What is the sprite Z layer used for the shadow sprites?
**** By default, this layer will now be 0.5 instead of 0.
* Feature Update!
** If a event is made whose priority is "Below characters" and is a tile object (ie taking a sprite from the map tileset or a character sprite with "!" in front of the name), it will be automatically regulated to a custom Z layer of 0.

-

[[Skills and States Core VisuStella MZ]]

Version 1.54: December 15, 2025
* Documentation Update!
** Added extra clarity for <nowiki><List Name: name></nowiki> notetag:
*** If used with Battle Core's <nowiki><Command Text: x></nowiki>, the Command Text notetag will take priority in the command window, but the List Name notetag will appear in the skill list.
*** This does not change the display text. If you'd like to change that, use the Battle Core's <nowiki><Display Text: x></nowiki> notetag along with this notetag.

-

'''Tier 2 (6 Plugin Updates)

-

[[Aggro Control System VisuStella MZ]]

Version 1.22: December 15, 2025
* Bug Fixes!
** Fixed a bug where battlers can become immune to provoke effects. Fix made by Olivia.

-

[[Battle System - ATB VisuStella MZ]]

Version 1.36: December 15, 2025
* Feature Update!
** Added extra failsafes to ensure TPB Charge Time does not become NaN or an illegal value. Update made by Arisu.

-

[[Battle System - CTB VisuStella MZ]]

Version 1.25: December 15, 2025
* Feature Update!
** Added extra failsafes to ensure TPB Charge Time does not become NaN or an illegal value. Update made by Arisu.

-

[[Class Change System VisuStella MZ]]

Version 1.19: December 15, 2025
* Documentation Update!
** Added extra notes for clarity for the "Show in Menus?" plugin parameter for CP and JP.
*** For extra clarity:
**** Shows up if there is enough room on the screen. Make sure your game's screen resolution is large enough (ie. 1280x720).
**** Shows up in the Skill menu if 'Learn' is selected.
* Compatibility Update!
** Added better preloading functionality for Main Menu Core's options to utilize Map Sprites and SV Battlers for the visual actor graphic.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.22: December 15, 2025
* Documentation Update!
** Help file updated for new features.
* New Plugin Parameters added by Irina:
** Parameters > Scroll Wheel Settings
*** Emulates Eastern Visual Novel controls regarding mouse scroll wheel functionality. If enabled, the scroll wheel can be used to "continue" the current "Show Text" message by scrolling down on the mouse wheel or if the VisuStella MZ Message Log is installed, scrolling up will reveal the message log to show what was previously said.
*** This feature will be temporarily disabled whenever any supporting windows are visible and active, such as the "Show Choice", "Input Number", "Select Item" windows. This is because those windows typically have scroll wheel controls of their own and theirs will take priority. Even if they do not have scroll wheel controls temporarily, the function will remain disabled for control consistency.

-

[[Skill Learn System VisuStella MZ]]

Version 1.18: December 15, 2025
* Documentation Update!
** Added extra notes for clarity for the "Show in Menus?" plugin parameter for AP and SP.
*** For extra clarity:
**** Shows up if there is enough room on the screen. Make sure your game's screen resolution is large enough (ie. 1280x720).
**** Shows up in the Skill menu if 'Learn' is selected.

-

'''Tier 4 (1 Plugin Update)

-

[[Map Camera Zoom VisuStella MZ]]

Version 1.08: December 15, 2025
* Bug Fix!
** Fixed a bug where upon loading a saved game, any scrolling done by the "Scroll" event would be lost. This fix only applies to new saves made after the fix. Fix made by Arisu.
** Fixed a bug where upon using "Change Parallax" to adjust loop speeds and then zooming in would cause the parallax to jump an unpredictable amount. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > Compatibility > Zoom Round Up?
**** While zooming, change the rounding effect to round up or round down?
**** Depending on the artistic style your game is going for, you may prefer for sprite positions to round up or round down.

-







=== November 13, 2025 - Update #155 ===

-

Total Plugins Updated: 4

-

'''Tier 1 (1 Plugin Update)

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.29: November 13, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag added by Arisu:
*** <nowiki><Replace type Trait: name></nowiki>
**** Replaces the current 'type' Trait with 'name' Trait.
**** This allows things like changing an ice element type to fire element.

-

'''Tier 2 (3 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.13: November 13, 2025
* Bug Fixes!
** Fixed a bug where if VisuMZ_4_BreakShields were turned off from showing in the UI, they would still show up. This requires you to update the plugin parameters for this plugin and can be done in three ways:
*** #1 Method: Select "Window Settings" in the Plugin Parameter list and press "Delete" button on your keyboard. Then open it back up to repopulate it with the default settings. This will reset all of the settings within "Window Settings".
*** #2 Method: Delete the current copy of VisuMZ_2_BattleGridSystem from the Plugin Manager list and install a new copy of VisuMZ_2_BattleGridSystem into the Plugin Manager list. This will reset all your Plugin Parameter settings.
*** #3 Method: Install a fresh copy of VisuMZ_2_BattleGridSystem, copy the Parameters > Window Settings > Tactics Grid Window > JS: Draw Actor Node setting and paste it in your existing copy in the Plugin Manager list.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.19: November 13, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New script calls added by Olivia:
*** $otbAddBattlerToCurrentTurnEnd(battler, times)
*** $otbAddBattlerToNextTurnEnd(battler, times)
**** Adds actions for target battler to the end of current/next turn.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.21: November 13, 2025
* Compatibility Update!
** "Auto-Forward" functionality now plays nice with VisuMZ_2_VoiceActControl and waits for voice lines to finish before continuing.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > Auto-Forward Settings > Compatibility > Voice Act Padding
**** How many frames to wait after a voice line finishes?
**** Average: 60 frames per second.

-







=== October 16, 2025 - Update #154 ===

-

Total Plugins Updated: 5

-

'''Tier 1 (1 Plugin Update)

-

[[Items and Equips Core VisuStella MZ]]

Version 1.59: October 16, 2025
* Bug Fixes!
** Fixed a bug where a changed parameter in the equipment menu would accidentally highlight the next parameter's name. Fix made by Irina.

-

'''Tier 2 (4 Plugin Updates)

-

[[Aggro Control System VisuStella MZ]]

Version 1.21: October 16, 2025
* Bug Fixes!
** Fixed a bug where auto-battle would bypass Taunt and Provoke effects. Fix made by Olivia.

-

[[Battle System - ATB VisuStella MZ]]

Version 1.35: October 16, 2025
* Bug Fixes!
** Fixed a bug where if an actor dies in battle and is revived post-battle using "Recover All", that actor no longer gets stuck after their first action in following battles. Fix made by Olivia.

-

[[Equip Battle Skills VisuStella MZ]]

Version 1.11: October 16, 2025
* Compatibility Update!
** Added better compatibility with Equip Battle Skills when used together with enemy reference ID's. Update made by Olivia.

-

[[Item Crafting System VisuStella MZ]]

Version 1.25: October 16, 2025
* Compatibility Update!
** Added better compatibility checks for shop batches to make sure they don't give out free items. Fix made by Arisu.

-







=== September 18, 2025 - Update #153 ===

-

Total Plugins Updated: 11

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.88: September 18, 2025
* Documentation Update!
** Extra notes for <nowiki><JS param Plus/Rate/Flat: code></nowiki> notetags
*** Use 'user' to refer to the currently equipping actor.
*** If you use code to refer to an actor's other stats like 'atk' and 'def', there is the potential to cause an infinite loop.
*** Use 'user.paramBase(x)' instead of 'user.atk', 'user.def', etc.
*** Plugin Parameter setting Parameters > "Convert JS To Base?" will automatically convert any instances of 'user.mhp', 'user.mmp', 'user.atk', etc. to their base parameters.
*** Turn this off if you do not want it.
*** You are responsible for any infinite loops this may cause.
* Feature Update!
** <nowiki><JS param Plus/Rate/Flat: code></nowiki> now support 'user' as a variable.
* New Features!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > Parameters > Convert JS To Base?
**** Automatically convert <nowiki><JS param Plus/Rate/Flat: code></nowiki> to use base parameters to prevent infinite loops.

-

'''Tier 1 (2 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.88: September 18, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag added by Olivia:
*** <nowiki><Damage Flinch></nowiki>
**** Normally, MP and TP actions do not cause damage flinching. However, skills and items with this notetag will cause damage flinching if they hurt the target's MP or TP.
**** HP damage will always be affected and cause target to flinch.
** New Plugin Parameter added by Olivia:
*** Plugin Parameters > Damage Settings > Check Formulas?
**** It's usually bad practice to put in battle mechanics within damage formulas and this will check the damage formulas for skills and items to see if they contain any of the common battle mechanics that have the potential to cause problems.
**** Checks for illegal mechanics inside of damage formulas?
**** (ie. gainHp, loseHp, addBuff, addDebuff, addState, etc)
**** Read the following article for an explanation on why battle mechanics in damage formulas are undesirable and for an alternate solution:
**** [[Stop Putting Mechanics in Damage Formulas]]
**** Turn this off if you do not want to be alerted of which skills/items have battle mechanics in their damage formulas.

-

[[Skills and States Core VisuStella MZ]]

Version 1.53: September 18, 2025
* Bug Fixes!
** Fixed a bug where the "Preset: Gauge Color" Plugin Parameter was not accepting #rrggbb values. Fix made by Arisu.
* Documentation Update!
** Added extra clarity for <nowiki><Passive State: x></nowiki>:
*** If you are using VisuMZ's Equip Battle Skills, know that the notetag <nowiki><Passive State: x></nowiki> will always have the passive state be available no matter if the skill is equipped or not, as long as the skill is learned.
*** If you want the passive state to only appear while the skill is equipped then use the VisuMZ Equip Battle Skills notetag <nowiki><Equip State: x></nowiki> for this effect instead.

-

'''Tier 2 (6 Plugin Updates)

-

[[Animated Message Text Effects VisuStella MZ]]

Version 1.05: September 18, 2025
* Bug Fixes!
** Word Wrap no longer causes multiple text effects to not register. Fix made by Irina.

-

[[Bestiary VisuStella MZ]]

Version 1.08: September 18, 2025
** Bug Fixes!
*** Fixed a bug where the Bestiary Reveal Enemies Plugin Command would not work with deployed games. Fix made by Irina.

-

[[Date and Time System VisuStella MZ]]

Version 1.06: September 18, 2025
* Bug Fixes!
** Fixed a bug where manual game time updates made by Plugin Commands would not allow variables to update if Game Time was paused. Fix made by Arisu.

-

[[Enhanced TP System VisuStella MZ]]

Version 1.17: September 18, 2025
* Bug Fixes!
** Fixed a bug where TP was not properly preserved. Fix made by Arisu.

-

[[Equip Battle Skills VisuStella MZ]]

Version 1.10: September 18, 2025
* Compatibility Update!
** Added better compatibility with Skills & States Core's new <nowiki><Toggle></nowiki> functionality. <nowiki><Equip State: x></nowiki> can now have the passive state be toggled on and off. Update made by Arisu.

-

[[Equip Passive System VisuStella MZ]]

Version 1.05: September 18, 2025
* Bug Fixes!
** Upon actor/enemy deaths, death and kill counts won't trigger multiple times anymore. Kills will also only trigger once per battle per enemy. Fix made by Arisu.

-

'''Tier 4 (2 Plugin Updates)

-

[[Encounter Effects VisuStella MZ]]

Version 1.12: September 18, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags/comment tags added by Arisu:
*** <nowiki><Enable Diagonal Chase></nowiki>
*** <nowiki><Disable Diagonal Chase></nowiki>
**** If Events & Movement Core is installed, events can chase the player in diagonal directions if the player can move diagonally.
**** However, if you want the player to only move in 4-directions but the event can move diagonally, you can use <nowiki><Enable Diagonal Chase></nowiki>.
**** Alternatively, you want the player to be able to move diagonally while the event cannot, you can use <nowiki><Disable Diagonal Chase></nowiki>.

-

[[Multi-Layer HP Gauge VisuStella MZ]]

Version 1.06: September 18, 2025
* Compatibility Update!
** HP Gauges will no longer cover up Tutorial Panel System's windows. Update made by Olivia.

-







=== August 14, 2025 - Update #152 ===

-

Total Plugins Updated: 6

-

'''Tier 1 (1 Plugin Update)

-

[[Skills and States Core VisuStella MZ]]

Version 1.52: August 14, 2025
* Feature Update!
** Passive States with custom JS conditions should be less prone to infinite loops. Update made by Irina.

-

'''Tier 2 (4 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.12: August 14, 2025
* Bug Fixes!
** Fixed a bug where cancelling attack and then moving, despite having pass turn on, would still cause the attack to go through. Fix made by Irina.

-

[[Battle System - PTB VisuStella MZ]]

Version 1.16: August 14, 2025
* Bug Fixes!
** Fixed a bug where if an actor is newly added during battle, while the battle would compensate and give the party an extra action to work with, the newly added actor would not get a turn. Fix made by Olivia.

-

[[Date and Time System VisuStella MZ]]

Version 1.05: August 14, 2025
* Documentation Update!
** Added warning to these Plugin Commands:
*** Game Time: Record to Variable(s)
*** Real Time: Record to Variable(s)
**** Does NOT overwrite automatic variables used in Plugin Parameters.
** Added segment to Plugin Parameters: Game Time Variables & Switches
*** Changing these variables' values does not mean the Game Time will be changed in-game. These variables are just for automatically reading what the Game Time is. If you wish to change the Game Time, you will need to use the Plugin Commands "Change Date To" and "Change Time To" instead.
** Added segment to Plugin Parameters: Real Time Variables & Switches
*** Changing these variables' values does not mean the Real Time will be changed in-game. These variables are just for automatically reading what the Real Time is. Real Time value cannot be changed by the plugin.

-

[[Party System VisuStella MZ]]

Version 1.35: August 14, 2025
* Bug Fixes!
** Fixed a bug where if the battle had no battle back setting and is using a map snapshot, the snapshot would be overwritten if the player enters the party change menu from battle. This should no longer occur and the map snapshot will be preserved. Fix made by Olivia.

-

'''Tier 4 (1 Plugin Update)

-

[[Button Common Events VisuStella MZ]]

Version 1.11: August 14, 2025
* Bug Fixes!
** When "Forbid Default Bound Keys" is enabled, walking over below/above priority events with Player Touch or Event Touch can enable them over and over again if they do not have any kind of stop measure until the player fully steps on the tile. This should no longer happen. Fix made by Arisu.

-







=== July 17, 2025 - Update #151 ===

-

Total Plugins Updated: 7

-

'''Tier 2 (5 Plugin Updates)

-

[[Aggro Control System VisuStella MZ]]

Version 1.20: July 17, 2025
* Bug Fixes!
** Fixed a bug where if a party member who provoked an enemy decided to switch out, the provoke effect would be retained and cause the enemy to bug out and crash the game. Fix made by Arisu.

-

[[Character Creation System VisuStella MZ]]

Version 1.09: July 17, 2025
* Compatibility Update!
** If traits were turned off, there would be a crash. Crash is now fixed. Applies to retraining, too. Fix made by Arisu.

-

[[Item Crafting System VisuStella MZ]]

Version 1.24: July 17, 2025
* Bug Fixes!
** Fixed a name masking bug that would result in a crash. Fix made by Arisu.

-

[[Party System VisuStella MZ]]

Version 1.34: July 17, 2025
* Compatibility Update!
** Added better compatibility with TPB when using the in-battle Party switch command from the Party Command Window. Update made by Irina.

-

[[Weapon Swap System VisuStella MZ]]

Version 1.14: July 17, 2025
* Bug Fixes!
** Fixed a bug where the default status scene would not display the correct weapons. Fix made by Irina.

-

'''Tier 3 (1 Plugin Update)

-

[[Skill Mastery VisuStella MZ]]

Version 1.03: July 17, 2025
* Bug Fixes!
** Before, if a skill with a common event would defeat an enemy, it wouldn't grant the user any mastery EXP. Fix made by Arisu.
* Compatibility Update!
** Better compatibility with Equip Battle Skills!

-

'''Tier 4 (1 Plugin Update)

-

[[CG Gallery VisuStella MZ]]

Version 1.03: July 17, 2025
* Bug Fixes!
** Fixed a bug where the CG Gallery would crash if Completion or Progress displays were turned off. Fix made by Irina.

-







=== June 12, 2025 - Update #150 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (1 Plugin Update)

-

[[Battle Core VisuStella MZ]]

Version 1.87: June 12, 2025
* Bug Fixes!
** Fixed a bug where <nowiki><JS Accuracy></nowiki> and related notetags did not work. Fix made by Arisu.
** Fixed a bug where dual wielding weapons with HP/MP bonuses would cause the max cache values to fluctuate per hit. Fix made by Olivia.
* Compatibility Update!
** Added fail safes for plugins that would sometimes add null battlers to animation queues. This update prevents crashes for potential checks.
** Added better compatibility with Message Core's text language change. Enemy names did not convert prior to placing state icons and would cause misalignment.

-

'''Tier 2 (7 Plugin Updates)

-

[[Battle System - BTB VisuStella MZ]]

Version 1.19: June 12, 2025
* Bug Fixes!
** Fixed a bug where notetags like <nowiki><Target: Enemy or Ally></nowiki> would cause action fusions to not work properly. Fix made by Arisu.
** Fixed a bug where some special targeting cases were not preserved when performing action fusions. Fix made by Arisu.

-

[[Battle System - PTB VisuStella MZ]]

Version 1.15: June 12, 2025
* Bug Fixes!
** Fixed a bug where "Fastest AGI First" mechanic was always on under most conditions. When this plugin parameter is off, the party order will always go by party index instead. Fix made by Arisu.

-

[[Class Change System VisuStella MZ]]

Version 1.18: June 12, 2025
* Documentation Update!
** Help file updated for new features.
** Added new line for <nowiki><CP Rate: x%></nowiki>
*** CP Gain Formulation Calculation: (1 + Plus) * Rate + Flat
** Added new line for <nowiki><JP Rate: x%></nowiki>
*** JP Gain Formulation Calculation: (1 + Plus) * Rate + Flat
* New Features!
** New notetags added by Arisu:
*** <nowiki><CP Plus: +x%></nowiki>
*** <nowiki><CP Plus: -x%></nowiki>
*** <nowiki><CP Flat: +x%></nowiki>
*** <nowiki><CP Flat: -x%></nowiki>
*** <nowiki><JP Plus: +x%></nowiki>
*** <nowiki><JP Plus: -x%></nowiki>
*** <nowiki><JP Flat: +x%></nowiki>
*** <nowiki><JP Flat: -x%></nowiki>
**** These are the additive versions of <nowiki><CP Rate: x%></nowiki> and <nowiki><JP Rate: x%></nowiki>
**** See help file for more information.

-

[[Equip Battle Skills VisuStella MZ]]

Version 1.09: June 12, 2025
* Bug Fixes!
** Fixed a bug where Skill & States Core's <nowiki><Hide in Battle></nowiki> is bypassed if used together with "All Skills" in the Battle Command controller. Fix made by Arisu.

-

[[Furniture System VisuStella MZ]]

Version 1.10: June 12, 2025
* Bug Fixes!
** Fixed a bug where if a template is not the neutral center pattern, the furniture cursor would not display it correctly. Fix made by Arisu.

-

[[QTE and Trigger System VisuStella MZ]]

Version 1.03: June 12, 2025
* Bug Fixes!
** Fixed a bug where some QTE's did not work properly in battle. Fix made by Arisu.

-

[[Skill Learn System VisuStella MZ]]

Version 1.17: June 12, 2025
* Documentation Update!
** Help file updated for new features.
** Added new line for <nowiki><AP Rate: x%></nowiki>
*** AP Gain Formulation Calculation: (1 + Plus) * Rate + Flat
** Added new line for <nowiki><SP Rate: x%></nowiki>
*** SP Gain Formulation Calculation: (1 + Plus) * Rate + Flat
* New Features!
** New notetags added by Arisu:
*** <nowiki><AP Plus: +x%></nowiki>
*** <nowiki><AP Plus: -x%></nowiki>
*** <nowiki><AP Flat: +x%></nowiki>
*** <nowiki><AP Flat: -x%></nowiki>
*** <nowiki><SP Plus: +x%></nowiki>
*** <nowiki><SP Plus: -x%></nowiki>
*** <nowiki><SP Flat: +x%></nowiki>
*** <nowiki><SP Flat: -x%></nowiki>
**** These are the additive versions of <nowiki><AP Rate: x%></nowiki> and <nowiki><SP Rate: x%></nowiki>
**** See help file for more information.

-

'''Tier 4 (1 Plugin Update)

-

[[Database Inheritance VisuStella MZ]]

Version 1.04: June 12, 2025
* Bug Fixes!
** Fixed a bug where parameters for classes would be inherited when this notetag should only be for equipment and enemies. Fix made by Arisu.

-







=== May 15, 2025 - Update #149 ===

-

Total Plugins Updated: 16

-

'''Tier 1 (1 Plugin Update)

-

[[Message Core VisuStella MZ]]

Version 1.54: May 15, 2025
* Bug Fixes!
** Fixed a bug where the text width of translated text was not taken into account. Fix made by Arisu

-

'''Tier 2 (7 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.11: May 15, 2025
* Bug Fixes!
** Fixed a bug where certain notetag combinations would cause crashes. Fix made by Arisu.
** Fixed a bug where using aura or miasma effects from Skills & States Core would cause the game to crash if there were not enough battle grid node slots to accommodate all characters, even if they were in the reserve. As a result, aura and miasma effects now only affect battle members.
* Documentation Update!
** Added documentation for <nowiki><Aura Range: type></nowiki> <nowiki><Miasma Range: type></nowiki> notetags
*** Aura/Miasma effects do not affect characters not in active party.

-

[[Battle System - ETB VisuStella MZ]]

Version 1.11: May 15, 2025
* Bug Fixes!
** Fixed a bug where if an actor performs a forced action while "Maintain Same Actor?" plugin parameter is enabled, the forced action would double. This should now be fixed.

-

[[Battle System - FTB VisuStella MZ]]

Version 1.14: May 15, 2025
* Bug Fixes!
** Fixed a bug where if an actor performs a forced action while "Maintain Same Actor?" plugin parameter is enabled, the forced action would double. This should now be fixed.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.18: May 15, 2025
* Bug Fixes!
** Fixed a bug where adding states with Action Times+ would add too many actions. Fix made by Olivia.

-

[[Bestiary VisuStella MZ]]

Version 1.07: May 15, 2025
* Compatibility Update!
** Added better compatibility with Message Core's text language settings. Update made by Arisu.

-

[[Item Crafting System VisuStella MZ]]

Version 1.23: May 15, 2025
* Compatibility Update!
** Added better compatibility with Message Core's text language settings. Update made by Arisu.

-

[[Party System VisuStella MZ]]

Version 1.33: May 15, 2025
* Compatibility Update!
** Added better compatibility for $gameParty.swapOrder function to allow it to work on the map. Update made by Irina.

-

'''Tier 3 (4 Plugin Updates)

-

[[Active Chain Skills VisuStella MZ]]

Version 1.07: May 15, 2025
* Documentation Update
** Added under "Active Chain Skills":
*** Auto Battle Timing
**** If an actor with auto battle uses a skill that can chain, they will pick a chain skill within 200 milliseconds after the skill has started. If the active chain mechanic is disabled within this time frame (through an action sequence command) then no chain skill will be automatically selected.
* Feature Update!
** Added a 200 millisecond delay before a chain skill is automatically selected through Auto Battle. This is done to give action sequences enough time to disable the Active Chain Mechanic if they want to.

-

[[Boost Action VisuStella MZ]]

Version 1.13: May 15, 2025
* Bug Fixes!
** Fixed a bug that would cause Boost Points to not work properly. Fix made by Arisu.

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.16: May 15, 2025
* Compatibility Update!
** Better compatibility with Visual Item Inventory. Update made by Arisu.

-

[[Steal Items VisuStella MZ]]

Version 1.10: May 15, 2025
* Bug Fixes!
** Fixed a bug that would cause a crash if an enemy has no items that can be stolen when using snatch functionality. Fix made by Arisu.

-

'''Tier 4 (4 Plugin Updates)

-

[[Battle Cursor VisuStella MZ]]

Version 1.04: May 15, 2025
* Bug Fixes!
** Fixed a bug where the battle cursor position could appear on non-rounded numbers, causing pixel bleeding between frames. Fix made by Olivia.

-

[[Button Common Events VisuStella MZ]]

Version 1.10: May 15, 2025
* Bug Fixes!
** When a common event is launched while the player is moving onto a below or above priority event with Player Touch or Event Touch, the event action would be skipped. This should no longer happen. Fix made by Arisu.

-

[[Unique Tile Effects VisuStella MZ]]

Version 1.07: May 15, 2025
* Documentation Update!
** Help file updated for new features.
** Updated "Warning! RPG Maker MZ Version 1.5.0+ Water-Tile Bug!" section:
*** As of version 1.9.0+, these two methods no longer work to fix the problem. There is a Plugin Parameter added to disable the error message. However, this does not mean that the tileset flag data is fixed. Turn off the error message at your will.
* Added new Plugin Parameter:
** Plugin Parameters > Enable Error Message?
*** Display error message for tilesets with incomplete flag data?
*** Disabling does not fix the problem.

-

[[Visual Item Inventory VisuStella MZ]]

Version 1.07: May 15, 2025
* Compatibility Update!
** Tooltip window now accounts for target window's scaling (ie Frontview Battle UI). Update made by Arisu.

-







=== April 17, 2025 - Update #148 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (1 Plugin Update)

-

[[Skills and States Core VisuStella MZ]]

Version 1.51: April 17, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Skill Toggle Settings
**** Skill toggles are a new type of skill. They do not perform any actions but instead, will switch on/off any passive effects the skill has.
**** Enemies are unable to switch Toggle Skills and the passive effects on a Toggle Skill for an enemy will always be considered ON.
**** See the help file for more information.
** New Notetags added by Olivia:
*** Skill Toggle Notetags:
**** <nowiki><Toggle></nowiki>
**** <nowiki><Initial Toggle: On/Off></nowiki>
**** <nowiki><Toggle Exclusion Group: key></nowiki>
**** <nowiki><Toggle On Animation: x></nowiki>
**** <nowiki><Toggle Off Animation: x></nowiki>
***** See the help file for more information.

[[File:SkillToggle.gif]]

-

'''Tier 2 (2 Plugin Updates)

-

[[Battle System - BTB VisuStella MZ]]

Version 1.18: April 17, 2025
* Bug Fixes!
** Fixed a bug where flex fusion combinations did not work properly and where the strict fusion combinations would draw from flex fusions. Fix made by Olivia.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.20: April 17, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Message Tails > Auto-Position > Auto-Correct X
**** Auto-corrects Message Tail position X when used with Auto-Position but are too close to edge of screen.

-

'''Tier 3 (5 Plugin Updates)

-

[[Boost Action VisuStella MZ]]

Version 1.12: April 17, 2025
* Compatibility Update!
** Better compatibility with Message Core's wordwrap.
* Documentation Update!
** The follow text codes now have added notes to them:
*** \boost>=x[text]
*** \boost>x[text]
*** \boost=x[text]
*** \boost<x[text]
*** \boost<=x[text]
**** Added note: In battle use only!
* Feature Update!
** \boost=0[x] now functions the same as \boost0[x] and does not require being in battle. Update made by Arisu.

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.15: April 17, 2025
* Bug Fixes!
** Fixed a bug where if an actor does not have Preserve TP and their TP changes on the map scene, the TP gauge does not reflect the new changes. Fix made by Arisu.

-

[[Limited Skill Uses VisuStella MZ]]

Version 1.05: April 17, 2025
* Compatibility Update!
** Added better compatibility with Skills & States Core's new Skill Toggles.

-

[[Skill Cooldowns VisuStella MZ]]

Version 1.08: April 17, 2025
* Compatibility Update!
** Added better compatibility with Skills & States Core's new Skill Toggles.

-

[[Victory Aftermath VisuStella MZ]]

Version 1.23: April 17, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Command added by Olivia:
*** System: Change Victory BGM
**** Changes victory BGM.

-

'''Tier 4 (1 Plugin Update)

-

[[Full Field Recovery VisuStella MZ]]

Version 1.02: April 17, 2025
* Bug Fixes!
** Fixed a bug where items would get used on dead party members even if the item did not allow targeting dead party members in its scope. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > General > Mechanics > Heal HP? > Prioritize Lowest %?
**** Prioritize using healing items on lowest HP% member first?
**** If off, heal members in party order.
*** Parameters > General > Mechanics > Heal MP? > Prioritize Lowest %?
**** Prioritize using healing items on lowest MP% member first?
**** If off, heal members in party order.

-







=== March 20, 2025 - Update #147 ===

-

Total Plugins Updated: 11

-

'''Tier 1 (1 Plugin Update)

-

[[Skills and States Core VisuStella MZ]]

Version 1.50: March 20, 2025
* Documentation Update!
** Changed the description of Plugin Parameter 'Action End Update' to 'Refer to "Major Changes" in Help File for explanation.'
** Added examples of "Action End Update" under "Major Changes"
*** The new state: "Fiery Blade" will allow the affected battler to deal fire elemental damage. With Action End, this means for 5 actions, those attacks will deal fire damage.
*** This means that if no action is taken, due to a status effect like "Sleep" or "Stun", then the duration count will not decrease.
*** On the flip side, if the battler performs multiple actions a turn, then the duration count drops faster because more actions have been spent.
*** However, if this "Fiery Blade" state was using Turn End instead, it will have its duration reduced by 1 each turn, regardless of "Sleep" or "Stun" states, and regardless of how many actions are performed each turn.

-

'''Tier 2 (3 Plugin Updates)

-

[[Battle System - ATB VisuStella MZ]]

Version 1.34: March 20, 2025
* Bug Fixes!
** Field ATB Gauge no longer stays visible during victory sequence. Fix made by Olivia.

-

[[QTE and Trigger System VisuStella MZ]]

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Arisu:
*** Plugin Parameters > QTE Settings > Input Buffer Leeway
**** How many input buffer frames of leeway should be granted to Button Sequence QTE?

-

[[Tutorial Panel System VisuStella MZ]]

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameters added by Irina:
*** Plugin Parameters > Scene Battle > Button Assist Window
**** Button Assist Window > Background Type
**** Button Assist Window > JS: X, Y, W, H
***** Added menu button assist to the battle scene where it previously was not available.
***** Requires VisuMZ_0_CoreEngine!

-

'''Tier 3 (6 Plugin Updates)

-

[[Auto Skill Triggers VisuStella MZ]]

Version 1.17: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > General Settings:
**** These are general settings used for this plugin. These are primarily used to impose a limit on the number of auto skill triggers that can happen per battler per turn (meaning each member in battle has that limit individually and not as a whole). Generally speaking, we recommend imposing limits limits like MP costs, TP costs, cooldowns, and the like.
**** This is because auto skill triggers, when left unchecked and reacting to everything, can cause a runaway effect where the player no longer inputs anything. Instead, it is best to put a limit (even if high) on the number of auto triggers to prevent such a thing from happening.
**** If you still want seemingly unlimited auto skill triggers, change the numbers to 100 or something, but keep in mind that we're not responsible for runaway effects when the risk of it happening is already mentioned.
*** Plugin Parameters > Limit Per Turn (Turn-Based)
**** Turn-Based Only. How many triggers per battler per turn? Higher risk of runaway auto triggers at higher counts.
*** Plugin Parameters > Limit Per Turn (TPB-Based)
**** TPB-Only. How many triggers per battler per turn? Higher risk of runaway auto triggers at higher counts.

-

[[Battle AI VisuStella MZ]]

Version 1.29: March 20, 2025
* Bug Fixes!
** Fixed a problem with TPB actions causing conflicts in AI registration of certain abilities. This would lead to crashes. Should be no more. Fix made by Olivia.

-

[[Boost Action VisuStella MZ]]

Version 1.11: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Mechanics > Boost Animations > Mirror Animation
*** Parameters > Mechanics > Boost Animations > Mute Animation
**** Mirror/Mute the effect animation?
*** Parameters > Mechanics > Boost Animations > Repeat Animation?
*** Parameters > Mechanics > Boost Animations > Repeat > Repeat Cycle
*** Parameters > Mechanics > Boost Animations > Repeat > Mirror Animation
*** Parameters > Mechanics > Boost Animations > Repeat > Mute Animation
**** Allows repeating animations while boosted and inputting.
**** Only repeated during command input.

-

[[Skill Mastery VisuStella MZ]]

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > General > Window_ActorCommand > Show Level in Name?
**** Show the skill level in name for single skills?
**** Only applies to Window_ActorCommand!
**** Not all skill name displays will show skill levels.
*** Parameters > General > Window_ActorCommand > Show Mastery Gauge?
**** Show the mastery gauge for single skills?
**** Only applies to Window_ActorCommand!
**** Not all skill name displays will show skill levels.

-

[[Visual Cutin Effect VisuStella MZ]]

Version 1.02: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Olivia:
*** Plugin Parameters > Cutin Layer
**** Where do you want the visual cutins layer placed?
***** Top - Above Everything Else
***** Below - Below UI Elements (Default)

-

[[Visual State Effects VisuStella MZ]]

Version 1.24: March 20, 2025
* Bug Fixes!
** Fixed a crash that would occur upon state removal regarding hovering. Fix made by Irina.

-

'''Tier 4 (1 Plugin Update)

-

[[Weakness Popups VisuStella MZ]]

Version 1.10: March 20, 2025
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Any Weakness > Animation ID
**** Play this animation when weakness effect activates.
**** Requires VisuMZ_0_CoreEngine.
*** Plugin Parameters > Any Weakness > Animation ID > Mirror Animation
*** Plugin Parameters > Any Weakness > Animation ID > Mute Animation
**** Mirrors/mutes the weakness effect animation?
**** Requires VisuMZ_0_CoreEngine.

-







=== February 20, 2025 - Update #146 ===

-

Total Plugins Updated: 33

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.87: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.
*** Better compatibility with different icon sizes.
* Documentation Update!
** Under Plugin Parameters: Menu Button Assist Window
*** Added text segments under Split "Escape"
**** This means you need to go to your own project's rmmz_core.js and modify Input.keyMapper to have buttons with "cancel" and "menu" instead of only "escape".
**** If there are none found, an error message will appear telling you to do so, or set the 'Split "Escape"' option to false.
**** If you are using Options Core's Rebind Keyboard option, be sure to have those have "cancel" and "menu" options inside there, too.
* Feature Update!
** Plugin Parameters > Button Assist > Split "Escape" will now show an error message if a custom Input.keyMapper is not found with the "cancel" and "menu" keys implemented. Update made by Irina.
** Updated Plugin Parameters > Button Assist > Split "Escape" description for Plugin Parameters to add in the following text: Requires custom Input.keyMapper with "cancel" and "menu".
** Added better compatibility with WASD controls as to prioritize showing the arrow keys rather than the W, A, S, D keys. Also applies to any other rebindings.

-

'''Tier 1 (7 Plugin Updates)

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.28: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.
* Documentation Update!
** Help file updated to add extra note to "Status Menu Settings"
*** Plugin Parameters > Status Menu Settings > Elements > IDs: Column 1/2
**** If you have a lot of elements and a single column does not have enough room to display them all, use these Plugin Parameters to split them up into two columns.
**** This can also be used for those who wish to separate their elements between physical and magical elements, major and minor, etc.

-

[[Items and Equips Core VisuStella MZ]]

Version 1.58: February 20, 2025
* Bug Fixes!
** Optimize no longer allows player to bypass the following notetags: <nowiki><Equip Copy Limit: x></nowiki>, <nowiki><Equip Weapon Type Limit: x></nowiki>, and <nowiki><Equip Armor Type Limit: x></nowiki>. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Main Menu Core VisuStella MZ]]

Version 1.27: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Message Core VisuStella MZ]]

Version 1.53: February 20, 2025, 2025
* Bug Fixes!
** Fixed an error with text language translations not working properly for the last listed language in the translation sheet. Fix made by Irina.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.
* Documentation Update!
** Help file updated for new features.
** Text Language Information section included for TSV.
** Updated text code note for \picture<nowiki><x></nowiki> and \CenterPicture<nowiki><x></nowiki>

-

[[Options Core VisuStella MZ]]

Version 1.28: February 20, 2025
* Feature Update!
** Added a fail safe to prevent crashes when pressing F4/Full Screen too early while the game is loading. Update made by Arisu.

-

[[Save Core VisuStella MZ]]

Version 1.14: February 20, 2025
* Feature Update!
** Whenever the background picture is now snapped for a screenshot (usually for a menu), the autosave confirmation window will no longer be included in it if the player reenters a menu immediately after going to map scene. Update made by Irina.

-

[[Skills and States Core VisuStella MZ]]

Version 1.49: February 20, 2025
* Bug Fixes!
** Fixed a bug where causing a dead battler to refresh afterwards would yield multiple death states on that battler. Fix made by Arisu.
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

'''Tier 2 (14 Plugin Updates)

-

[[Animated Message Text Effects VisuStella MZ]]

Version 1.04: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Battle System - BTB VisuStella MZ]]

Version 1.17: February 20, 2025
* Bug Fixes!
** Fixed a bug where for certain battle layouts, the BTB Action Counter on the actor command window would start off center. Fix made by Olivia.

-

[[Character Creation System VisuStella MZ]]

Version 1.08: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Class Change System VisuStella MZ]]

Version 1.17: February 20, 2025
* Bug Fixes!
** Fixed a crash that would occur upon loading a save game that was made before Class Change System was installed. Fix made by Olivia.

-

[[Enhanced TP System VisuStella MZ]]

Version 1.16: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Equip Battle Skills VisuStella MZ]]

Version 1.08: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Equip Medal System VisuStella MZ]]

Version 1.06: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Equip Passive System VisuStella MZ]]

Version 1.04: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.19: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different face sizes.

-

[[Horror Effects VisuStella MZ]]

Version 1.05: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

[[Item Crafting System VisuStella MZ]]

Version 1.22: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.
* Documentation Update!
** Added extra clarity to <nowiki><Craft Batch></nowiki>
*** Items CANNOT add themselves!
*** ie. Item 'Super Potion' must not give Item 'Super Potion'.
* Feature Update!
** Add fail safes to prevent items from having batch entries add themselves. Added by Arisu.

-

[[More Currencies VisuStella MZ]]

Version 1.05: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Picture Choices VisuStella MZ]]

Version 1.02: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

[[Picture Effects VisuStella MZ]]

Version 1.01: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

'''Tier 3 (6 Plugin Updates)

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.14: February 20, 2025
* Documentation Update!
** Help file updated "Major Changes" section:
*** Face Dimensions
**** With the updated release of RPG Maker MZ 1.9.0, you can now change face sizes within the database's system settings. However, this plugin's default settings are geared towards the default face sizes of 144 x 144 pixels. If you do wish to change their sizes, you will need to adjust this plugin's Plugin Parameters accordingly to make the object offsets look correct. The plugin will not automatically adjust them for you.

-

[[Item Amplify Skills VisuStella MZ]]

Version 1.03: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Shop Batches VisuStella MZ]]

Version 1.03: February 20, 2025
* Documentation Update!
** Added extra clarity to <nowiki><Shop Batch></nowiki>
*** Items CANNOT add themselves!
*** ie. Item 'Super Potion' must not give Item 'Super Potion'.
* Feature Update!
** Add fail safes to prevent items from having batch entries add themselves. Added by Arisu.

-

[[Shop Listing Unlock VisuStella MZ]]

Version 1.01: February 20, 2025
* Optimization Update!
** Plugin should run more optimized.

-

[[Visual Gauge Styles VisuStella MZ]]

Version 1.03: February 20, 2025
* Bug Fixes!
** Fixed a bug where for certain gauges, the "sectioned" gauge style would not fill past the first section. Fix made by Arisu.

-

[[Visual Gold Display VisuStella MZ]]

Version 1.02: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

'''Tier 4 (5 Plugin Updates)

-

[[Animated Pictures VisuStella MZ]]

Version 1.05: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

[[Attached Pictures VisuStella MZ]]

Version 1.05: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-

[[Break Shields VisuStella MZ]]

Version 1.07: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Better compatibility with different icon sizes.

-

[[Message Visibility VisuStella MZ]]

Version 1.03: February 20, 2025
* Compatibility Update!
** Added better compatibility with some of the more recent Message Core additions.

-

[[Picture Common Events VisuStella MZ]]

Version 1.03: February 20, 2025
* Compatibility Update!
** Updated for RPG Maker MZ Core Scripts 1.9.0!
*** Removed picture limit of 100 from Picture-related Plugin Commands.

-







=== January 16, 2025 - Update #145 ===

-

Total Plugins Updated: 21

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.86: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.

-

'''Tier 1 (3 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.86: January 16, 2025
* Bug Fixes!
** Fixed a bug where during Active TPB, actors were not showing damage motions. Fix made by Olivia.
** Fixed a bug regarding the in-battle status requiring that the Main Menu Core to be installed when other plugins are also present. Fix by Olivia.
** Fixed a bug where <nowiki><Exclude From Status Listing></nowiki> notetag was not working properly due to a documentation typo of <nowiki><Exclude From Status List></nowiki>. Both notetags should now work. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Added clarity for Plugin Parameters > Party Command Window Settings > Help Window
** Added clarity for Plugin Parameters > Actor Command Window Settings > Help Window
*** The Help Window will only appear for 'Border' and 'Frontview Battle UI' battle layouts.
* New Features!
** New notetag added by Irina:
*** <nowiki><Under></nowiki>
**** If this tag is found in an animation's name, the animation will appear under battlers while in battle.
***** This effect only applies to battlers in the battle scene.
***** Under effect is NOT applied to status window portraits.
***** Under effect is NOT applied to projectile animations.
** Added new Action Sequence Projectile settings:
*** Extra Settings > End Animation ID:
**** Plays an animation when projectile reaches target.

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.27: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.

-

[[Items and Equips Core VisuStella MZ]]

Version 1.57: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different line height settings. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Added extra clarity for <nowiki><Status Info></nowiki> notetag:
*** For clarity regarding "Damage Multiplier" and "HP Recovery"/"HP Damage":
**** "Damage Multiplier" refers to the amount determined by damage formulas.
**** "HP Recovery"/"HP Damage" refers to the "Recover HP" database effect.
**** Likewise, the same will apply to "MP Recovery"/"MP Damage" if the damage formula type is to deal MP recovery/damage instead.
* New Features!
** New Notetags added by Arisu:
*** <nowiki><Status Style: type></nowiki>
**** Changes up the way the shop status window displays data for this database object in particular.
*** <nowiki><Custom Status Parameters: name, name, name></nowiki>
**** Customize which parameters are displayed for this equipment object's shop status window.
* Optimization Update!
** Plugin should run more optimized.

-

'''Tier 2 (11 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.10: January 16, 2025
* Bug Fixes!
** Fixed a bug where certain grid node targeting scopes did not work properly. Fix made by Olivia.
* Compatibility Update!
** Added better compatibility with Battle A.I. regarding scopes.

-

[[Battle System - ATB VisuStella MZ]]

Version 1.33: January 16, 2025
* Bug Fixes!
** Fixed an actor softlock issue where if charm, berserk, and confusion can lock a 100% charged actor for Active ATB.
* Documentation Update!
** Added extra clarification for Plugin Parameter "Stuns Reset Gauge?":
*** Charm, Berserk, and Confusion states will still reset the ATB Gauge.

-

[[Battle System - ETB VisuStella MZ]]

Version 1.10: January 16, 2025
* Bug Fixes!
** Fixed a bug where if the entire party is completely restricted via stun, charm, confusion, or berserk, entire turns would be skipped for both actors and enemies. Fix made by Irina.

-

[[Battle System - FTB VisuStella MZ]]

Version 1.13: January 16, 2025
* Bug Fixes!
** Fixed a bug where if the entire party is completely restricted via stun, charm, confusion, or berserk, entire turns would be skipped for both actors and enemies. Fix made by Irina.

-

[[Battle System - PTB VisuStella MZ]]

Version 1.14: January 16, 2025
* Bug Fixes!
** Fixed a bug where if the entire party is completely restricted via stun, charm, confusion, or berserk, entire turns would be skipped for both actors and enemies. Fix made by Irina.

-

[[Bright Effects VisuStella MZ]]

Version 1.10: January 16, 2025
* Bug Fixes!
** Fixed bug with Tilt Shift effect not applying correctly when exiting a menu upon reentering the map scene. Fix made by Olivia.

-

[[Character Creation System VisuStella MZ]]

Version 1.07: January 16, 2025
* Bug Fixes!
** Fixed an issue where certain icons were not aligning properly at different lineheight settings. Fix made by Olivia.

-

[[Lighting Effects VisuStella MZ]]

Version 1.10: January 16, 2025
* Documentation Update!
** Updated documentation for following notetags:
*** <nowiki><Conical Light Offset: +x, +y></nowiki>
**** Used with the <nowiki><Conical Light Center Offset></nowiki> tag if the Plugin Parameters dictate using hand offsets.
**** As of the v1.10 update of this plugin, the presence of this tag will also automatically include the <nowiki><Conical Light Center Offset></nowiki> tag.
*** <nowiki><Conical Light d Pattern p: +x, +y></nowiki>
**** Used with the <nowiki><Conical Light Hand Offset></nowiki> tag if the Plugin Parameters dictate using non-hand offsets.
**** As of the v1.10 update of this plugin, the presence of this tag will also automatically include the <nowiki><Conical Light Hand Offset></nowiki> tag.
* Feature Update!
** Using <nowiki><Conical Light Offset: +x, +y></nowiki> on an event will automaticaly use the <nowiki><Conical Light Center Offset></nowiki> tag as of this update.
** Using <nowiki><Conical Light d Pattern p: +x, +y></nowiki> on an event will automatically use the <nowiki><Conical Light Hand Offset></nowiki> tag as of this update.

-

[[Picture Choices VisuStella MZ]]

Version 1.01: January 16, 2025
* Documentation Update!
** Help file updated for new features.
* Feature Update!
** Plugin Commands "Picture Settings: Change ID(s)" and "Change Range" are updated to display an error message if On Select and On Deselect settings are the same.
* New Features!
** New Plugin Parameter added by Arisu:
*** Parameters > Same Check
**** Checks to see if On Select and On Deselect settings are the same and pops up an error message.
**** This is to prevent the impression that the plugin is unresponsive when the plugin command settings would have instructions for no change otherwise.

-

[[Skill Learn System VisuStella MZ]]

Version 1.16: January 16, 2025
* Bug Fixes!
** Fixed a compatibility bug that would cause the last skill of a list to be removed from learning. Fix made by Irina.

-

[[Weapon Swap System VisuStella MZ]]

Version 1.13: January 16, 2025
* Bug Fixes!
** Fixed a bug where if an actor does not have any weapons equipped, the "Swap" command will not appear. Fix made by Olivia.

-

'''Tier 3 (6 Plugin Updates)

-

[[Action Sequence Projectiles VisuStella MZ]]

Version 1.09: January 16, 2025
* Documentation Update!
** Help file updated for new features.
** Added new Action Sequence Projectile settings:
*** Extra Settings > End Animation ID:
**** Plays an animation when projectile reaches target.

-

[[Battle AI VisuStella MZ]]

Version 1.28: Version 1.10: January 16, 2025
* Compatibility Update!
** Added better compatibility with Battle Grid System regarding scopes.

-

[[Enemy Levels VisuStella MZ]]

Version 1.06: January 16, 2025
* Bug Fixes!
** Fixed a bug where this plugin would suppress Elements & Status Menu Core trait image properties.
* Documentation Update!
** Added notes for <nowiki><Level x Image: filename></nowiki> and <nowiki><Level Images></nowiki>
*** If using VisuMZ_1_ElementStatusCore and the enemy uses a custom trait- related notetag that alters its battler, this notetag will be suppressed unless it's the original battler name being used.

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.13: January 16, 2025
* Documentation Update!
** Help file updated for new features.
* Bug Fixes!
** Fixed a bug where graphical updates did not update properly for FTB/ETB battle systems. Fix made by Olivia.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > Battle Settings > Damage Offset
*** Parameters > Battle Settings > Damage Offset > Offset X
*** Parameters > Battle Settings > Damage Offset > Offset Y
**** How many pixels to offset the damage popup x/y position?

-

[[New Game Plus VisuStella MZ]]

Version 1.05: January 16, 2025
* Bug Fixes!
** Fixed a bug where New Game+ data did not carry over if the starting party did not have any actors in it. Fix made by Irina.

-

[[State Tooltips VisuStella MZ]]

Version 1.10: January 16, 2025
* Bug Fixes!
** Added a failsafe to prevent crashes from party members that left. Fix made by Olivia.

-







=== December 19, 2024 - Update #144 ===

-

Total Plugins Updated: 13

-

'''Tier 1 (4 Plugin Updates)

-

[[Items and Equips Core VisuStella MZ]]

Version 1.56: December 19, 2024
* Bug Fixes!
** Fixed a bug where newly added equipment would cause crashes upon interaction. Fix made by Irina.

-

[[Message Core VisuStella MZ]]

Version 1.52: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Text Codes added by Arisu:
*** <nowiki><left></nowiki>
*** <nowiki><center></nowiki>
*** <nowiki><right></nowiki>
**** When used in the Map Name, instead of aligning the text which is centered by default, the text code will align the horizontal position of the name displayed on the screen.
*** <nowiki><top></nowiki>
*** <nowiki><middle></nowiki>
*** <nowiki><bottom></nowiki>
**** When used in the Map Name, the text code will align the vertical position of the name displayed on the screen.
*** <nowiki><X: +n></nowiki>
*** <nowiki><X: -n></nowiki>
*** <nowiki><Y: +n></nowiki>
*** <nowiki><Y: -n></nowiki>
**** Adjusts the horizontal/vertical position of map name by 'n' value.
*** All of these text codes require VisuMZ_0_CoreEngine installed and its "Map Name Text Code" plugin parameter enabled.

-

[[Options Core VisuStella MZ]]

Version 1.27: December 19, 2024
* Documentation Update!
** Added new section in help file for "Keyboard/Controller Rebind Settings":
*** Late Retroactive Updating of WASD
**** If you've decided to enable Keyboard/Controller Rebind, decided to enable VisuMZ Core Engine's "WASD Movement" after your project has config.rmmzsave in your project's /save/ folder, then the newly added 'WASD Controls' will NOT be updated retroactively.
**** This can be remedied in one of two ways:
***** 1. Go into your keybindings and add them in manually (arrow keys still retain functionality). You may need to readjust the "Shift Right" option, too.
***** 2. Delete the config.rmmzsave file from /save/ and the game will generate you a new one with the updated "WASD Movement" controls.
**** This retroactive non-update will only affect your players if they've already begun playing your game with a version before "WASD Movement" was enabled and has a config.rmmzsave file already made. Players that are affected by this can just simply update and add the 'WASD controls' on their own.
**** Otherwise, a new player would not experience this at all.

-

[[Skills and States Core VisuStella MZ]]

Version 1.48: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** Auras & Miasmas added by Olivia:
*** Auras are a type passive that affects an allied party. Miasmas are a type of passive that affects an opposing party. Auras and Miasmas only need to come from a single source to give an entire party or troop a passive provided that the battler emitting the aura/miasma is alive and in battle.
** New Notetags added by Olivia:
*** <nowiki><Aura State: x></nowiki>
**** Emits an aura that affects the battler's allies and gives each affected member passive state(s) 'x'.
*** <nowiki><Miasma State: x></nowiki>
**** Emits an aura that affects the battler's opponents and gives each affected member passive state(s) 'x'.
*** <nowiki><Not User Aura></nowiki>
**** Prevents the emitting user from being affected by the related aura.
*** <nowiki><Allow Dead Aura></nowiki>
*** <nowiki><Allow Dead Miasma></nowiki>
**** Allows aura/miasma to continue emitting even after the emitting user is in a dead state.
*** <nowiki><Dead Aura Only></nowiki>
*** <nowiki><Dead Miasma Only></nowiki>
**** Allows aura/miasma to only emit if the emitting user is in a dead state
* Optimization Update!
** Plugin should run more optimized.

[[File:SkillsStatesCore_Aura.png|600px]]

-

'''Tier 2 (5 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.09: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetags added by Olivia:
*** <nowiki><Aura Range: type></nowiki>
*** <nowiki><Miasma Range: type></nowiki>
**** Used together with <nowiki><Aura State: x></nowiki> and <nowiki><Miasma State: x></nowiki> from VisuMZ_1_SkillsStatesCore!
**** Restricts the range in which the aura/miasma passive is emitted from the user.
**** Read the help file for more information.
* Optimization Update!
** Plugin should run more optimized.

-

[[Battle System - ATB VisuStella MZ]]

Version 1.32: December 19, 2024
* Bug Fixes!
** Fixed a few features that bled over into CTB if the game project used both ATB and CTB battle systems simultaneously. Fix made by Olivia.
* Feature Update!
** "Stuns Reset Gauge" set to "Don't Reset" should now work as expected for both actors and enemies, instead of just actors, while they are in the casting state. Update made by Olivia.
* Optimization Update!
** Plugin should run more optimized.

-

[[Class Change System VisuStella MZ]]

Version 1.16: December 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New plugin parameters added by Irina:
*** Parameters > General Settings > Select Same Subclass?
**** Allow selecting the same subclass that's already equipped in that slot?
**** Mostly an aesthetic thing to allow/prevent the same subclass from being selected if that's what you want to control.
*** Parameters > Window Settings > Confirm Animation ID > Play for Unassign?
**** Play animation for unassigning a subclass?
**** Mostly an aesthetic thing to play/not play animations when unassigning a subclass if that's what you want to control.

-

[[Extended Message Functionality VisuStella MZ]]

Version 1.18: December 19, 2024
* Bug Fixes!
** Fixed a bug where if the button console was top positioned and the buttons were hidden, the rest of the text would not readjust. Fix made by Irina.

-

[[Party System VisuStella MZ]]

Version 1.32: December 19, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash upon adding new members if the VisuStella Core Engine wasn't installed. Fix made by Arisu.

-

'''Tier 3 (2 Plugin Updates)

-

[[Action Sequence Camera VisuStella MZ]]

Version 1.15: December 19, 2024
* Compatibility Update!
** Added better support for MV-style animations when used against frontview actors.

-

[[Visual State Effects VisuStella MZ]]

Version 1.23: December 19, 2024
* Documentation Update!
** Updated targets <nowiki><Repeat Animation: x></nowiki> and <nowiki><Repeat Animation Cycle: x></nowiki>.
* Feature Update!
** Expanded database targets for notetags: <nowiki><Repeat Animation: x></nowiki> and <nowiki><Repeat Animation Cycle: x></nowiki>.
*** From State Notetags only to Actor, Class, Skill, Weapon, Armor, Enemy, State Notetags

-

'''Tier 4 (2 Plugin Updates)

-

[[Gab Window VisuStella MZ]]

Version 1.05: December 19, 2024
* Bug Fixes!
** Fixed a bug where attached event gabs did not scale properly with zoom. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
* New Features!
** Added new "Optional Settings" for various Gab Plugin Commands:
*** Sound Volume
*** Sound Pitch
*** Sound Pan
**** Previously, these were not available and defaulted to standard settings used by RPG Maker MZ.

-

[[Map Camera Zoom VisuStella MZ]]

Version 1.07: December 19, 2024
* Compatibility Update!
** Added better compatibility with outside plugins when doing battle transitions. Camera will automatically focus the player if the "Adapt Battle Encounter Ani" is enabled.
** Added better compatibility with VisuMZ's Event Title Scene plugin.

-







=== November 14, 2024 - Update #143 ===

-

Total Plugins Updated: 13

-

'''Tier 1 (1 Plugin Update)

-

[[Items and Equips Core VisuStella MZ]]

Version 1.55: November 14, 2024
* Bug Fixes!
** Fixed a bug where you can no longer attempt to equip an actor with zero equip slots and causing a crash. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
** Updated <Status Info>
*** Used for: Skill, Item, Weapon, Armor Notetags
**** Replace 'key' with one of the following for weapons and armors:
***** 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI', or 'LUK'
***** For those with VisuMZ_0_CoreEngine:
****** 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT', 'HRG', 'MRG', 'TRG'
****** 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR', 'MDR', 'FDR', 'EXR'
**** Only relevant if the Draw Style for equipment is "classic" or "double".
** Updated <Custom Status Info> notetag:
*** Used for: Skill, Item, Weapon, Armor Notetags
**** When used with weapon or armor database objects, this information is only relevant if the Draw Style for equipment is "classic" or "double".
* New Feature!
** New Plugin Parameters:
*** Parameters > Shop Status Window > Data Style:
**** How do you wish to display equipment data?
***** Compare - Compares selected equip to equipped gear
****** Lists all main party actors
****** Displays the parameter differences when equipped
****** Calculates custom JS values
***** Classic - Shows basic parameters of selected equip
***** Double - Shows basic parameters in double columns
****** Involves no actors, only shows the item's stats
****** Shows weapon or armor specific parameters
****** Does not show custom JS values as those are calculated per actor
****** Does not show custom parameters as those are calculated per actor
****** Use <Status Info> and <Custom Status Info> notetags to overwrite or add custom data to classic equip data
**** Data Style > Classic Style:
**** Data Style > Double Style:
***** Added Weapon Params
***** Added Armor Params
****** Display these parameters when a weapon/armor is selected.
****** Requires VisuMZ_0_CoreEngine!

[[File:ItemEquipCore_StatusWindowStyles.png|600px]]

-

'''Tier 2 (5 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.08: November 14, 2024
* Compatibility Update!
** Added better compatibility with Main Menu Core's force show/hide and force enable/disable Plugin Commands for Class, Equip, Skills, and Status commands. Update made by Olivia.

-

[[Battle System - OTB VisuStella MZ]]

Version 1.17: November 14, 2024
* Bug Fixes!
** Fixed a bug where the <OTB Target Follow Turn: +x> and similar notetags altered the following turn regardless of the presence of the target in current turn order. Fix made by Olivia.

-

[[Date and Time System VisuStella MZ]]

Version 1.04: November 14, 2024
* Bug Fixes!
** Fixed a bug where turns were added to each state without using any of the notetag effects. Fix made by Olivia.

-

[[Horror Effects VisuStella MZ]]

Version 1.04: November 14, 2024
* Bug Fixes!
** Fixed a bug where some horror effects would reset upon leaving the screen and/or exiting the menu. Fix made by Olivia.

-

[[Lighting Effects VisuStella MZ]]

Version 1.09: November 14, 2024
* Documentation Update!
** Updated documentation for following notetags:
*** <Radial Light Flash Rate: x%>
*** <Radial Light Flare Rate: x%>
**** To include the following:
***** Must be used with a lower opacity setting.
****** Use with <Radial Light Opacity: x%> notetag.
****** If <Radial Light Opacity: x%> is not used, default to 50%.
*** <Conical Light Flash Rate: x%>
*** <Conical Light Flare Rate: x%>
**** To include the following:
***** Must be used with a lower opacity setting.
****** Use with <Conical Light Opacity: x%> notetag.
****** If <Conical Light Opacity: x%> is not used, default to 50%.
* Feature Updates!
** Notetags for flash/flare rates will now automatically default the opacity level of a light to 50% if the opacity notetag is not present. Update made by Arisu.

-

'''Tier 3 (4 Plugin Updates)

-

[[Battle AI VisuStella MZ]]

Version 1.27: November 14, 2024
* Compatibility Update!
** Added better compatibility with Skill Cooldowns' <Once Per Turn> notetag.

-

[[Evolution Matrix Skills VisuStella MZ]]

Version 1.06: November 14, 2024
* Compatibility Update!
** Added better compatibility between Evolution Matrix Skills and Battle Grid System's targeting for nodes. Update made by Olivia.

-

[[Skill Cooldowns VisuStella MZ]]

Version 1.07: November 14, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New notetag added by Irina:
*** <Once Per Turn>
**** Makes the skill only usable once per turn. Cannot be used in TPB, ATB, or CTB. Does not apply outside of battle.
**** Best used with actors/enemies that perform multiple actions per turn.

-

[[State Tooltips VisuStella MZ]]

Version 1.09: November 14, 2024
* Documentation Update!
** Help file updated for new features.
** Updated <Help Description> notetag documentation:
*** This is used as a common notetag between Battle Core's state descriptions and State Tooltips' state descriptions.
* New Features!
** New Notetag added by Olivia:
*** <State Tooltip Description>
**** A prioritized help description used to separate from the common help description notetag shared with Battle Core's In-Battle Status.

-

'''Tier 4 (3 Plugin Updates)

-

[[Gab Window VisuStella MZ]]

Version 1.04: November 14, 2024
* Documentation Update!
** Added section "Clearing Up Misunderstandings":
*** Gabs are NOT part of the Event List
**** For events with Show Text messages, the game goes through the event list one by one until it reaches the end. This does not apply to Gabs. The Plugin Commands that add Gabs add them into a queue outside of the event list and therefore, any events that may be intended for gabs to be finished will launch immediately unless there are event commands or plugin commands that will cause the event list to wait for them.

-

[[Side Chatter VisuStella MZ]]

Version 1.02: November 14, 2024
* Documentation Update!
** Added section "Clearing Up Misunderstandings":
*** Side chatter is NOT part of the Event List
**** For events with Show Text messages, the game goes through the event list one by one until it reaches the end. This does not apply to side chatter. The Plugin Commands that add side chatter add them into a queue outside of the event list and therefore, any events that may be intended for side chatter to be finished will launch immediately unless there are event commands or plugin commands that will cause the event list to wait for them.
** Help file updated for new features.
* New Features!
** New Plugin Command added by Arisu:
*** Side Chatter: Wait
**** Causes the game to wait until there is no more side chatter.

-

[[Visual Parallaxes VisuStella MZ]]

Version 1.13: November 14, 2024
* Compatibility Update!
** Added reflection compatibility with spawned events.

-







=== October 17, 2024 - Update #142 ===

-

Total Plugins Updated: 18

-

'''Tier 0 (1 Plugin Update)

-

[[Core Engine VisuStella MZ]]

Version 1.85: October 17, 2024
* Feature Updates!
** Updated to fit RPG Maker MZ's updated 1.8.1 version better.

-

'''Tier 1 (4 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.85: October 17, 2024
* Bug Fixes!
** Fixed a bug where the enemy name's visibility would remain after an action has taken place and before inputting is done. Fix made by Olivia.
** Fixed a bug where the "Name Visibility As Target" plugin parameter did not work properly. Fix made by Olivia.
* Documentation Update!
** Help file updated for new features.
** Updated <Help Description> notetag documentation:
*** This is used as a common notetag between Battle Core's state descriptions and State Tooltips' state descriptions.
* New Features!
** New Notetag added by Olivia:
*** <In-Battle Status Description>
**** A prioritized help description used to separate from the common help description notetag shared with State Tooltips.
** New Plugin Parameters added by Olivia:
*** Actor Battlers > Frontview > Portrait Animations > Each Target
*** Actor Battlers > Frontview > Portrait Animations > Center of All
*** Actor Battlers > Frontview > Portrait Animations > Center of Screen
**** Place animations on top or behind for these display types?
*** Battle Log > Action Changes > Show Counter? > Wait Frames
*** Battle Log > Action Changes > Show Reflect? > Wait Frames
*** Battle Log > Action Changes > Show Substitute? > Wait Frames
**** If devs allow the results of counters, reflects, and substitutes, there wasn't enough time before to allow the text to be visible on screen. You can now adjust how many frames are now visible if text is shown.
**** Default values are left at 0 as to not interrupt currently existing action sequences.

-

[[Items and Equips Core VisuStella MZ]]

Version 1.54: October 17, 2024
* Feature Update!
** If "Modern Controls" is selected while "Remove Equip" and "Optimize" are gone from the Equip Menu, right click will exit the menu. Feature added by Arisu.

-

[[Main Menu Core VisuStella MZ]]

Version 1.26: October 17, 2024
* Documentation Update!
** Help file updated for updated features.
* Feature Update!
** Due to conflicts with deployment, the Custom Mouse Cursor has its base location moved from /img/system/ to /icon/.
** Please move the cursor file(s) as well as update the Plugin Parameters.
** Sorry for the inconvenience.

-

[[Message Core VisuStella MZ]]

Version 1.51: October 17, 2024
* Bug Fixes!
** Fixed a bug where \LastGainObj text code did not work with text language key codes. Fix made by Irina.
* Documentation Update!
** Help file updated for new features.
** Added note to Text Language Information > How to Enable Switching
*** IMPORTANT! The separator used for the CSV file must be a semicolon (;) and not a comma (,) as to reduce the amount of punctuation conflicts. Keep this in mind as most CSV editors will default to comma (,) instead of the semicolon (;) for their separator.
** Added note to Text Language Information > Naming Weapon Types, etc:
*** You might have noticed that if you've decided to use \tl{keyName} for weapon or other database types, other parts of the game will error out. Don't worry, for these, you don't have to change the currently used database name. Go straight to the CSV and insert in a new key for that particular database name. For example, the equip type "Accessory" will use "Accessory" as the automatic key to look for a translated phrase. If there isn't any in the CSV file, then the default database text entry will be used.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > Text Language Settings > Language Fonts
**** Different default fonts used for different languages. This allows different stylistic choices to be made for different languages in case the current font you're using doesn't have support for other language types.
**** Keep in mind that players can override this with Options Core if they select a text option other than 'Default' for the 'Text Font' option.
**** Make sure any new custom fonts used for different languages are registered with the 'Custom Font Manager' found in this plugin's Plugin Parameters.
*** Parameters > Text Language Settings > Language Images
**** Allows different images to be used when different languages are used. This is for images that have text on it that you want to appear in different languages based on the text language selected by the player.

-

'''Tier 2 (5 Plugin Updates)

-

[[Battle Grid System VisuStella MZ]]

Version 1.07: October 17, 2024
* Bug Fixes!
** Fixed a bug where switching positions with dead party members using notetag effects would not move the dead member. Fix made by Olivia.
* Documentation Update!
** Fixed the documentation error for <rule Move User Node direction: x> notetag's "Must Switch Mid" rule explanation.
* Optimization Update!
** Plugin should run more optimized.

-

[[Bright Effects VisuStella MZ]]

Version 1.09: October 17, 2024
* Optimization Update!
** Plugin should run more optimized.

-

[[Equip Medal System VisuStella MZ]]

Version 1.05: October 17, 2024
* Bug Fixes!
** If both "Optimize" and "Remove Equipment" are removed from the equipment scene, the Equip Medal Window would lose some modern controls. This is now properly restored. Fix made by Arisu.

-

[[Equipment Set Bonuses VisuStella MZ]]

Version 1.05: October 17, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Notetags added by Arisu:
*** <Equip Set Wildcard>
**** Assigns a wildcard effect for this equipment piece.
**** This will add +1 to every currently equipped equipment set on actor.
**** See help file for more information.
*** <Equip Set Wildcards: name, name, name>
**** Assigns a limited wildcard effect for this equipment piece for specific equipment sets.
**** This will add +1 to every listed limited set that is currently equipped on the actor.
**** See help file for more information.
** New Plugin Parameters added by Arisu:
*** Parameters > Tooltip Settings > Vocabulary > Wildcard Format
*** Parameters > Tooltip Settings > Vocabulary > Wildcard: Any Set
**** See help file for more information.
* Optimization Update!
** Plugin should run more optimized.

[[File:EquipSetBonus_Wildcards.png|600px]]

-

[[Horror Effects VisuStella MZ]]

Version 1.03: October 17, 2024
* Optimization Update!
** Plugin should run more optimized.

-

'''Tier 3 (5 Plugin Updates)

-

[[Action Sequence Camera VisuStella MZ]]

Version 1.14: October 17, 2024
* Optimization Update!
** Plugin should run more optimized.

-

[[Battle Voices VisuStella MZ]]

Version 1.06: October 17, 2024
* Bug Fixes!
** Fixed a bug where "Allow Self Response?" setting was inverted. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Feature!
** New Plugin Parameter added by Irina:
*** Plugin Parameters > Defeat Type
**** When should defeat-related battle voices by played?
***** 0 HP - Plays when target reaches 0 HP the first time.
***** When Collapse - Plays when target performs collapse animation.

-

[[Choice Common Events VisuStella MZ]]

Version 1.02: October 17, 2024
* Optimization Update!
** Plugin should run more optimized.

-

[[Visual Cutin Effect VisuStella MZ]]

Version 1.01: October 17, 2024
* Bug Fixes!
** Fixed a crash where clearing cutins under certain conditions would cause an error. Fix made by Arisu.

-

[[Visual State Effects VisuStella MZ]]

Version 1.22: October 17, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Plugin Parameters > Response Popup Settings
**** Popup settings for response-type state effects (ie Counter, Reflect, Substitute).
**** See help file for more information.

-

'''Tier 4 (3 Plugin Updates)

-

[[Combat Log VisuStella MZ]]

Version 1.14: October 17, 2024
* Compatibility Update!
** Plugin should be more compatible with Battle System - OTB.

-

[[Map Camera Zoom VisuStella MZ]]

Version 1.06: October 17, 2024
* Compatibility Update!
** Added better compatibility with Visual Parallaxes when using plugin commands to focus scroll.

-

[[Multi-Layer HP Gauge VisuStella MZ]]

Version 1.05: October 17, 2024
* Compatibility Update!
** Added better compatibility with In-Battle Status feature for Battle Core as to not cover up the window.

-







=== September 19, 2024 - Update #141 ===

-

Total Plugins Updated: 9

-

'''Tier 1 (3 Plugin Updates)

-

[[Battle Core VisuStella MZ]]

Version 1.84: September 19, 2024
* Bug Fixes!
** Fixed a bug where Action Sequence "MOVE: Change Home By Distance" would also be affected by the actor and enemy position offsets. Fixed by Irina.
** Fixed a bug where Action Sequence "MECH: STB Exploit Effect" caused a crash. Fix made by Arisu.
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Command added by Arisu:
*** ANIM: Change Battle Portrait (JS)
**** Changes the battle portrait of the actor through JavaScript.
**** Can be used outside of battle/action sequences.
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > In-Battle Status Window
**** This new window allows the player to view the status of the current active party. If the actors have states and buffs, the player can scroll through them and read about their effects through the help window.
** New Notetags added by Olivia:
*** <Help Description>
**** Assigns a help description for the state that's displayed under the new "Status" actor command.
*** <Exclude From Status Listing>
**** Excludes the state from being displayed in the status listing.
*** <Aspect Name: x>
*** <Aspect Icon: x>
*** <Aspect Color: x>
*** <Aspect Description>
**** Used to define enemy aspect that will show up in the In-Battle Status as well as other supported plugins.
*** <Popup Position: Head>
*** <Popup Position: Center>
*** <Popup Position: Base>
**** Changes the popup starting position for this enemy.
*** <Popup Offset X: +x>
*** <Popup Offset X: -x>
*** <Popup Offset Y: +y>
*** <Popup Offset Y: -y>
**** Changes the popup X/Y position offset for this enemy.
** New Plugin Parameters added by Olivia:
*** Plugin Parameters > Party Command Window > Add Status?
**** Add the "Status" command to the Command Window?
*** Plugin Parameters > Actor Command Window > Command List
**** Updated to have the "Status" command.
*** Plugin Parameters > In-Battle Status Window
**** Completely new! View the help file for more information.
*** Plugin Parameters > Enemy > Aspects
**** Used for the In-Battle Status as well as other supported plugins.

[[File:BattleCore_InBattleStatus1.png|600px]]

[[File:BattleCore_InBattleStatus2.png|600px]]

-

[[Elements and Status Menu Core VisuStella MZ]]

Version 1.26: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameter added by Olivia:
*** Parameters > Element Rulings > Reflect-Element Ruling
**** Ruling on how element reflect is handled for multi-elements.
***** All (All elements must be Reflected)
***** Any (Only one element must be Reflected)
** New Notetag added by Olivia:
*** <Element Reflect Rule: All>
**** Makes this skill/item require all of the action's elements to be considered "reflected" in order for this action to be actually reflected.
*** <Element Reflect Rule: All>
**** Makes this skill/item require only one of action's element to be considered "reflected" in order for this action to be actually reflected.

-

[[Main Menu Core VisuStella MZ]]

Version 1.25: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Custom Mouse Cursor
**** Add/enable a custom mouse cursor for your game.

[[File:MainMenuCore_CustomCursor.gif]]

-

'''Tier 2 (2 Plugin Updates)

-

[[Battle System - OTB VisuStella MZ]]

Version 1.16: September 19, 2024
* Compatibility Update!
** Added better compatibility with Auto Skill Triggers. Update by Arisu.

-

[[Bestiary VisuStella MZ]]

Version 1.06: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Olivia:
*** Parameters > Window Settings > Skills Window > Show Aspects
*** Parameters > Window Settings > Skills Window > Show Passives
**** Show enemy aspect/passives if available?
**** Requires VisuMZ_1_BattleCore/VisuMZ_1_SkillsStatesCore!

-

'''Tier 3 (3 Plugin Updates)

-

[[Frontview Battle UI VisuStella MZ]]

Version 1.12: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Parameters added by Arisu:
*** Parameters > Window Settings > Window Widths > Command Windows
*** Parameters > Window Settings > Window Widths > Action Windows
**** Type in the numeric value you want this width to be.
**** Otherwise, type "auto" to let the plugin adjust them.

-

[[State Tooltips VisuStella MZ]]

Version 1.08: September 19, 2024
* Documentation Update!
** Help file updated for new features.
* New Features!
** Keyboard-Select Show added by Arisu.
*** This allows showing enemy tooltips when selecting targets during battle while using the keyboard. Tooltip will appear after a brief pause while selecting the enemy.
** New Plugin Parameters added by Arisu:
*** Parameters > Tooltip Settings > Appearance > Centered?
**** Center the state tooltip when shown through hovering?
*** Parameters > Tooltip Settings > Keyboard-Select Show
**** See help file for more information.
*** Parameters > Vocabulary > Entries > Enemy Aspect Format
**** Used to support the Battle Core's new Enemy Aspect feature.

-

[[Steal Items VisuStella MZ]]

Version 1.09: September 19, 2024
* Compatibility Update!
** Added better compatibility with Frontview Battle UI.

-

'''Tier 4 (1 Plugin Update)

-

[[Encounter Effects VisuStella MZ]]

Version 1.11: September 19, 2024
* Documentation Update!
** Help file updated for new features.
** Added new section in Major Features section for new Battle Transitions.
* New Features!
** New Plugin Parameters added by Irina:
*** Parameters > Default Battle Transition
**** Select the default battle transition (10 new ones, 1 MZ original).
*** Parameters > Default Battle Transition > Duration
**** What is the duration of every battle transition in frames?
*** Parameters > Default Battle Transition > Random List
**** Pick battle transition types used for "random".
** New Plugin Commands added by Irina:
*** Battle Transition: Change Type
**** Changes the battle transition type.
*** Battle Transition: Duration
**** Changes the battle transition duration.

[[File:EncEffect_Abberation.gif]]

[[File:EncEffect_Glitch.gif]]

[[File:EncEffect_Static.gif]]

[[File:EncEffect_Twirl.gif]]

[[File:EncEffect_Warp.gif]]

-