Core Engine VisuStella MZ

From Yanfly.moe Wiki
Jump to navigation Jump to search

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


Contents


Download

System

This is a plugin created for RPG Maker MZ.

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


UpdatePlugins.png

Click here to learn how to update plugins.


Troubleshooting.jpg

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



CoreEnginePluginMenuAssist.png CoreEnginePluginMenuBg.png
CoreEnginePluginTitleButtons.png CoreEnginePluginGold.png

Extension Plugins

The following plugins are Extension Plugins that require this plugin as its Parent Plugin.

Place the following plugins below this plugin located in the Plugin Manager if you plan on using them.


VisuStella MZ

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


Support VisuStella

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


Introduction

The Core Engine plugin is designed to fix any bugs that may have slipped past RPG Maker MZ's source code and to give game devs more control over RPG Maker MZ's various features, ranging from mechanics to aesthetics to quality of life improvements.

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

  • Bug fixes for the problems existing in the RPG Maker MZ base code.
  • Failsafes added for Script Call related event commands.
  • Lots of Quality of Life Settings that can be activated through the Plugin Parameters.
  • Control over the various Text Colors used throughout the game.
  • Change up the maximum amount of gold carried, give it an icon attached to the label, and include text for overlap specifics.
  • Preload images as the game boots up.
  • Add specific background images for menus found throughout the game.
  • A button assist window will appear at the top or bottom of the screen, detailing which buttons do what when inside a menu. This feature can be turned off.
  • Choose which in-game battler parameters to display inside menus (ie ATK, DEF, AGI, etc.) and determine their maximum values, along with plenty of notetags to give more control over parameter, x-parameter, s-parameter bonuses through equipment, states, and other trait objects.
  • Control over how the UI objects appear (such as the menu button, cancel button, left/right actor switch buttons).
  • Reposition actors and enemies if the battle resolution is larger.
  • Allow class names and nicknames to support text codes when displayed.
  • Determine how windows behave in the game, if they will mask other windows, their line height properties, and more.

Requirements

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


Tier 0

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

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


Important Changes: Bug Fixes

This plugin also serves to fix various bugs found in RPG Maker MZ that have been unaddressed or not yet taken care of. The following is a list of bugs that have been fixed by this plugin:

---

Attack Skill Trait

Enemies are unaffected by the Attack Skill Trait. This means if they have an Attack action, they will always use Attack over and over even if their Attack Skill Trait has been changed. This plugin will change it up so that the Attack skill will comply with whatever their Attack Skill Trait's skill is set to.

---

Auto Battle Actor Skill Usage

If an actor with Auto Battle has access to a skill but not have any access to that skill's type, that actor will still be able to use the skill during Auto Battle despite the fact that the actor cannot use that skill during manual input.

---

Auto Battle Lock Up

CoreEngine AutoBattleLockUp.png

If an auto battle Actor fights against an enemy whose DEF/MDF is too high, they will not use any actions at all. This can cause potential game freezing and softlocks. This plugin will change that and have them default to a regular Attack.

---

Gamepad Repeat Input

Cleared inputs on gamepads do not have a downtime and will trigger the following input frame. The causes problems with certain RPG Maker MZ menus where the inputs have to be cleared as the next immediate frame will have them inputted again. This plugin changes it so that whenever inputs are cleared, there is a downtime equal to the keyboard clear frames before the gamepad input is registered once more.

---

Invisible Battle Sprites

CoreEngine InvisibleBattlerBug.png

If you removed a party member during battle and added that exact party member back into the same slot, their sprite would appear invisible. The VisuStella Core Engine will fix this problem and prevent it from happening.

---

Instant Text Discrepancy for Window_Message

CoreEngine InstantTextBug.png

Window_Message displays text differently when it draws letters one by one versus when the text is displayed instantly. This isn't noticeable with the default font, but it's very visible when using something like Arial. The error is due to Bitmap.measureTextWidth yielding a rounded value per letter versus per word. The Core Engine will provide a bug fix that will single out the cause and make it so that only Window_Message will not utilize any round number values when determining the width of each letter, whether or not it is shown instantly. This change will only affect Window_Message and not any other window in order to prevent unintended side effects.

Plugin Parameters > QoL Settings > Misc > Font Width Fix

Move Picture, Origin Differences

If a Show Picture event command is made with an Origin setting of "Upper Left" and a Move Picture event command is made afterwards with an Origin setting of "Center", RPG Maker MZ would originally have it instantly jump into the new origin setting without making a clean transition between them. This plugin will create that clean transition between origins.

---

Termination Clear Effects

In RPG Maker MZ, requesting an animation while transitioning between scenes, such as going from the map scene to the battle scene, can cause crashes. This is because the animation queue does not take off immediately and will likely register incorrect targets for the scene. This plugin will forcefully clear any registered animations and balloon effects when terminating a scene in order to prevent crashes.

---

Timer Sprite

By default, RPG Maker MZ adds Sprite_Timer into its spriteset, either for maps or for battles. There is one major problem with this: when spritesets are affected by filters, zooms, and/or blurs, this hinders how readable the timer sprite is, making the information perceived by the player to be much harder than it needs to be. The Core Engine adds the sprite to the parent scene instead of the spriteset to ensure it's unobscured by anything else.

---

Unusable Battle Items

If any party member is able to use an item in battle, then all party members are able to use said item, even if that party member is supposed to be unable to use that item. This is now changed so that battle items are checked on an individual basis and not on a party-wide basis.

---

Window Arrows Sprite Tearing

If a window object in RPG Maker MZ were to have an odd number for width size then the arrow elements found for the window would be positioned on a half pixel, giving it a blurry look and also have sprite tearing issues. This is now fixed by rounding the number to the nearest whole number.

---

Window Client Area Scaling Bug

If the window has a scale value different from 1.0, the client area (the interactable parts) will not scale properly and appear clipped out. This is now fixed by adjusting the client area to the window's scale values and rounding upward to the nearest whole number.

---

Window Skin Bleeding

CoreEngineWindowSkinBleeding.png

This bug is fixed in the core scripts for RPG Maker MZ v1.3.0+.

Since the v1.2.0 update, Window.prototype._refreshBack's frame value has been set from 96 to 95. This results in the window skin bleeding past the window's intended borders. The Core Engine now reverts this change to prevent the bleeding effect from happening.

---

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.

---

Scroll-Linked Pictures

If a Parallax has a ! at the start of its filename, it is bound to the map scrolling. The same thing now happens with pictures. If a Picture has a ! at the start of its filename, it is bound to the map's scrolling as well.

---

Movement Route Scripts

If code in a Movement Route Script command fails, instead of crashing the game, it will now act as if nothing happened except to display the cause of the error inside the console.

---

Script Call Failsafes

If code found in Conditional Branches, Control Variables, and/or Script Calls fail to activate, instead of crashing the game, it will now act as if nothing happened except to display the cause of the error inside the console.

---

Digit Grouping

- There exists an option to change how numbers are displayed and converted in your game. This option can be enabled or disabled by going into the Plugin Manager > VisuMZ_0_OptionsCore > Quality of Life Settings > Digit Grouping and toggling on/off whichever ones you want.

- Digit Grouping will follow the rules of whatever country/locale the Plugin Parameters are set to. If it's to default 'en-US', then 1234567.123456 will become 1,234,567.123456. Set it to 'es-ES' and it becomes 1.234.567,123456 instead.

- This uses JavaScript's Number.toLocaleString() function and will therefore follow whatever rules it has. This means if there are trailing zeroes at the end of a decimal, it will cut them off. Numbers like 123.45000 will become 123.45 instead. Excess numbers past 6 decimal places will be rounded. A number like 0.123456789 will become 0.123457 instead.

- Numbers in between [ and ], < and > will be excluded from digit grouping in order for text codes to be preserved accurately. \I[1234] will remain as \I[1234].

- If you would like to enter in a number without digit grouping, surround it with {{ and }}. Typing in {{1234567890}} will yield 1234567890.

---

Show Scrolling Text, additional functionality

CoreEngine Update25 Feature1.png

The event command "Show Scrolling Text" now has additional functionality as long as the VisuStella MZ Core Engine is installed. If the game dev inserts "// Script Call" (without the quotes) inside the scrolling text, then the entirity of the Show Scrolling Text event command will be ran as a giant script call event command.

The reason why this functionality is added is because the "Script..." event command contains only 12 lines maximum. This means for any script call larger than 12 lines of code cannot be done by normal means as each script call is ran as a separate instance.

By repurposing the "Show Scrolling Text" event command to be able to function as an extended "Script..." event command, such a thing is now possible with less hassle and more lines to code with.

This effect does not occur if the Show Scrolling Text event command does not have "// Script Call" in its contents.

---

Notetags

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. 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 Notetag(s) that you may use.


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.

Actors

Parameter limits can be adjusted in the Plugin Parameters, but this won't lift the ability to change the values of an actor's initial or max level past the editor's limits. Instead, this must be done through the usage of notetags to accomplish the feat.

---

<Max Level: x>

- Used for: Actor Notetags
- Replace 'x' with an integer to determine the actor's max level.
- This allows you to go over the database limit of 99.
- If this notetag isn't used, default to the actor's database value.

---

<Initial Level: x>

- Used for: Actor Notetags
- Replace 'x' with an integer to determine the actor's initial level.
- This allows you to go over the database limit of 99.
- If this notetag isn't used, default to the actor's database value.

---

Classes

As actor levels can now surpass 99 due to the notetag system, there may be some skills you wish certain classes can learn upon reaching higher levels past 99, too.

---

<Learn At Level: x>

- Used for: Class Skill Learn Notetags
- Replace 'x' with an integer to determine the level this class will learn
  the associated skill at.
- This allows you to go over the database limit of 99.
- If this notetag isn't used, default to the class's database value.

---

Enemies

Enemies are now given levels. The levels don't do anything except to serve as a container for a number value. This way, levels can be used in damage formulas (ie. a.atk - b.level) without causing any errors. To give enemies levels, use the notetags below. These notetags also allow you to adjust the base parameters, EXP, and Gold past the database limitations.

---

<Level: x>

- Used for: Enemy Notetags
- Replace 'x' with an integer to determine the enemy's level.
- If no level is declared, the level will default to 1.

---

<param: x>

- Used for: Enemy Notetags
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to alter.
  - This notetag does NOT work with X Parameters, S Parameters, or any
    custom parameters. This notetag ONLY works with the base parameters.
- Replace 'x' with an integer to set an enemy's 'param' base value.
- This will overwrite the enemy's database value and can exceed the original
  value limitation in the database.
- If these notetags aren't used, default to the enemy's database value.

---

<EXP: x>
<Gold: x>

- Used for: Enemy Notetags
- Replace 'x' with an integer to determine the enemy's EXP or Gold values.
- This will overwrite the enemy's database value and can exceed the original
  value limitation in the database.
- If these notetags aren't used, default to the enemy's database value.

---

Animations

CoreEngineAnimationNotetags.png

Animations in RPG Maker MZ are done by Effekseer and the animation system has been revamped. However, the animations are only centered on the targets now, and cannot be attached to the head or foot. Insert these tags into the names of the animations in the database to adjust their positions.

---

<Head>
<Foot>

- Used for: Animation Name Tags
- Will set the animation to anchor on top of the sprite (if <Head> is used)
  or at the bottom of the sprite (if <Foot> is used).

---

<Anchor X: x>
<Anchor Y: y>

<Anchor: x, y>

- Used for: Animation Name Tags
- Will anchor the animation at a specific point within the sprite based on
  the 'x' and 'y' values.
- Replace 'x' and 'y' with numeric values representing their positions based
  on a rate where 0.0 is the furthest left/up (x, y respectively) to 1.0 for
  the furthest right/down (x, y respectively).

Examples:

<Anchor X: 0.4>
<Anchor Y: 0.8>

<Anchor: 0.2, 0.9>

---

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

<Offset: +x, +y>
<Offset: -x, -y>

- Used for: Animation Name Tags
- Will anchor the animation to be offset by an exact number of pixels.
- This does the same the editor does, except it lets you input values
  greater than 999 and lower than -999.
- Replace 'x' and 'y' with numeric values the exact number of pixels to
  offset the animation's x and y coordinates by.

Examples:

<Offset X: +20>
<Offset Y: -50>

<Offset: +10, -30>

---

<Mirror Offset X>
<No Mirror Offset X>

- Used for: Animation Name Tags
- If an animation is mirrored, you can choose to have the animation's Offset
  X value be mirrored, too (or not at all).
- If no name tag is discovered, this will use the setting found in the
  Plugin Parameters > QoL Settings > Misc > Ani: Mirror Offset X setting.

---

Quality of Life

By default, RPG Maker MZ does not offer an encounter step minimum after a random encounter has finished. This means that one step immediately after finishing a battle, the player can immediately enter another battle. The Quality of Life improvement: Minimum Encounter Steps allows you to set a buffer range between battles for the player to have some breathing room.

---

<Minimum Encounter Steps: x>

- Used for: Map Notetags
- Replace 'x' with the minimum number of steps before the player enters a
  random encounter on that map.
- If this notetag is not used, then the minimum encounter steps for the map
  will default to Quality of Life Settings => Encounter Rate Min.

---

Tile shadows are automatically added to certain tiles in the map editor. These tile shadows may or may not fit some types of maps. You can turn them on/off with the Quality of Life Plugin Parameters or you can override the settings with the following notetags:

<Show Tile Shadows>
<Hide Tile Shadows>

- Used for: Map Notetags
- Use the respective notetag for the function you wish to achieve.
- If this notetag is not used, then the tileset shadow settings for the map
  will default to Quality of Life Settings => No Tile Shadows.

---

Basic, X, and S Parameters

A battler's parameters, or stats as some devs know them as, are the values that determine how a battler performs. These settings allow you to alter behaviors and give boosts to trait objects in a more controlled manner.

---

<param Plus: +x>
<param Plus: -x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Adds or subtracts 'x' to 'param' plus value when calculating totals.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to modify.
- Replace 'x' with an integer on how much to adjust the parameter by.
- This is used to calculate the 'plus' portion in the Parameter Settings =>
  Basic Parameter => Formula.

---

<param Rate: x%>
<param Rate: x.x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Changes 'param' rate to 'x' to alter the total 'param' value.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to modify.
- Replace 'x' with a percentage (ie. 150%) or a rate (ie. 1.5).
- This is used to calculate the 'paramRate' portion in Parameter Settings =>
  Basic Parameter => Formula.

---

<param Flat: +x>
<param Flat: -x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Adds or subtracts 'x' to 'param' plus value when calculating totals.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to modify.
- Replace 'x' with an integer on how much to adjust the parameter by.
- This is used to calculate the 'flatBonus' portion in Parameter Settings =>
  Basic Parameter => Formula.

---

<param Max: x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Sets max caps for the 'param' to be 'x'. If there are multiple max caps
  available to the unit, then the highest will be selected.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to modify.
- Replace 'x' with an integer to determine what the max cap should be.

---

<xparam Plus: +x%>
<xparam Plus: -x%>

<xparam Plus: +x.x>
<xparam Plus: -x.x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Adds or subtracts 'x' to 'xparam' plus value when calculating totals.
- Replace 'xparam' with 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT',
  'HRG', 'MRG', 'TRG' to determine which X parameter to modify.
- Replace 'x' with a percentage (ie. 150%) or a rate (ie. 1.5).
- This is used to calculate the 'plus' portion in the Parameter Settings =>
  X Parameter => Formula.

---

<xparam Rate: x%>
<xparam Rate: x.x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Changes 'param' rate to 'x' to alter the total 'xparam' value.
- Replace 'xparam' with 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT',
  'HRG', 'MRG', 'TRG' to determine which X parameter to modify.
- Replace 'x' with a percentage (ie. 150%) or a rate (ie. 1.5).
- This is used to calculate the 'paramRate' portion in Parameter Settings =>
  X Parameter => Formula.

---

<xparam Flat: +x%>
<xparam Flat: -x%>

<xparam Flat: +x.x>
<xparam Flat: -x.x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Adds or subtracts 'x' to 'xparam' plus value when calculating totals.
- Replace 'xparam' with 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT',
  'HRG', 'MRG', 'TRG' to determine which X parameter to modify.
- Replace 'x' with a percentage (ie. 150%) or a rate (ie. 1.5).
- This is used to calculate the 'flatBonus' portion in Parameter Settings =>
  X Parameter => Formula.

---

<sparam Plus: +x%>
<sparam Plus: -x%>

<sparam Plus: +x.x>
<sparam Plus: -x.x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Adds or subtracts 'x' to 'sparam' plus value when calculating totals.
- Replace 'sparam' with 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR',
  'MDR', 'FDR', 'EXR' to determine which S parameter to modify.
- Replace 'x' with a percentage (ie. 150%) or a rate (ie. 1.5).
- This is used to calculate the 'plus' portion in the Parameter Settings =>
  S Parameter => Formula.

---

<sparam Rate: x%>
<sparam Rate: x.x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Changes 'param' rate to 'x' to alter the total 'sparam' value.
- Replace 'sparam' with 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR',
  'MDR', 'FDR', 'EXR' to determine which S parameter to modify.
- Replace 'x' with a percentage (ie. 150%) or a rate (ie. 1.5).
- This is used to calculate the 'paramRate' portion in Parameter Settings =>
  S Parameter => Formula.

---

<sparam Flat: +x%>
<sparam Flat: -x%>

<sparam Flat: +x.x>
<sparam Flat: -x.x>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Adds or subtracts 'x' to 'sparam' plus value when calculating totals.
- Replace 'sparam' with 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR',
  'MDR', 'FDR', 'EXR' to determine which S parameter to modify.
- Replace 'x' with a percentage (ie. 150%) or a rate (ie. 1.5).
- This is used to calculate the 'flatBonus' portion in Parameter Settings =>
  S Parameter => Formula.

---

JavaScript Notetags: Basic, X, and S Parameters

The following are notetags made for users with JavaScript knowledge. These notetags are primarily aimed at Basic, X, and S Parameters.

---

<JS param Plus: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'param' plus value.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  plus amount for the parameter's total calculation.
- This is used to calculate the 'plus' portion in the Parameter Settings =>
  Basic Parameter => Formula.

---

<JS param Rate: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'param' rate value.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  param rate amount for the parameter's total calculation.
- This is used to calculate the 'paramRate' portion in Parameter Settings =>
  Basic Parameter => Formula.

---

<JS param Flat: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'param' flat value.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  flat bonus amount for the parameter's total calculation.
- This is used to calculate the 'flatBonus' portion in Parameter Settings =>
  Basic Parameter => Formula.

---

<JS param Max: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to determine what the max cap for 'param' should be. If there
  are multiple max caps available to the unit, then the highest is selected.
- Replace 'param' with 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI',
  or 'LUK' to determine which parameter to modify.
- Replace 'code' with JavaScript code to determine the max cap for the
  desired parameter.

---

<JS xparam Plus: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'xparam' plus value.
- Replace 'xparam' with 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT',
  'HRG', 'MRG', 'TRG' to determine which X parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  plus amount for the X parameter's total calculation.
- This is used to calculate the 'plus' portion in the Parameter Settings =>
  X Parameter => Formula.

---

<JS xparam Rate: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'xparam' rate value.
- Replace 'xparam' with 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT',
  'HRG', 'MRG', 'TRG' to determine which X parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  param rate amount for the X parameter's total calculation.
- This is used to calculate the 'paramRate' portion in Parameter Settings =>
  X Parameter => Formula.

---

<JS xparam Flat: code>
- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'xparam' flat value.
- Replace 'xparam' with 'HIT', 'EVA', 'CRI', 'CEV', 'MEV', 'MRF', 'CNT',
  'HRG', 'MRG', 'TRG' to determine which X parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  flat bonus amount for the X parameter's total calculation.
- This is used to calculate the 'flatBonus' portion in Parameter Settings =>
  X Parameter => Formula.

---

<JS sparam Plus: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'sparam' plus value.
- Replace 'sparam' with 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR',
  'MDR', 'FDR', 'EXR' to determine which S parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  plus amount for the S parameter's total calculation.
- This is used to calculate the 'plus' portion in the Parameter Settings =>
  S Parameter => Formula.

---

<JS sparam Rate: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'sparam' rate value.
- Replace 'sparam' with 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR',
  'MDR', 'FDR', 'EXR' to determine which S parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  param rate amount for the S parameter's total calculation.
- This is used to calculate the 'paramRate' portion in Parameter Settings =>
  S Parameter => Formula.

---

<JS sparam Flat: code>

- Used for: Actor, Class, Weapon, Armor, Enemy, State Notetags
- Runs 'code' to change the 'sparam' flat value.
- Replace 'sparam' with 'TGR', 'GRD', 'REC', 'PHA', 'MCR', 'TCR', 'PDR',
  'MDR', 'FDR', 'EXR' to determine which S parameter to modify.
- Replace 'code' with JavaScript code to determine how much to change the
  flat bonus amount for the S parameter's total calculation.
- This is used to calculate the 'flatBonus' portion in Parameter Settings =>
  S Parameter => Formula.

---

Battle Setting-Related Notetags

These tags will change the settings for battle regardless of how the battle system is 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.

---

<FV>
<Front View>
<Battle View: FV>
<Battle View: Front View>

- Used for: Map Notetags, Troop Name Tags, and Troop Comment Tags
- Changes the perspective of battle to front view for this specific map or
  battle.
- Make sure you have the enemy image files available in the img/enemies/
  folder as they will used instead of the "sv_enemies" graphics.
- 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.

---

<SV>
<Side View>
<Battle View: SV>
<Battle View: Side View>

- Used for: Map Notetags, Troop Name Tags, and Troop Comment Tags
- Changes the perspective of battle to side view for this specific map or
  battle.
- Make sure you have the enemy image files available in the img/sv_enemies/
  folder as they will used instead of the "enemies" graphics.
- Make sure your actors have "sv_actor" graphics attached to them.
- 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.

---

<DTB>
<Battle System: DTB>

- Used for: Map Notetags, Troop Name Tags, and Troop Comment Tags
- Changes the battle system to the default battle system (DTB).
- 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.

---

<TPB Active>
<ATB Active>
<Battle System: TPB Active>
<Battle System: ATB Active>

<TPB Wait>
<ATB Wait>
<Battle System: TPB Wait>
<Battle System: ATB Wait>

- Used for: Map Notetags, Troop Name Tags, and Troop Comment Tags
- Changes the battle system to the time progress battle system (TPB) or
  active turn battle system (ATB) if you have VisuMZ_2_BattleSystemATB
  installed for the game project.
- 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.

---

<BTB>
<Battle System: BTB>

<CTB>
<Battle System: CTB>

<ETB>
<Battle System: ETB>

<FTB>
<Battle System: FTB>

<OTB>
<Battle System: OTB>

<PTB>
<Battle System: PTB>

<STB>
<Battle System: STB>

- Used for: Map Notetags, Troop Name Tags, and Troop Comment Tags
- Changes the battle system to the respective battle system as long as you
  have those plugins installed in the current project.
- 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.

---

Plugin Commands

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

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

---


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

---

Animation Commands

CoreEngine PointAni.gif

CoreEngine Update53 Command1.png

Animation: Play at Coordinate
- Plays an animation on the screen at a specific x, y coordinate even if
  there is no sprite attached.

  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?

---

Export Plugin Commands

CoreEngine Update39 Command1.png

---

Export: All Maps Text
- PLAY TEST ONLY. Exports all of the text from all maps,
  their events, event pages, and any associated Common Events.

  - Exports 'Show Text' event commands.
  - Exports 'Show Choices' event commands.
  - Exports 'Show Scrolling Text' event commands.
  - Exports 'Comments' event commands.
  - Only the raw text will be exported.
  - Only usable during Play Test.

---

Export: All Troops Text
- PLAY TEST ONLY. Exports all of the text from all troops,
  their event pages, and any associated Common Events.

  - Exports 'Show Text' event commands.
  - Exports 'Show Choices' event commands.
  - Exports 'Show Scrolling Text' event commands.
  - Exports 'Comments' event commands.
  - Only the raw text will be exported.
  - Only usable during Play Test.

---

Export: Current Map Text
- PLAY TEST ONLY. Exports all of the text on the current map,
  its events, the event pages, and any associated Common Events.

  - Exports 'Show Text' event commands.
  - Exports 'Show Choices' event commands.
  - Exports 'Show Scrolling Text' event commands.
  - Exports 'Comments' event commands.
  - Only the raw text will be exported.
  - Only usable during Play Test.
  - If not in battle, this Plugin Command will not work.

---

Export: Current Troop Text
- PLAY TEST ONLY. Exports all of the text on the current troop,
  the troop's event pages, and any associated Common Events.

  - Exports 'Show Text' event commands.
  - Exports 'Show Choices' event commands.
  - Exports 'Show Scrolling Text' event commands.
  - Exports 'Comments' event commands.
  - Only the raw text will be exported.
  - Only usable during Play Test.
  - If not in battle, this Plugin Command will not work.

---

Game Plugin Commands

---

CoreEnginePluginCommand01.png

Game: Open URL
- Opens a website URL from the game.

  URL:
  - Where do you want to take the player?

---

Gold Plugin Commands

---

CoreEnginePluginCommand02.png

Gold: Gain/Lose
- Allows you to give/take more gold than the event editor limit.

  Value:
  - How much gold should the player gain/lose?
  - Use negative values to remove gold.

---

Picture Plugin Commands

---

CoreEngine PictureCoordinates2.gif

Picture: Coordinates Mode
- Play Test Mode only! Gets the coordinates of a specific picture as you
  move it across the screen.

  Picture ID:
  - The ID of the pictures to track the coordinates of.

---

CoreEnginePluginCommand03.png

CoreEnginePluginCommand03a.png

Picture: Easing Type
- Changes the easing type to a number of options.

  Picture ID:
  - Which picture do you wish to apply this easing to?

  Easing Type:
  - Select which easing type you wish to apply.

  Instructions:
  - Insert this Plugin Command after a "Move Picture" event command.
  - Turn off "Wait for Completion" in the "Move Picture" event.
  - You may have to add in your own "Wait" event command after.

---

CoreEngine Update43 Command2.png

Picture: Erase All
- Erases all pictures on the screen because it's extremely tedious to do it
  one by one.

---

CoreEngine Update43 Command3.png

Picture: Erase Range
- Erases all pictures within a range of numbers because it's extremely
  tedious to do it one by one.

  Starting ID:
  - The starting ID of the pictures to erase.

  Ending ID:
  - The ending ID of the pictures to erase.

---

CoreEngine Update43 Command1.png

CoreEngine Update43 Command1 Ani2.gif

Picture: Show Icon
- Shows an icon instead of a picture image.
- The picture icon can be controlled like any other picture.

  General:

    Picture ID Number:
    - What is the ID of the picture you wish to show at?
    - Use a number between 1 and 100.
    - You may use JavaScript code.

    Icon Index:
    - Select the icon index to use for this picture.
    - You may use JavaScript code.

    Smooth Icon?:
    - This will make the icon smoothed out or pixelated.

  Picture Settings:

    Position:

      Origin:
      - What is the origin of this picture icon?
        - Upper Left
        - Center

      Position X:
      - X coordinate of the picture.
      - You may use JavaScript code.

      Position Y:
      - Y coordinate of the picture.
      - You may use JavaScript code.

    Scale:

      Width %:
      - Horizontal scale of the picture.
      - You may use JavaScript code.
      - 100 is 100%

      Height %:
      - Vertical scale of the picture.
      - You may use JavaScript code.
      - 100 is 100%

    Blend:

      Opacity:
      - Insert a number to determine opacity level.
      - Use a number between 0 and 255.
      - You may use JavaScript code.

      Blend Mode:
      - What kind of blend mode do you wish to apply to the picture?

---

Screen Shake Plugin Commands

---

CoreEngineCommandScreenShake.png

Screen Shake: Custom:
- Creates a custom screen shake effect and also sets the following uses of
  screen shake to this style.

  Shake Style:
  - Select shake style type.
  - Original
  - Random
  - Horizontal
  - Vertical

  Power:
  - Power level for screen shake.

  Speed:
  - Speed level for screen shake.

  Duration:
  - Duration of screenshake.
  - You can use code as well.

  Wait for Completion:
  - Wait until completion before moving onto the next event?

---

Switch Plugin Commands

---

Switches: Randomize ID(s)
- Select specific Switch ID's to randomize ON/OFF.

  Switch ID(s):
  - Select which Switch ID(s) to toggle.

  Chance for ON:
  - Chance out of 100 that determines the switches to be ON.

---

Switches: Randomize Range
- Select specific Switch ID Range to randomize ON/OFF.
- The ratio determines the ON/OFF distribution.

  Starting ID:
  - The starting ID of the Switch to toggle.

  Ending ID:
  - The ending ID of the Switch to toggle.

  Chance for ON:
  - Chance out of 100 that determines the switches to be ON.

---

Switches: Toggle ID(s)
- Select specific Switch ID's to toggle ON/OFF.
- ON becomes OFF. OFF becomes ON.

  Switch ID(s):
  - Select which Switch ID(s) to toggle.

---

Switches: Toggle Range
- Select specific Switch ID Range to toggle ON/OFF.
- ON becomes OFF. OFF becomes ON.

  Starting ID:
  - The starting ID of the Switch to toggle.

  Ending ID:
  - The ending ID of the Switch to toggle.

---

System Plugin Commands

---

CoreEngine Update5 Command1.png

System: Battle System Change
- Switch to a different battle system in-game.

  Change To:
  - Choose which battle system to switch to.
    - Database Default (Use game database setting)
    - -
    - DTB: Default Turn Battle
    - TPB Active: Time Progress Battle (Active)
    - TPB Wait: Time Progress Battle (Wait)
    - -
    - BTB: Brave Turn Battle (Req VisuMZ_2_BattleSystemBTB)
    - CTB: Charge Turn Battle (Req VisuMZ_2_BattleSystemCTB)
    - OTB: Order Turn Battle (Req VisuMZ_2_BattleSystemOTB)
    - STB: Standard Turn Battle (Req VisuMZ_2_BattleSystemSTB)

---

CoreEngine Update14 Command1.png

System: Load Images
- Allows you to (pre) load up images ahead of time.

  img/animations/:
  img/battlebacks1/:
  img/battlebacks2/:
  img/enemies/:
  img/faces/:
  img/parallaxes/:
  img/pictures/:
  img/sv_actors/:
  img/sv_enemies/:
  img/system/:
  img/tilesets/:
  img/titles1/:
  img/titles2/:
  - Which files do you wish to load from this directory?

---

CoreEnginePluginCommand04.png

System: Main Font Size
- Set the game's main font size.

  Change To:
  - Change the font size to this number.

---

CoreEnginePluginCommand05.png

System: Side View Battle
- Switch between Front View or Side View for battle.

  Change To:
  - Choose which view type to switch to.

---

CoreEnginePluginCommand07.png

System: Window Padding
- Change the game's window padding amount.

  Change To:
  - Change the game's standard window padding to this value.

---

Plugin Parameters

Quality of Life Settings

CoreEnginePluginParam01.png

A variety of (optional) settings and changes are added with the Core Engine to improve the quality of life for both the game devs and players alike.

---

Play Test

 New Game on Boot:
 - Automatically start a new game on Play Test?
 - Only enabled during Play Test.
 No Play Test Mode:
 - Force the game to be out of Play Test mode when play testing.
 Open Console on Boot:
 - Open the Debug Console upon booting up your game?
 - Only enabled during Play Test.
 F6: Toggle Sound:
 - F6 Key Function: Turn on all sound to 100% or to 0%, toggling between
   the two.
 - Only enabled during Play Test.
 F7: Toggle Fast Mode:
 - F7 Key Function: Toggle fast mode.
 - Only enabled during Play Test.
 NewGame > CommonEvent:
 - Runs a common event each time a new game is started.
 - Only enabled during Play Test.

---

Battle Test

 Add Item Type:
 Add Weapon Type:
 Add Armor Type:
 - Add copies of each database item, weapon, and/or armor?
 - Effective only during battle test.
 Added Quantity:
 - Determines how many items are added during a battle test instead of
   the maximum amount.

---

Digit Grouping

 Standard Text:
 - Make numbers like 1234567 appear like 1,234,567 for standard text
   inside windows?
 Ex Text:
 - Make numbers like 1234567 appear like 1,234,567 for ex text,
   written through drawTextEx (like messages)?
 Damage Sprites:
 - Make numbers like 1234567 appear like 1,234,567 for in-battle
   damage sprites?
 Gauge Sprites:
 - Make numbers like 1234567 appear like 1,234,567 for visible gauge
   sprites such as HP, MP, and TP gauges?

---

Player Benefit

 Encounter Rate Min:
 - Minimum number of steps the player can take without any
   random encounters.
 Escape Always:
 - If the player wants to escape a battle, let them escape the battle
   with 100% chance.
 Accuracy Formula:
 - Accuracy formula calculation change to
   Skill Hit% * (User HIT - Target EVA) for better results.
 Accuracy Boost:
 - Boost HIT and EVA rates in favor of the player.
 Level Up -> Full HP:
 Level Up -> Full MP:
 - Recovers full HP or MP when an actor levels up.

---

Misc

 Animation: Mirror Offset X:
 - When animations are mirrored, mirror their Offset X values, too.
 - The animation name tags <Mirror Offset X> and <No Mirror Offset X> will
   override this effect for that specific animation.
 Anti-Zoom Pictures:
 - If on, prevents pictures from being affected by zoom.
 Font Shadows:
 - If on, text uses shadows instead of outlines.
 Font Smoothing:
 - If on, smoothes fonts shown in-game.
 Font Width Fix:
 - Fixes the font width issue with instant display non-monospaced fonts
   in the Message Window.
 Key Item Protection:
 - If on, prevents Key Items from being able to be sold and from being
   able to be consumed.
 Modern Controls:
 - If on, allows usage of the Home/End buttons.
 - Home would scroll to the first item on a list.
 - End would scroll to the last item on a list.
 - Shift + Up would page up.
 - Shift + Down would page down.
 NewGame > CommonEvent:
 - Runs a common event each time a new game during any session is started.
 - Applies to all types of sessions, play test or not.
 No Tile Shadows:
 - Removes tile shadows from being displayed in-game.
 Pixel Image Rendering:
 - If on, pixelates the image rendering (for pixel games).
 Require Focus?
 - Requires the game to be focused? If the game isn't focused, it will
   pause if it's not the active window.
 Smart Event Collision:
 - Makes events only able to collide with one another if they're
  'Same as characters' priority.

---

Battle System

CoreEngine Update5 Param1.png

Choose which battle system to use for your game.

---


  Database Default (Use game database setting)

  -

  DTB: Default Turn Battle
  TPB Active: Time Progress Battle (Active)
  TPB Wait: Time Progress Battle (Wait)

  -

  BTB: Brave Turn Battle (Req VisuMZ_2_BattleSystemBTB)
  CTB: Charge Turn Battle (Req VisuMZ_2_BattleSystemCTB)
  OTB: Order Turn Battle (Req VisuMZ_2_BattleSystemOTB)
  STB: Standard Turn Battle (Req VisuMZ_2_BattleSystemSTB)

  -

---

Color Settings

CoreEnginePluginParam02.png

These settings allow you, the game dev, to have more control over which colors appear for what conditions found in the game. You can use regular numbers to use the colors predetermined by the game's Window Skin or you can use the #rrggbb format for a hex color code.

If the game's Window Skin is changed mid-game, the colors used will still be based off the default Window Skin's colors. This is due to storing them in a cache and preventing extra processing and reduces lag.

You can find out what hex codes belong to which color from this website: https://htmlcolorcodes.com/

---

Basic Colors
- These are colors that almost never change and are used globally throughout
  the in-game engine.

  Normal:
  System:
  Crisis:
  Death:
  Gauge Back:
  HP Gauge:
  MP Gauge:
  MP Cost:
  Power Up:
  Power Down:
  CT Gauge:
  TP Gauge:
  Pending Color:
  EXP Gauge:
  MaxLv Gauge:
  - Use #rrggbb for custom colors or regular numbers
  for text colors from the Window Skin.

---

Alpha Colors:
- These are colors that have a bit of transparency to them and are specified
  by the 'rgba(red, green, blue, alpha)' format.
- Replace 'red' with a number between 0-255 (integer).
- Replace 'green' with a number between 0-255 (integer).
- Replace 'blue' with a number between 0-255 (integer).
- Replace 'alpha' with a number between 0 and 1 (decimal).

  Window Font Outline:
  Gauge Number Outline:
  Dim Color:
  Item Back Color:
  - Colors with a bit of alpha settings.
  - Format rgba(0-255, 0-255, 0-255, 0-1)

---

Conditional Colors:
- These require a bit of JavaScript knowledge. These determine what colors
  to use under which situations and uses such as different values of HP, MP,
  TP, for comparing equipment, and determine damage popup colors.

  JS: Actor HP Color:
  JS: Actor MP Color:
  JS: Actor TP Color:
  - Code used for determining what HP, MP, or TP color to use for actors.

  JS: Parameter Change:
  - Code used for determining whatcolor to use for parameter changes.

  JS: Damage Colors:
  - Code used for determining what color to use for damage types.

---

Gold Settings

CoreEnginePluginGold.png

CoreEnginePluginParam03.png

Gold is the main currency in RPG Maker MZ. The settings provided here will determine how Gold appears in the game and certain behaviors Gold has.

---

Gold Settings

 Gold Max:
 - Maximum amount of Gold the party can hold.
 - Default 99999999
 Gold Font Size:
 - Font size used for displaying Gold inside Gold Windows.
 - Default: 26
 Gold Icon:
 - Icon used to represent Gold.
 - Use 0 for no icon.
 Gold Overlap:
 - Text used too much Gold to fit in the window.

---

Image Loading

Not all images are loaded at once in-game. RPG Maker MZ uses asynchronous loading which means images are loaded when needed. This may cause delays in when you want certain images to appear. However, if an image is loaded beforehand, they can be used immediately provided they aren't removed from the image cache.

---

Image Loading

 img/animations/:
 img/battlebacks1/:
 img/battlebacks2/:
 img/enemies/:
 img/faces/:
 img/parallaxes/:
 img/pictures/:
 img/sv_actors/:
 img/sv_enemies/:
 img/system/:
 img/tilesets/:
 img/titles1/:
 img/titles2/:
 - Which files do you wish to load from this directory upon starting
   up the game?

---

Keyboard Input Settings

CoreEngine KeyboardInput.png

CoreEngine Update28 Param1.png

Settings for the game that utilize keyboard input. These are primarily for the name input scene (Scene_Name) and the number input event command. These settings have only been tested on English keyboards and may or may not be compatible with other languages, so please disable these features if they do not fit in with your game.

If a controller is connected upon entering the name change scene, it will use the default manual-entry mode instead of the keyboard-entry mode. If a controller button is pressed during the keyboard-entry mode, it will automatically switch to the manual-entry mode.

This plugin does not provide support for controllers that are undetected by RPG Maker MZ's default controller support.

---

Controls

 WASD Movement:
 - Enables or disables WASD movement for your game project.
 - Moves the W page down button to E.
 R Button: Dash Toggle:
 - Enables or disables R button as an Always Dash option toggle.

---

Name Input

 Enable?:
 - Enables keyboard input for name entry.
 - Only tested with English keyboards.
 Default Mode:
 - Select default mode when entering the scene.
   - Default - Uses Arrow Keys to select letters.
   - Keyboard - Uses Keyboard to type in letters.
 QWERTY Layout:
 - Uses the QWERTY layout for manual entry.
 Keyboard Message:
 - The message displayed when allowing keyboard entry.
 - You may use text codes here.
 Banned Words:
 - Players cannot use these words for names.
 - These include words inside the names.
 - If a banned word is used, a buzzer sound will play.

---

Number Input

 Enable?:
 - Enables keyboard input for number entry.
 - Only tested with English keyboards.

---

Button Assist

 Switch to Keyboard:
 - Text used to describe the keyboard switch.
 Switch To Manual:
 - Text used to describe the manual entry switch.

---

Menu Background Settings

CoreEnginePluginMenuBg.png

CoreEnginePluginParam04.png

These settings in the Plugin Parameters allow you to adjust the background images used for each of the scenes. The images will be taken from the game project folders img/titles1/ and img/titles2/ to load into the game.

These settings are only available to scenes found within the Main Menu, the Shop scene, and the Actor Naming scene.

---

Menu Background Settings:

 Scene_Menu:
 Scene_Item:
 Scene_Skill:
 Scene_Equip:
 Scene_Status:
 Scene_Options:
 Scene_Save:
 Scene_Load:
 Scene_GameEnd:
 Scene_Shop:
 Scene_Name:
 - Individual background settings for the scene.
 Scene_Unlisted
 - Individual background settings for any scenes that aren't listed above.

---

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.

---

Menu Button Assist Window

CoreEnginePluginMenuAssist.png

CoreEnginePluginParam06.png

In most modern RPG's, there exist small windows on the screen which tell the player what the control schemes are for that scene. This plugin gives you the option to add that window to the menu scenes in the form of a Button Assist Window.

---

General

 Enable:
 - Enable the Menu Button Assist Window.
 Location:
 - Determine the location of the Button Assist Window.
 - Requires Plugin Parameters => UI => Side Buttons ON.
 Background Type:
 - Select background type for this window.

---

Text

 Text Format:
 - Format on how the buttons are displayed.
 - Text codes allowed. %1 - Key, %2 - Text
 Multi-Key Format:
 - Format for actions with multiple keys.
 - Text codes allowed. %1 - Key 1, %2 - Key 2
 OK Text:
 Cancel Text:
 Switch Actor Text:
 - Default text used to display these various actions.

---

Keys

 Key: Unlisted Format:
 - If a key is not listed below, use this format.
 - Text codes allowed. %1 - Key
 Key: Up:
 Key: Down:
 Key: Left:
 Key: Right:
 Key: Shift:
 Key: Tab:
 Key: A through Z:
 - How this key is shown in-game.
 - Text codes allowed.

---

Menu Layout Settings

CoreEnginePluginParam05.png

These settings allow you to rearrange the positions of the scenes accessible from the Main Menu, the Shop scene, and the Actor Naming scene. This will require you to have some JavaScript knowledge to make the windows work the way you would like.

---

Menu Layout Settings

 Scene_Title:
 Scene_Menu:
 Scene_Item:
 Scene_Skill:
 Scene_Equip:
 Scene_Status:
 Scene_Options:
 Scene_Save:
 Scene_Load:
 Scene_GameEnd:
 Scene_Shop:
 Scene_Name:
 - Various options on adjusting the selected scene.

---

Scene Window Settings

 Background Type:
 - Selects the background type for the selected window.
 - Window
 - Dim
 - Transparent
 JS: X, Y, W, H
 - Code used to determine the dimensions for the selected window.

---

Scene_Title Settings - The following are settings unique to Scene_Title.

Title Screen

 Document Title Format:
 - Format to display text in document title.
 - %1 - Main Title, %2 - Subtitle, %3 - Version
 Subtitle:
 - Subtitle to be displayed under the title name.
 Version:
 - Version to be display in the title screen corner.
 JS: Draw Title:
 - Code used to draw the game title.
 JS: Draw Subtitle:
 - Code used to draw the game subtitle.
 JS: Draw Version:
 - Code used to draw the game version.
 Button Fade Speed:
 - Speed at which the buttons fade in at (1-255).

---

Scene_GameEnd Settings - The following are settings unique to Scene_GameEnd.

 Command Window List:
 - Window commands used by the title screen.
 - Add new commands here.

---

Command Window List - This is found under Scene_Title and Scene_GameEnd settings.

 Symbol:
 - The symbol used for this command.
 STR: Text:
 - Displayed text used for this title command.
 - If this has a value, ignore the JS: Text version.
 JS: Text:
 - JavaScript code used to determine string used for the displayed name.
 JS: Show:
 - JavaScript code used to determine if the item is shown or not.
 JS: Enable:
 - JavaScript code used to determine if the item is enabled or not.
 JS: Ext:
 - JavaScript code used to determine any ext data that should be added.
 JS: Run Code:
 - JavaScript code that runs once this command is selected.

---

CoreEnginePluginTitleButtons.png

Title Picture Buttons: - This is found under Scene_Title settings.

 Picture's Filename:
 - Filename used for the picture.
 Button URL:
 - URL for the button to go to upon being clicked.
 JS: Position:
 - JavaScript code that helps determine the button's Position.
 JS: On Load:
 - JavaScript code that runs once this button bitmap is loaded.
 JS: Run Code:
 - JavaScript code that runs once this button is pressed.

---

Parameter Settings

CoreEnginePluginParam07.png

A battler's parameters, or stats as some devs know them as, are the values that determine how a battler performs. These settings allow you to alter their behaviors and give boosts to trait objects in a controlled manner.

---

Parameter Settings

 Displayed Parameters
 - A list of the parameters that will be displayed in-game.
 - Shown in the Equip Menu.
 - Shown in the Status Menu.
 Extended Parameters
 - The list shown in extended scenes (for other VisuStella plugins).

---

Basic Parameters

MHP - MaxHP

- This is the maximum health points value. The amount of health points (HP) a battler has determines whether or not the battler is in a living state or a dead state. If the HP value is above 0, then the battler is living. If it is 0 or below, the battler is in a dead state unless the battler has a way to counteract death (usually through immortality). When the battler takes damage, it is usually dealt to the HP value and reduces it. If the battler is healed, then the HP value is increased. The MaxHP value determines what's the maximum amount the HP value can be held at, meaning the battler cannot be healed past that point.

MMP - MaxMP

- This is the maximum magic points value. Magic points (MP) are typically used for the cost of skills and spells in battle. If the battler has enough MP to fit the cost of the said skill, the battler is able to use the said skill provided that all of the skill's other conditions are met. If not, the battler is then unable to use the skill. Upon using a skill that costs MP, the battler's MP is reduced. However, the battler's MP can be recovered and results in a gain of MP. The MaxMP value determines what is the maximum amount the MP value can be held at, meaning the battler cannot recover MP past the MaxMP value.

ATK - Attack

- This is the attack value of the battler. By default, this stat is used for the purpose of damage calculations only, and is typically used to represent the battler's physical attack power. Given normal damage formulas, higher values mean higher damage output for physical attacks.

DEF - Defense

- This is the defense value of the battler. By default, this stat is used for the purpose of damage calculations only, and is typically used to represent the battler's physical defense. Given normal damage formulas, higher values mean less damage received from physical attacks.

MAT - Magic Attack

- This is the magic attack value of the battler. By default, this stat is used for the purpose of damage calculations only, and is typically used to represent the battler's magical attack power. Given normal damage formulas, higher values mean higher damage output for magical attacks.

MDF - Magic Defense

- This is the magic defense value of the battler. By default, this stat is used for the purpose of damage calculations only, and is typically used to represent the battler's magical defense. Given normal damage formulas, higher values mean less damage received from magical attacks.

AGI - Agility

- This is the agility value of the battler. By default, this stat is used to determine battler's position in the battle turn's order. Given a normal turn calculation formula, the higher the value, the faster the battler is, and the more likely the battler will have its turn earlier in a turn.

LUK - Luck

- This is the luck value of the battler. By default, this stat is used to affect the success rate of states, buffs, and debuffs applied by the battler and received by the battler. If the user has a higher LUK value, the state, buff, or debuff is more likely to succeed. If the target has a higher LUK value, then the state, buff, or debuff is less likely to succeed.

---

Basic Parameters

 HP Crisis Rate:
 - HP Ratio at which a battler can be considered in crisis mode.
 JS: Formula:
 - Formula used to determine the total value all 8 basic parameters:
 - MaxHP, MaxMP, ATK, DEF, MAT, MDF, AGI, LUK.

Parameter Caps:

 MaxHP Cap:
 MaxMP Cap:
 ATK Cap:
 DEF Cap:
 MAT Cap:
 MDF Cap:
 AGI Cap:
 LUK Cap:
 - Formula used to determine the selected parameter's cap.
 - These settings DO NOT raise the editor's maximum values. If you want to
   raise an enemy's maximum parameter value past their default cap, use the
   associated notetag for them instead.

---

X Parameters

HIT - Hit Rate%

- This determines the physical hit success rate of the any physical action. All physical attacks make a check through the HIT rate to see if the attack will connect. If the HIT value passes the randomizer check, the attack will connect. If the HIT value fails to pass the randomizer check, the attack will be considered a MISS.

EVA - Evasion Rate%

- This determines the physical evasion rate against any incoming physical actions. If the HIT value passes, the action is then passed to the EVA check through a randomizer check. If the randomizer check passes, the physical attack is evaded and will fail to connect. If the randomizer check passes, the attempt to evade the action will fail and the action connects.

CRI - Critical Hit Rate%

- Any actions that enable Critical Hits will make a randomizer check with this number. If the randomizer check passes, extra damage will be carried out by the initiated action. If the randomizer check fails, no extra damage will be added upon the action.

CEV - Critical Evasion Rate%

- This value is put against the Critical Hit Rate% in a multiplicative rate. If the Critical Hit Rate is 90% and the Critical Evasion Rate is 20%, then the randomizer check will make a check against 72% as the values are calculated by the source code as CRI * (1 - CEV), therefore, with values as 0.90 * (1 - 0.20) === 0.72.

MEV - Magic Evasion Rate%

- Where EVA is the evasion rate against physical actions, MEV is the evasion rate against magical actions. As there is not magical version of HIT, the MEV value will always be bit against when a magical action is initiated. If the randomizer check passes for MEV, the magical action will not connect. If the randomizer check fails for MEV, the magical action will connect.

MRF - Magic Reflect Rate%

- If a magical action connects and passes, there is a chance the magical action can be bounced back to the caster. That chance is the Magic Reflect Rate. If the randomizer check for the Magic Reflect Rate passes, then the magical action is bounced back to the caster, ignoring the caster's Magic Evasion Rate. If the randomizer check for the Magic Reflect Rate fails, then the magical action will connect with its target.

CNT - Counter Attack Rate%

- If a physical action connects and passes, there is a chance the physical action can be avoided and a counter attack made by the user will land on the attacking unit. This is the Counter Attack Rate. If the randomizer check for the Counter Attack Rate passes, the physical action is evaded and the target will counter attack the user. If the randomizer check fails, the physical action will connect to the target.

HRG - HP% Regeneration

- During a battler's regeneration phase, the battler will regenerate this percentage of its MaxHP as gained HP with a 100% success rate.

MRG - MP% Regeneration

- During a battler's regeneration phase, the battler will regenerate this percentage of its MaxMP as gained MP with a 100% success rate.

TRG - TP% Regeneration

- During a battler's regeneration phase, the battler will regenerate this percentage of its MaxTP as gained TP with a 100% success rate.

---

X Parameters

 JS: Formula:
 - Formula used to determine the total value all 10 X parameters:
 - HIT, EVA, CRI, CEV, MEV, MRF, CNT, HRG, MRG, TRG.

Vocabulary

 HIT:
 EVA:
 CRI:
 CEV:
 MEV:
 MRF:
 CNT:
 HRG:
 MRG:
 TRG:
 - In-game vocabulary used for the selected X Parameter.

---

S Parameters

TGR - Target Rate

- Against the standard enemy, the Target Rate value determines the odds of an enemy specifically targeting the user for a single target attack. At 0%, the enemy will almost never target the user. At 100%, it will have normal targeting opportunity. At 100%+, the user will have an increased chance of being targeted.

NOTE: For those using the Battle A.I. Core, any actions that have specific

target conditions will bypass the TGR rate.

GRD - Guard Effect

- This is the effectiveness of guarding. This affects the guard divisor value of 2. At 100% GRD, damage will become 'damage / (2 * 1.00)'. At 50% GRD, damage will become 'damage / (2 * 0.50)'. At 200% GRD, damage will become 'damage / (2 * 2.00)' and so forth.

REC - Recovery Effect

- This is how effective heals are towards the user. The higher the REC rate, the more the user is healed. If a spell were to heal for 100 and the user has 300% REC, then the user is healed for 300 instead.

PHA - Pharmacology

- This is how effective items are when used by the user. The higher the PHA rate, the more effective the item effect. If the user is using a Potion that recovers 100% on a target ally and the user has 300% PHA, then the target ally will receive healing for 300 instead.

MCR - MP Cost Rate

- This rate affects how much MP skills with an MP Cost will require to use. If the user has 100% MCR, then the MP Cost will be standard. If the user has 50% MCR, then all skills that cost MP will cost only half the required MP. If the user has 200% MCR, then all skills will cost 200% their MP cost.

TCR - TP Charge Rate

- This rate affects how much TP skills with an TP will charge when gaining TP through various actions. At 100%, TP will charge normally. At 50%, TP will charge at half speed. At 200%, TP will charge twice as fast.

PDR - Physical Damage Rate

- This rate affects how much damage the user will take from physical damage. If the user has 100% PDR, then the user takes the normal amount. If the user has 50% PDR, then all physical damage dealt to the user is halved. If the user has 200% PDR, then all physical damage dealt to the user is doubled.

MDR - Magical Damage Rate

- This rate affects how much damage the user will take from magical damage. If the user has 100% MDR, then the user takes the normal amount. If the user has 50% MDR, then all magical damage dealt to the user is halved. If the user has 200% MDR, then all magical damage dealt to the user is doubled.

FDR - Floor Damage Rate

- On the field map, this alters how much damage the user will take when the player walks over a tile that damages the party. The FDR value only affects the damage dealt to the particular actor and not the whole party. If FDR is at 100%, then the user takes the full damage. If FDR is at 50%, then only half of the damage goes through. If FDR is at 200%, then floor damage is doubled for that actor.

EXR - Experience Rate

- This determines the amount of experience gain the user whenever the user gains any kind of EXP. At 100% EXR, the rate of experience gain is normal. At 50%, the experience gain is halved. At 200%, the experience gain for the user is doubled.

---

S Parameters

 JS: Formula
 - Formula used to determine the total value all 10 S parameters:
 - TGR, GRD, REC, PHA, MCR, TCR, PDR, MDR, FDR, EXR.

Vocabulary

 TGR:
 GRD:
 REC:
 PHA:
 MCR:
 TCR:
 PDR:
 MDR:
 FDR:
 EXR:
 - In-game vocabulary used for the selected S Parameter.

---

Icons

 Draw Icons?
 - Draw icons next to parameter names?
 MaxHP, MaxMP, ATK, DEF, MAT, MDF, AGI, LUK:
 HIT, EVA, CRI, CEV, MEV, MRF, CNT, HRG, MRG, TRG:
 TGR, GRD, REC, PHA, MCR, TCR, PDR, MDR, FDR, EXR:
 - Icon used for the selected parameter.

---

Custom Parameters Settings

CoreEngine CustomParam1.png

CoreEngine CustomParam2.png

CoreEngine CustomParam3.png

As of version 1.07, you can add Custom Parameters to your game if RPG Maker MZ's default set of parameters isn't enough for you. These parameters can have variable functionality depending on how you code it. More importantly, these are compatible with the VisuStella MZ menus and the VisuStella Core Engine's Parameters settings.

For clarification, these settings do NOT create brand-new parameters for you to use and add to your game nor are the bonuses supported by other plugins in the VisuStella MZ library. These settings exist to function as a bridge for non-VisuStella MZ plugins that have created their own parameter values and to show them inside VisuStella menus.

---

Custom Parameter

 Parameter Name:
 - What's the parameter's name?
 - Used for VisuStella MZ menus.
 Abbreviation:
 - What abbreviation do you want to use for the parameter?
 - Do not use special characters. Avoid numbers if possible.
 Icon:
 - What icon do you want to use to represent this parameter?
 - Used for VisuStella MZ menus.
 Type:
 - What kind of number value will be returned with this parameter?
   - Integer (Whole Numbers Only)
   - Float (Decimals are Allowed)
 JS: Value:
 - Run this code when this parameter is to be returned.

---

Instructions on Adding Custom Parameters to VisuStella Menus

In the Core Engine and Elements and Status Menu Core plugins, there are plugin parameter fields for you to insert the parameters you want displayed and visible to the player.

Insert in those the abbreviation of the custom parameter. For example, if you want to add the "Strength" custom parameter and the abbreviation is "str", then add "str" to the Core Engine/Elements and Status Menu Core's plugin parameter field for "Strength" to appear in-game. Case does not matter here so you can insert "str" or "STR" and it will register all the same to make them appear in-game.

---

Instructions on Using Custom Parameters as Mechanics

If you want to use a custom parameter in, say, a damage formula, refer to the abbreviation you have set for the custom parameter. For example, if you want to call upon the "Strength" custom parameter's value and its set abbreviation is "str", then refer to it as such. This is case sensitive.

An example damage formula would be something like the following if using "str" for "Strength" and "con" for "Constitution":

 a.str - b.con

These values are attached to the Game_Battlerbase prototype class.

---

Instructions on Setting Custom Parameter Values

This requires JavaScript knowledge. There is no way around it. Whatever code you insert into the "JS: Value" field will return the value desired. The 'user' variable will refer to the Game_Battlerbase prototype object in which the information is to be drawn from.

Depending on the "type" you've set for the Custom Parameter, the returned value will be rounded using Math.round for integers and left alone if set as a float number.

---

Screen Resolution Settings

CoreEngine Update45 Params1.png

Alter various properties to make the game look better for varying screen resolutions. This is mostly for RPG Maker MZ version 1.3.0 and up where the Troops tab has been updated to match the screen resolution settings found in the System 2 Database tab.

---

Troops

 Reposition Actors:
 - Update the position of actors in battle if the screen resolution
   has changed to become larger than 816x624.
 - Ignore if using the VisuStella MZ Battle Core.
 - When using the VisuStella MZ Battle Core, adjust the position through
   Battle Core > Parameters > Actor Battler Settings > JS: Home Position
 Reposition Enemies:
 - Update the position of enemies in battle if the screen resolution
   has changed to become larger than 816x624.
   For MZ 1.3.0+?:
   - Both this parameter and its parent parameter need to be on when using
     RPG Maker MZ 1.3.0+.
   - If the Core Script is below 1.3.0, this setting is ignored. This does
     not take into account what version the editor is on. Pay attention to
     that as the plugin will not auto adjust for it.

---

Screen Shake Settings

CoreEngineParamsScreenShake.png

Get more screen shake effects into your game!

These effects have been added by Aries of Sheratan!

---

Settings

 Default Style:
 - The default style used for screen shakes.
 - Original
 - Random
 - Horizontal
 - Vertical
 JS: Original Style:
 JS: Random Style
 JS: Horizontal Style
 JS: Vertical Style
 - This code gives you control over screen shake for this screen
   shake style.

---

Title Command List Settings

CoreEngineUpdate4Params1.png

This plugin parameter allows you to adjust the commands that appear on the title screen. Some JavaScript knowledge is needed.

---

Title Command

 Symbol:
 - The symbol used for this command.
 STR: Text:
 - Displayed text used for this title command.
 - If this has a value, ignore the JS: Text version.
 JS: Text:
 - JavaScript code used to determine string used for the displayed name.
 JS: Show:
 - JavaScript code used to determine if the item is shown or not.
 JS: Enable:
 - JavaScript code used to determine if the item is enabled or not.
 JS: Ext:
 - JavaScript code used to determine any ext data that should be added.
 JS: Run Code:
 - JavaScript code that runs once this command is selected.

---

Title Picture Buttons Settings

CoreEnginePluginTitleButtons.png

CoreEngineUpdate4Params2.png

These allow you to insert picture buttons on your title screen that can send users to various links on the internet when clicked.

---

Settings

 Picture's Filename:
 - Filename used for the picture.
 Button URL:
 - URL for the button to go to upon being clicked.
 JS: Position:
 - JavaScript code that helps determine the button's Position.
 JS: On Load:
 - JavaScript code that runs once this button bitmap is loaded.
 JS: Run Code:
 - JavaScript code that runs once this button is pressed.

---

UI Settings

CoreEnginePluginParam08.png

In previous iterations of RPG Maker, the Core Engine would allow you to change the screen resolution. In MZ, that functionality is provided by default but a number of UI settings still remain. These settings allow you adjust how certain in-game objects and menus are displayed.

---

UI Area

 Fade Speed:
 - Default fade speed for transitions.
 Box Margin:
 - Set the margin in pixels for the screen borders.
 Command Window Width:
 - Sets the width for standard Command Windows.
 Bottom Help Window:
 - Put the Help Window at the bottom of the screen?
 Right Aligned Menus:
 - Put most command windows to the right side of the screen.
 Show Buttons:
 - Show clickable buttons in your game?
   Show Cancel Button:
   Show Menu Button:
   Show Page Up/Down:
   Show Number Buttons:
   - Show/hide these respective buttons if the above is enabled.
   - If 'Show Buttons' is false, these will be hidden no matter what.
 Button Area Height:
 - Sets the height for the button area.
 Bottom Buttons:
 - Put the buttons at the bottom of the screen?
 Side Buttons:
 - Push buttons to the side of the UI if there is room.

---

Menu Objects

 Level -> EXP Gauge:
 - Draw an EXP Gauge under the drawn level.
 Parameter Arrow:
 - The arrow used to show changes in the parameter values.

---

Text Code Support

 Class Names:
 - Make class names support text codes?
 Nicknames:
 - Make nicknames support text codes?

---

Window Settings

CoreEnginePluginParam09new.png

Adjust the default settings of the windows in-game. This ranges from things such as the line height (to better fit your font size) to the opacity level (to fit your window skins).

---

Window Defaults

 Line Height:
 - Default line height used for standard windows.
 Item Height Padding:
 - Default padding for selectable items.
 Item Padding:
 - Default line padding used for standard windows.
 Back Opacity:
 - Default back opacity used for standard windows.
 - As of version 1.3.0, this is no longer needed.
 - This will still work for lower versions.
 Translucent Opacity:
 - Default translucent opacity used for standard windows.
 Window Opening Speed:
 - Default open speed used for standard windows.
 - Default: 32 (Use a number between 0-255)
 Column Spacing:
 - Default column spacing for selectable windows.
 - Default: 8
 Row Spacing:
 - Default row spacing for selectable windows.
 - Default: 4

---

Selectable Items:

 Show Background?:
 - Selectable menu items have dark boxes behind them. Show them?
 Item Height Padding:
 - Default padding for selectable items.
 JS: Draw Background:
 - Code used to draw the background rectangle behind clickable menu objects

---

JS: Quick Functions

CoreEnginePluginParam10.png

WARNING: This feature is highly experimental! Use it at your own risk!

JavaScript Quick Functions allow you to quickly declare functions in the global namespace for ease of access. It's so that these functions can be used in Script Calls, Control Variable Script Inputs, Conditional Branch Script Inputs, Damage Formulas, and more.

---

JS: Quick Function

 Function Name:
 - The function's name in the global namespace.
 - Will not overwrite functions/variables of the same name.
 JS: Code:
 - Run this code when using the function.

---

If you have a Function Name of "Example", then typing "Example()" in a Script Call, Conditional Branch Script Input, or similar field will yield whatever the code is instructed to return.

If a function or variable of a similar name already exists in the global namespace, then the quick function will be ignored and not created.

If a quick function contains bad code that would otherwise crash the game, a fail safe has been implemented to prevent it from doing so, display an error log, and then return a 0 value.

---


Terms of Use

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

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

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

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

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

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

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

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

Terms of Use: Japanese


『VisuStella MZ』利用規約

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

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

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

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

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

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

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

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

Credits

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

Team VisuStella

Changelog

Version 1.48: October 21, 2021

  • Feature Update!
    • Bitmap.blt function will now have source coordinates and destination X and Y coordinates rounded to prevent blurring. Update made by Olivia.


Version 1.47: October 14, 2021

  • Bug Fixes!
    • Prevents Number Input window from having a NaN value due to holding down the fast forward key. Fix made by Arisu.
  • Compatibility Update
    • Added compatibility functionality for future plugins.
  • Documentation Update!
    • Help file updated for new features.
  • New Feature!
    • New Plugin Parameter added by Yanfly:
      • Plugin Parameters > QoL Settings > Misc > Font Width Fix
        • Fixes the font width issue with non-monospaced fonts in the Message Window. This is now an optional fix.


Version 1.46: September 23, 2021

  • Documentation Update!
    • Added line to Plugin Command: "System: Battle System Change":
      • Some battle systems REQUIRE their specific plugins!
    • Added lines to "Plugin Parameters: Battle System":
      • Some battle systems REQUIRE their specific plugins! This means if you do not have the required battle system plugin installed, it will not change over. The Core Engine plugin does not contain data for all of the battle systems inside its code.


Version 1.45: September 17, 2021

  • Bug Fixes!
    • Fixed a problem with "Picture: Coordinates Mode" to properly utilize the correct picture ID. Fix made by Arisu.
    • RPG Maker MZ Bug Fix:
      • Instant Text Discrepancy for Window_Message
        • Window_Message displays text differently when it draws letters one by one versus when the text is displayed instantly. This isn't noticeable with the default font, but it's very visible when using something like Arial. The error is due to Bitmap.measureTextWidth yielding a rounded value per letter versus per word. The Core Engine will provide a bug fix that will single out the cause and make it so that only Window_Message will not utilize any round number values when determining the width of each letter, whether or not it is shown instantly. This change will only affect Window_Message and not any other window in order to prevent unintended side effects.
        • Fix made by Yanfly.
  • Compatibility Update!
    • RPG Maker MZ 1.3.3 compatibility.
      • Updated how gauges are drawn.
  • Documentation Update!
    • Help file updated for new RPG Maker MZ bug fix.


Version 1.44: August 20, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Command added by Irina and sponsored by Anon.
      • "Animation: Play at Coordinate"
        • Plays an animation on the screen at a specific x, y coordinate even if there is no sprite attached.


Version 1.43: July 23, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Command added by Irina and sponsored by Archeia!
      • "Picture: Coordinates Mode"
        • Play Test Mode only!
        • Gets the coordinates of a specific picture as you move it across the screen.
        • Helpful for those who don't want to do guess work on the screen coordinates when it comes to placing down pictures.


Version 1.42: July 16, 2021

  • Documentation Update
    • Added text to "Plugin Parameters: Color Settings" for clarification:
      • If the game's Window Skin is changed mid-game, the colors used will still be based off the default Window Skin's colors. This is due to storing them in a cache and preventing extra processing and reduces lag.


Version 1.41: July 2, 2021

  • Compatibility Update
    • Further compatibility update with RPG Maker MZ 1.3.0+.
  • Documentation Update
    • Added extra notes to "Important Changes: Bug Fixes" section for the "Window Skin Bleeding" bug:
      • This bug is fixed in the core scripts for RPG Maker MZ v1.3.0+.


Version 1.40: June 25, 2021

  • Compatibility Update
    • Compatibility update with RPG Maker MZ 1.3.0+.
  • Documentation Update:
    • Plugin Parameters > Window Settings > Back Opacity
      • As of version 1.3.0, this is no longer needed.
      • This will still work for lower versions.
    • Help file updated for new features.
  • Feature Updates!
    • Window Skin Bleeding fix updated to newest version.
  • New Plugin Parameters added:
    • Plugin Parmaeters > Screen Resolution Settings
      • These settings have been moved from the UI settings to be its own thing.
        • This is mostly for RPG Maker MZ version 1.3.0 and up where the Troops tab has been updated to match the screen resolution settings found in the System 2 Database tab.
      • Reposition Enemies > For MZ 1.3.0+?
        • Both of these plugin parameters need to be set to true in order for the repositioning to work for MZ v1.3.0.
        • If the Core Script is below 1.3.0, this setting is ignored. This does not take into account what version the editor is on. Pay attention to that as the plugin will not auto adjust for it.


Version 1.39: June 18, 2021

  • Bug Fixes!
    • Number Inputs should now work with the controller if keyboard Number Input is enabled. Fix made by Olivia.
    • RPG Maker Bug: Termination Clear Effects
      • In RPG Maker MZ, requesting an animation while transitioning between scenes, such as going from the map scene to the battle scene, can cause crashes. This is because the animation queue does not take off immediately and will likely register incorrect targets for the scene. This plugin will forcefully clear any registered animations and balloon effects when terminating a scene in order to prevent crashes.
  • Documentation Update!
    • Help file updated for updated features.
  • Feature Update!
    • <Battle View: x> Troop Name tags can now work with comment tags.
    • <Battle System: x> Troop Name tags can now work with comment tags.
      • Updates made by Irina.


Version 1.38: June 11, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Command added by Irina and sponsored by Caz!
      • Picture: Show Icon
        • Shows an icon instead of a picture image.
        • The picture icon can be controlled like any other picture.


Version 1.37: May 21, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Commands added by Arisu:
      • Switches: Randomize ID(s)
      • Switches: Randomize Range
      • Switches: Toggle ID(s)
      • Switches: Toggle Range
        • These Plugin Commands allow you to randomize the ON/OFF positions of switches or toggle them so that they flip their ON/OFF status.


Version 1.36: May 14, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Commands added by Irina:
      • Export: All Maps Text
      • Export: All Troops Text
      • Export: Current Map Text
      • Export: Current Troop Text
        • Play Test Only Plugin Commands. These Plugin Commands are used for extracting all messages, show choices, comments, and scrolling text to parse and export them as a TXT file. Useful for getting a game's script to a voice actor or voice actress.

CoreEngine Update39 Command1.png


Version 1.35: May 7, 2021

  • Documentation Update!
    • Added the following text to "Parameter Settings" Plugin Parameters for extra clarity regarding Parameter Caps:
      • These settings DO NOT raise the editor's maximum values. If you want to raise an enemy's maximum parameter value past their default cap, use the associated notetag for them instead.


Version 1.34: April 23, 2021

  • Bug Fixes!
    • For the vanilla Equip Status window, custom parameters with integer values will now show up as integers and not percentiles. Fix by Olivia.
  • Documentation Update!
    • Added clarity to the <param: x> notetag for enemies.
      • This notetag does NOT work with X Parameters, S Parameters, or any custom parameters. This notetag ONLY works with the base parameters.


Version 1.33: April 9, 2021

  • Bug Fixes!
    • RPG Maker MZ Bug: Window Skin Bleeding
      • Since the v1.2.0 update, Window.prototype._refreshBack's frame value has been set from 96 to 95. This results in the window skin bleeding past the window's intended borders. The Core Engine now reverts this change to prevent the bleeding effect from happening.
  • Feature Update!
    • "Encounter Rate Minimum" now has a valid minimum value of 1. Update made by Olivia.


Version 1.32: April 2, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Parameters added by Yanfly:
      • Plugin Parameters > QoL Settings > Battle Test > Add Item Type
      • Plugin Parameters > QoL Settings > Battle Test > Add Weapon Type
      • Plugin Parameters > QoL Settings > Battle Test > Add Armor Type
      • Plugin Parameters > QoL Settings > Battle Test > Added Quantity
        • By default, RPG Maker MZ only adds 99 of items and not weapons or armor making it awkward for testing specific battle mechanics. These settings allow you to add in custom amounts of items, weapons, and/or armors if you so wish.


Version 1.31: March 26, 2021

  • Feature Update!
    • Title screen buttons will now become fully opaque when hovered over them instead of only when pressed. Update made by Yanfly.


Version 1.30: March 19, 2021

  • Bug Fixes!
    • RPG Maker MZ Bug: Invisible Battle Sprites
      • If you removed a party member during battle and added that exact party member back into the same slot, their sprite would appear invisible. The VisuStella Core Engine will fix this problem and prevent it from happening. Fix made by Olivia.
  • Compatibility Update
    • Added compatibility functionality for future plugins.
  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Parameter added by Arisu:
      • Plugin Parameters > QoL Settings > Misc > Ani: Mirror Offset
        • When animations are mirrored, mirror their Offset X values, too.
    • New animation name tags added by Arisu:
      • <Mirror Offset X> and <No Mirror Offset X>
        • If these text tags are placed in an animation's name, it will cause the offset X value to be mirrored when the animation is mirrored or have it ignored despite being mirrored.


Version 1.29: March 12, 2021

  • Documentation Update!
    • Added documentation for new RPG Maker MZ bug fixes!
    • Help file updated for updated features.
  • Feature Update!
    • Name Input should be more controller-friendly. If a controller is connected upon entering the name change scene, it will use the default manual-entry mode instead of the keyboard-entry mode. If a controller button is pressed during the keyboard-entry mode, it will automatically switch to the manual-entry mode.
    • This plugin does not provide support for controllers that are undetected by RPG Maker MZ's default controller support.
    • This feature was already implemented since version 1.27 but wasn't documented so here we are. Update made by Irina.


Version 1.28: March 5, 2021

  • Bug Fixes!
    • Bug Fixes!
      • RPG Maker MZ Bug: The arrows drawn by a window skin will no longer by placed on a half pixel when a window's size is an odd number. This would cause sprite tearing problems and look awful. Fix made by Irina.
  • Documentation Update!
    • Added documentation for new RPG Maker MZ bug fixes!


Version 1.27: February 26, 2021

  • Documentation Update!
    • Help file updated for new features.
    • Moved "Show Scrolling Text, additional functionality" section from Bug Fixes to Major Changes as it was placed in the wrong section.
  • New Features!
    • New Plugin Parameter added by Yanfly.
      • Plugin Parameters > Keyboard Input > Name Input > Banned Words
        • Insert words you don't want your players to use for character names.


Version 1.26: February 19, 2021

  • Bug Fixes!
    • Certain Plugin Parameters no longer have settings that restrict them to a maximum of 1. Fix made by Arisu.
  • Feature Update!
    • Changed the default value for a New Game > Common Event upon Play Testing to 0 to prevent confusion. Update made by Arisu.


Version 1.25: February 5, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • Show Scrolling Text, additional functionality added by Arisu
      • The event command "Show Scrolling Text" now has additional functionality as long as the VisuStella MZ Core Engine is installed. If the game dev inserts "// Script Call" (without the quotes) inside the scrolling text, then the entirity of the Show Scrolling Text event command will be ran as a giant script call event command.
      • The reason why this functionality is added is because the "Script..." event command contains only 12 lines maximum. This means for any script call larger than 12 lines of code cannot be done by normal means as each script call is ran as a separate instance.
      • By repurposing the "Show Scrolling Text" event command to be able to function as an extended "Script..." event command, such a thing is now possible with less hassle and more lines to code with.
      • This effect does not occur if the Show Scrolling Text event command does not have "// Script Call" in its contents.


Version 1.24: January 29, 2021

  • Documentation Update!
    • Plugin Parameters: Custom Parameters Settings added the following note:
      • For clarification, these settings do NOT create brand-new parameters for you to use and add to your game nor are the bonuses supported by other plugins in the VisuStella MZ library. These settings exist to function as a bridge for non-VisuStella MZ plugins that have created their own parameter values and to show them inside VisuStella menus.
  • Feature Update!
    • Default JS Plugin Parameter for the Title Command: "Shutdown" now has a note in it that reads: "Do NOT use this command with mobile devices or browser games. All it does is cause the game to display a blank, black canvas which the player is unable to do anything with. It does NOT force close the browser tab nor the app."
      • This is also why this command is disabled by default for any non-NodeJS client deployed game versions.
    • Disabled some bug fixes made by the Core Engine for the default RMMZ code base since the 1.1.1 version now contains those very same fixes.


Version 1.23: January 22, 2021

  • Optimization Update!
    • Plugin should run more optimized.


Version 1.22: January 15, 2021

  • Documentation Update!
    • Added documentation for new RPG Maker MZ bug fixes!
  • Bug Fixes!
    • RPG Maker MZ Bug: Sprite_Timer is added to the spriteset for the parent scene, making it affected by any filers, zooms, and/or blurs, hindering its readability.


Version 1.21: January 8, 2021

  • Documentation Update!
    • Added documentation for new feature(s)!
  • New Features!
    • New Plugin Parameters added by Arisu:
      • Plugin Parameters > Keyboard Input > Controls > WASD Movement
      • Plugin Parameters > Keyboard Input > Controls > R Button: Dash Toggle


Version 1.20: January 1, 2021

  • Compatibility Update!
    • Added compatibility functionality for future plugins.


Version 1.19: December 25, 2020

  • Documentation Update!
    • Added documentation for new feature(s) and feature updates!
  • Bug Fixes!
    • Fixed typo inside of the comments inside the JS: Quick Functions.
  • Feature Update!
    • Plugin Parameters > Color Settings > Outline Color is now renamed to Font Outline.
  • New Features!
    • New Plugin Parameters added by Shaz!
      • Plugin Parameters > Color Settings > Gauge Number Outline


Version 1.18: December 18, 2020

  • Bug Fixes!
    • Compatible string text from the Items and Equips Core will no longer register MaxHP and MaxMP as percentile values for the info window.
    • RPG Maker MZ Bug: Gamepads no longer go rapidfire after a cleared input. There is now a period of delay for gamepads after an input clear.
    • 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.
    • RPG Maker MV animations will no longer crash for unplayable sound effects. Fix made by Yanfly.
  • Compatibility Update!
    • Plugins should be more compatible with one another.
  • Documentation Update!
    • Added documentation for new feature(s)!
    • Added documentation for new RPG Maker MZ bug fixes!
  • New Features!
    • New Plugin Parameters added by Yanfly!
      • Plugin Parameters > Button Assist > Key: Shift
      • Plugin Parameters > Button Assist > Key: Tab
        • These let you assign text codes to the Shift and Tab buttons for the Button Assist windows.
      • Plugin Parameters > QoL Settings > Misc > NewGame > CommonEvent
        • For an all version (including non-play test) common event to start new games with.


Version 1.17: December 11, 2020

  • Compatibility Update!
    • Added compatibility functionality for future plugins.


Version 1.16: December 4, 2020

  • Compatibility Update!
    • Plugins should be more compatible with one another.
  • Documentation Update!
    • Added documentation for new feature(s)!
  • Feature Update!
    • Button Assist Window for the change name scene will now default to "Tab" for switching between both modes. Update made by Yanfly.
  • New Features!
    • New Plugin Parameter added by Yanfly:
      • Plugin Parameters > Keyboard Input > Default Mode
        • Select default mode when entering the scene.


Version 1.15: November 29, 2020

  • Bug Fixes!
    • Pressing "Enter" in the change name scene while the actor's name is completely empty will no longer result in endless buzzer sounds. Fix made by Arisu.
  • Documentation Update!
    • Added documentation for new feature(s)!
  • Feature Update!
    • For the name change scene, the "Tab" key now also lets the user switch between the two modes. Update made by Yanfly.
  • New Features!
    • Two new plugin parameters added to Keyboard Input:
      • "Switch To Keyboard" and "Switch To Manual"
        • These determine the text used for the button assist window when switching between the two modes. Update made by Yanfly.
        • Button Assist window now takes into consideration for these texts.
  • Optimization Update!
    • Plugin should run more optimized.


Version 1.14: November 22, 2020

  • Documentation Update!
    • Added documentation for new feature(s)!
  • New Features!
    • New Plugin Command added by Yanfly!
      • System: Load Images
        • Allows you to (pre) load up images ahead of time.


Version 1.13: November 15, 2020

  • Optimization Update!
    • Plugin should run more optimized.


Version 1.12: November 8, 2020

  • Compatibility Update!
    • Plugins should be more compatible with one another.
  • Documentation Update!
    • Added documentation for new feature(s)!
  • Feature Update!
    • Screen Shake Plugin Parameters and JS: Quick Function Plugin Parameters have been taken off experimental status.
  • New Features!
    • New plugin parameters added by Arisu.
      • Plugin Parameters > Keyboard Input
        • Settings for the game that utilize keyboard input. These are primarily for the name input scene (Scene_Name) and the number input event command. These settings have only been tested on English keyboards and may or may not be compatible with other languages, so please disable these features if they do not fit in with your game.


Version 1.11: November 1, 2020

  • Compatibility Update!
    • Plugins should be more compatible with one another.
  • Feature Update!
    • Bitmap smoothing now takes into consideration for rounding coordinates. Update made by Irina.


Version 1.10: October 25, 2020

  • Feature Update!
    • Sprite animation location now adjusts position relative to the sprite's scale, too. Update made by Arisu.


Version 1.09: October 18, 2020

  • Bug Fixes!
    • RPG Maker MZ Bug: Auto Battle Lock Up. Fixed by Yanfly.
      • If an auto battle Actor fights against an enemy whose DEF/MDF is too high, they will not use any actions at all. This can cause potential game freezing and softlocks. This plugin will change that and have them default to a regular Attack.
  • Compatibility Update!
    • Plugins should be more compatible with one another.


Version 1.08: October 11, 2020

  • Feature Update!
    • Altered sprite bitmaps via the various draw functions will now be marked as modified and will automatically purge themselves from graphical memory upon a sprite's removal to free up more resources. Change made by Yanfly.
    • Picture Sprite Origin anchors are now tied to the Game_Picture show and move commands instead of the Game_Interpretter commands. Change by Arisu.


Version 1.07: October 4, 2020

  • Documentation Update!
    • New documentation added for the new Plugin Parameter category: "Custom Parameters".
  • New Features!
    • New Plugin Parameter "Custom Parameters" added by Yanfly.
      • Create custom parameters for your game! These will appear in VisuStella MZ menus.


Version 1.06: September 27, 2020

  • Bug Fixes!
    • Battler evasion pose can now occur if there is a miss. These were made separate in RPG Maker MZ and misses didn't enable the evasion pose. Fix made by Olivia.
  • New Features!
    • New notetags for Maps and name tags for Troops added by Yanfly!
      • <Frontview>, <Sideview> to change the battle view for that specific map, or troop regardless of what other settings are.
      • <DTB>, <TPB Active>, <TPB Wait> to change the battle system for that specific map or troop regardless of what other settings are.


Version 1.05: September 20, 2020

  • Bug Fixes!
    • <Level: x> notetag for enemies is now fixed! Fix made by Arisu.
  • Documentation Update!
    • Documentation added for the new "System: Battle System Change" Plugin Command and removed the old "System: Set Time Progress Battle".
  • Feature Update!
    • The Plugin Command "System: Set Time Progress Battle" has been replaced with "System: Battle System Change" instead. This is to accommodate future plugins that allow for different battle systems. Added by Yanfly.
      • If you have previously used "System: Set Time Progress Battle", please replace them. We apologize for the inconvenience.
  • New Features!
    • In the Core Engine's plugin parameters, you can now set the Battle System used. This will default to whatever is the game database's setting. This feature is used for the future when new battle systems are made. Feature added by Yanfly.


Version 1.04: September 13, 2020

  • Documentation Update!
    • Added new documentation for the "Title Command List" and Title Picture Buttons" plugin parameters. They now have a dedicated section each.
  • Feature Updates!
    • Moved the "Title Command List" and "Title Picture Buttons" parameters from the Menu Layout > Title settings. They were far too hidden away and users had a hard time finding them. Update made by Yanfly.
      • Users who have customized these settings before will need to readjust them again. We apologize for the inconvenience.


Version 1.03: September 6, 2020

  • Bug Fixes!
    • Having QoL > Modern Controls disabled (why would you) used to prevent the down button from working. It works again. Fix made by Yanfly.
  • New Feature!
    • Plugin default settings now come with a "Game End" option on the title screen. For those updating from version 1.02 or order, you can add this in by opening the Core Engine > Plugin Parameters > Menu Layout Settings > press "delete" on Scene_Title > open it up, then the new settings will fill in automatically.
  • New Experimental Feature Added:
    • Screen Shake Settings added to the Plugin Parameters.
      • Screen Shake: Custom Plugin Command added!
      • Credit to Aries of Sheratan, who gave us permission to use her formula.
      • We'll be expanding on more screen shaking options in the future.
  • Optimization Update
    • Digit Grouping now works more efficiently.


Version 1.02: August 30, 2020

  • New Feature!
    • New Plugin Command: "Picture: Erase All". Added by Olivia.
      • Erases all pictures on the screen because it's extremely tedious to do it one by one.
    • New Plugin Command: "Picture: Erase Range"
      • Erases all pictures within a range of numbers because it's extremely tedious to do it one by one.
  • Optimization Update
    • Added a more accurate means of parsing numbers for Digit Grouping.
    • Window_Base.prototype.textSizeEx now stores data to a cache.
  • Documentation Update
    • Added a section to Major Changes: New Hard-Coded Features on Digit Grouping and explaining its intricacies.
    • Added a note to Plugin Parameters > UI > Reposition Actors to ignore the setting if using the Battle Core.


Version 1.01: August 23, 2020

  • Bug Fixes!
    • Digit grouping fixed to allow text codes to detect values larger than 1000. Fix made by Olivia and Yanfly.
    • Param Plus, Rate, Flat notetags fixed. Fix made by Yanfly.
  • New Experimental Feature Added:
    • JS: Quick Functions found in the Plugin Parameters


Version 1.00: August 20, 2020

  • Finished Plugin!

End of File