Difference between revisions of "Core Engine VisuStella MZ"

From Yanfly.moe Wiki
Jump to navigation Jump to search
(Changelog)
 
(185 intermediate revisions by 3 users not shown)
Line 30: Line 30:
 
{{ExtensionPluginsMZ}}
 
{{ExtensionPluginsMZ}}
 
* [[Action Sequence Camera VisuStella MZ]]
 
* [[Action Sequence Camera VisuStella MZ]]
 +
* [[Action Sequence Impact VisuStella MZ]]
 +
* [[Action Sequence Projectiles VisuStella MZ]]
 
* [[Anti-Damage Barriers VisuStella MZ]]
 
* [[Anti-Damage Barriers VisuStella MZ]]
 +
* [[Battle System - BTB VisuStella MZ]]
 
* [[Battle System - CTB VisuStella MZ]]
 
* [[Battle System - CTB VisuStella MZ]]
 +
* [[Battle System - ETB VisuStella MZ]]
 +
* [[Battle System - FTB VisuStella MZ]]
 +
* [[Battle System - OTB VisuStella MZ]]
 +
* [[Battle System - PTB VisuStella MZ]]
 +
* [[Battle System - STB VisuStella MZ]]
 +
* [[Battle Voices VisuStella MZ]]
 +
* [[Boost Action VisuStella MZ]]
 +
* [[Chain Battles VisuStella MZ]]
 +
* [[Challenge System VisuStella MZ]]
 +
* [[Character Creation System VisuStella MZ]]
 +
* [[Date and Time System VisuStella MZ]]
 
* [[Enemy Levels VisuStella MZ]]
 
* [[Enemy Levels VisuStella MZ]]
 +
* [[Equip Battle Skills VisuStella MZ]]
 +
* [[Equip Medal System VisuStella MZ]]
 +
* [[Equip Passive System VisuStella MZ]]
 +
* [[Equipment Set Bonuses VisuStella MZ]]
 +
* [[Field Skills VisuStella MZ]]
 +
* [[Frontview Battle UI VisuStella MZ]]
 +
* [[Furniture System VisuStella MZ]]
 +
* [[Item Amplify Skills VisuStella MZ]]
 +
* [[Lighting Effects VisuStella MZ]]
 +
* [[More Currencies VisuStella MZ]]
 +
* [[Movement Effects VisuStella MZ]]
 +
* [[Picture Effects VisuStella MZ]]
 +
* [[QTE and Trigger System VisuStella MZ]]
 +
* [[Shop Bust Style UI VisuStella MZ]]
 +
* [[Sideview Battle UI VisuStella MZ]]
 +
* [[Skill Mastery VisuStella MZ]]
 +
* [[Tile Grafter System VisuStella MZ]]
 +
* [[Visual Cutin Effect VisuStella MZ]]
 +
* [[Visual Gauge Styles VisuStella MZ]]
 +
* [[Visual Novel Picture Busts VisuStella MZ]]
 
* [[Visual State Effects VisuStella MZ]]
 
* [[Visual State Effects VisuStella MZ]]
 +
* [[Voice Acting Control VisuStella MZ]]
 +
* [[Weather Effects VisuStella MZ]]
  
 
{{Visustella MZ}}
 
{{Visustella MZ}}
  
 
== Introduction ==
 
== Introduction ==
 +
 +
[[File:VisuMZ.001.jpg|600px]]
  
 
The Core Engine plugin is designed to fix any bugs that may have slipped
 
The Core Engine plugin is designed to fix any bugs that may have slipped
Line 74: Line 112:
  
 
---
 
---
 +
 +
=== Attack Skill Trait ===
  
 
<html><img src='https://img.itch.zone/aW1nLzQwMDQ2OTYucG5n/original/O8p6UZ.png'></html>
 
<html><img src='https://img.itch.zone/aW1nLzQwMDQ2OTYucG5n/original/O8p6UZ.png'></html>
 
'''Attack Skill Trait'''
 
  
 
Enemies are unaffected by the Attack Skill Trait. This means if they have
 
Enemies are unaffected by the Attack Skill Trait. This means if they have
Line 86: Line 124:
  
 
---
 
---
 +
 +
=== Auto Battle Actor Skill Usage ===
  
 
<html><img src='https://img.itch.zone/aW1nLzQwMDQ3NTIucG5n/original/kEC235.png'></html>
 
<html><img src='https://img.itch.zone/aW1nLzQwMDQ3NTIucG5n/original/kEC235.png'></html>
 
'''Auto Battle Actor Skill Usage'''
 
  
 
If an actor with Auto Battle has access to a skill but not have any access
 
If an actor with Auto Battle has access to a skill but not have any access
Line 98: Line 136:
 
---
 
---
  
<html><img src='https://img.itch.zone/aW1nLzQwMDQ3MjguZ2lm/original/GevQGx.gif'></html>
+
=== Auto Battle Attack Seal Bypass ===
 +
 
 +
By default, if the attack skill is sealed via a trait and an actor has
 +
auto-battle, the action can still be used via auto-battle. This is now fixed
 +
and actors should not be able to attack via auto-battle if their attack
 +
ability is sealed.
 +
 
 +
---
 +
 
 +
=== Auto Battle Lock Up ===
  
'''Move Picture, Origin Differences'''
+
[[File:CoreEngine_AutoBattleLockUp.png]]
  
If a Show Picture event command is made with an Origin setting of
+
If an auto battle Actor fights against an enemy whose DEF/MDF is too high,
"Upper Left" and a Move Picture event command is made afterwards with an
+
they will not use any actions at all. This can cause potential game freezing
Origin setting of "Center", RPG Maker MZ would originally have it instantly
+
and softlocks. This plugin will change that and have them default to a
jump into the new origin setting without making a clean transition between
+
regular Attack.
them. This plugin will create that clean transition between origins.
 
  
 
---
 
---
  
== Major Changes: New Hard-Coded Features ==
+
=== Auto Save After New Game ===
  
This plugin adds some new hard-coded features to RPG Maker MZ's functions.
+
Normally, when starting a new game through the "New Game" option, there is
The following is a list of them.
+
no auto save trigger. However, if you start a new game or load a saved game,
 +
then go to the Game End screen, return back to the title screen, then start
 +
a New Game, the auto save trigger occurs when it shouldn't. The Core Engine
 +
will now patch this and prevent the trigger from taking place.
  
 
---
 
---
  
=== Scroll-Linked Pictures ===
+
=== Battle Forced End Action Crash ===
  
If a Parallax has a ! at the start of its filename, it is bound to the map
+
Depending on various circumstances, currently active battlers can be cleared
scrolling. The same thing now happens with pictures. If a Picture has a ! at
+
from the battle system at will due to a number of reasons. However, if it
the start of its filename, it is bound to the map's scrolling as well.
+
just so happens that the targets are cleared, too, with actions remaining,
 +
then a crash will follow up. This plugin will prevent that change. Fix made
 +
by Olivia.
  
 
---
 
---
  
=== Movement Route Scripts ===
+
=== Debug Console Refresh Bug ===
  
If code in a Movement Route Script command fails, instead of crashing the
+
When pressing F5 to refresh while the debug console (DevTools) is open,
game, it will now act as if nothing happened except to display the cause of
+
some graphics will fail to load properly. This started occurring since the
the error inside the console.
+
RPG Maker MZ 1.5.0 update and the code for loading the images has now been
 +
reverted to the 1.4.4 version where it was last stable.
  
 
---
 
---
  
=== Script Call Failsafes ===
+
=== 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.
  
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
+
=== Invisible Battle Sprites ===
console.
 
  
---
+
[[File:CoreEngine_InvisibleBattlerBug.png]]
  
=== Digit Grouping ===
+
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.
  
- 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
+
=== Instant Text Discrepancy for Window_Message ===
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
+
[[File:CoreEngine_InstantTextBug.png|600px]]
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
+
Window_Message displays text differently when it draws letters one by one
in order for text codes to be preserved accurately. \I[1234] will remain as
+
versus when the text is displayed instantly. This isn't noticeable with the
\I[1234].
+
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.
  
- If you would like to enter in a number without digit grouping, surround it
+
Plugin Parameters > QoL Settings > Misc > Font Width Fix
with <nowiki>{{ and }}. Typing in {{1234567890}}</nowiki> will yield 1234567890.
 
  
 
---
 
---
  
{{Notetags MZ}}
+
=== Move Picture, Origin Differences ===
  
{{VisuMZ Core Engine Notetags}}
+
<html><img src='https://img.itch.zone/aW1nLzQwMDQ3MjguZ2lm/original/GevQGx.gif'></html>
  
{{Plugin Commands MZ}}
+
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.
  
{{VisuMZ Core Engine Plugin Commands}}
+
---
  
== Plugin Parameters ==
+
=== Overly-Protective Substitute ===
  
=== Quality of Life Settings ===
+
[[File:CoreEngine_BugSubHeal.png]]
  
[[File:CoreEnginePluginParam01.png]]
+
When an ally with critical health is being targeted by a friendly non-
 +
Certain Hit skill (such as a heal or buff) and another ally has the
 +
substitute state, the other ally would "protect" the originally targeted
 +
ally and take the heal or buff.
  
A variety of (optional) settings and changes are added with the Core Engine
+
The new changed behavior is that now, substitute will not trigger for any
to improve the quality of life for both the game devs and players alike.
+
actions whose scope targets allies.
  
 
---
 
---
  
Play Test
+
=== Skill List Active After Party Member Change ===
 +
 
 +
If the skill list is active (ie. the player can move the cursor around) and
 +
the party member currently being viewed is changed via the button commands,
 +
then previously, RPG Maker MZ would still have that window be active despite
 +
having the cursor hidden temporarily. Upon pressing direction buttons, the
 +
cursor reveals itself and both the skill type window and skill list window
 +
are both active, making way for lots of potential problems to happen.
  
  New Game on Boot:
+
---
  - Automatically start a new game on Play Test?
 
  - Only enabled during Play Test.
 
  
  No Play Test Mode:
+
=== Sprite Removal and Destroy Crash ===
  - Force the game to be out of Play Test mode when play testing.
 
  
  Open Console on Boot:
+
A texture check will now occur for sprites that are being removed and
  - Open the Debug Console upon booting up your game?
+
destroyed in order to prevent crashes. In the off chance that someone
  - Only enabled during Play Test.
+
creates a sprite through a script call and removes it through such, the
 +
likelihood of this occurance becomes higher. This makes the "destroy"
 +
property take into account a texture check in order to see if the sprite
 +
removal is taking extra steps and will reduce those extra steps.
  
  F6: Toggle Sound:
+
---
  - F6 Key Function: Turn on all sound to 100% or to 0%, toggling between
+
 
    the two.
+
=== Status Window Name Vertical Cutoffs ===
  - Only enabled during Play Test.
 
  
  F7: Toggle Fast Mode:
+
[[File:CoreEngine_BugTextCrop.png]]
  - F7 Key Function: Toggle fast mode.
 
  - Only enabled during Play Test.
 
  
  NewGame > CommonEvent:
+
In the battle status windows, whenever actor names are displayed, the bitmap
  - Runs a common event each time a new game is started.
+
used to display their name text do not extend vertically all the way,
  - Only enabled during Play Test.
+
causing letters like lowercase "Q" and "G" to be cut off, making them hard
 +
to distinguish from one another. The Core Engine will remedy this by
 +
extending the bitmap to allow enough room. Fix made by Irina.
  
 
---
 
---
  
Digit Grouping
+
=== Termination Clear Effects ===
  
  Standard Text:
+
In RPG Maker MZ, requesting an animation while transitioning between
  - Make numbers like 1234567 appear like 1,234,567 for standard text
+
scenes, such as going from the map scene to the battle scene, can cause
    inside windows?
+
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.
  
  Ex Text:
+
---
  - Make numbers like 1234567 appear like 1,234,567 for ex text,
 
    written through drawTextEx (like messages)?
 
  
  Damage Sprites:
+
=== Timer Sprite ===
  - Make numbers like 1234567 appear like 1,234,567 for in-battle
 
    damage sprites?
 
  
  Gauge Sprites:
+
By default, RPG Maker MZ adds Sprite_Timer into its spriteset, either for
  - Make numbers like 1234567 appear like 1,234,567 for visible gauge
+
maps or for battles. There is one major problem with this: when spritesets
    sprites such as HP, MP, and TP gauges?
+
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.
  
 
---
 
---
  
Player Benefit
+
=== Unusable Battle Items ===
  
  Encounter Rate Min:
+
If any party member is able to use an item in battle, then all party members
  - Minimum number of steps the player can take without any
+
are able to use said item, even if that party member is supposed to be
    random encounters.
+
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.
  
  Escape Always:
+
---
  - If the player wants to escape a battle, let them escape the battle
+
 
    with 100% chance.
+
=== Water Tile Bug ===
 +
 
 +
[[File:CoreEngine_WaterTileBug.gif]]
 +
 
 +
It seems like there's a new bug that occurs if you create a tileset from
 +
scratch in RPG Maker MZ version 1.5.0+ and version 1.6.0+! What this bug
 +
does is it causes many tiles to become water tiles without intending to.
 +
You can find this out by turning off all the plugins in your project,
 +
putting a Ship or Boat on what are normally ground tiles, and then seeing
 +
the Ship or Boat traverse through it.
 +
 
 +
There are two ways to fix this. We cannot fix it through code in this plugin
 +
as it's a problem that involves the tileset json data there are ways to work
 +
around it so that you can get the proper water-flags to go where they need
 +
to be at.
  
  Accuracy Formula:
+
# Copy a working un-bugged tileset onto the currently bugged one and reapply the tile features like passability, terrain tags, etc. This will make sure the water-passability tiles get copied over correctly.
  - Accuracy formula calculation change to
+
# If you're on RPG Maker MZ version 1.5.0 or above, select a working un-bugged tileset (usually a pre-existing tileset when a new project is made), click the "Copy Page" button, go to the bugged tileset and press "Paste Page". You'll have to reapply any different properties like passabilities and terrain tags, but the water tile flags should now be working properly.
    Skill Hit% * (User HIT - Target EVA) for better results.
 
  
  Accuracy Boost:
+
The plugin will not fix the problem itself since flag data is delicate and
  - Boost HIT and EVA rates in favor of the player.
+
should not be tampered with midgame as the changes made by the plugin might
 +
not match the desired settings.
  
  Level Up -> Full HP:
+
This plugin, however, will also send out an alert message when coming across
  Level Up -> Full MP:
+
such a tile. Pay attention to it and do one of the following two steps above
  - Recovers full HP or MP when an actor levels up.
+
to fix the problem.
  
 
---
 
---
  
Misc
+
=== Window Arrows Sprite Tearing ===
  
  Anti-Zoom Pictures:
+
If a window object in RPG Maker MZ were to have an odd number for width size
  - If on, prevents pictures from being affected by zoom.
+
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.
  
  Font Shadows:
+
---
  - If on, text uses shadows instead of outlines.
 
  
  Font Smoothing:
+
=== Window Client Area Scaling Bug ===
  - If on, smoothes fonts shown in-game.
 
  
  Key Item Protection:
+
If the window has a scale value different from 1.0, the client area (the
  - If on, prevents Key Items from being able to be sold and from being
+
interactable parts) will not scale properly and appear clipped out. This
    able to be consumed.
+
is now fixed by adjusting the client area to the window's scale values and
 +
rounding upward to the nearest whole number.
  
  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.
 
  
  No Tile Shadows:
+
=== Window Skin Bleeding ===
  - Removes tile shadows from being displayed in-game.
 
  
  Pixel Image Rendering:
+
[[File:CoreEngineWindowSkinBleeding.png|600px]]
  - If on, pixelates the image rendering (for pixel games).
 
  
  Require Focus?
+
'''This bug is fixed in the core scripts for RPG Maker MZ v1.3.0+.'''
  - 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:
+
Since the v1.2.0 update, Window.prototype._refreshBack's frame value has
  - Makes events only able to collide with one another if they're
+
been set from 96 to 95. This results in the window skin bleeding past the
  'Same as characters' priority.
+
window's intended borders. The Core Engine now reverts this change to
 +
prevent the bleeding effect from happening.
  
 
---
 
---
  
=== Battle System ===
+
== Major Changes: New Hard-Coded Features ==
  
[[File:CoreEngine_Update5_Param1.png]]
+
This plugin adds some new hard-coded features to RPG Maker MZ's functions.
 
+
The following is a list of them.
Choose which battle system to use for your game.
 
  
 
---
 
---
  
<pre>
+
=== Scroll-Linked Pictures ===
  
  Database Default (Use game database setting)
+
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.
  
  -
+
---
  
  DTB: Default Turn Battle
+
=== Movement Route Scripts ===
  TPB Active: Time Progress Battle (Active)
 
  TPB wait: Time Progress Battle (Wait)
 
  
  -
+
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.
  
  CTB: Charge Turn Battle (Req VisuMZ_2_BattleSystemCTB)
+
---
  OTB: Order Turn Battle (Req VisuMZ_2_BattleSystemOTB)
 
  STB: Standard Turn Battle (Req VisuMZ_2_BattleSystemSTB)
 
  
  -
+
=== Script Call Failsafes ===
  
</pre>
+
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.
  
 
---
 
---
  
=== Color Settings ===
+
=== Digit Grouping ===
  
[[File:CoreEnginePluginParam02.png]]
+
- 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.
  
These settings allow you, the game dev, to have more control over which
+
- Digit Grouping will follow the rules of whatever country/locale the Plugin
colors appear for what conditions found in the game. You can use regular
+
Parameters are set to. If it's to default 'en-US', then 1234567.123456 will
numbers to use the colors predetermined by the game's Window Skin or you
+
become 1,234,567.123456. Set it to 'es-ES' and it becomes 1.234.567,123456
can use the #rrggbb format for a hex color code.
+
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].
  
You can find out what hex codes belong to which color from this website:
+
- If you would like to enter in a number without digit grouping, surround it
https://htmlcolorcodes.com/
+
with <nowiki>{{ and }}. Typing in {{1234567890}}</nowiki> will yield 1234567890.
  
 
---
 
---
  
<pre>
+
=== Show Scrolling Text, additional functionality ===
Basic Colors
+
 
- These are colors that almost never change and are used globally throughout
+
[[File:CoreEngine_Update25_Feature1.png]]
  the in-game engine.
 
  
  Normal:
+
The event command "Show Scrolling Text" now has additional functionality as
  System:
+
long as the VisuStella MZ Core Engine is installed. If the game dev inserts
  Crisis:
+
"// Script Call" (without the quotes) inside the scrolling text, then the
  Death:
+
entirity of the Show Scrolling Text event command will be ran as a giant
  Gauge Back:
+
script call event command.
  HP Gauge:
+
 
  MP Gauge:
+
The reason why this functionality is added is because the "Script..." event
  MP Cost:
+
command contains only 12 lines maximum. This means for any script call
  Power Up:
+
larger than 12 lines of code cannot be done by normal means as each script
  Power Down:
+
call is ran as a separate instance.
  CT Gauge:
+
 
  TP Gauge:
+
By repurposing the "Show Scrolling Text" event command to be able to
  Pending Color:
+
function as an extended "Script..." event command, such a thing is now
  EXP Gauge:
+
possible with less hassle and more lines to code with.
  MaxLv Gauge:
+
 
  - Use #rrggbb for custom colors or regular numbers
+
This effect does not occur if the Show Scrolling Text event command does not
  for text colors from the Window Skin.
+
have "// Script Call" in its contents.
</pre>
 
  
 
---
 
---
  
<pre>
+
{{Notetags MZ}}
Alpha Colors:
+
 
- These are colors that have a bit of transparency to them and are specified
+
{{VisuMZ Core Engine Notetags}}
  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).
 
  
  Outline Color:
+
{{Plugin Commands MZ}}
  Dim Color:
 
  Item Back Color:
 
  - Colors with a bit of alpha settings.
 
  - Format rgba(0-255, 0-255, 0-255, 0-1)
 
</pre>
 
  
---
+
{{VisuMZ Core Engine Plugin Commands}}
  
<pre>
+
== Plugin Parameters ==
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:
+
=== Quality of Life Settings ===
  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:
+
[[File:CoreEnginePluginParam01.png]]
  - Code used for determining whatcolor to use for parameter changes.
 
  
  JS: Damage Colors:
+
A variety of (optional) settings and changes are added with the Core Engine
  - Code used for determining what color to use for damage types.
+
to improve the quality of life for both the game devs and players alike.
</pre>
 
  
---
 
  
=== Gold Settings ===
 
  
[[File:CoreEnginePluginGold.png|600px]]
+
{|
 +
{{Featured Article
 +
|link = Useful Shortcuts for Playtesting
 +
|title = Useful Shortcuts for Playtesting
 +
|author = Arisu
 +
|date = 2024 January 5
 +
|image = Shortcuts.jpg
 +
|imgwidth = 100px
 +
|content = Read about some useful shortcuts you can enable with the [[Core Engine VisuStella MZ|VisuStella Core Engine]] here.
 +
}}
 +
|}
  
[[File:CoreEnginePluginParam03.png]]
+
---
  
Gold is the main currency in RPG Maker MZ. The settings provided here will
+
Play Test
determine how Gold appears in the game and certain behaviors Gold has.
 
  
---
+
  New Game on Boot:
 +
  - Automatically start a new game on Play Test?
 +
  - Only enabled during Play Test.
  
Gold Settings
+
  No Play Test Mode:
 +
  - Force the game to be out of Play Test mode when play testing.
  
   Gold Max:
+
   Open Console on Boot:
   - Maximum amount of Gold the party can hold.
+
   - Open the Debug Console upon booting up your game?
   - Default 99999999
+
   - Only enabled during Play Test.
  
   Gold Font Size:
+
   F6: Toggle Sound:
   - Font size used for displaying Gold inside Gold Windows.
+
   - F6 Key Function: Turn on all sound to 100% or to 0%, toggling between
   - Default: 26
+
    the two.
 
+
   - Only enabled during Play Test.
   Gold Icon:
+
 
   - Icon used to represent Gold.
+
   F7: Toggle Fast Mode:
   - Use 0 for no icon.
+
   - F7 Key Function: Toggle fast mode.
 +
   - Only enabled during Play Test.
  
   Gold Overlap:
+
   NewGame > CommonEvent:
   - Text used too much Gold to fit in the window.
+
   - Runs a common event each time a new game is started.
 +
  - Only enabled during Play Test.
  
 
---
 
---
  
=== Image Loading ===
+
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.
 +
 
 +
  Shift+R: Recover All:
 +
  - For Play Test only!
 +
  - During battle, pressing SHIFT + R will refill the whole party's HP
 +
    and MP and status.
  
Not all images are loaded at once in-game. RPG Maker MZ uses asynchronous
+
  Shift+T: Full TP
loading which means images are loaded when needed. This may cause delays in
+
  - For Play Test only!
when you want certain images to appear. However, if an image is loaded
+
  - During battle, pressing SHIFT + T will refill the whole party's TP.
beforehand, they can be used immediately provided they aren't removed from
 
the image cache.
 
  
 
---
 
---
  
Image Loading
+
Digit Grouping
  
   img/animations/:
+
   Standard Text:
  img/battlebacks1/:
+
   - Make numbers like 1234567 appear like 1,234,567 for standard text
  img/battlebacks2/:
+
     inside windows?
  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?
 
  
---
+
  Ex Text:
 +
  - Make numbers like 1234567 appear like 1,234,567 for ex text,
 +
    written through drawTextEx (like messages)?
  
=== Menu Background Settings ===
+
  Damage Sprites:
 +
  - Make numbers like 1234567 appear like 1,234,567 for in-battle
 +
    damage sprites?
  
[[File:CoreEnginePluginMenuBg.png|600px]]
+
  Gauge Sprites:
 +
  - Make numbers like 1234567 appear like 1,234,567 for visible gauge
 +
    sprites such as HP, MP, and TP gauges?
  
[[File:CoreEnginePluginParam04.png]]
+
---
 +
 
 +
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.
  
These settings in the Plugin Parameters allow you to adjust the background
+
  Accuracy Boost:
images used for each of the scenes. The images will be taken from the game
+
  - Boost HIT and EVA rates in favor of the player.
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
+
  Level Up -> Full HP:
Shop scene, and the Actor Naming scene.
+
  Level Up -> Full MP:
 +
  - Recovers full HP or MP when an actor levels up.
  
 
---
 
---
  
Menu Background Settings:
+
Misc
  
   Scene_Menu:
+
   Animation: Mirror Offset X:
  Scene_Item:
+
   - When animations are mirrored, mirror their Offset X values, too.
   Scene_Skill:
+
   - The animation name tags <Mirror Offset X> and <No Mirror Offset X> will
   Scene_Equip:
+
    override this effect for that specific animation.
  Scene_Status:
 
  Scene_Options:
 
  Scene_Save:
 
  Scene_Load:
 
  Scene_GameEnd:
 
  Scene_Shop:
 
  Scene_Name:
 
  - Individual background settings for the scene.
 
  
   Scene_Unlisted
+
   Anti-Zoom Pictures:
   - Individual background settings for any scenes that aren't listed above.
+
   - If on, prevents pictures from being affected by zoom.
  
---
+
  Font Shadows:
 +
  - If on, text uses shadows instead of outlines.
  
Background Settings
+
  Font Smoothing:
 +
  - If on, smoothes fonts shown in-game.
  
   Snapshop Opacity:
+
   Font Width Fix:
   - Snapshot opacity for the scene.
+
   - Fixes the font width issue with instant display non-monospaced fonts
 +
    in the Message Window.
  
   Background 1:
+
   Key Item Protection:
   - Filename used for the bottom background image.
+
   - If on, prevents Key Items from being able to be sold and from being
  - Leave empty if you don't wish to use one.
+
    able to be consumed.
  
   Background 2:
+
   Map Name Text Code:
   - Filename used for the upper background image.
+
   - If on, map names will use text codes.
   - Leave empty if you don't wish to use one.
+
   - If off, only the raw map name will be used.
  
---
+
  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.
  
=== Menu Button Assist Window ===
+
  MV Animation Rate:
 +
  - Adjusts the rate at which MV animations play.
 +
  - Default: 4.
 +
  - Lower for faster.
 +
  - Higher for slower.
  
[[File:CoreEnginePluginMenuAssist.png|600px]]
+
  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.
  
[[File:CoreEnginePluginParam06.png]]
+
  No Tile Shadows:
 +
  - Removes tile shadows from being displayed in-game.
  
In most modern RPG's, there exist small windows on the screen which tell the
+
  Pixel Image Rendering:
player what the control schemes are for that scene. This plugin gives you
+
  - If on, pixelates the image rendering (for pixel games).
the option to add that window to the menu scenes in the form of a Button
 
Assist Window.
 
  
---
+
  Require Focus?
 +
  - Requires the game to be focused? If the game isn't focused, it will
 +
    pause if it's not the active window.
  
General
+
[[File:CoreEngine_Update56_Param1.png]]
 +
 
 +
<pre>
 +
  Shortcut Scripts:
 +
  - Enables shortcut-based script variables and functions that can be used
 +
    for script calls.
 +
  - Shortcut list enabled for this is as follows:
  
  Enable:
+
    $commonEvent(id)
  - Enable the Menu Button Assist Window.
+
    - Queues a common event.
 +
    - This does not interrupt the current event to run the desired common
 +
      event. Any queued common events will run after the current event list
 +
      has finished.
 +
    - Replace 'id' with the ID of the common event you wish to queue.
 +
    - Common events only run in the map scene and battle scene.
  
  Location:
+
    $onceParallel(id)
  - Determine the location of the Button Assist Window.
+
    - Runs a common event in the background as a once parallel event.
  - Requires Plugin Parameters => UI => Side Buttons ON.
+
    - Once parallel events will run in the background like a parallel
 +
      process, except that it does not repeat after finishing.
 +
    - Replace 'id' with the ID of the common event you wish to run.
 +
    - Only works in the map scene and battle scene. Battle scene usage will
 +
      require VisuMZ_1_BattleCore.
  
  Background Type:
+
    $scene
  - Select background type for this window.
+
    - Returns current scene.
  
---
+
    $spriteset
 +
    - Returns current scene's spriteset if there is one.
  
Text
+
    $subject
 +
    - Returns last recorded identity of the battle's subject/user.
  
  Text Format:
+
    $targets
  - Format on how the buttons are displayed.
+
    - Returns last recorded targets marked in battle.
  - Text codes allowed. %1 - Key, %2 - Text
 
  
  Multi-Key Format:
+
    $target
  - Format for actions with multiple keys.
+
    - Returns last recorded target marked in battle.
  - Text codes allowed. %1 - Key 1, %2 - Key 2
+
    - Works better with VisuMZ_1_BattleCore.
  
  OK Text:
+
    $event
  Cancel Text:
+
    - Returns currently initiated map event.
  Switch Actor Text:
+
</pre>
  - Default text used to display these various actions.
 
  
---
+
  Smart Event Collision:
 +
  - Makes events only able to collide with one another if they're
 +
  'Same as characters' priority.
  
Keys
+
   Subfolder Name Purge:
 
+
   - Purge subfolder name from Plugin Parameters when reading data to let
   Key: Unlisted Format:
+
    Plugin Commands work properly.
   - If a key is not listed below, use this format.
+
   - This is for plugins (such as the VisuMZ library) that utilize dynamic
  - Text codes allowed. %1 - Key
+
    name registrations for Plugin Commands. Turn this on if you plan on
 
+
    using subfolders with VisuMZ plugins.
  Key: Up:
 
  Key: Down:
 
  Key: Left:
 
  Key: Right:
 
  Key: A through Z:
 
   - How this key is shown in-game.
 
  - Text codes allowed.
 
  
 
---
 
---
  
=== Menu Layout Settings ===
+
=== Battle System ===
  
[[File:CoreEnginePluginParam05.png]]
+
[[File:CoreEngine_Update5_Param1.png]]
  
These settings allow you to rearrange the positions of the scenes accessible
+
Choose which battle system to use for your game.
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
+
<pre>
 +
 
 +
  Database Default (Use game database setting)
  
  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.
 
  
---
+
  DTB: Default Turn Battle
 +
  TPB Active: Time Progress Battle (Active)
 +
  TPB Wait: Time Progress Battle (Wait)
  
Scene Window Settings
+
  -
  
   Background Type:
+
   BTB: Brave Turn Battle (Req VisuMZ_2_BattleSystemBTB)
   - Selects the background type for the selected window.
+
   CTB: Charge Turn Battle (Req VisuMZ_2_BattleSystemCTB)
   - Window
+
   OTB: Order Turn Battle (Req VisuMZ_2_BattleSystemOTB)
   - Dim
+
   STB: Standard Turn Battle (Req VisuMZ_2_BattleSystemSTB)
  - Transparent
 
  
   JS: X, Y, W, H
+
   -
  - Code used to determine the dimensions for the selected window.
+
 
 +
</pre>
  
 
---
 
---
  
Scene_Title Settings
+
=== Color Settings ===
- The following are settings unique to Scene_Title.
 
  
Title Screen
+
[[File:CoreEnginePluginParam02.png]]
  
  Document Title Format:
+
These settings allow you, the game dev, to have more control over which
  - Format to display text in document title.
+
colors appear for what conditions found in the game. You can use regular
  - %1 - Main Title, %2 - Subtitle, %3 - Version
+
numbers to use the colors predetermined by the game's Window Skin or you
 +
can use the #rrggbb format for a hex color code.
  
  Subtitle:
+
If the game's Window Skin is changed mid-game, the colors used will still
  - Subtitle to be displayed under the title name.
+
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:
+
You can find out what hex codes belong to which color from this website:
  - Version to be display in the title screen corner.
+
https://htmlcolorcodes.com/
  
  JS: Draw Title:
+
---
  - Code used to draw the game title.
 
  
  JS: Draw Subtitle:
+
<pre>
  - Code used to draw the game subtitle.
+
Basic Colors
 +
- These are colors that almost never change and are used globally throughout
 +
  the in-game engine.
  
   JS: Draw Version:
+
   Normal:
   - Code used to draw the game version.
+
  System:
 
+
  Crisis:
   Button Fade Speed:
+
  Death:
   - Speed at which the buttons fade in at (1-255).
+
  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.
 +
</pre>
  
 
---
 
---
  
Scene_GameEnd Settings
+
<pre>
- The following are settings unique to Scene_GameEnd.
+
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).
  
   Command Window List:
+
   Window Font Outline:
   - Window commands used by the title screen.
+
  Gauge Number Outline:
   - Add new commands here.
+
  Dim Color:
 +
  Item Back Color:
 +
   - Colors with a bit of alpha settings.
 +
   - Format rgba(0-255, 0-255, 0-255, 0-1)
 +
</pre>
  
 
---
 
---
  
Command Window List
+
<pre>
- This is found under Scene_Title and Scene_GameEnd settings.
+
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.
  
   Symbol:
+
   JS: Actor HP Color:
   - The symbol used for this command.
+
  JS: Actor MP Color:
 +
  JS: Actor TP Color:
 +
   - Code used for determining what HP, MP, or TP color to use for actors.
  
   STR: Text:
+
   JS: Parameter Change:
   - Displayed text used for this title command.
+
   - Code used for determining whatcolor to use for parameter changes.
   - If this has a value, ignore the JS: Text version.
+
 
 +
   JS: Damage Colors:
 +
  - Code used for determining what color to use for damage types.
 +
</pre>
  
  JS: Text:
+
---
  - JavaScript code used to determine string used for the displayed name.
 
  
  JS: Show:
+
=== Gold Settings ===
  - JavaScript code used to determine if the item is shown or not.
 
  
  JS: Enable:
+
[[File:CoreEnginePluginGold.png|600px]]
  - JavaScript code used to determine if the item is enabled or not.
 
  
  JS: Ext:
+
[[File:CoreEnginePluginParam03.png]]
  - JavaScript code used to determine any ext data that should be added.
 
  
  JS: Run Code:
+
Gold is the main currency in RPG Maker MZ. The settings provided here will
  - JavaScript code that runs once this command is selected.
+
determine how Gold appears in the game and certain behaviors Gold has.
  
 
---
 
---
  
[[File:CoreEnginePluginTitleButtons.png|600px]]
+
Gold Settings
  
Title Picture Buttons:
+
  Gold Max:
- This is found under Scene_Title settings.
+
  - Maximum amount of Gold the party can hold.
 +
  - Default 99999999
 +
 
 +
  Gold Font Size:
 +
  - Font size used for displaying Gold inside Gold Windows.
 +
  - Default: 26
  
   Picture's Filename:
+
   Gold Icon:
   - Filename used for the picture.
+
   - Icon used to represent Gold.
 +
  - Use 0 for no icon.
  
   Button URL:
+
   Gold Overlap:
   - URL for the button to go to upon being clicked.
+
   - Text used too much Gold to fit in the window.
  
  JS: Position:
+
---
  - JavaScript code that helps determine the button's Position.
 
  
  JS: On Load:
+
=== Image Loading ===
  - JavaScript code that runs once this button bitmap is loaded.
 
  
  JS: Run Code:
+
Not all images are loaded at once in-game. RPG Maker MZ uses asynchronous
  - JavaScript code that runs once this button is pressed.
+
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.
  
 
---
 
---
  
=== Parameter Settings ===
+
Image Loading
  
[[File:CoreEnginePluginParam07.png]]
+
  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?
  
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.
 
  
---
+
=== Keyboard Input Settings ===
  
Parameter Settings
+
[[File:CoreEngine_KeyboardInput.png|600px]]
  
  Displayed Parameters
+
[[File:CoreEngine_Update28_Param1.png]]
  - A list of the parameters that will be displayed in-game.
 
  - Shown in the Equip Menu.
 
  - Shown in the Status Menu.
 
  
  Extended Parameters
+
Settings for the game that utilize keyboard input. These are primarily for
  - The list shown in extended scenes (for other VisuStella plugins).
+
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.
  
==== 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
+
{{Featured Article
a dead state. If the HP value is above 0, then the battler is living. If it
+
|link = WASD Movement
is 0 or below, the battler is in a dead state unless the battler has a way
+
|title = WASD Movement
to counteract death (usually through immortality). When the battler takes
+
|author = Arisu
damage, it is usually dealt to the HP value and reduces it. If the battler
+
|date = 2023 December 29
is healed, then the HP value is increased. The MaxHP value determines what's
+
|image = WASD.jpg
the maximum amount the HP value can be held at, meaning the battler cannot
+
|imgwidth = 100px
be healed past that point.
+
|content = Read about how to quickly set up WASD movement with the [[Core Engine VisuStella MZ|VisuStella Core Engine]] here.
 +
}}
 +
|}
  
; MMP - MaxMP
+
---
  
- This is the maximum magic points value. Magic points (MP) are typically
+
Controls
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
+
  WASD Movement:
 +
  - Enables or disables WASD movement for your game project.
 +
  - Moves the W page down button to E.
  
- This is the attack value of the battler. By default, this stat is used for
+
  R Button: Dash Toggle:
the purpose of damage calculations only, and is typically used to represent
+
  - Enables or disables R button as an Always Dash option toggle.
the battler's physical attack power. Given normal damage formulas, higher
+
 
values mean higher damage output for physical attacks.
+
---
  
; DEF - Defense
+
Name Input
  
- This is the defense value of the battler. By default, this stat is used
+
  Enable?:
for the purpose of damage calculations only, and is typically used to
+
  - Enables keyboard input for name entry.
represent the battler's physical defense. Given normal damage formulas,
+
  - Only tested with English keyboards.
higher values mean less damage received from physical attacks.
 
  
; MAT - Magic Attack
+
  Default Mode:
 +
  - Select default mode when entering the scene.
 +
    - Default - Uses Arrow Keys to select letters.
 +
    - Keyboard - Uses Keyboard to type in letters.
  
- This is the magic attack value of the battler. By default, this stat is
+
  QWERTY Layout:
used for the purpose of damage calculations only, and is typically used to
+
  - Uses the QWERTY layout for manual entry.
represent the battler's magical attack power. Given normal damage formulas,
 
higher values mean higher damage output for magical attacks.
 
  
; MDF - Magic Defense
+
  Keyboard Message:
 +
  - The message displayed when allowing keyboard entry.
 +
  - You may use text codes here.
  
- This is the magic defense value of the battler. By default, this stat is
+
  Banned Words:
used for the purpose of damage calculations only, and is typically used to
+
  - Players cannot use these words for names.
represent the battler's magical defense. Given normal damage formulas,
+
  - These include words inside the names.
higher values mean less damage received from magical attacks.
+
  - If a banned word is used, a buzzer sound will play.
  
; AGI - Agility
+
---
  
- This is the agility value of the battler. By default, this stat is used to
+
Number Input
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
+
  Enable?:
 
+
  - Enables keyboard input for number entry.
- This is the luck value of the battler. By default, this stat is used to
+
  - Only tested with English keyboards.
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
+
Button Assist
  
   HP Crisis Rate:
+
   Finish Entry:
   - HP Ratio at which a battler can be considered in crisis mode.
+
   - Text used to describe finish entry.
  
   JS: Formula:
+
   Page Change:
   - Formula used to determine the total value all 8 basic parameters:
+
   - Text used to describe character page changing.
  - MaxHP, MaxMP, ATK, DEF, MAT, MDF, AGI, LUK.
 
  
Parameter Caps:
+
  Switch to Keyboard:
 +
  - Text used to describe the keyboard switch.
  
   MaxHP Cap:
+
   Switch To Manual:
  MaxMP Cap:
+
   - Text used to describe the manual entry switch.
  ATK Cap:
 
  DEF Cap:
 
  MAT Cap:
 
  MDF Cap:
 
  AGI Cap:
 
  LUK Cap:
 
   - Formula used to determine the selected parameter's cap.
 
  
 
---
 
---
  
==== X Parameters ====
+
=== Menu Background Settings ===
 +
 
 +
[[File:CoreEnginePluginMenuBg.png|600px]]
  
; HIT - Hit Rate%
+
[[File:CoreEnginePluginParam04.png]]
  
- This determines the physical hit success rate of the any physical action.
+
These settings in the Plugin Parameters allow you to adjust the background
All physical attacks make a check through the HIT rate to see if the attack
+
images used for each of the scenes. The images will be taken from the game
will connect. If the HIT value passes the randomizer check, the attack will
+
project folders img/titles1/ and img/titles2/ to load into the game.
connect. If the HIT value fails to pass the randomizer check, the attack
 
will be considered a MISS.
 
  
; EVA - Evasion Rate%
+
These settings are only available to scenes found within the Main Menu, the
 +
Shop scene, and the Actor Naming scene.
  
- 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%
+
Menu Background Settings:
 
 
- 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%
+
  Blur Strength:
 +
  - Strength used for menu background snapshots.
 +
  - Default: 8. Higher is stronger. Lower is weaker.
  
- This value is put against the Critical Hit Rate% in a multiplicative rate.
+
  Scene_Menu:
If the Critical Hit Rate is 90% and the Critical Evasion Rate is
+
  Scene_Item:
20%, then the randomizer check will make a check against 72% as the values
+
  Scene_Skill:
are calculated by the source code as CRI * (1 - CEV), therefore, with values
+
  Scene_Equip:
as 0.90 * (1 - 0.20) === 0.72.
+
  Scene_Status:
 +
  Scene_Options:
 +
  Scene_Save:
 +
  Scene_Load:
 +
  Scene_GameEnd:
 +
  Scene_Shop:
 +
  Scene_Name:
 +
  - Individual background settings for the scene.
  
; MEV - Magic Evasion Rate%
+
  Scene_Unlisted
 +
  - Individual background settings for any scenes that aren't listed above.
  
- 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%
+
Background Settings
  
- If a magical action connects and passes, there is a chance the magical
+
  Snapshop Opacity:
action can be bounced back to the caster. That chance is the Magic Reflect
+
  - Snapshot opacity for the scene.
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%
+
  Background 1:
 +
  - Filename used for the bottom background image.
 +
  - Leave empty if you don't wish to use one.
  
- If a physical action connects and passes, there is a chance the physical
+
  Background 2:
action can be avoided and a counter attack made by the user will land on the
+
  - Filename used for the upper background image.
attacking unit. This is the Counter Attack Rate. If the randomizer check for
+
  - Leave empty if you don't wish to use one.
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
+
=== Menu Button Assist Window ===
percentage of its MaxHP as gained HP with a 100% success rate.
 
  
; MRG - MP% Regeneration
+
[[File:CoreEnginePluginMenuAssist.png|600px]]
  
- During a battler's regeneration phase, the battler will regenerate this
+
[[File:CoreEnginePluginParam06.png]]
percentage of its MaxMP as gained MP with a 100% success rate.
 
  
; TRG - TP% Regeneration
+
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
  
- During a battler's regeneration phase, the battler will regenerate this
+
  Enable:
percentage of its MaxTP as gained TP with a 100% success rate.
+
  - Enable the Menu Button Assist Window.
  
---
+
  Location:
 +
  - Determine the location of the Button Assist Window.
 +
  - Requires Plugin Parameters => UI => Side Buttons ON.
  
X Parameters
+
  Background Type:
 +
  - Select background type for this window.
  
   JS: Formula:
+
   Split "Escape":
   - Formula used to determine the total value all 10 X parameters:
+
   - Used ONLY for those making their own custom keyboard key input maps.
   - HIT, EVA, CRI, CEV, MEV, MRF, CNT, HRG, MRG, TRG.
+
  - "Split" option makes separate instances of "Cancel" and "Menu" keys.
 +
   - "Don't" option will consolidate both into "Escape" keys.
  
Vocabulary
+
---
  
   HIT:
+
Text
   EVA:
+
 
   CRI:
+
   Text Format:
   CEV:
+
   - Format on how the buttons are displayed.
   MEV:
+
   - Text codes allowed. %1 - Key, %2 - Text
   MRF:
+
 
  CNT:
+
   Multi-Key Format:
   HRG:
+
   - Format for actions with multiple keys.
   MRG:
+
   - Text codes allowed. %1 - Key 1, %2 - Key 2
   TRG:
+
 
   - In-game vocabulary used for the selected X Parameter.
+
   OK Text:
 +
   Cancel Text:
 +
   Switch Actor Text:
 +
   - Default text used to display these various actions.
  
 
---
 
---
  
==== S Parameters ====
+
Keys
  
; TGR - Target Rate
+
  Key: Unlisted Format:
 +
  - If a key is not listed below, use this format.
 +
  - Text codes allowed. %1 - Key
  
- Against the standard enemy, the Target Rate value determines the odds of
+
  Key: Up:
an enemy specifically targeting the user for a single target attack. At 0%,
+
  Key: Down:
the enemy will almost never target the user. At 100%, it will have normal
+
  Key: Left:
targeting opportunity. At 100%+, the user will have an increased chance of
+
  Key: Right:
being targeted.
+
  Key: Shift:
 +
  Key: Tab:
 +
  Key: A through Z:
 +
  - How this key is shown in-game.
 +
  - Text codes allowed.
 +
 
 +
---
  
: NOTE: For those using the Battle A.I. Core, any actions that have specific
+
=== Controller Button Assist Settings ===
target conditions will bypass the TGR rate.
 
  
; GRD - Guard Effect
+
[[File:CoreEngine_Update95_Param1.png]]
  
- This is the effectiveness of guarding. This affects the guard divisor
+
These are sub-settings for the Button Assist Window Plugin Parameters. Where
value of 2. At 100% GRD, damage will become 'damage / (2 * 1.00)'. At 50%
+
the Button Assist Window Plugin Parameters are focused on keyboard entries,
GRD, damage will become 'damage / (2 * 0.50)'. At 200% GRD, damage will
+
these sections are focused on gamepad controllers.
become 'damage / (2 * 2.00)' and so forth.
 
  
; REC - Recovery Effect
+
Add multiple gamepads to the list to give them different button assist text.
 +
If a gamepad is being used but not listed here, the button assist text will
 +
default to the keyboard version.
  
- This is how effective heals are towards the user. The higher the REC rate,
+
For those looking for more information regarding controllers, visit this
the more the user is healed. If a spell were to heal for 100 and the user
+
site: [https://gamepad-tester.com/ https://gamepad-tester.com/]
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
+
ID Information
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
+
  Controller ID Name:
 +
  - Exact string used for this controller ID.
 +
  - Plugin Command "Debug: Current Controller ID" for ID help.
 +
  - Example: Xbox 360 Controller (XInput STANDARD GAMEPAD)
  
- This rate affects how much MP skills with an MP Cost will require to use.
+
  Similarity Match:
If the user has 100% MCR, then the MP Cost will be standard. If the user has
+
  - Partial string used to check for controller ID.
50% MCR, then all skills that cost MP will cost only half the required MP.
+
  - Plugin Command "Debug: Current Controller ID" for ID help.
If the user has 200% MCR, then all skills will cost 200% their MP cost.
+
  - This check occurs secondary to the exact name.
 +
  - Example: Xbox
  
; TCR - TP Charge Rate
+
---
  
- This rate affects how much TP skills with an TP will charge when gaining
+
Directions
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
+
  Up:
 +
  Left:
 +
  Right:
 +
  Down:
 +
  - How this button is shown in-game.
 +
  - Text codes allowed.
  
- 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
+
Actions
  
- This rate affects how much damage the user will take from magical damage.
+
  OK:
If the user has 100% MDR, then the user takes the normal amount. If the user
+
  Cancel:
has 50% MDR, then all magical damage dealt to the user is halved. If the
+
  Menu:
user has 200% MDR, then all magical damage dealt to the user is doubled.
+
  Shift:
 +
  Page Up:
 +
  Page Down:
 +
  - How this button is shown in-game.
 +
  - Text codes allowed.
 +
  - *NOTE*: Controllers use a different mapping scheme from keyboards.
 +
    - The "cancel" button is separate from the "menu" button though, for the
 +
      majority of the button assist window help text, we'll be referring to
 +
      the cancel button usually.
  
; FDR - Floor Damage Rate
+
---
  
- On the field map, this alters how much damage the user will take when the
+
=== Menu Layout Settings ===
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
+
[[File:CoreEnginePluginParam05.png]]
  
- This determines the amount of experience gain the user whenever the user
+
These settings allow you to rearrange the positions of the scenes accessible
gains any kind of EXP. At 100% EXR, the rate of experience gain is normal.
+
from the Main Menu, the Shop scene, and the Actor Naming scene. This will
At 50%, the experience gain is halved. At 200%, the experience gain for the
+
require you to have some JavaScript knowledge to make the windows work the
user is doubled.
+
way you would like.
  
 
---
 
---
  
S Parameters
+
Menu Layout Settings
  
   JS: Formula
+
   Scene_Title:
   - Formula used to determine the total value all 10 S parameters:
+
   Scene_Menu:
   - TGR, GRD, REC, PHA, MCR, TCR, PDR, MDR, FDR, EXR.
+
   Scene_Item:
 
+
   Scene_Skill:
Vocabulary
+
   Scene_Equip:
 
+
   Scene_Status:
  TGR:
+
   Scene_Options:
   GRD:
+
   Scene_Save:
   REC:
+
   Scene_Load:
   PHA:
+
   Scene_GameEnd:
   MCR:
+
   Scene_Shop:
   TCR:
+
   Scene_Name:
   PDR:
+
   - Various options on adjusting the selected scene.
   MDR:
 
   FDR:
 
   EXR:
 
   - In-game vocabulary used for the selected S Parameter.
 
  
 
---
 
---
  
Icons
+
Scene Window Settings
  
   Draw Icons?
+
   Background Type:
   - Draw icons next to parameter names?
+
   - Selects the background type for the selected window.
 
+
  - Window
   MaxHP, MaxMP, ATK, DEF, MAT, MDF, AGI, LUK:
+
   - Dim
   HIT, EVA, CRI, CEV, MEV, MRF, CNT, HRG, MRG, TRG:
+
   - Transparent
   TGR, GRD, REC, PHA, MCR, TCR, PDR, MDR, FDR, EXR:
+
 
   - Icon used for the selected parameter.
+
   JS: X, Y, W, H
 +
   - Code used to determine the dimensions for the selected window.
  
 
---
 
---
  
=== Custom Parameters Settings ===
+
Scene_Title Settings
 +
- The following are settings unique to Scene_Title.
  
[[File:CoreEngine_CustomParam1.png]]
+
Title Screen
  
[[File:CoreEngine_CustomParam2.png]]
+
  Document Title Format:
 +
  - Format to display text in document title.
 +
  - %1 - Main Title, %2 - Subtitle, %3 - Version
  
[[File:CoreEngine_CustomParam3.png]]
+
  Subtitle:
 +
  - Subtitle to be displayed under the title name.
  
As of version 1.07, you can add Custom Parameters to your game if RPG Maker
+
  Version:
MZ's default set of parameters isn't enough for you. These parameters can
+
  - Version to be display in the title screen corner.
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.
 
  
---
+
  JS: Draw Title:
 +
  - Code used to draw the game title.
  
Custom Parameter
+
  JS: Draw Subtitle:
 +
  - Code used to draw the game subtitle.
  
   Parameter Name:
+
   JS: Draw Version:
   - What's the parameter's name?
+
   - Code used to draw the game version.
  - Used for VisuStella MZ menus.
 
  
   Abbreviation:
+
   Button Fade Speed:
   - What abbreviation do you want to use for the parameter?
+
   - Speed at which the buttons fade in at (1-255).
  - 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:
+
Scene_GameEnd Settings
  - What kind of number value will be returned with this parameter?
+
- The following are settings unique to Scene_GameEnd.
    - Integer (Whole Numbers Only)
 
    - Float (Decimals are Allowed)
 
  
   JS: Value:
+
   Command Window List:
   - Run this code when this parameter is to be returned.
+
   - Window commands used by the title screen.
 +
  - Add new commands here.
  
 
---
 
---
  
Instructions on Adding Custom Parameters to VisuStella Menus
+
Command Window List
 +
- This is found under Scene_Title and Scene_GameEnd settings.
  
In the Core Engine and Elements and Status Menu Core plugins, there are
+
  Symbol:
plugin parameter fields for you to insert the parameters you want displayed
+
  - The symbol used for this command.
and visible to the player.
 
  
Insert in those the abbreviation of the custom parameter. For example, if
+
  STR: Text:
you want to add the "Strength" custom parameter and the abbreviation is
+
  - Displayed text used for this title command.
"str", then add "str" to the Core Engine/Elements and Status Menu Core's
+
  - If this has a value, ignore the JS: Text version.
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.
 
  
---
+
  JS: Text:
 +
  - JavaScript code used to determine string used for the displayed name.
  
Instructions on Using Custom Parameters as Mechanics
+
  JS: Show:
 +
  - JavaScript code used to determine if the item is shown or not.
  
If you want to use a custom parameter in, say, a damage formula, refer to
+
  JS: Enable:
the abbreviation you have set for the custom parameter. For example, if you
+
  - JavaScript code used to determine if the item is enabled or not.
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
+
  JS: Ext:
"str" for "Strength" and "con" for "Constitution":
+
  - JavaScript code used to determine any ext data that should be added.
  
   a.str - b.con
+
   JS: Run Code:
 
+
  - JavaScript code that runs once this command is selected.
These values are attached to the Game_Battlerbase prototype class.
 
  
 
---
 
---
  
Instructions on Setting Custom Parameter Values
+
[[File:CoreEnginePluginTitleButtons.png|600px]]
  
This requires JavaScript knowledge. There is no way around it. Whatever code
+
Title Picture Buttons:
you insert into the "JS: Value" field will return the value desired. The
+
- This is found under Scene_Title settings.
'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
+
  Picture's Filename:
value will be rounded using Math.round for integers and left alone if set as
+
  - Filename used for the picture.
a float number.
 
  
---
+
  Button URL:
 +
  - URL for the button to go to upon being clicked.
  
=== Title Command List Settings ===
+
  JS: Position:
 +
  - JavaScript code that helps determine the button's Position.
  
[[File:CoreEngineUpdate4Params1.png]]
+
  JS: On Load:
 +
  - JavaScript code that runs once this button bitmap is loaded.
  
This plugin parameter allows you to adjust the commands that appear on the
+
  JS: Run Code:
title screen. Some JavaScript knowledge is needed.
+
  - JavaScript code that runs once this button is pressed.
  
 
---
 
---
  
Title Command
+
=== Parameter Settings ===
  
  Symbol:
+
[[File:CoreEnginePluginParam07.png]]
  - The symbol used for this command.
 
  
  STR: Text:
+
A battler's parameters, or stats as some devs know them as, are the values
  - Displayed text used for this title command.
+
that determine how a battler performs. These settings allow you to alter
  - If this has a value, ignore the JS: Text version.
+
their behaviors and give boosts to trait objects in a controlled manner.
  
  JS: Text:
+
---
  - JavaScript code used to determine string used for the displayed name.
 
  
  JS: Show:
+
Parameter Settings
  - JavaScript code used to determine if the item is shown or not.
 
  
   JS: Enable:
+
   Displayed Parameters
   - JavaScript code used to determine if the item is enabled or not.
+
   - A list of the parameters that will be displayed in-game.
 +
  - Shown in the Equip Menu.
 +
  - Shown in the Status Menu.
  
   JS: Ext:
+
   Extended Parameters
   - JavaScript code used to determine any ext data that should be added.
+
   - The list shown in extended scenes (for other VisuStella plugins).
 
 
  JS: Run Code:
 
  - JavaScript code that runs once this command is selected.
 
  
 
---
 
---
  
=== Title Picture Buttons Settings ===
+
==== Basic Parameters ====
  
[[File:CoreEnginePluginTitleButtons.png|600px]]
+
; MHP - MaxHP
  
[[File:CoreEngineUpdate4Params2.png]]
+
- 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.
  
These allow you to insert picture buttons on your title screen that can
+
; MMP - MaxMP
send users to various links on the internet when clicked.
 
  
---
+
- 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.
  
Settings
+
; ATK - Attack
  
  Picture's Filename:
+
- This is the attack value of the battler. By default, this stat is used for
  - Filename used for the picture.
+
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.
  
  Button URL:
+
; DEF - Defense
  - URL for the button to go to upon being clicked.
 
  
  JS: Position:
+
- This is the defense value of the battler. By default, this stat is used
  - JavaScript code that helps determine the button's Position.
+
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.
  
  JS: On Load:
+
; MAT - Magic Attack
  - JavaScript code that runs once this button bitmap is loaded.
 
  
  JS: Run Code:
+
- This is the magic attack value of the battler. By default, this stat is
  - JavaScript code that runs once this button is pressed.
+
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
  
=== UI Settings ===
+
- 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.
  
[[File:CoreEnginePluginParam08.png]]
+
; AGI - Agility
  
In previous iterations of RPG Maker, the Core Engine would allow you to
+
- This is the agility value of the battler. By default, this stat is used to
change the screen resolution. In MZ, that functionality is provided by
+
determine battler's position in the battle turn's order. Given a normal turn
default but a number of UI settings still remain. These settings allow you
+
calculation formula, the higher the value, the faster the battler is, and
adjust how certain in-game objects and menus are displayed.
+
the more likely the battler will have its turn earlier in a turn.
  
---
+
; LUK - Luck
  
UI Area
+
- 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.
  
  Fade Speed:
+
---
  - Default fade speed for transitions.
 
  
  Box Margin:
+
Basic Parameters
  - Set the margin in pixels for the screen borders.
 
  
   Command Window Width:
+
   Show Actor Level?:
   - Sets the width for standard Command Windows.
+
   - Show the actor level when displaying actors?
 +
  - Affects for most windows in-game.
  
   Bottom Help Window:
+
   HP Crisis Rate:
   - Put the Help Window at the bottom of the screen?
+
   - HP Ratio at which a battler can be considered in crisis mode.
  
   Right Aligned Menus:
+
   JS: Formula:
   - Put most command windows to the right side of the screen.
+
   - Formula used to determine the total value all 8 basic parameters:
 +
  - MaxHP, MaxMP, ATK, DEF, MAT, MDF, AGI, LUK.
  
  Show Buttons:
+
Parameter Caps:
  - Show clickable buttons in your game?
 
  
    Show Cancel Button:
+
  MaxHP Cap:
    Show Menu Button:
+
  MaxMP Cap:
    Show Page Up/Down:
+
  ATK Cap:
    Show Number Buttons:
+
  DEF Cap:
    - Show/hide these respective buttons if the above is enabled.
+
  MAT Cap:
    - If 'Show Buttons' is false, these will be hidden no matter what.
+
   MDF Cap:
 
+
   AGI Cap:
   Button Area Height:
+
   LUK Cap:
   - Sets the height for the button area.
+
   - Formula used to determine the selected parameter's cap.
 
+
   - These settings DO NOT raise the editor's maximum values. If you want to
   Bottom Buttons:
+
    raise an enemy's maximum parameter value past their default cap, use the
   - Put the buttons at the bottom of the screen?
+
    associated notetag for them instead.
 
 
  Side Buttons:
 
   - Push buttons to the side of the UI if there is room.
 
  
 
---
 
---
  
Larger Resolutions
+
==== X Parameters ====
  
  Reposition Actors:
+
; HIT - Hit Rate%
  - Update the position of actors in battle if the screen resolution
 
    has changed to become larger than 816x624.
 
  
  Reposition Enemies:
+
- This determines the physical hit success rate of the any physical action.
  - Update the position of enemies in battle if the screen resolution
+
All physical attacks make a check through the HIT rate to see if the attack
    has changed to become larger than 816x624.
+
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%
  
Menu Objects
+
- 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.
  
  Level -> EXP Gauge:
+
; CRI - Critical Hit Rate%
  - Draw an EXP Gauge under the drawn level.
 
  
  Parameter Arrow:
+
- Any actions that enable Critical Hits will make a randomizer check with
  - The arrow used to show changes in the parameter values.
+
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%
  
Text Code Support
+
- 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.
  
  Class Names:
+
; MEV - Magic Evasion Rate%
  - Make class names support text codes?
 
  
  Nicknames:
+
- Where EVA is the evasion rate against physical actions, MEV is the evasion
  - Make nicknames support text codes?
+
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%
  
=== Window Settings ===
+
- 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.
  
[[File:CoreEnginePluginParam09new.png]]
+
; CNT - Counter Attack Rate%
  
Adjust the default settings of the windows in-game. This ranges from things
+
- If a physical action connects and passes, there is a chance the physical
such as the line height (to better fit your font size) to the opacity level
+
action can be avoided and a counter attack made by the user will land on the
(to fit your window skins).
+
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
  
Window Defaults
+
- During a battler's regeneration phase, the battler will regenerate this
 +
percentage of its MaxHP as gained HP with a 100% success rate.
  
  Line Height:
+
; MRG - MP% Regeneration
  - Default line height used for standard windows.
 
  
  Item Height Padding:
+
- During a battler's regeneration phase, the battler will regenerate this
  - Default padding for selectable items.
+
percentage of its MaxMP as gained MP with a 100% success rate.
  
  Item Padding:
+
; TRG - TP% Regeneration
  - Default line padding used for standard windows.
 
  
  Back Opacity:
+
- During a battler's regeneration phase, the battler will regenerate this
  - Default back opacity used for standard windows.
+
percentage of its MaxTP as gained TP with a 100% success rate.
  
  Translucent Opacity:
+
---
  - Default translucent opacity used for standard windows.
+
 
 +
X Parameters
  
   Window Opening Speed:
+
   JS: Formula:
   - Default open speed used for standard windows.
+
   - Formula used to determine the total value all 10 X parameters:
   - Default: 32 (Use a number between 0-255)
+
   - HIT, EVA, CRI, CEV, MEV, MRF, CNT, HRG, MRG, TRG.
  
  Column Spacing:
+
Vocabulary
  - Default column spacing for selectable windows.
 
  - Default: 8
 
  
   Row Spacing:
+
   HIT:
   - Default row spacing for selectable windows.
+
   EVA:
  - Default: 4
+
  CRI:
 +
  CEV:
 +
  MEV:
 +
  MRF:
 +
  CNT:
 +
  HRG:
 +
  MRG:
 +
  TRG:
 +
  - In-game vocabulary used for the selected X Parameter.
  
 
---
 
---
  
Selectable Items:
+
==== S Parameters ====
  
  Show Background?:
+
; TGR - Target Rate
  - Selectable menu items have dark boxes behind them. Show them?
 
  
  Item Height Padding:
+
- Against the standard enemy, the Target Rate value determines the odds of
  - Default padding for selectable items.
+
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.
  
  JS: Draw Background:
+
: NOTE: For those using the Battle A.I. Core, any actions that have specific
  - Code used to draw the background rectangle behind clickable menu objects
+
target conditions will bypass the TGR rate.
  
---
+
; GRD - Guard Effect
  
=== Screen Shake Settings ===
+
- 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.
  
[[File:CoreEngineParamsScreenShake.png]]
+
; REC - Recovery Effect
  
Get more screen shake effects into your game!
+
- 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.
  
These effects have been added by [[Aries of Sheratan]]!
+
; 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.
  
Settings
+
; MCR - MP Cost Rate
  
  Default Style:
+
- This rate affects how much MP skills with an MP Cost will require to use.
  - The default style used for screen shakes.
+
If the user has 100% MCR, then the MP Cost will be standard. If the user has
  - Original
+
50% MCR, then all skills that cost MP will cost only half the required MP.
  - Random
+
If the user has 200% MCR, then all skills will cost 200% their MP cost.
  - Horizontal
 
  - Vertical
 
  
  JS: Original Style:
+
; TCR - TP Charge Rate
  JS: Random Style
 
  JS: Horizontal Style
 
  JS: Vertical Style
 
  - This code gives you control over screen shake for this screen
 
    shake style.
 
  
---
+
- 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.
  
=== JS: Quick Functions ===
+
; PDR - Physical Damage Rate
  
[[File:CoreEnginePluginParam10.png]]
+
- 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.
  
WARNING: This feature is highly experimental! Use it at your own risk!
+
; MDR - Magical Damage Rate
  
JavaScript Quick Functions allow you to quickly declare functions in the
+
- This rate affects how much damage the user will take from magical damage.
global namespace for ease of access. It's so that these functions can be
+
If the user has 100% MDR, then the user takes the normal amount. If the user
used in Script Calls, Control Variable Script Inputs, Conditional Branch
+
has 50% MDR, then all magical damage dealt to the user is halved. If the
Script Inputs, Damage Formulas, and more.
+
user has 200% MDR, then all magical damage dealt to the user is doubled.
  
---
+
; FDR - Floor Damage Rate
  
JS: Quick Function
+
- 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.
  
  Function Name:
+
; EXR - Experience Rate
  - The function's name in the global namespace.
 
  - Will not overwrite functions/variables of the same name.
 
  
  JS: Code:
+
- This determines the amount of experience gain the user whenever the user
  - Run this code when using the function.
+
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.
  
 
---
 
---
  
If you have a Function Name of "Example", then typing "Example()" in a
+
S Parameters
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
+
  JS: Formula
namespace, then the quick function will be ignored and not created.
+
  - Formula used to determine the total value all 10 S parameters:
 +
  - TGR, GRD, REC, PHA, MCR, TCR, PDR, MDR, FDR, EXR.
  
If a quick function contains bad code that would otherwise crash the game,
+
Vocabulary
a fail safe has been implemented to prevent it from doing so, display an
 
error log, and then return a 0 value.
 
  
---
+
  TGR:
 
+
  GRD:
{{VisuStella MZ Terms of Use}}
+
  REC:
 +
  PHA:
 +
  MCR:
 +
  TCR:
 +
  PDR:
 +
  MDR:
 +
  FDR:
 +
  EXR:
 +
  - In-game vocabulary used for the selected S Parameter.
  
== Credits ==
+
---
  
If you are using this plugin, credit the following people in your game:
+
Icons
  
Team VisuStella
+
  Draw Icons?
 +
  - Draw icons next to parameter names?
  
* [[Yanfly]]
+
  MaxHP, MaxMP, ATK, DEF, MAT, MDF, AGI, LUK:
* [[Arisu]]
+
  HIT, EVA, CRI, CEV, MEV, MRF, CNT, HRG, MRG, TRG:
* [[Olivia]]
+
  TGR, GRD, REC, PHA, MCR, TCR, PDR, MDR, FDR, EXR:
* [[Irina]]
+
  - Icon used for the selected parameter.
  
== Changelog ==
+
---
  
Version 1.09: October 18, 2020
+
=== Custom Parameters Settings ===
* 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.
 
  
 +
[[File:CoreEngine_CustomParam1.png]]
  
 +
[[File:CoreEngine_CustomParam2.png]]
  
Version 1.08: October 11, 2020
+
[[File:CoreEngine_CustomParam3.png]]
* 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.
 
  
 +
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.
  
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.
 
  
 +
Custom Parameter
  
 +
  Parameter Name:
 +
  - What's the parameter's name?
 +
  - Used for VisuStella MZ menus.
  
Version 1.06: September 27, 2020
+
  Abbreviation:
* Bug Fixes!
+
  - What abbreviation do you want to use for the parameter?
** 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.
+
  - Do not use special characters. Avoid numbers if possible.
* New Features!
+
 
** New notetags for Maps and name tags for Troops added by Yanfly!
+
  Icon:
*** <Frontview>, <Sideview> to change the battle view for that specific map, or troop regardless of what other settings are.
+
  - What icon do you want to use to represent this parameter?
*** <DTB>, <TPB Active>, <TPB Wait> to change the battle system for that specific map or troop regardless of what other settings are.
+
  - 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.
  
 +
---
  
Version 1.05: September 20, 2020
+
Instructions on Adding Custom Parameters to VisuStella Menus
* 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.
 
  
 +
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.
  
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.
 
  
 +
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.
  
Version 1.03: September 6, 2020
+
An example damage formula would be something like the following if using
* Bug Fixes!
+
"str" for "Strength" and "con" for "Constitution":
** 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!
+
  a.str - b.con
** 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:
+
These values are attached to the Game_Battlerbase prototype class.
** Screen Shake Settings added to the Plugin Parameters.
+
 
*** Screen Shake: Custom Plugin Command added!
+
---
 +
 
 +
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 ===
 +
 
 +
[[File: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.
 +
 
 +
---
 +
 
 +
Maps
 +
 
 +
  Scroll Lock Small X?:
 +
  Scroll Lock Small Y?:
 +
  - Automatically scroll lock X/Y scrolling if the map is too small?
 +
  - Useful for 1280x720 resolutions when the map is 27 tiles wide.
 +
    - This will get rid of the subtle scrolling when moving from one half of
 +
      the screen to the other.
 +
  - This setting will be disabled if the map is zoomed in.
 +
 
 +
  Locked Display X?:
 +
  Locked Display Y?:
 +
  - What display X/Y value do you want for auto-scroll locked maps?
 +
  - Use a number between 0 and 1 for best results.
 +
 
 +
---
 +
 
 +
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 ===
 +
 
 +
[[File: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 ===
 +
 
 +
[[File: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 ===
 +
 
 +
[[File:CoreEnginePluginTitleButtons.png|600px]]
 +
 
 +
[[File: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 ===
 +
 
 +
[[File: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 ===
 +
 
 +
[[File: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
 +
 
 +
  Enable Masking:
 +
  - Enable window masking (windows hide other windows behind them)?
 +
  - WARNING: Turning it on can obscure data.
 +
 
 +
  Correct Skin Bleed:
 +
  - Allows you to enable/disable the window skin bleeding correction for
 +
    those who wish to use the 95 calculator instead of 96 to augment higher
 +
    and larger screen resolutions.
 +
  - Read the "Bug Fixes" section if you don't understand what the window
 +
    skin bleeding problem is.
 +
 
 +
  Line Height:
 +
  - Default line height used for standard windows.
 +
  - Avoid using odd numbers.
 +
  - Visuals in RPG Maker and general game dev don't work well with odd
 +
    numbers so avoid them unless you want your game's visuals to behave
 +
    inconsistently.
 +
 
 +
  Item Padding:
 +
  - Default line padding used for standard windows.
 +
  - Avoid using odd numbers.
 +
  - Visuals in RPG Maker and general game dev don't work well with odd
 +
    numbers so avoid them unless you want your game's visuals to behave
 +
    inconsistently.
 +
 
 +
  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
 +
 
 +
---
 +
 
 +
Scroll Bar
 +
 
 +
[[File:CoreEngine_Scroll_Bar_Smol.gif]]
 +
 
 +
  Show Scroll Bar?:
 +
  - Show the scroll bar for scrollable windows?
 +
 
 +
  Thickness:
 +
  - How thick do you want the scroll bar to be?
 +
 
 +
  Offset:
 +
  - How much do you want to offset the scroll bar by?
 +
 
 +
  Bar Body Color:
 +
  - Use #rrggbb for custom colors or regular numbers for text colors from
 +
    the Window Skin.
 +
 
 +
  Off Bar Color:
 +
  - Use #rrggbb for custom colors or regular numbers for text colors from
 +
    the Window Skin.
 +
 
 +
  Off Bar Opacity:
 +
  - What opacity value do you want the off bar opacity to be?
 +
  - Use a number between 0 and 255.
 +
 
 +
---
 +
 
 +
Selectable Items:
 +
 
 +
  Show Background?:
 +
  - Selectable menu items have dark boxes behind them. Show them?
 +
 
 +
  Item Height Padding:
 +
  - Default padding for selectable items.
 +
  - Avoid using odd numbers.
 +
  - Visuals in RPG Maker and general game dev don't work well with odd
 +
    numbers so avoid them unless you want your game's visuals to behave
 +
    inconsistently.
 +
 
 +
  JS: Draw Background:
 +
  - Code used to draw the background rectangle behind clickable menu objects
 +
 
 +
---
 +
 
 +
=== JS: Quick Functions ===
 +
 
 +
[[File: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.
 +
 
 +
---
 +
 
 +
{{VisuStella MZ Terms of Use}}
 +
 
 +
== Credits ==
 +
 
 +
If you are using this plugin, credit the following people in your game:
 +
 
 +
Team VisuStella
 +
 
 +
* [[Yanfly]]
 +
* [[Arisu]]
 +
* [[Olivia]]
 +
* [[Irina]]
 +
 
 +
== Changelog ==
 +
 
 +
Version 1.81: February 15, 2024
 +
* Compatibility Update!
 +
** Added compatibility functionality for future plugins.
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New notetags added for future plugin: VisuMZ_2_BattleGridSystem
 +
*** <Grid>
 +
*** <No Grid>
 +
**** Requires the future plugin VisuMZ_2_BattleGridSystem!
 +
**** Read the help section for more information on these.
 +
** New Plugin Parameter added by Arisu:
 +
*** Plugin Parameters > Window > Correct Skin Bleed
 +
**** Allows you to enable/disable the window skin bleeding correction for those who wish to use the 95 calculator instead of 96 to augment higher and larger screen resolutions.
 +
**** Read the "Bug Fixes" section if you don't understand what the window skin bleeding problem is.
 +
 
 +
 
 +
 
 +
Version 1.80: January 18, 2024
 +
* RPG Fixes!
 +
** RPG Maker MZ Bug Fix!
 +
*** Auto Save After New Game
 +
**** Normally, when starting a new game through the "New Game" option, there is no auto save trigger. However, if you start a new game or load a saved game, then go to the Game End screen, return back to the title screen, then start a New Game, the auto save trigger occurs when it shouldn't. The Core Engine will now patch this and prevent the trigger from taking place.
 +
 
 +
 
 +
 
 +
Version 1.79: November 16, 2023
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Plugin Command added by Arisu:
 +
** Text Popup: Show Text
 +
*** Adds text to a text popup window to briefly appear.
 +
*** Multiple text popups will be queued.
 +
*** Does not halt the game and works parallel to game activity.
 +
 
 +
 
 +
 
 +
Version 1.78: October 12, 2023
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New Plugin Parameters added by Olivia and sponsored by AndyL:
 +
*** QoL Settings > Battle Test > Shift+R: Recover All
 +
**** For Play Test only! During battle, pressing SHIFT + R will refill the whole party's HP and MP and status.
 +
*** QoL Settings > Battle Test > Shift+T: Full TP
 +
**** For Play Test only! During battle, pressing SHIFT + T will refill the whole party's TP.
 +
 
 +
 
 +
 
 +
Version 1.77: August 17, 2023
 +
* Bug Fixes!
 +
** Fixed a bug that would cause the BGS related Plugin Commands to crash. Fix made by Arisu.
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* Feature Update!
 +
** Scroll-Linked Pictures now work if the image file are in a folder within the img/pictures/ folder without the folder needing a ! at the start.
 +
* New Features!
 +
** New Plugin Commands added by Arisu:
 +
*** Picture: Rotate by Angle
 +
**** Rotates target picture by a amount angle over a set duration instead of continuously.
 +
**** View help file for more information on the Plugin Command.
 +
*** Picture: Rotate to Angle
 +
**** Rotates target picture to a certain angle over a set duration instead of continuously.
 +
**** View help file for more information on the Plugin Command.
 +
** New Plugin Parameter added by Irina:
 +
*** Parameters > Menu Button Assist > General > Split "Escape":
 +
**** Used ONLY for those making their own custom keyboard key input maps.
 +
**** "Split" option makes separate instances of "Cancel" and "Menu" keys.
 +
**** "Don't" option will consolidate both into "Escape" keys.
 +
 
 +
 
 +
 
 +
Version 1.76: June 15, 2023
 +
* Bug Fixes
 +
** Fixed a bug that displayed the incorrect button press key for name input processing's cancel action. Fix made by Olivia.
 +
 
 +
 
 +
 
 +
Version 1.75: March 16, 2023
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* Feature Update!
 +
** In Scene_Name, when using the Keyboard Input, the button assist windows will no longer display the keyboard shortcuts for Ok and Cancel, but instead, show them for ENTER and BKSP. Update made by Arisu.
 +
** In Scene_Name, when manual inputting, the Page Up/Dn keys are now displayed to show changing character pages.
 +
* New Features!
 +
** New Plugin Parameters added by Arisu and sponsored by AndyL:
 +
*** Params > Keyboard Input > Button Assist > Finish Entry
 +
**** Text used to describe finish entry.
 +
*** Params > Keyboard Input > Button Assist > Page Change
 +
**** Text used to describe changing character pages.
 +
*** Params > Window Settings > Scroll Bar
 +
**** These settings also allow you to add scroll bars to scrollable windows, letting the player know how much of the window's contents there are left for scrolling. The scroll bar can be enabled, disabled, have its thickness changed, colors changed, etc.
 +
 
 +
 
 +
 
 +
Version 1.74: February 16, 2023
 +
* Compatibility Update!
 +
** Plugin Commands for: Audio: Change Current BGM/BGS Volume/Pitch/Pan should now work properly with the updated RPG Maker MZ version and WebAudio changes. Update made by Arisu.
 +
 
 +
 
 +
 
 +
Version 1.73: January 20, 2023
 +
* Compatibility Update!
 +
** Added better Effekseer version compatibility.
 +
 
 +
 
 +
 
 +
Version 1.72: December 15, 2022
 +
* Bug Fixes!
 +
** RPG Maker MZ Bug Fix!
 +
*** Skill List Active After Party Member Change
 +
**** If the skill list is active (ie. the player can move the cursor around) and the party member currently being viewed is changed via the button commands, then previously, RPG Maker MZ would still have that window be active despite having the cursor hidden temporarily. Upon pressing direction buttons, the cursor reveals itself and both the skill type window and skill list window are both active, making way for lots of potential problems to happen.
 +
** Water Tile Bug
 +
*** It seems like there's a new bug that occurs if you create a tileset from scratch in RPG Maker MZ version 1.5.0+ and version 1.6.0+! What this bug does is it causes many tiles to become water tiles without intending to. You can find this out by turning off all the plugins in your project, putting a Ship or Boat on what are normally ground tiles, and then seeing the Ship or Boat traverse through it.
 +
*** There are two ways to fix this. We cannot fix it through code in this plugin as it's a problem that involves the tileset json data there are ways to work around it so that you can get the proper water-flags to go where they need to be at.
 +
**** 1. Copy a working un-bugged tileset onto the currently bugged one and reapply the tile features like passability, terrain tags, etc. This will make sure the water-passability tiles get copied over correctly.
 +
**** 2. If you're on RPG Maker MZ version 1.5.0 or above, select a working un-bugged tileset (usually a pre-existing tileset when a new project is made), click the "Copy Page" button, go to the bugged tileset and press "Paste Page". You'll have to reapply any different properties like passabilities and terrain tags, but the water tile flags should now be working properly.
 +
*** The plugin will not fix the problem itself since flag data is delicate and should not be tampered with midgame as the changes made by the plugin might not match the desired settings.
 +
*** This plugin, however, will also send out an alert message when coming across such a tile. Pay attention to it and do one of the following two steps above to fix the problem.
 +
* Documentation Update!
 +
** Added "Skill List Active After Party Member Change" section to the "Important Changes: Bug Fixes" section of the help file.
 +
** Added "Water Tile Bug" section to the "Important Changes: Bug Fixes" section of the help file.
 +
** Help file updated for new features.
 +
* New Feature!
 +
** New Plugin Parameter added by Irina:
 +
*** Plugin Parameters > Menu Backgrounds > Blur Strength
 +
**** Strength used for menu background snapshots.
 +
 
 +
 
 +
 
 +
Version 1.71: November 10, 2022
 +
* Bug Fixes!
 +
** Title Command Window should now allow for more than 4 custom commands without hidden commands. Fix made by Irina.
 +
** Fixed a problem with repeating animations from Visual State Effects causing softlocks. Fix made by Olivia.
 +
 
 +
 
 +
 
 +
Version 1.70: October 6, 2022
 +
* Bug Fixes!
 +
** RPG Maker MZ Bug Fix!
 +
*** A texture check will now occur for sprites that are being removed and destroyed in order to prevent crashes. In the off chance that someone creates a sprite through a script call and removes it through such, the likelihood of this occurance becomes higher. This makes the destroy property take into account a texture check in order to see if the sprite removal is taking extra steps and will reduce those extra steps.
 +
* Documentation Update!
 +
** Added "Sprite Removal and Destroy Crash" section to the "Important Changes: Bug Fixes" section.
 +
* Optimization Update!
 +
** Plugin should run more optimized.
 +
 
 +
 
 +
 
 +
Version 1.69: September 8, 2022
 +
* Bug Fixes!
 +
** Fixed the combination of Button Assist Location: Top with Help Location: Bottom combination not working properly. Fix made by Irina.
 +
 
 +
 
 +
 
 +
Version 1.68: August 4, 2022
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New Plugin Commands added by Olivia and sponsored by Archeia:
 +
*** Audio: Change Current BGM Volume
 +
*** Audio: Change Current BGM Pitch
 +
*** Audio: Change Current BGM Pan
 +
*** Audio: Change Current BGS Volume
 +
*** Audio: Change Current BGS Pitch
 +
*** Audio: Change Current BGS Pan
 +
**** Changes the current BGM/BGS volume/pitch/pan without changing any of the current BGM/BGS's other properties and without restarting BGM/BGS.
 +
 
 +
 
 +
 
 +
Version 1.67: July 28, 2022
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
** Added notes for Line Height and Item Padding parameters:
 +
*** Avoid using odd numbers.
 +
*** Visuals in RPG Maker and general game dev don't work well with odd numbers so avoid them unless you want your game's visuals to behave inconsistently.
 +
*** This setting will be disabled if the map is zoomed in.
 +
* New Features!
 +
** New map notetags added by Irina and sponsored by AndyL:
 +
*** <Scroll Lock X>
 +
*** <Scroll Lock X: x>
 +
*** <Scroll Lock Y>
 +
*** <Scroll Lock Y: y>
 +
**** Causes the map to not scroll left/right(x) or up/down(y). Useful for when maps are just slightly smaller than normal and the tiny scrolling is distracting.
 +
** New Plugin Parameters added by Irina and sponsored by AndyL:
 +
*** Plugin Parameters > Screen Resolution > Maps > Scroll Lock Small X?
 +
*** Plugin Parameters > Screen Resolution > Maps > Scroll Lock Small Y?
 +
*** Plugin Parameters > Screen Resolution > Maps > Locked Display X?
 +
*** Plugin Parameters > Screen Resolution > Maps > Locked Display Y?
 +
**** Automatically scroll locks small maps to prevent them from scrolling horizontally/vertically. Useful for 1280x720 resolutions when the map is 27 tiles wide. This will get rid of the subtle scrolling when moving from one half of the screen to the other.
 +
**** This setting will be disabled if the map is zoomed in.
 +
* Feature Update!
 +
** Warnings added to Line Height and Item Padding parameters:
 +
*** Avoid using odd numbers.
 +
*** Visuals in RPG Maker and general game dev don't work well with odd numbers so avoid them unless you want your game's visuals to behave inconsistently.
 +
 
 +
 
 +
 
 +
Version 1.66: July 14, 2022
 +
* Bug Fixes!
 +
** RPG Maker MZ Bug Fix!
 +
*** Debug Console Refresh Bug
 +
**** When pressing F5 to refresh while the debug console (DevTools) is open, some graphics will fail to load properly. This started occurring since the RPG Maker MZ 1.5.0 update and the code for loading the images has now been reverted to the 1.4.4 version where it was last stable.
 +
* Documentation Update!
 +
** Help file updated for new major bug fix.
 +
 
 +
 
 +
 
 +
Version 1.65: June 30, 2022
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New Plugin Parameter added by Irina:
 +
*** Plugin Parameters > Parameter Settings > Show Actor Level?
 +
**** Show the actor level when displaying actors?
 +
**** Used for most windows in-game.
 +
 
 +
 
 +
 
 +
Version 1.64: June 9, 2022
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New Plugin Command made by Arisu and sponsored by ImGonnaPutMyGameOnXboxAndYouCantStopMe:
 +
*** Debug: Current Controller ID
 +
**** PLAY TEST ONLY. Shows current controller ID in debug console.
 +
**** Also copies to computer clipboard if possible.
 +
** New Plugin Parameters made by Arisu and sponsored by ImGonnaPutMyGameOnXboxAndYouCantStopMe:
 +
*** Subsettings for Button Assist Window: Controller Button Assist
 +
**** These are sub-settings for the Button Assist Window Plugin Parameters. Where the Button Assist Window Plugin Parameters are focused on keyboard entries, these sections are focused on gamepad controllers.
 +
**** Add multiple gamepads to the list to give them different button assist text. If a gamepad is being used but not listed here, the button assist text will default to the keyboard version.
 +
 
 +
 
 +
 
 +
Version 1.63: May 2, 2022
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New Plugin Parameter added by Irina:
 +
*** Plugin Parameters > QoL Settings > Misc > Map Name Text Code
 +
**** If on, map names will use text codes.
 +
**** If off, only the raw map name will be used.
 +
* Feature Update!
 +
** The map name text code change will no longer be on forcefully. It is now something that can be toggled by Plugin Parameters. Update by Irina.
 +
 
 +
 
 +
 
 +
Version 1.62: April 28, 2022
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New Plugin Commands added by Arisu and sponsored by Archeia:
 +
*** Variable: JS Eval
 +
**** Pick a variable ID and value to alter through JS.
 +
**** Allows one line of code for variable ID and operand.
 +
**** Functions like RM2k3's Variable Pointers.
 +
*** Variable: JS Block
 +
**** Pick a variable ID and value to alter through JS.
 +
**** Allows JS block code for variable ID and operand.
 +
**** Functions like RM2k3's Variable Pointers.
 +
** Map names can now use text codes. Made by Arisu and sponsored by Archeia.
 +
 
 +
 
 +
 
 +
Version 1.61: April 21, 2022
 +
* Bug Fixes!
 +
** RPG Maker MZ Bug Fix!
 +
*** Battle Forced End Action Crash
 +
**** Depending on various circumstances, currently active battlers can be cleared from the battle system at will due to a number of reasons. However, if it just so happens that the targets are cleared, too, with actions remaining, then a crash will follow up. This plugin will prevent that change. Fix made by Olivia.
 +
 
 +
 
 +
 
 +
Version 1.60: April 14, 2022
 +
* Bug Fixes!
 +
** Number Input window will now respond to Home/End keys properly. Fix made by Olivia.
 +
 
 +
 
 +
 
 +
Version 1.59: April 7, 2022
 +
* Compatibility Update!
 +
** RPG Maker MZ 1.4.4 compatibility update!
 +
*** "Shutdown" command should now be more compatible with other aspects of the client when running from Node JS client on other OS's.
 +
 
 +
 
 +
 
 +
Version 1.58: March 24, 2022
 +
* Feature Update!
 +
** Plugin Commands now have separators for easier selection.
 +
 
 +
 
 +
 
 +
Version 1.57: March 3, 2022
 +
* Compatibility Update!
 +
** The "Shutdown" command from the title screen should now be compatible with RPG Maker MZ 1.4.4 and up. Update made by Olivia.
 +
 
 +
 
 +
 
 +
Version 1.56: February 10, 2022
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New features added by Arisu and sponsored by Anon:
 +
*** Plugin Parameters > QoL > Misc > Shortcut Scripts
 +
**** Enables shortcut-based script variables and functions that can be used for script calls.
 +
**** Shortcut list enabled for this is as follows:
 +
***** $commonEvent(id), $onceParallel(id), $scene, $spriteset, $subject, $targets, $target, $event
 +
***** For more information on how to use them, review the help file.
 +
 
 +
 
 +
 
 +
Version 1.55: January 27, 2022
 +
* Feature Update!
 +
** Once Parallels for the map are now able to update even while other events are running. Update made by Arisu.
 +
 
 +
 
 +
 
 +
Version 1.54: January 13, 2022
 +
* Bug Fixes!
 +
** RPG Maker MZ Bug Fix!
 +
*** Overly-Protective Substitute
 +
*** When an ally with critical health is being targeted by a friendly non-Certain Hit skill (such as a heal or buff) and another ally has the substitute state, the other ally would "protect" the originally targeted ally and take the heal or buff.
 +
*** The new changed behavior is that now, substitute will not trigger for any actions whose scope targets allies.
 +
*** Fix made by Olivia.
 +
* Documentation Update!
 +
** Added documentation for new MZ Bug: Overly-Protective Substitute.
 +
* Feature Update!
 +
** Added a failsafe for those who did not update the plugin parameter settings and are using MV Animations.
 +
 
 +
 
 +
 
 +
Version 1.53: December 30, 2021
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Features!
 +
** New Notetag added by Olivia:
 +
*** <Rate: x>
 +
**** Allows you to adjust the update for this MV Animation.
 +
***** Does NOT work with Effekseer animations.
 +
**** The lower the number, the faster.
 +
**** Replace 'x' with a number representing the animation update rate.
 +
***** Default rate: 4.
 +
***** Minimum rate: 1.
 +
***** Maximum rate: 10.
 +
** New Plugin Parameter added by Olivia:
 +
*** Plugin Parameters > Qualify of Life Settings > MV Animation Rate
 +
**** Adjusts the rate at which MV animations play.
 +
**** Default: 4. Lower for faster. Higher for slower.
 +
* Optimization Update!
 +
** MV Animations should run more optimized.
 +
 
 +
 
 +
 
 +
Version 1.52: December 16, 2021
 +
* Compatibility Update!
 +
** RPG Maker MZ 1.4.0 compatibility update!
 +
*** MV Animations played on screen level will now show up properly in the center of the screen.
 +
 
 +
 
 +
 
 +
Version 1.51: December 9, 2021
 +
* Bug Fixes!
 +
** RPG Maker MZ Bug Fix!
 +
*** In the battle status windows, whenever actor names are displayed, the bitmap used to display their name text do not extend vertically all the way, causing letters like lowercase "Q" and "G" to be cut off, making them hard to distinguish from one another. The Core Engine will remedy this by extending the bitmap to allow enough room. Fix made by Irina.
 +
 
 +
 
 +
 
 +
Version 1.50: November 4, 2021
 +
* Bug Fixes!
 +
** RPG Maker MZ Bug Fix!
 +
*** By default, if the attack skill is sealed via a trait and an actor has auto-battle, the action can still be used via auto-battle. This is now fixed and actors should not be able to attack via auto-battle if their attack ability is sealed. Fix made by Yanfly.
 +
* Documentation Update!
 +
** Help file updated for new RPG Maker MZ bug fix.
 +
 
 +
 
 +
 
 +
Version 1.49: October 28, 2021
 +
* Documentation Update!
 +
** Help file updated for new features.
 +
* New Feature!
 +
** New Plugin Command added by Arisu and sponsored by Anon:
 +
*** Map: Once Parallel
 +
**** Plays a Common Event parallel to the event once without repeating itself when done. Map only!
 +
**** When exiting map scene or changing maps, all Once Parallels are cleared
 +
**** Once Parallels are not retained upon reentering the scene or map.
 +
**** Once Parallels are not stored in memory and cannot be saved.
 +
 
 +
 
 +
 
 +
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.
 +
 
 +
[[File:CoreEngine_Update39_Command1.png|600px]]
 +
 
 +
 
 +
 
 +
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.
 
*** 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.
+
*** We'll be expanding on more screen shaking options in the future.
* Optimization Update
+
* Optimization Update
** Digit Grouping now works more efficiently.
+
** Digit Grouping now works more efficiently.
 
+
 
 
+
 
 
+
 
Version 1.02: August 30, 2020
+
Version 1.02: August 30, 2020
* New Feature!
+
* New Feature!
** New Plugin Command: "Picture: Erase All". Added by Olivia.
+
** 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.
+
*** Erases all pictures on the screen because it's extremely tedious to do it one by one.
** New Plugin Command: "Picture: Erase Range"
+
** 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.
+
*** Erases all pictures within a range of numbers because it's extremely tedious to do it one by one.
* Optimization Update
+
* Optimization Update
** Added a more accurate means of parsing numbers for Digit Grouping.
+
** Added a more accurate means of parsing numbers for Digit Grouping.
** Window_Base.prototype.textSizeEx now stores data to a cache.
+
** Window_Base.prototype.textSizeEx now stores data to a cache.
* Documentation Update
+
* Documentation Update
** Added a section to Major Changes: New Hard-Coded Features on Digit Grouping and explaining its intricacies.
+
** 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.
+
** 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!
  
 +
== See Also ==
  
 
+
* [[Inspiration Behind Wave 1]]
Version 1.01: August 23, 2020
+
* [[Useful Shortcuts for Playtesting]]
* Bug Fixes!
+
* [[WASD Movement]]
** 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!
 
  
 
|}
 
|}

Latest revision as of 15:38, 23 February 2024

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.

InstallPluginsMz.png

UpdatePlugins.png

Troubleshooting.jpg

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

Click here to learn how to update plugins.

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


Masterarbeit Writer


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.

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

Introduction

VisuMZ.001.jpg

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 Attack Seal Bypass

By default, if the attack skill is sealed via a trait and an actor has auto-battle, the action can still be used via auto-battle. This is now fixed and actors should not be able to attack via auto-battle if their attack ability is sealed.

---

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.

---

Auto Save After New Game

Normally, when starting a new game through the "New Game" option, there is no auto save trigger. However, if you start a new game or load a saved game, then go to the Game End screen, return back to the title screen, then start a New Game, the auto save trigger occurs when it shouldn't. The Core Engine will now patch this and prevent the trigger from taking place.

---

Battle Forced End Action Crash

Depending on various circumstances, currently active battlers can be cleared from the battle system at will due to a number of reasons. However, if it just so happens that the targets are cleared, too, with actions remaining, then a crash will follow up. This plugin will prevent that change. Fix made by Olivia.

---

Debug Console Refresh Bug

When pressing F5 to refresh while the debug console (DevTools) is open, some graphics will fail to load properly. This started occurring since the RPG Maker MZ 1.5.0 update and the code for loading the images has now been reverted to the 1.4.4 version where it was last stable.

---

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.

---

Overly-Protective Substitute

CoreEngine BugSubHeal.png

When an ally with critical health is being targeted by a friendly non- Certain Hit skill (such as a heal or buff) and another ally has the substitute state, the other ally would "protect" the originally targeted ally and take the heal or buff.

The new changed behavior is that now, substitute will not trigger for any actions whose scope targets allies.

---

Skill List Active After Party Member Change

If the skill list is active (ie. the player can move the cursor around) and the party member currently being viewed is changed via the button commands, then previously, RPG Maker MZ would still have that window be active despite having the cursor hidden temporarily. Upon pressing direction buttons, the cursor reveals itself and both the skill type window and skill list window are both active, making way for lots of potential problems to happen.

---

Sprite Removal and Destroy Crash

A texture check will now occur for sprites that are being removed and destroyed in order to prevent crashes. In the off chance that someone creates a sprite through a script call and removes it through such, the likelihood of this occurance becomes higher. This makes the "destroy" property take into account a texture check in order to see if the sprite removal is taking extra steps and will reduce those extra steps.

---

Status Window Name Vertical Cutoffs

CoreEngine BugTextCrop.png

In the battle status windows, whenever actor names are displayed, the bitmap used to display their name text do not extend vertically all the way, causing letters like lowercase "Q" and "G" to be cut off, making them hard to distinguish from one another. The Core Engine will remedy this by extending the bitmap to allow enough room. Fix made by Irina.

---

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.

---

Water Tile Bug

CoreEngine WaterTileBug.gif

It seems like there's a new bug that occurs if you create a tileset from scratch in RPG Maker MZ version 1.5.0+ and version 1.6.0+! What this bug does is it causes many tiles to become water tiles without intending to. You can find this out by turning off all the plugins in your project, putting a Ship or Boat on what are normally ground tiles, and then seeing the Ship or Boat traverse through it.

There are two ways to fix this. We cannot fix it through code in this plugin as it's a problem that involves the tileset json data there are ways to work around it so that you can get the proper water-flags to go where they need to be at.

  1. Copy a working un-bugged tileset onto the currently bugged one and reapply the tile features like passability, terrain tags, etc. This will make sure the water-passability tiles get copied over correctly.
  2. If you're on RPG Maker MZ version 1.5.0 or above, select a working un-bugged tileset (usually a pre-existing tileset when a new project is made), click the "Copy Page" button, go to the bugged tileset and press "Paste Page". You'll have to reapply any different properties like passabilities and terrain tags, but the water tile flags should now be working properly.

The plugin will not fix the problem itself since flag data is delicate and should not be tampered with midgame as the changes made by the plugin might not match the desired settings.

This plugin, however, will also send out an alert message when coming across such a tile. Pay attention to it and do one of the following two steps above to fix the problem.

---

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-Related Notetags

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-Related Notetags

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-Related Notetags

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-Related Notetags

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.

---

<Rate: x>

- Used for: MV Animation Name Tags
- Allows you to adjust the update for this MV Animation.
  - Does NOT work with Effekseer animations.
- The lower the number, the faster.
- Replace 'x' with a number representing the animation update rate.
  - Default rate: 4.
  - Minimum rate: 1.
  - Maximum rate: 10.

---

Quality of Life-Related Notetags

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.

---

<Scroll Lock X>
<Scroll Lock Y>

- Used for: Map Notetags
- Will prevent the map from being able to scroll left/right(x) or up/down(y)
  if these notetags are present.
- Useful for when maps are just slightly smaller than normal and the tiny
  scrolling is distracting.
- This will use the display nudge setting found in the Plugin Parameters.
- This setting will be disabled if the map is zoomed in.

---

<Scroll Lock X: x>
<Scroll Lock Y: y>

- Used for: Map Notetags
- Will prevent the map from being able to scroll left/right(x) or up/down(y)
  if these notetags are present and will nudge the map camera slightly.
- Useful for when maps are just slightly smaller than normal and the tiny
  scrolling is distracting.
- Replace 'x' and 'y' with numbers between 0 and 1 to represent how much is
  being judged.
  - For example, for a 1280x720 resolution, a 27 tile wide map will benefit
    from a nudge of 0.15625. Play with these numbers to determine the best
    value for your maps.
- This setting will be disabled if the map is zoomed in.

---

Basic, X, and S Parameters-Related Notetags

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.

---

<Grid>
<Battle Grid>

<No Grid>
<No Battle Grid>

- Used for: Map Notetags, Troop Name Tags, and Troop Comment Tags
- Requires VisuMZ_2_BattleGridSystem!
- Changes the battle system to utilize the Battle Grid System or not.
- 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.
- If none of these notetags or comment tags are found, refer to the default
  settings found in the Plugin Parameters.

---

Plugin Commands

PluginCommandsMZ.png

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?

---

Audio Plugin Commands

---

CoreEngine Update103 Command1.png

Audio: Change Current BGM Volume
- Changes the current BGM volume without changing any of the current BGM's
  other properties and without restarting the BGM.

  Volume:
  - Change the current BGM's volume to what amount?
  - You may use JavaScript code.
  - Use numbers from 0 to 100.

---

CoreEngine Update103 Command2.png

Audio: Change Current BGM Pitch
- Changes the current BGM pitch without changing any of the current BGM's
  other properties and without restarting the BGM.

  Pitch:
  - Change the current BGM's pitch to what amount?
  - You may use JavaScript code.
  - Use numbers from 50 to 150.

---

CoreEngine Update103 Command3.png

Audio: Change Current BGM Pan
- Changes the current BGM pan without changing any of the current BGM's
  other properties and without restarting the BGM.

  Pan:
  - Change the current BGM's pan to what amount?
  - You may use JavaScript code.
  - Use numbers from -100 to 100.

---

CoreEngine Update103 Command4.png

Audio: Change Current BGM Volume
- Changes the current BGM volume without changing any of the current BGM's
  other properties and without restarting the BGM.

  Volume:
  - Change the current BGM's volume to what amount?
  - You may use JavaScript code.
  - Use numbers from 0 to 100.

---

CoreEngine Update103 Command5.png

Audio: Change Current BGM Pitch
- Changes the current BGM pitch without changing any of the current BGM's
  other properties and without restarting the BGM.

  Pitch:
  - Change the current BGM's pitch to what amount?
  - You may use JavaScript code.
  - Use numbers from 50 to 150.

---

CoreEngine Update103 Command6.png

Audio: Change Current BGM Pan
- Changes the current BGM pan without changing any of the current BGM's
  other properties and without restarting the BGM.

  Pan:
  - Change the current BGM's pan to what amount?
  - You may use JavaScript code.
  - Use numbers from -100 to 100.

---

Debug Plugin Commands

---

CoreEngine Update95 Command1.png

Debug: Current Controller ID
- PLAY TEST ONLY.
- Shows current controller ID in debug console.
- If you press a key on the keyboard, this data will be erased.
- Also copies to computer clipboard if possible.

---


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.

---

Map Plugin Commands

---

Map: Once Parallel
- Plays a Common Event parallel to the event once without repeating itself
  when done.
- Map only!

  Common Event ID:
  - The ID of the parallel Common Event to play.
  - Does NOT repeat itself when finished.
  - When exiting map scene or changing maps, all Once Parallels are cleared.
  - Once Parallels are not retained upon reentering the scene or map.
  - Once Parallels are not stored in memory and cannot be saved.

---

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 Update128 Command1.png

Picture: Rotate by Angle
- Rotates target picture by a amount angle over a set duration instead of
  continuously.

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

  Adjust Angle:
  - What is the angle you wish to rotate the picture by?
  - Use degrees (360 degrees per full rotation).
  - You may use JavaScript code.

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

  Duration:
  - Duration of rotation effect in frames.
  - 60 frames = 1 second.
  - You may use JavaScript code.

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

---

CoreEngine Update128 Command2.png

Picture: Rotate to Angle
- Rotates target picture to a certain angle over a set duration
  instead of continuously.

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

  Target Angle:
  - What is the target angle you wish to rotate the picture?
  - Use degrees (360 degrees per full rotation).
  - You may use JavaScript code.

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

  Duration:
  - Duration of rotation effect in frames.
  - 60 frames = 1 second.
  - You may use JavaScript code.

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

---

[[File:CoreEngine_Update43_Command1.png]]

[[File:CoreEngine_Update43_Command1_Ani2.gif]]

<pre>
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.

---

Text Popup Command

CoreEngine TextPopup.png

---

CoreEngine TextPopupCmd.png

Text Popup: Show Text
- Adds text to a text popup window to briefly appear.
- Multiple text popups will be queued.
- Does not halt the game and works parallel to game activity.

  Text:
  - Write the text that you want to appear here.
  - You may use text codes.

---

Variable Plugin Commands

---

CoreEngine Update89 Command1.png

Variable: JS Eval
- Pick a variable ID and value to alter through JS.
- Allows one line of code for variable ID and operand.
- Functions like RM2k3's Variable Pointers.

  Variable ID:
  - This is the target variable to alter.
  - You may use JavaScript.
  - ie: $gameVariables.value(1)

  Operation Type:
  - What operation do you wish to use for this Plugin Command?

  Operand Modifier:
  - Value to be used in calculating the target variable.
  - You may use JavaScript.
  - ie: $gameVariables.value(1)

---

CoreEngine Update89 Command2.png

Variable: JS Block
- Pick a variable ID and value to alter through JS.
- Allows JS block code for variable ID and operand.
- Functions like RM2k3's Variable Pointers.

  Variable ID:
  - This is the target variable to alter.
  - You may use JavaScript.
  - ie: $gameVariables.value(1)

  Operation Type:
  - What operation do you wish to use for this Plugin Command?

  Operand Modifier:
  - Value to be used in calculating the target variable.
  - You may use JavaScript.
  - ie: $gameVariables.value(1)

---

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.


Shortcuts.jpg
Useful Shortcuts for Playtesting by Arisu

2024 January 5

Read about some useful shortcuts you can enable with the VisuStella Core Engine here.


---

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.
 Shift+R: Recover All:
 - For Play Test only!
 - During battle, pressing SHIFT + R will refill the whole party's HP
   and MP and status.
 Shift+T: Full TP
 - For Play Test only!
 - During battle, pressing SHIFT + T will refill the whole party's TP.

---

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.
 Map Name Text Code:
 - If on, map names will use text codes.
 - If off, only the raw map name will be used.
 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.
 MV Animation Rate:
 - Adjusts the rate at which MV animations play.
 - Default: 4.
 - Lower for faster.
 - Higher for slower.
 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.

CoreEngine Update56 Param1.png

  Shortcut Scripts:
  - Enables shortcut-based script variables and functions that can be used
    for script calls.
  - Shortcut list enabled for this is as follows:

    $commonEvent(id)
    - Queues a common event.
    - This does not interrupt the current event to run the desired common
      event. Any queued common events will run after the current event list
      has finished.
    - Replace 'id' with the ID of the common event you wish to queue.
    - Common events only run in the map scene and battle scene.

    $onceParallel(id)
    - Runs a common event in the background as a once parallel event.
    - Once parallel events will run in the background like a parallel
      process, except that it does not repeat after finishing.
    - Replace 'id' with the ID of the common event you wish to run.
    - Only works in the map scene and battle scene. Battle scene usage will
      require VisuMZ_1_BattleCore.

    $scene
    - Returns current scene.

    $spriteset
    - Returns current scene's spriteset if there is one.

    $subject
    - Returns last recorded identity of the battle's subject/user.

    $targets
    - Returns last recorded targets marked in battle.

    $target
    - Returns last recorded target marked in battle.
    - Works better with VisuMZ_1_BattleCore.

    $event
    - Returns currently initiated map event.
 Smart Event Collision:
 - Makes events only able to collide with one another if they're
  'Same as characters' priority.
 Subfolder Name Purge:
 - Purge subfolder name from Plugin Parameters when reading data to let
   Plugin Commands work properly.
 - This is for plugins (such as the VisuMZ library) that utilize dynamic
   name registrations for Plugin Commands. Turn this on if you plan on
   using subfolders with VisuMZ plugins.

---

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.


WASD.jpg
WASD Movement by Arisu

2023 December 29

Read about how to quickly set up WASD movement with the VisuStella Core Engine here.


---

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

 Finish Entry:
 - Text used to describe finish entry.
 Page Change:
 - Text used to describe character page changing.
 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:

 Blur Strength:
 - Strength used for menu background snapshots.
 - Default: 8. Higher is stronger. Lower is weaker.
 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.
 Split "Escape":
 - Used ONLY for those making their own custom keyboard key input maps.
 - "Split" option makes separate instances of "Cancel" and "Menu" keys.
 - "Don't" option will consolidate both into "Escape" keys.

---

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.

---

Controller Button Assist Settings

CoreEngine Update95 Param1.png

These are sub-settings for the Button Assist Window Plugin Parameters. Where the Button Assist Window Plugin Parameters are focused on keyboard entries, these sections are focused on gamepad controllers.

Add multiple gamepads to the list to give them different button assist text. If a gamepad is being used but not listed here, the button assist text will default to the keyboard version.

For those looking for more information regarding controllers, visit this site: https://gamepad-tester.com/

---

ID Information

 Controller ID Name:
 - Exact string used for this controller ID.
 - Plugin Command "Debug: Current Controller ID" for ID help.
 - Example: Xbox 360 Controller (XInput STANDARD GAMEPAD)
 Similarity Match:
 - Partial string used to check for controller ID.
 - Plugin Command "Debug: Current Controller ID" for ID help.
 - This check occurs secondary to the exact name.
 - Example: Xbox

---

Directions

 Up:
 Left:
 Right:
 Down:
 - How this button is shown in-game.
 - Text codes allowed.

---

Actions

 OK:
 Cancel:
 Menu:
 Shift:
 Page Up:
 Page Down:
 - How this button is shown in-game.
 - Text codes allowed.
 - *NOTE*: Controllers use a different mapping scheme from keyboards.
   - The "cancel" button is separate from the "menu" button though, for the
     majority of the button assist window help text, we'll be referring to
     the cancel button usually.

---

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

 Show Actor Level?:
 - Show the actor level when displaying actors?
 - Affects for most windows in-game.
 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.

---

Maps

 Scroll Lock Small X?:
 Scroll Lock Small Y?:
 - Automatically scroll lock X/Y scrolling if the map is too small?
 - Useful for 1280x720 resolutions when the map is 27 tiles wide.
   - This will get rid of the subtle scrolling when moving from one half of
     the screen to the other.
 - This setting will be disabled if the map is zoomed in.
 Locked Display X?:
 Locked Display Y?:
 - What display X/Y value do you want for auto-scroll locked maps?
 - Use a number between 0 and 1 for best results.

---

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

 Enable Masking:
 - Enable window masking (windows hide other windows behind them)?
 - WARNING: Turning it on can obscure data.
 Correct Skin Bleed:
 - Allows you to enable/disable the window skin bleeding correction for
   those who wish to use the 95 calculator instead of 96 to augment higher
   and larger screen resolutions.
 - Read the "Bug Fixes" section if you don't understand what the window
   skin bleeding problem is.
 Line Height:
 - Default line height used for standard windows.
 - Avoid using odd numbers.
 - Visuals in RPG Maker and general game dev don't work well with odd
   numbers so avoid them unless you want your game's visuals to behave
   inconsistently.
 Item Padding:
 - Default line padding used for standard windows.
 - Avoid using odd numbers.
 - Visuals in RPG Maker and general game dev don't work well with odd
   numbers so avoid them unless you want your game's visuals to behave
   inconsistently.
 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

---

Scroll Bar

CoreEngine Scroll Bar Smol.gif

 Show Scroll Bar?:
 - Show the scroll bar for scrollable windows?
 Thickness:
 - How thick do you want the scroll bar to be?
 Offset:
 - How much do you want to offset the scroll bar by?
 Bar Body Color:
 - Use #rrggbb for custom colors or regular numbers for text colors from
   the Window Skin.
 Off Bar Color:
 - Use #rrggbb for custom colors or regular numbers for text colors from
   the Window Skin.
 Off Bar Opacity:
 - What opacity value do you want the off bar opacity to be?
 - Use a number between 0 and 255.

---

Selectable Items:

 Show Background?:
 - Selectable menu items have dark boxes behind them. Show them?
 Item Height Padding:
 - Default padding for selectable items.
 - Avoid using odd numbers.
 - Visuals in RPG Maker and general game dev don't work well with odd
   numbers so avoid them unless you want your game's visuals to behave
   inconsistently.
 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.81: February 15, 2024

  • Compatibility Update!
    • Added compatibility functionality for future plugins.
  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New notetags added for future plugin: VisuMZ_2_BattleGridSystem
      • <Grid>
      • <No Grid>
        • Requires the future plugin VisuMZ_2_BattleGridSystem!
        • Read the help section for more information on these.
    • New Plugin Parameter added by Arisu:
      • Plugin Parameters > Window > Correct Skin Bleed
        • Allows you to enable/disable the window skin bleeding correction for those who wish to use the 95 calculator instead of 96 to augment higher and larger screen resolutions.
        • Read the "Bug Fixes" section if you don't understand what the window skin bleeding problem is.


Version 1.80: January 18, 2024

  • RPG Fixes!
    • RPG Maker MZ Bug Fix!
      • Auto Save After New Game
        • Normally, when starting a new game through the "New Game" option, there is no auto save trigger. However, if you start a new game or load a saved game, then go to the Game End screen, return back to the title screen, then start a New Game, the auto save trigger occurs when it shouldn't. The Core Engine will now patch this and prevent the trigger from taking place.


Version 1.79: November 16, 2023

  • Documentation Update!
    • Help file updated for new features.
  • New Plugin Command added by Arisu:
    • Text Popup: Show Text
      • Adds text to a text popup window to briefly appear.
      • Multiple text popups will be queued.
      • Does not halt the game and works parallel to game activity.


Version 1.78: October 12, 2023

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Parameters added by Olivia and sponsored by AndyL:
      • QoL Settings > Battle Test > Shift+R: Recover All
        • For Play Test only! During battle, pressing SHIFT + R will refill the whole party's HP and MP and status.
      • QoL Settings > Battle Test > Shift+T: Full TP
        • For Play Test only! During battle, pressing SHIFT + T will refill the whole party's TP.


Version 1.77: August 17, 2023

  • Bug Fixes!
    • Fixed a bug that would cause the BGS related Plugin Commands to crash. Fix made by Arisu.
  • Documentation Update!
    • Help file updated for new features.
  • Feature Update!
    • Scroll-Linked Pictures now work if the image file are in a folder within the img/pictures/ folder without the folder needing a ! at the start.
  • New Features!
    • New Plugin Commands added by Arisu:
      • Picture: Rotate by Angle
        • Rotates target picture by a amount angle over a set duration instead of continuously.
        • View help file for more information on the Plugin Command.
      • Picture: Rotate to Angle
        • Rotates target picture to a certain angle over a set duration instead of continuously.
        • View help file for more information on the Plugin Command.
    • New Plugin Parameter added by Irina:
      • Parameters > Menu Button Assist > General > Split "Escape":
        • Used ONLY for those making their own custom keyboard key input maps.
        • "Split" option makes separate instances of "Cancel" and "Menu" keys.
        • "Don't" option will consolidate both into "Escape" keys.


Version 1.76: June 15, 2023

  • Bug Fixes
    • Fixed a bug that displayed the incorrect button press key for name input processing's cancel action. Fix made by Olivia.


Version 1.75: March 16, 2023

  • Documentation Update!
    • Help file updated for new features.
  • Feature Update!
    • In Scene_Name, when using the Keyboard Input, the button assist windows will no longer display the keyboard shortcuts for Ok and Cancel, but instead, show them for ENTER and BKSP. Update made by Arisu.
    • In Scene_Name, when manual inputting, the Page Up/Dn keys are now displayed to show changing character pages.
  • New Features!
    • New Plugin Parameters added by Arisu and sponsored by AndyL:
      • Params > Keyboard Input > Button Assist > Finish Entry
        • Text used to describe finish entry.
      • Params > Keyboard Input > Button Assist > Page Change
        • Text used to describe changing character pages.
      • Params > Window Settings > Scroll Bar
        • These settings also allow you to add scroll bars to scrollable windows, letting the player know how much of the window's contents there are left for scrolling. The scroll bar can be enabled, disabled, have its thickness changed, colors changed, etc.


Version 1.74: February 16, 2023

  • Compatibility Update!
    • Plugin Commands for: Audio: Change Current BGM/BGS Volume/Pitch/Pan should now work properly with the updated RPG Maker MZ version and WebAudio changes. Update made by Arisu.


Version 1.73: January 20, 2023

  • Compatibility Update!
    • Added better Effekseer version compatibility.


Version 1.72: December 15, 2022

  • Bug Fixes!
    • RPG Maker MZ Bug Fix!
      • Skill List Active After Party Member Change
        • If the skill list is active (ie. the player can move the cursor around) and the party member currently being viewed is changed via the button commands, then previously, RPG Maker MZ would still have that window be active despite having the cursor hidden temporarily. Upon pressing direction buttons, the cursor reveals itself and both the skill type window and skill list window are both active, making way for lots of potential problems to happen.
    • Water Tile Bug
      • It seems like there's a new bug that occurs if you create a tileset from scratch in RPG Maker MZ version 1.5.0+ and version 1.6.0+! What this bug does is it causes many tiles to become water tiles without intending to. You can find this out by turning off all the plugins in your project, putting a Ship or Boat on what are normally ground tiles, and then seeing the Ship or Boat traverse through it.
      • There are two ways to fix this. We cannot fix it through code in this plugin as it's a problem that involves the tileset json data there are ways to work around it so that you can get the proper water-flags to go where they need to be at.
        • 1. Copy a working un-bugged tileset onto the currently bugged one and reapply the tile features like passability, terrain tags, etc. This will make sure the water-passability tiles get copied over correctly.
        • 2. If you're on RPG Maker MZ version 1.5.0 or above, select a working un-bugged tileset (usually a pre-existing tileset when a new project is made), click the "Copy Page" button, go to the bugged tileset and press "Paste Page". You'll have to reapply any different properties like passabilities and terrain tags, but the water tile flags should now be working properly.
      • The plugin will not fix the problem itself since flag data is delicate and should not be tampered with midgame as the changes made by the plugin might not match the desired settings.
      • This plugin, however, will also send out an alert message when coming across such a tile. Pay attention to it and do one of the following two steps above to fix the problem.
  • Documentation Update!
    • Added "Skill List Active After Party Member Change" section to the "Important Changes: Bug Fixes" section of the help file.
    • Added "Water Tile Bug" section to the "Important Changes: Bug Fixes" section of the help file.
    • Help file updated for new features.
  • New Feature!
    • New Plugin Parameter added by Irina:
      • Plugin Parameters > Menu Backgrounds > Blur Strength
        • Strength used for menu background snapshots.


Version 1.71: November 10, 2022

  • Bug Fixes!
    • Title Command Window should now allow for more than 4 custom commands without hidden commands. Fix made by Irina.
    • Fixed a problem with repeating animations from Visual State Effects causing softlocks. Fix made by Olivia.


Version 1.70: October 6, 2022

  • Bug Fixes!
    • RPG Maker MZ Bug Fix!
      • A texture check will now occur for sprites that are being removed and destroyed in order to prevent crashes. In the off chance that someone creates a sprite through a script call and removes it through such, the likelihood of this occurance becomes higher. This makes the destroy property take into account a texture check in order to see if the sprite removal is taking extra steps and will reduce those extra steps.
  • Documentation Update!
    • Added "Sprite Removal and Destroy Crash" section to the "Important Changes: Bug Fixes" section.
  • Optimization Update!
    • Plugin should run more optimized.


Version 1.69: September 8, 2022

  • Bug Fixes!
    • Fixed the combination of Button Assist Location: Top with Help Location: Bottom combination not working properly. Fix made by Irina.


Version 1.68: August 4, 2022

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Commands added by Olivia and sponsored by Archeia:
      • Audio: Change Current BGM Volume
      • Audio: Change Current BGM Pitch
      • Audio: Change Current BGM Pan
      • Audio: Change Current BGS Volume
      • Audio: Change Current BGS Pitch
      • Audio: Change Current BGS Pan
        • Changes the current BGM/BGS volume/pitch/pan without changing any of the current BGM/BGS's other properties and without restarting BGM/BGS.


Version 1.67: July 28, 2022

  • Documentation Update!
    • Help file updated for new features.
    • Added notes for Line Height and Item Padding parameters:
      • Avoid using odd numbers.
      • Visuals in RPG Maker and general game dev don't work well with odd numbers so avoid them unless you want your game's visuals to behave inconsistently.
      • This setting will be disabled if the map is zoomed in.
  • New Features!
    • New map notetags added by Irina and sponsored by AndyL:
      • <Scroll Lock X>
      • <Scroll Lock X: x>
      • <Scroll Lock Y>
      • <Scroll Lock Y: y>
        • Causes the map to not scroll left/right(x) or up/down(y). Useful for when maps are just slightly smaller than normal and the tiny scrolling is distracting.
    • New Plugin Parameters added by Irina and sponsored by AndyL:
      • Plugin Parameters > Screen Resolution > Maps > Scroll Lock Small X?
      • Plugin Parameters > Screen Resolution > Maps > Scroll Lock Small Y?
      • Plugin Parameters > Screen Resolution > Maps > Locked Display X?
      • Plugin Parameters > Screen Resolution > Maps > Locked Display Y?
        • Automatically scroll locks small maps to prevent them from scrolling horizontally/vertically. Useful for 1280x720 resolutions when the map is 27 tiles wide. This will get rid of the subtle scrolling when moving from one half of the screen to the other.
        • This setting will be disabled if the map is zoomed in.
  • Feature Update!
    • Warnings added to Line Height and Item Padding parameters:
      • Avoid using odd numbers.
      • Visuals in RPG Maker and general game dev don't work well with odd numbers so avoid them unless you want your game's visuals to behave inconsistently.


Version 1.66: July 14, 2022

  • Bug Fixes!
    • RPG Maker MZ Bug Fix!
      • Debug Console Refresh Bug
        • When pressing F5 to refresh while the debug console (DevTools) is open, some graphics will fail to load properly. This started occurring since the RPG Maker MZ 1.5.0 update and the code for loading the images has now been reverted to the 1.4.4 version where it was last stable.
  • Documentation Update!
    • Help file updated for new major bug fix.


Version 1.65: June 30, 2022

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Parameter added by Irina:
      • Plugin Parameters > Parameter Settings > Show Actor Level?
        • Show the actor level when displaying actors?
        • Used for most windows in-game.


Version 1.64: June 9, 2022

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Command made by Arisu and sponsored by ImGonnaPutMyGameOnXboxAndYouCantStopMe:
      • Debug: Current Controller ID
        • PLAY TEST ONLY. Shows current controller ID in debug console.
        • Also copies to computer clipboard if possible.
    • New Plugin Parameters made by Arisu and sponsored by ImGonnaPutMyGameOnXboxAndYouCantStopMe:
      • Subsettings for Button Assist Window: Controller Button Assist
        • These are sub-settings for the Button Assist Window Plugin Parameters. Where the Button Assist Window Plugin Parameters are focused on keyboard entries, these sections are focused on gamepad controllers.
        • Add multiple gamepads to the list to give them different button assist text. If a gamepad is being used but not listed here, the button assist text will default to the keyboard version.


Version 1.63: May 2, 2022

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Parameter added by Irina:
      • Plugin Parameters > QoL Settings > Misc > Map Name Text Code
        • If on, map names will use text codes.
        • If off, only the raw map name will be used.
  • Feature Update!
    • The map name text code change will no longer be on forcefully. It is now something that can be toggled by Plugin Parameters. Update by Irina.


Version 1.62: April 28, 2022

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Plugin Commands added by Arisu and sponsored by Archeia:
      • Variable: JS Eval
        • Pick a variable ID and value to alter through JS.
        • Allows one line of code for variable ID and operand.
        • Functions like RM2k3's Variable Pointers.
      • Variable: JS Block
        • Pick a variable ID and value to alter through JS.
        • Allows JS block code for variable ID and operand.
        • Functions like RM2k3's Variable Pointers.
    • Map names can now use text codes. Made by Arisu and sponsored by Archeia.


Version 1.61: April 21, 2022

  • Bug Fixes!
    • RPG Maker MZ Bug Fix!
      • Battle Forced End Action Crash
        • Depending on various circumstances, currently active battlers can be cleared from the battle system at will due to a number of reasons. However, if it just so happens that the targets are cleared, too, with actions remaining, then a crash will follow up. This plugin will prevent that change. Fix made by Olivia.


Version 1.60: April 14, 2022

  • Bug Fixes!
    • Number Input window will now respond to Home/End keys properly. Fix made by Olivia.


Version 1.59: April 7, 2022

  • Compatibility Update!
    • RPG Maker MZ 1.4.4 compatibility update!
      • "Shutdown" command should now be more compatible with other aspects of the client when running from Node JS client on other OS's.


Version 1.58: March 24, 2022

  • Feature Update!
    • Plugin Commands now have separators for easier selection.


Version 1.57: March 3, 2022

  • Compatibility Update!
    • The "Shutdown" command from the title screen should now be compatible with RPG Maker MZ 1.4.4 and up. Update made by Olivia.


Version 1.56: February 10, 2022

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New features added by Arisu and sponsored by Anon:
      • Plugin Parameters > QoL > Misc > Shortcut Scripts
        • Enables shortcut-based script variables and functions that can be used for script calls.
        • Shortcut list enabled for this is as follows:
          • $commonEvent(id), $onceParallel(id), $scene, $spriteset, $subject, $targets, $target, $event
          • For more information on how to use them, review the help file.


Version 1.55: January 27, 2022

  • Feature Update!
    • Once Parallels for the map are now able to update even while other events are running. Update made by Arisu.


Version 1.54: January 13, 2022

  • Bug Fixes!
    • RPG Maker MZ Bug Fix!
      • Overly-Protective Substitute
      • When an ally with critical health is being targeted by a friendly non-Certain Hit skill (such as a heal or buff) and another ally has the substitute state, the other ally would "protect" the originally targeted ally and take the heal or buff.
      • The new changed behavior is that now, substitute will not trigger for any actions whose scope targets allies.
      • Fix made by Olivia.
  • Documentation Update!
    • Added documentation for new MZ Bug: Overly-Protective Substitute.
  • Feature Update!
    • Added a failsafe for those who did not update the plugin parameter settings and are using MV Animations.


Version 1.53: December 30, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Features!
    • New Notetag added by Olivia:
      • <Rate: x>
        • Allows you to adjust the update for this MV Animation.
          • Does NOT work with Effekseer animations.
        • The lower the number, the faster.
        • Replace 'x' with a number representing the animation update rate.
          • Default rate: 4.
          • Minimum rate: 1.
          • Maximum rate: 10.
    • New Plugin Parameter added by Olivia:
      • Plugin Parameters > Qualify of Life Settings > MV Animation Rate
        • Adjusts the rate at which MV animations play.
        • Default: 4. Lower for faster. Higher for slower.
  • Optimization Update!
    • MV Animations should run more optimized.


Version 1.52: December 16, 2021

  • Compatibility Update!
    • RPG Maker MZ 1.4.0 compatibility update!
      • MV Animations played on screen level will now show up properly in the center of the screen.


Version 1.51: December 9, 2021

  • Bug Fixes!
    • RPG Maker MZ Bug Fix!
      • In the battle status windows, whenever actor names are displayed, the bitmap used to display their name text do not extend vertically all the way, causing letters like lowercase "Q" and "G" to be cut off, making them hard to distinguish from one another. The Core Engine will remedy this by extending the bitmap to allow enough room. Fix made by Irina.


Version 1.50: November 4, 2021

  • Bug Fixes!
    • RPG Maker MZ Bug Fix!
      • By default, if the attack skill is sealed via a trait and an actor has auto-battle, the action can still be used via auto-battle. This is now fixed and actors should not be able to attack via auto-battle if their attack ability is sealed. Fix made by Yanfly.
  • Documentation Update!
    • Help file updated for new RPG Maker MZ bug fix.


Version 1.49: October 28, 2021

  • Documentation Update!
    • Help file updated for new features.
  • New Feature!
    • New Plugin Command added by Arisu and sponsored by Anon:
      • Map: Once Parallel
        • Plays a Common Event parallel to the event once without repeating itself when done. Map only!
        • When exiting map scene or changing maps, all Once Parallels are cleared
        • Once Parallels are not retained upon reentering the scene or map.
        • Once Parallels are not stored in memory and cannot be saved.


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!

See Also


End of File