Picture Effects VisuStella MZ

From Yanfly.moe Wiki
Jump to navigation Jump to search

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



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


PictureEffects ArrangeCol.gif

PictureEffects Capsule.gif

PictureEffects FlyingCard.gif

PictureEffects Merge.gif

PictureEffects PieceInOut.gif

PictureEffects SpinChange.gif

Required Plugins

The following plugins are required in order to use this plugin.

Place the following plugins above this plugin located in the Plugin Manager.


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.146.jpg

Picture Effects is a comprehensive toolkit for enhancing RPG Maker MZ's picture by allowing various effects and transitions within your game. With over 70 different types of effects, users can adjust and animate pictures in various ways, ranging from banner-style transitions, hue shifts, many tonal changes, blur effects, transformations, and more.

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

  • Over 70 different Plugin Commands that will adjust and move pictures to perform various Picture Effects.
  • A plethora of picture transitions are available that are useful for banner like images to enter/exit from view.
  • Quick Plugin Commands that allow sorting a bunch of pictures on the screen into single file lines, by rows, or by columns.
  • Some effects have the ability to transform images into other graphics.
  • A batch of tone shifting effects that may be tedious to do otherwise.
  • Hue shifts can be applied to pictures to give more color variety.
  • Blur Filters can now be applied to pictures to add blurry effects.
  • Hovering and Sidestep effects allow pictures to move continuously up/down and/or left/right without constant event commands.
  • Breathing effects can make pictures look like they're breathing in and out in an alive fashion.
  • Swaying effects allow the pictures to rock its angles back and forth.
  • A depth of field effect where the player's mouse position can shift the perspective of a picture by having it go a certain direction.
  • Z Layer is now added to pictures. Game devs can now easily move pictures in front or behind other pictures by simply changing their Z values.

Requirements

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

Required Plugin List

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


Tier 2

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

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



Instructions - Quick Start

Here are some quick instructions on getting started.

PictureEffects Instructions.png

---

Step 1: "Show Picture" Event Command

  1. Create a new event and use the "Show Picture" event command.
  2. Pick the image you want and the position you want the image to be displayed at. We recommend using "Center" for the position origin.
  3. This will be where the image either starts or ends. The relative position will vary depending on the Picture Effect and its parameters used.
  4. Remember the Picture's ID number. This will be used later.

---

Step 2: "Picture Effect" Plugin Command

  1. Immediately after the "Show Picture" event command, under event commands, select "Plugin Command" and select the "VisuMZ_2_PictureEffects" plugin from the list.
  2. Select the desired "Picture Effect" you wish to apply.
  3. Under the "Picture ID(s)" parameter, insert the ID of the picture from Step 1.
  4. Adjust the other parameters as needed.

---

Step 3: Play Test

  1. Save the event and save the game project.
  2. Click Play Test and launch the event to make sure the effect is working properly. Some effects are jointed (namely the ones with "In/Out" in their Plugin Command names). You may need to put them back to back.

---

Major Changes

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

---

Event Commands

Keep in mind that when Picture Effects are used, using event commands that move, show, or erase the picture will very likely have an impact on how the Picture Effects are carried out. It is best for you to wait until they're done to make sure the Picture Effects are working as intended.

We are not responsible for how Picture Effects turn out if you interrupt them with event commands, script calls, or other Plugin Commands.

---


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.

VisuMZ.146.jpg

---

Effects - A - Plugin Commands

---

PictureEffects Angry.gif

EFFECT: Angry
- Picture(s) gets angry and turns red while shaking.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Distance X:
  - How far should the max horizontal distance be?

  Distance Y:
  - How far should the max vertical distance be?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects ArrangeCol.gif

EFFECT: Arrange By Column
- Picture(s) gets arranged by columns across the screen.
- Works best with multiple pictures.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Max Column Size:
  - What is the max column size before creating a new one?
  - You may use JavaScript.

  Anchor:
  Anchor X:
  - X anchor for pictures to adjust to.
  - 0.0 - left; 0.5 - center; 1.0 - right

  Anchor Y:
  - Y anchor for pictures to adjust to.
  - 0.0 - top; 0.5 - middle; 1.0 - bottom

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects ArrangeRow.gif

EFFECT: Arrange By Row
- Picture(s) gets arranged by rows across the screen.
- Works best with multiple pictures.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Max Row Size:
  - What is the max row size before creating a new one?
  - You may use JavaScript.

  Anchor:
  Anchor X:
  - X anchor for pictures to adjust to.
  - 0.0 - left; 0.5 - center; 1.0 - right

  Anchor Y:
  - Y anchor for pictures to adjust to.
  - 0.0 - top; 0.5 - middle; 1.0 - bottom

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects ArrangeHorz.gif

EFFECT: Arrange Horizontally
- Picture(s) gets spread horizontally on the screen.
- Works best with multiple pictures.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Target Y:
  - What Y coordinate do you want pictures arranged at?
  - You may use JavaScript.

  Anchor:
  Anchor X:
  - X anchor for pictures to adjust to.
  - 0.0 - left; 0.5 - center; 1.0 - right

  Anchor Y:
  - Y anchor for pictures to adjust to.
  - 0.0 - top; 0.5 - middle; 1.0 - bottom

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects ArrangeVert.gif

EFFECT: Arrange Vertically
- Picture(s) gets spread vertically on the screen.
- Works best with multiple pictures.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Target X:
  - What X coordinate do you want pictures arranged at?
  - You may use JavaScript.

  Anchor:
  Anchor X:
  - X anchor for pictures to adjust to.
  - 0.0 - left; 0.5 - center; 1.0 - right

  Anchor Y:
  - Y anchor for pictures to adjust to.
  - 0.0 - top; 0.5 - middle; 1.0 - bottom

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - B - Plugin Commands

---

PictureEffects BannerInOut.gif

EFFECT: Banner In/Out
- Picture(s) slides in from the side to the center, and then slides out to
  the side.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  From Direction:
  - Select which direction the effect starts from.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Berserk.gif

EFFECT: Berserk
- Picture(s) breathes heavily and turns into a reddish tone.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Blur.gif

EFFECT: Blur
- Picture(s) gets blurry (or not).

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Blur Strength:
  - Change blur strength for the picture(s).
  - For best results, use numbers between 0 and 10.

  Blur Duration:
  - The amount of time it takes for the change to occur.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Breathing.gif

EFFECT: Breathing
- Picture(s) breathes in and out continuously.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Scale Range X:
  Scale Range Y:
  - What is the horizontal/vertical breathing scale range?

  Speed Rate X:
  Speed Rate Y:
  - How fast or slow should the effect be?
  - Smaller numbers are slower. Larger numbers are faster.

  Random Seed:
  - What is the random seed used for this effect?
  - You may use JavaScript code.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. 0 for instant change.

---

Effects - C - Plugin Commands

---

PictureEffects Capsule.gif

EFFECT: Capsule Burst
- Picture(s) wobbles back and forth and transforms into a new image.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Transform Image:
  - Filename used for the transform image.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Scale Change:
  - How does the scale change over time?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Spazz Distance:
  - Potential spazz distance for this effect.

  Wobble Angle:
  - How many degrees does this wobble?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 20.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects CardFlipBack.gif

EFFECT: Card Flip
- Picture(s) flips like a card and shows its back.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Back Image:
  - Filename used for the card back image.
  - Leave empty if you don't wish to use one.

  Mirror Back?:
  - Mirror the back image?
  - If no back image is used, effect is always mirrored.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Charm.gif

EFFECT: Charm
- Picture(s) subject becomes charmed and enamored.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Scale Change:
  - How does the scale change over time?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 20.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Chilly.gif

EFFECT: Chilly
- Picture(s) spazzes and wobbles and turns light blue-ish.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Spazz Distance:
  - Potential distance for this effect.

  Wobble Angle:
  - Potential angle for this effect.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Confused.gif

EFFECT: Confused
- Picture(s) acts as if it's confused and moves in random directions.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Degrees:
  - How many degrees does this sway back and forth?

  Distance X:
  - How far should the max horizontal distance be?

  Distance Y:
  - How far should the max vertical distance be?

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - D - Plugin Commands

---

PictureEffects Damage.gif

EFFECT: Damage
- Picture(s) gets damaged and turns red while violently shaking.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Distance X:
  - How far should the max horizontal distance be?

  Distance Y:
  - How far should the max vertical distance be?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Depth.gif

EFFECT: Depth of Field
- Picture(s) is given an image depth of field and will change based off the
  mouse cursor position continuously.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Distance X:
  - How far should the max horizontal distance be?
  - Use negative numbers to go opposite directions.

  Distance Y:
  - How far should the max vertical distance be?
  - Use negative numbers to go opposite directions.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.
  - 0 for instant change.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Dizzy.gif

EFFECT: Dizzy
- Picture(s) acts as if it's dizzy and moves in a circle.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Degrees:
  - How many degrees does this sway back and forth?

  Distance X:
  - How far should the max horizontal distance be?

  Distance Y:
  - How far should the max vertical distance be?

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects DropInOut.gif

EFFECT: Drop In/Out
- Picture(s) drops downward in, and sinks further downward out.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Distance:
  - What is this effect's drop distance?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - E - Plugin Commands

---

PictureEffects Electrocute.gif

EFFECT: Electrocuted
- Picture(s) gets electrocuted and flashes two different colors while
  spazzing.
- WARNING! Flashing lights!

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Color Tone 1:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Color Tone 2:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Spazz Distance:
  - Potential distance for this effect.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Expand.gif

EFFECT: Expand In/Out
- Picture(s) expands as it enters and further as it exits.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - F - Plugin Commands

---

PictureEffects FadeChange.gif

EFFECT: Fade Change
- Picture(s) fades in and out while transforming in the middle.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Transform Image:
  - Filename used for the transform image.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects FadeInOut.gif

EFFECT: Fade In/Out
- Picture(s) fade in from nothing and fade out to nothing.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects FadeLayerSwitch.gif

EFFECT: Fade Layer Switch
- Picture(s) fade in and out while switching layers in between.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Target Z:
  - What Z Layer do you wish to assign this picture(s)?
  - You may use JavaScript.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Fear.gif

EFFECT: Fear
- Picture(s) goes pale and slowly regains color.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects FlashChange.gif

EFFECT: Flash Change
- Picture(s) flashes a few times before changing into a different graphic.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Transform Image:
  - Filename used for the transform image.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Flash Times:
  - How many times to flash the tone without changing?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 20

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects FlyingCard.gif

EFFECT: Flying Card
- Picture(s) flies out from current position to front of the screen and ends
  up in the center.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  To Direction:
  - Select which side of the screen the effect flies towards.

  Angle:
  - What is the angle at which the picture(s) stops at the front?

  Front Scale:
  - What is the scale of the picture(s) at the front?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Spin Times:
  - How many times does the picture(s) spin?

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects FocusInOut.gif

EFFECT: Focus In/Out
- Picture(s) focuses into view and clarity and out of.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - G - Plugin Commands

---

PictureEffects GhostInOut.gif

EFFECT: Ghost In/Out
- Picture(s) changes into or out of an etheral form.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Blur Strength:
  - Change blur strength for the picture(s).
  - For best results, use numbers between 0 and 10.

  Flash Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Ghost Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Glow.gif

EFFECT: Glow
- Picture(s) glows for a duration.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Blur Strength:
  - Change blur strength for the picture(s).
  - For best results, use numbers between 0 and 10.

  Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - H - Plugin Commands

---

PictureEffects Heal.gif

EFFECT: Heal
- Picture(s) glows and blurs a bit for a healing effect.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Blur Strength:
  - Change blur strength for the picture(s).
  - For best results, use numbers between 0 and 10.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Hoppity.gif

EFFECT: Hoppity
- Picture(s) jumps up in place and back down.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Height:
  - How high do you want the picture(s) to hop.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Hover.gif

EFFECT: Hover
- Picture(s) gains hover effect, floating up and down visually continuously.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Distance Y:
  - How far should the max vertical distance be?

  Speed Rate:
  - How fast or slow should the effect be?
  - Smaller numbers are slower. Larger numbers are faster.

  Random Seed:
  - What is the random seed used for this effect?
  - You may use JavaScript code.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.
  - 0 for instant change.

---

PictureEffects Hue.gif

EFFECT: Hue Shift By
- Picture(s) shifts by a relative hue value.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Hue Shift:
  - Insert a hue value here. (0 - 360)
  - You may use JavaScript.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Hue.gif

EFFECT: Hue Shift To
- Picture(s) shifts to a specific hue value.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Target Hue:
  - Insert a hue value here. (0 - 360)
  - You may use JavaScript.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - I - Plugin Commands

---

PictureEffects Illusion.gif

EFFECT: Illusion
- Picture(s) appears on random parts of the screen before landing in place.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Duration:
  - How long each extension's effect?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - J - Plugin Commands

---

PictureEffects Jiggle.gif

EFFECT: Jiggle
- Picture(s) jiggles from top to bottom, side to side.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Jump.gif

EFFECT: Jump By X/Y
- Picture(s) jumps by relative X/Y values.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Height:
  - How high do you want the picture(s) to hop.0

  Distance X:
  - How far should picture(s) jump horizontally?
  - You may use JavaScript. Negative: left. Positive: right.

  Distance Y:
  - How far should picture(s) jump vertically?
  - You may use JavaScript. Negative: up. Positive: down.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Jump.gif

EFFECT: Jump To X/Y
- Picture(s) jumps to X/Y coordinate.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Height:
  - How high do you want the picture(s) to hop.0

  Target X:
  - What is the target X destination?
  - You may use JavaScript.

  Target Y:
  - What is the target Y destination?
  - You may use JavaScript.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - L - Plugin Commands

---

PictureEffects Levitate.gif

EFFECT: Levitate In/Out
- Picture(s) floats upward in, and floats upward out.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Distance:
  - What is this effect's levitation distance?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - M - Plugin Commands

---

PictureEffects Mana.gif

EFFECT: Mana Restore
- Picture(s) glows, hue shifts, and blurs a bit for a restoration effect.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Blur Strength:
  - Change blur strength for the picture(s).
  - For best results, use numbers between 0 and 10.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Merge.gif

EFFECT: Merge & Change
- Picture(s) merge together to transform into a new graphic.
- Works best with multiple pictures.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Transform Image:
  - Filename used for the transform image.
  - First image is transformed. Others have 0 opacity.

  Blur Strength:
  - Change blur strength for the picture(s).
  - For best results, use numbers between 0 and 10.

  Target X:
  - What is the target X destination?
  - You may use JavaScript.

  Target Y:
  - What is the target Y destination?
  - You may use JavaScript.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 20.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - O - Plugin Commands

---

PictureEffects OpenClose.gif

EFFECT: Open & Close
- Picture(s) opens and closes like an in-game window.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - P - Plugin Commands

---

PictureEffects Petrify.gif

EFFECT: Petrify
- Picture(s) struggles as it becomes petrified..

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Petrify Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Scale Maximum:
  - How does the scale change over time?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Scale Minimum:
  - How does the scale change over time?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 20.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects PhaseInOut.gif

EFFECT: Phase In/Out
- Picture(s) phases into view and out of view.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects PieceInOut.gif

EFFECT: Piece In/Out
- Picture(s) flies in and out from a random screen border area.
- Works best with multiple pictures.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Border Scale:
  - What is the scale of the picture(s) at the border?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Poison.gif

EFFECT: Poison
- Picture(s) subject receives poison and becomes sickly.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Distance:
  - How far should the max horizontal distance be?

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 20.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects PowerUp.gif

EFFECT: Power Up Change
- Picture(s) switches between two images before changing completely.

  Transform Image:
  - Filename used for the transform image.

  Effect Times:
  - How many times to switch images?

  Duration:
  - How long is each switch's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Psyche.gif

EFFECT: Psychedelic
- Picture(s) shifts hue all the way around.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Pulse.gif

EFFECT: Pulse
- Picture(s) pulses towards its new scale.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Target Scale:
  - What is the target scale of the picture(s)?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - Q - Plugin Commands

---

PictureEffects QuickPress.gif

EFFECT: Quick Press
- Picture(s) is quickly pressed and rebounds back into place.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Distance X:
  - What is this effect's X distance?

  Distance 16:
  - What is this effect's Y distance?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - R - Plugin Commands

---

PictureEffects Random.gif

EFFECT: Random In/Out
- Picture(s) fades in and out in random positions.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Distance:
  - What is this effect's max randomized distance?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Roll.gif

EFFECT: Roll In/Out
- Picture(s) rolls in from the side and out to the other.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Distance:
  - What is this effect's roll distance?

  From Direction:
  - Select which direction the effect starts from.

  Spin Times:
  - How many times does the picture(s) spin while rolling?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Rotate.gif

EFFECT: Rotate
- Picture(s) rotates clockwise or counter clockwise.
- Apply opposite if the picture(s) is mirrored.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  From Direction:
  - Select which direction the effect rotates.
  - Apply opposite if the picture(s) is mirrored.

  Spin Times:
  - How many times does the picture(s) spin while rolling?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - S - Plugin Commands

---

PictureEffects Shakey.gif

EFFECT: Shakey
- Picture(s) shakes back and forth from side to side.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Distance:
  - What is this effect's shake distance?

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects ShrinkInOut.gif

EFFECT: Shrink In/Out
- Picture(s) shrinks in and shrinks further inward.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects SideStep.gif

EFFECT: Sidestep
- Picture(s) gains sidestep effect, moving left and right visually
  continuously.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Distance X:
  - How far should the max horizontal distance be?

  Speed Rate:
  - How fast or slow should the effect be?
  - Smaller numbers are slower. Larger numbers are faster.

  Random Seed:
  - What is the random seed used for this effect?
  - You may use JavaScript code.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.
  - 0 for instant change.

---

PictureEffects Spazz.gif

EFFECT: Spazz
- Picture(s) spazzes up, down, left, right at random.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Distance:
  - What is this effect's spazz distance?

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects SpinChange.gif

EFFECT: Spin Change
- Picture(s) spins and changes into a different graphic.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Transform Image:
  - Filename used for the transform image.

  Scale Change:
  - How does the scale change over time?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Spin Times:
  - How many times does the picture(s) spin before transforming?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 20

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects SpinInOut.gif

EFFECT: Spin In/Out
- Picture(s) spins into view and out of view.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Spin Times:
  - How many times does the picture(s) spin while rolling?

  Vanish Scale:
  - What is the scale of the picture(s) when null?
  - 0.0 = 0%; 0.5 = 50%; 1.0 = 100%; 2.0 = 200%

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects SquishInOut.gif

EFFECT: Squish In/Out
- Picture(s) squishes as it enters and further as it exits.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects StretchInOut.gif

EFFECT: Stretch In/Out
- Picture(s) stretches as it enters and further as it exits.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects SubmergeInOut.gif

EFFECT: Submerge In/Out
- Picture(s) enters and exits the bottom of the screen.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Swaying.gif

EFFECT: Swaying
- Picture(s) angles back and forth from side to side continuously.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Angle Range:
  - How many degrees should the picture sway?

  Speed Rate:
  - How fast or slow should the effect be?
  - Smaller numbers are slower. Larger numbers are faster.

  Random Seed:
  - What is the random seed used for this effect?
  - You may use JavaScript code.

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.
  - 0 for instant change.

---

Effects - T - Plugin Commands

---

PictureEffects Teleport.gif

EFFECT: Teleport In/Out
- Picture(s) teleports into view and out of view.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Television.gif

EFFECT: Television In/Out
- Picture(s) snaps in and out like a television screen.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects TintShift.gif

EFFECT: Tint Shift By
- Picture(s) changes tone and its own Z Layer relatively.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Adjust Z:
  - Adjust the Z value of target picture(s) by this.
  - You may use JavaScript. + Move Front. - Move Back.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects TintShift.gif

EFFECT: Tint Shift To
- Picture(s) changes tone and its Z Layer to a specific value.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Target Z:
  - What Z Layer do you wish to assign this picture(s)?
  - You may use JavaScript.

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

PictureEffects Transform.gif

EFFECT: Transform
- Picture(s) transforms into another image with no other effects.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Transform Image:
  - Filename used for the transform image.

---

Effects - U - Plugin Commands

---

PictureEffects UFO.gif

EFFECT: UFO In/Out
- Picture(s) enters and exits the top of the screen.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Color Tone:
  - What tone do you want for the effect?
  - Format: [Red, Green, Blue, Gray]

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second. Minimum: 10.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - V - Plugin Commands

---

PictureEffects Vibrate.gif

EFFECT: Vibrate
- Picture(s) vibrates a certain distance from start to end.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Distance X:
  - How far should the max horizontal distance be?

  Distance Y:
  - How far should the max vertical distance be?

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - W - Plugin Commands

---

PictureEffects Wobble.gif

EFFECT: Wobble
- Picture(s) wobbles its angle from side to side.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect Times:
  - How many times to extend this effect?

  Degrees:
  - How many degrees does this wobble?

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---

Effects - Z - Plugin Commands

---

PictureEffects ZLayer.gif

EFFECT: Z Layer Change By
- Picture(s) changes its Z layer to a relative value.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Adjust Z:
  - Adjust the Z value of target picture(s) by this.
  - You may use JavaScript. + Move Front. - Move Back.

---

PictureEffects ZLayer.gif

EFFECT: Z Layer Set To
- Picture(s) changes its Z layer to a specific value.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Target Z:
  - What Z Layer do you wish to assign this picture(s)?
  - You may use JavaScript.

---

PictureEffects ZoomInOut.gif

EFFECT: Zoom In/Out
- Picture(s) zooms into view and out of.

  Picture ID(s):
  - Select which picture ID(s) to play this effect with.

  Effect In/Out?:
  - What effect type is this?

  Duration:
  - How long is this effect's duration?
  - 60 frames = 1 second.

  Wait for Completion?:
  - Wait until effect is complete before moving onto next event command?

---



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.00 Official Release Date: February 21, 2024

  • Finished Plugin!


See Also


End of Helpfile