Difference between revisions of "Category:Script Calls (MV)"

From Yanfly.moe Wiki
Jump to navigation Jump to search
(Created blank page)
 
Line 1: Line 1:
 +
{{TOCright}}
 +
== [[Visual Novel Busts (Irina)]] ==
  
 +
; Displaying a Bust
 +
 +
Does exactly what it means, display a bust. There are 11 busts that can be
 +
controlled. 0 is the Message Window's bust graphic. 1 through 10 are the
 +
busts that are shown on the screen behind the Message Window.
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwMzgucG5n/original/Yc%2BA5M.png' width='300'></html>
 +
 +
Insert [BUST] into the filenames of face graphics and they will be setup
 +
automatically to change as the bust graphic. Harold.png will become
 +
Harold[BUST].png. This makes it unnecessary for you to use \bust[0] every
 +
time you want to set a bust to the message window itself. This only works
 +
for images in the img/faces/ folder.
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNTEucG5n/original/frQf33.png' width='300'></html>
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).loadBitmap('face', 'filename')
 +
    $bust(id).loadBitmap('picture', 'filename')
 +
    - Replace id with the bust ID you want to implant the face graphic on.
 +
      - 0 if you want to use the message bust.
 +
      - 1 through 10 if you want to use the screen busts.
 +
    - Decide if you're going to load from img/faces/ or img/pictures/
 +
    - Replace 'filename' with the exact case sensitive filename of the file
 +
    while keeping the quotes.
 +
    - Examples:
 +
      - $bust(0).loadBitmap('face', 'Harold[BUST]')
 +
      - $bust(1).loadBitmap('picture', 'Therese[BUST]')
 +
</pre>
 +
 +
; Clear
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNTMucG5n/original/ub5ozD.png' width='300'></html>
 +
 +
Clearing a bust removes it from view and resets it to the default settings
 +
so that the next time it's used, it will be a fresh slate. This is done
 +
automatically for message busts after the Message Window closes. A plugin
 +
parameter setting can be turned on to make all busts clear after an event
 +
finishes running.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).clear(duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - (Optional) Replace duration with how long it takes to clear.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(0).clear()
 +
      - $bust(2).clear(20)
 +
</pre>
 +
 +
; Expressions
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MTgyNjQuZ2lm/original/awhJMi.gif' width='300'></html>
 +
 +
If you have set up a bust to use expressions, you can use this text code to
 +
change the expression of the bust. Please refer to the "Expression List"
 +
part of the help section up above to learn how to set up busts to make an
 +
expression sheet.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).setExpression(expression)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace expression with either a number index or the string that is
 +
      associated with that expression to display the wanted expression.
 +
    - Examples:
 +
      - $bust(0).setExpression(1)
 +
      - $bust(2).setExpression('Angry')
 +
</pre>
 +
 +
; Battle Animations
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNTQuZ2lm/original/LjAGJQ.gif' width='300'></html>
 +
 +
You can play battle animations on the busts to depict actions, emotions,
 +
whatever you want them to do. These will play the battle animation only once
 +
before closing out.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).startAnimation(ani, mirror, delay)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace ani with the ID of the battle animation
 +
      - Alternatively, you can type out the battle animation's name, too.
 +
        If you do, make it into a string for the Script Call.
 +
    - (Optional) Replace mirror with true/face to mirror the animation.
 +
    - (Optional) Replace delay with the frames to wait before playing.
 +
    - Examples:
 +
      - $bust(0).startAnimation(5)
 +
      - $bust(2).startAnimation('Healing One 2', true, 20)
 +
</pre>
 +
 +
; Repeating Battle Animations
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNTUuZ2lm/original/EfisZ%2B.gif' width='300'></html>
 +
 +
Play battle animations repeatedly instead of one time. Otherwise, this is
 +
the same as playing regular battle animations. Repeating animations will
 +
stop automatically for message busts when the window closes. For screen
 +
busts, they will vanish once the event terminates.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).setupRepeatingAnimation(ani, mirror, delay)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace ani with the ID of the battle animation
 +
      - Alternatively, you can type out the battle animation's name, too.
 +
        If you do, make it into a string for the Script Call.
 +
    - (Optional) Replace mirror with true/face to mirror the animation.
 +
    - (Optional) Replace delay with the frames to wait before playing.
 +
    - Examples:
 +
      - $bust(0).setupRepeatingAnimation(5)
 +
      - $bust(2).setupRepeatingAnimation('Healing One 2', true, 20)
 +
</pre>
 +
 +
; Clear Repeating Battle Animation
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNTcucG5n/original/D7Xs0W.png' width='300'></html>
 +
 +
Put an end to a repeating battle animation because otherwise that is going
 +
to go on forever until the currently running event fully terminates.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).clearRepeatingAnimation();
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Examples:
 +
      - $bust(0).clearRepeatingAnimation();
 +
      - $bust(3).clearRepeatingAnimation();
 +
</pre>
 +
 +
; Move To
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNTkuZ2lm/original/JbFggl.gif' width='300'></html>
 +
 +
Allows bust sprites to move to specific x and y coordinates. This does not
 +
work for message busts as they're locked to the Message Window.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).moveTo(x, y, duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace x with the x coordinate on the screen to move to.
 +
    - Replace y with the y coordinate on the screen to move to.
 +
    - (Optional) Replace duration with how long it takes to move there.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(1).moveTo(640, 720)
 +
      - $bust(5).moveTo(100, 360, 60)
 +
</pre>
 +
 +
; Move By
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNjAuZ2lm/original/i6YOHV.gif' width='300'></html>
 +
 +
Allows bust sprites to move relative to their current position. This does
 +
not work for message busts as they're locked to the Message Window.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).moveBy(+x, +y, duration)
 +
    $bust(id).moveBy(-x, -y, duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace x with how far left(-) or right(+) to move by.
 +
    - Replace y with how far up(-) or down(+) to move by.
 +
    - (Optional) Replace duration with how long it takes to move there.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(1).moveBy(-100, +0)
 +
      - $bust(5).moveBy(+200, -50, 60)
 +
</pre>
 +
 +
; Move Home
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNjEuZ2lm/original/6i2j5i.gif' width='300'></html>
 +
 +
Returns a bust sprite back to the home position. For those moments you're
 +
too confused, lazy, or both to figure out how to bring a bust sprite back to
 +
the original coordinates it was in. This does not work for message busts as
 +
they're locked to the Message Window.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).moveHome(duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - (Optional) Replace duration with how long it takes to move there.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(1).moveHome()
 +
      - $bust(4).moveHome(60)
 +
</pre>
 +
 +
; Move Type
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNjQuZ2lm/original/WS5mOO.gif' width='300'></html>
 +
 +
Allows you to adjust the rate, acceleration, and easing when a bust moves.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).moveType('type')
 +
    - Replace id with the bust ID you want to affect.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace type with the movement type. Look below for a list.
 +
    - Examples:
 +
      - $bust(0).moveType('Linear')
 +
      - $bust(4).moveType('OutBounce')
 +
 +
Types:
 +
    Linear ......... No easing, no acceleration
 +
 +
    InSine ......... Slight acceleration from zero to full speed
 +
    OutSine ........ Slight deceleration at the end
 +
    InOutSine ...... Slight accel. at beginning and slight decel. at end
 +
 +
    InQuad ......... LV2 Accelerating from zero velocity
 +
    OutQuad ........ LV2 Decelerating to zero velocity
 +
    InOutQuad ...... LV2 Acceleration until halfway, then deceleration
 +
 +
    InCubic ........ LV3 Accelerating from zero velocity
 +
    OutCubic ....... LV3 Decelerating to zero velocity
 +
    InOutCubic ..... LV3 Acceleration until halfway, then deceleration
 +
 +
    InQuart ........ LV4 Accelerating from zero velocity
 +
    OutQuart ....... LV4 Decelerating to zero velocity
 +
    InOutQuart ..... LV4 Acceleration until halfway, then deceleration
 +
 +
    InQuint ........ LV5 Accelerating from zero velocity
 +
    OutQuint ....... LV5 Decelerating to zero velocity
 +
    InOutQuint ..... LV5 Acceleration until halfway, then deceleration
 +
 +
    InExpo ......... Accelerate exponentially until finish
 +
    OutExpo ........ Initial exponential acceleration slowing to stop
 +
    InOutExpo ...... Exponential acceleration and deceleration
 +
 +
    InCirc ......... Increasing velocity until stop
 +
    OutCirc ........ Start fast, decreasing velocity until stop
 +
    InOutCirc ...... Fast increase in velocity, fast decrease in velocity
 +
 +
    InBack ......... Slow movement backwards then fast snap to finish
 +
    OutBack ........ Fast snap to backwards point then slow to finish
 +
    InOutBack ...... Back In, then Back Out
 +
 +
    InElastic ...... Bounces slowly then quickly to finish
 +
    OutElastic ..... Fast acceleration, bounces to zero
 +
    InOutElastic ... Slow start and end, two bounces sandwich a fast motion
 +
 +
    InBounce ....... Bounce increasing in velocity until completion
 +
    OutBounce ...... Bounce to completion
 +
    InOutBounce .... Bounce in and bounce out
 +
</pre>
 +
 +
; Fade In, Fade Out
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNjYuZ2lm/original/yvvvq7.gif' width='300'></html>
 +
 +
Fade in to 255 opacity or fade out 0 opacity. This can affect any bust and
 +
you can also declare the duration of the fading process.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).fadeIn(duration)
 +
    $bust(id).fadeOut(duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - (Optional) Replace duration with how long it takes to fade in or out.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(1).fadeIn()
 +
      - $bust(6).fadeOut(40)
 +
</pre>
 +
 +
; Opacity To
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNzIuZ2lm/original/jjNmll.gif' width='300'></html>
 +
 +
If you don't want to fully change a bust's opacity to either 0 or 255, set
 +
it to whatever opacity level you want instead.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).opacityTo(opacity, duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace opacity with a number between 0 and 255 for how opaque it is.
 +
    - (Optional) Replace duration with how long it takes to fade in or out.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(0).opacityTo(128)
 +
      - $bust(7).opacityTo(64)
 +
</pre>
 +
 +
; Opacity By
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNzQuZ2lm/original/q%2FyJuw.gif' width='300'></html>
 +
 +
This changes the opacity level of a bust relative to its current opacity
 +
instead of needing to put in an exact value.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).opacityBy(+opacity, duration)
 +
    $bust(id).opacityBy(-opacity, duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace opacity with how much you wish to adjust the opacity by.
 +
    - (Optional) Replace duration with how long it takes to change opacity.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(0).opacityBy(+32)
 +
      - $bust(8).opacityBy(-64)
 +
</pre>
 +
 +
; Slide In, Slide Out
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwNzguZ2lm/original/MmoDKJ.gif' width='300'></html>
 +
 +
Sliding In and Sliding Out is a small move and fade in/out combo that is
 +
based around the bust's home position. This makes busts look like they're
 +
fading into the scene or fading out of them.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).slideIn(duration)
 +
    $bust(id).slideInFromLeft(duration)
 +
    $bust(id).slideInFromRight(duration)
 +
    $bust(id).slideOut(duration)
 +
    $bust(id).slideOutToLeft(duration)
 +
    $bust(id).slideOutToRight(duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Use the FromLeft, FromRight, ToLeft, ToRight versions to control the
 +
      direction the busts are going or leave it up to the plugin.
 +
    - (Optional) Replace duration with how long it takes to slide in/out.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(0).slideIn()
 +
      - $bust(9).slideOut(20)
 +
</pre>
 +
 +
; Mirror, Unmirror, MirrorToggle
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwODAuZ2lm/original/zaHQAu.gif' width='300'></html>
 +
 +
Lets you set the bust sprite to mirror, unmirror, or toggle the mirror
 +
setting it currently has.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).mirror()
 +
    $bust(id).unmirror()
 +
    $bust(id).mirrorToggle()
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Examples:
 +
      - $bust(0).slideIn()
 +
      - $bust(9).slideOut(100, 20)
 +
</pre>
 +
 +
; Scale To
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwODguZ2lm/original/9aHQQS.gif' width='300'></html>
 +
 +
This lets you change the scale of the bust sprite to an exact amount. Now, I
 +
know that sprites with a negative value for scale flip over, but these text
 +
codes and script calls will disable that. If you want to mirror something,
 +
use the mirror text codes for it.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).scaleTo(scale, duration)
 +
    $bust(id).scaleToX(scale, duration)
 +
    $bust(id).scaleToY(scale, duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace scale with a number value on how to scale it.
 +
      - 0.5 is 50%. 1.0 is 100%. 1.5 is 150%.
 +
    - (Optional) Replace duration with how long it takes to scale.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Use the X and Y variations if you want to adjust those specifically
 +
    - Examples:
 +
      - $bust(0).scaleTo(1.0)
 +
      - $bust(2).scaleToX(0.5, 20)
 +
      - $bust(4).scaleToX(2.5, 60)
 +
</pre>
 +
 +
; Scale By
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwOTAuZ2lm/original/lbA4KM.gif' width='300'></html>
 +
 +
This lets you change the scale of the bust sprite relative to its current
 +
scale value. This will work with an absolute value of the current scale to
 +
remove any confusion about how mirrored scaling works, so just treat a bust
 +
that is mirrored the same way you'd treat a bust that's not mirrored.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).scaleBy(+scale, duration)
 +
    $bust(id).scaleByX(-scale, duration)
 +
    $bust(id).scaleByY(+scale, duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace scale with a number value on how to scale it.
 +
      - 0.5 is 50%. 1.0 is 100%. 1.5 is 150%.
 +
    - (Optional) Replace duration with how long it takes to scale.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Use the X and Y variations if you want to adjust those specifically
 +
    - Examples:
 +
      - $bust(0).scaleBy(-1.0)
 +
      - $bust(2).scaleToX(+0.5, 20)
 +
      - $bust(4).scaleToX(-2.5, 60)
 +
</pre>
 +
 +
; Tone
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIwOTguZ2lm/original/yp8BYR.gif' width='300'></html>
 +
 +
Give busts a tone! Tones will tint the colors on a bust. The bust will then
 +
change its tint towards that tone over time.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).setTone(red, green, blue, gray, duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - Replace red with a number between -255 and 255.
 +
    - Replace green with a number between -255 and 255.
 +
    - Replace blue with a number between -255 and 255.
 +
    - Replace gray with a number between 0 and 255.
 +
    - (Optional) Replace duration with how long it takes to change tone.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(0).setTone(-68, -68, 0, 68)
 +
      - $bust(5).setTone(-68, -68, -68, 0, 60)
 +
</pre>
 +
 +
; Dim, Light
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIxMDAuZ2lm/original/WPIY%2Bs.gif' width='300'></html>
 +
 +
Dim and Light are preset tones that are primarily used for tinting busts.
 +
Usually visual novels will dim busts that aren't talking and light the busts
 +
that are. This is to speed up the process so that you don't have to type out
 +
a tone code every time. You can set the dim and light values in the plugin
 +
parameters. They'll also use the duration for tones if no duration is used
 +
to specify that specific dim or light tone change.
 +
 +
<pre>
 +
Script Call:
 +
    $bust(id).dim(duration)
 +
    $bust(id).light(duration)
 +
    - Replace id with the bust ID you want to affect.
 +
      - 0 if you want to affect the message bust.
 +
      - 1 through 10 if you want to affect the screen busts.
 +
    - (Optional) Replace duration with how long it takes to change tone.
 +
      - If no duration is used, then use the value in the plugin parameters
 +
    - Examples:
 +
      - $bust(0).dim()
 +
      - $bust(5).light(60)
 +
</pre>
 +
 +
; Mass Bust Script Calls
 +
 +
<html><img src='https://img.itch.zone/aW1nLzE5MDIxMDQucG5n/original/mUyp3r.png' width='300'></html>
 +
 +
To have multiple busts do a bunch of things at once, you can use this piece
 +
of code in a script to accomplish it with whatever script call listed above.
 +
 +
<pre>
 +
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10].forEach(function(i) {
 +
  $bust(i).slideIn(20);
 +
  $bust(i).moveType('OutBounce');
 +
  $bust(i).scaleTo(1.25, 20);
 +
});
 +
</pre>
 +
 +
Replace the numbers in the array with the bust ID's that you want it to
 +
affect and whatever script calls in the middle after the $bust(i). Do not
 +
replace the i because that tells the code which bust to affect.
 +
 +
Any number that's not listed in that array won't have the bust associated
 +
with it performing any of the listed actions in the middle.

Revision as of 20:42, 24 June 2019

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.


Visual Novel Busts (Irina)

Displaying a Bust

Does exactly what it means, display a bust. There are 11 busts that can be controlled. 0 is the Message Window's bust graphic. 1 through 10 are the busts that are shown on the screen behind the Message Window.

Insert [BUST] into the filenames of face graphics and they will be setup automatically to change as the bust graphic. Harold.png will become Harold[BUST].png. This makes it unnecessary for you to use \bust[0] every time you want to set a bust to the message window itself. This only works for images in the img/faces/ folder.

Script Call:
     $bust(id).loadBitmap('face', 'filename')
     $bust(id).loadBitmap('picture', 'filename')
     - Replace id with the bust ID you want to implant the face graphic on.
       - 0 if you want to use the message bust.
       - 1 through 10 if you want to use the screen busts.
     - Decide if you're going to load from img/faces/ or img/pictures/
     - Replace 'filename' with the exact case sensitive filename of the file
     while keeping the quotes.
     - Examples:
       - $bust(0).loadBitmap('face', 'Harold[BUST]')
       - $bust(1).loadBitmap('picture', 'Therese[BUST]')
Clear

Clearing a bust removes it from view and resets it to the default settings so that the next time it's used, it will be a fresh slate. This is done automatically for message busts after the Message Window closes. A plugin parameter setting can be turned on to make all busts clear after an event finishes running.

Script Call:
     $bust(id).clear(duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - (Optional) Replace duration with how long it takes to clear.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(0).clear()
       - $bust(2).clear(20)
Expressions

If you have set up a bust to use expressions, you can use this text code to change the expression of the bust. Please refer to the "Expression List" part of the help section up above to learn how to set up busts to make an expression sheet.

Script Call:
     $bust(id).setExpression(expression)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Replace expression with either a number index or the string that is
       associated with that expression to display the wanted expression.
     - Examples:
       - $bust(0).setExpression(1)
       - $bust(2).setExpression('Angry')
Battle Animations

You can play battle animations on the busts to depict actions, emotions, whatever you want them to do. These will play the battle animation only once before closing out.

Script Call:
     $bust(id).startAnimation(ani, mirror, delay)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Replace ani with the ID of the battle animation
       - Alternatively, you can type out the battle animation's name, too.
         If you do, make it into a string for the Script Call.
     - (Optional) Replace mirror with true/face to mirror the animation.
     - (Optional) Replace delay with the frames to wait before playing.
     - Examples:
       - $bust(0).startAnimation(5)
       - $bust(2).startAnimation('Healing One 2', true, 20)
Repeating Battle Animations

Play battle animations repeatedly instead of one time. Otherwise, this is the same as playing regular battle animations. Repeating animations will stop automatically for message busts when the window closes. For screen busts, they will vanish once the event terminates.

Script Call:
     $bust(id).setupRepeatingAnimation(ani, mirror, delay)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Replace ani with the ID of the battle animation
       - Alternatively, you can type out the battle animation's name, too.
         If you do, make it into a string for the Script Call.
     - (Optional) Replace mirror with true/face to mirror the animation.
     - (Optional) Replace delay with the frames to wait before playing.
     - Examples:
       - $bust(0).setupRepeatingAnimation(5)
       - $bust(2).setupRepeatingAnimation('Healing One 2', true, 20)
Clear Repeating Battle Animation

Put an end to a repeating battle animation because otherwise that is going to go on forever until the currently running event fully terminates.

Script Call:
     $bust(id).clearRepeatingAnimation();
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Examples:
       - $bust(0).clearRepeatingAnimation();
       - $bust(3).clearRepeatingAnimation();
Move To

Allows bust sprites to move to specific x and y coordinates. This does not work for message busts as they're locked to the Message Window.

Script Call:
     $bust(id).moveTo(x, y, duration)
     - Replace id with the bust ID you want to affect.
       - 1 through 10 if you want to affect the screen busts.
     - Replace x with the x coordinate on the screen to move to.
     - Replace y with the y coordinate on the screen to move to.
     - (Optional) Replace duration with how long it takes to move there.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(1).moveTo(640, 720)
       - $bust(5).moveTo(100, 360, 60)
Move By

Allows bust sprites to move relative to their current position. This does not work for message busts as they're locked to the Message Window.

Script Call:
     $bust(id).moveBy(+x, +y, duration)
     $bust(id).moveBy(-x, -y, duration)
     - Replace id with the bust ID you want to affect.
       - 1 through 10 if you want to affect the screen busts.
     - Replace x with how far left(-) or right(+) to move by.
     - Replace y with how far up(-) or down(+) to move by.
     - (Optional) Replace duration with how long it takes to move there.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(1).moveBy(-100, +0)
       - $bust(5).moveBy(+200, -50, 60)
Move Home

Returns a bust sprite back to the home position. For those moments you're too confused, lazy, or both to figure out how to bring a bust sprite back to the original coordinates it was in. This does not work for message busts as they're locked to the Message Window.

Script Call:
     $bust(id).moveHome(duration)
     - Replace id with the bust ID you want to affect.
       - 1 through 10 if you want to affect the screen busts.
     - (Optional) Replace duration with how long it takes to move there.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(1).moveHome()
       - $bust(4).moveHome(60)
Move Type

Allows you to adjust the rate, acceleration, and easing when a bust moves.

Script Call:
     $bust(id).moveType('type')
     - Replace id with the bust ID you want to affect.
       - 1 through 10 if you want to affect the screen busts.
     - Replace type with the movement type. Look below for a list.
     - Examples:
       - $bust(0).moveType('Linear')
       - $bust(4).moveType('OutBounce')

Types:
     Linear ......... No easing, no acceleration

     InSine ......... Slight acceleration from zero to full speed
     OutSine ........ Slight deceleration at the end
     InOutSine ...... Slight accel. at beginning and slight decel. at end

     InQuad ......... LV2 Accelerating from zero velocity
     OutQuad ........ LV2 Decelerating to zero velocity
     InOutQuad ...... LV2 Acceleration until halfway, then deceleration

     InCubic ........ LV3 Accelerating from zero velocity
     OutCubic ....... LV3 Decelerating to zero velocity
     InOutCubic ..... LV3 Acceleration until halfway, then deceleration

     InQuart ........ LV4 Accelerating from zero velocity
     OutQuart ....... LV4 Decelerating to zero velocity
     InOutQuart ..... LV4 Acceleration until halfway, then deceleration

     InQuint ........ LV5 Accelerating from zero velocity
     OutQuint ....... LV5 Decelerating to zero velocity
     InOutQuint ..... LV5 Acceleration until halfway, then deceleration

     InExpo ......... Accelerate exponentially until finish
     OutExpo ........ Initial exponential acceleration slowing to stop
     InOutExpo ...... Exponential acceleration and deceleration

     InCirc ......... Increasing velocity until stop
     OutCirc ........ Start fast, decreasing velocity until stop
     InOutCirc ...... Fast increase in velocity, fast decrease in velocity

     InBack ......... Slow movement backwards then fast snap to finish
     OutBack ........ Fast snap to backwards point then slow to finish
     InOutBack ...... Back In, then Back Out

     InElastic ...... Bounces slowly then quickly to finish
     OutElastic ..... Fast acceleration, bounces to zero
     InOutElastic ... Slow start and end, two bounces sandwich a fast motion

     InBounce ....... Bounce increasing in velocity until completion
     OutBounce ...... Bounce to completion
     InOutBounce .... Bounce in and bounce out
Fade In, Fade Out

Fade in to 255 opacity or fade out 0 opacity. This can affect any bust and you can also declare the duration of the fading process.

Script Call:
     $bust(id).fadeIn(duration)
     $bust(id).fadeOut(duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - (Optional) Replace duration with how long it takes to fade in or out.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(1).fadeIn()
       - $bust(6).fadeOut(40)
Opacity To

If you don't want to fully change a bust's opacity to either 0 or 255, set it to whatever opacity level you want instead.

Script Call:
     $bust(id).opacityTo(opacity, duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Replace opacity with a number between 0 and 255 for how opaque it is.
     - (Optional) Replace duration with how long it takes to fade in or out.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(0).opacityTo(128)
       - $bust(7).opacityTo(64)
Opacity By

This changes the opacity level of a bust relative to its current opacity instead of needing to put in an exact value.

Script Call:
     $bust(id).opacityBy(+opacity, duration)
     $bust(id).opacityBy(-opacity, duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Replace opacity with how much you wish to adjust the opacity by.
     - (Optional) Replace duration with how long it takes to change opacity.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(0).opacityBy(+32)
       - $bust(8).opacityBy(-64)
Slide In, Slide Out

Sliding In and Sliding Out is a small move and fade in/out combo that is based around the bust's home position. This makes busts look like they're fading into the scene or fading out of them.

Script Call:
     $bust(id).slideIn(duration)
     $bust(id).slideInFromLeft(duration)
     $bust(id).slideInFromRight(duration)
     $bust(id).slideOut(duration)
     $bust(id).slideOutToLeft(duration)
     $bust(id).slideOutToRight(duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Use the FromLeft, FromRight, ToLeft, ToRight versions to control the
       direction the busts are going or leave it up to the plugin.
     - (Optional) Replace duration with how long it takes to slide in/out.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(0).slideIn()
       - $bust(9).slideOut(20)
Mirror, Unmirror, MirrorToggle

Lets you set the bust sprite to mirror, unmirror, or toggle the mirror setting it currently has.

Script Call:
     $bust(id).mirror()
     $bust(id).unmirror()
     $bust(id).mirrorToggle()
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Examples:
       - $bust(0).slideIn()
       - $bust(9).slideOut(100, 20)
Scale To

This lets you change the scale of the bust sprite to an exact amount. Now, I know that sprites with a negative value for scale flip over, but these text codes and script calls will disable that. If you want to mirror something, use the mirror text codes for it.

Script Call:
     $bust(id).scaleTo(scale, duration)
     $bust(id).scaleToX(scale, duration)
     $bust(id).scaleToY(scale, duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Replace scale with a number value on how to scale it.
       - 0.5 is 50%. 1.0 is 100%. 1.5 is 150%.
     - (Optional) Replace duration with how long it takes to scale.
       - If no duration is used, then use the value in the plugin parameters
     - Use the X and Y variations if you want to adjust those specifically
     - Examples:
       - $bust(0).scaleTo(1.0)
       - $bust(2).scaleToX(0.5, 20)
       - $bust(4).scaleToX(2.5, 60)
Scale By

This lets you change the scale of the bust sprite relative to its current scale value. This will work with an absolute value of the current scale to remove any confusion about how mirrored scaling works, so just treat a bust that is mirrored the same way you'd treat a bust that's not mirrored.

Script Call:
     $bust(id).scaleBy(+scale, duration)
     $bust(id).scaleByX(-scale, duration)
     $bust(id).scaleByY(+scale, duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Replace scale with a number value on how to scale it.
       - 0.5 is 50%. 1.0 is 100%. 1.5 is 150%.
     - (Optional) Replace duration with how long it takes to scale.
       - If no duration is used, then use the value in the plugin parameters
     - Use the X and Y variations if you want to adjust those specifically
     - Examples:
       - $bust(0).scaleBy(-1.0)
       - $bust(2).scaleToX(+0.5, 20)
       - $bust(4).scaleToX(-2.5, 60)
Tone

Give busts a tone! Tones will tint the colors on a bust. The bust will then change its tint towards that tone over time.

Script Call:
     $bust(id).setTone(red, green, blue, gray, duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - Replace red with a number between -255 and 255.
     - Replace green with a number between -255 and 255.
     - Replace blue with a number between -255 and 255.
     - Replace gray with a number between 0 and 255.
     - (Optional) Replace duration with how long it takes to change tone.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(0).setTone(-68, -68, 0, 68)
       - $bust(5).setTone(-68, -68, -68, 0, 60)
Dim, Light

Dim and Light are preset tones that are primarily used for tinting busts. Usually visual novels will dim busts that aren't talking and light the busts that are. This is to speed up the process so that you don't have to type out a tone code every time. You can set the dim and light values in the plugin parameters. They'll also use the duration for tones if no duration is used to specify that specific dim or light tone change.

Script Call:
     $bust(id).dim(duration)
     $bust(id).light(duration)
     - Replace id with the bust ID you want to affect.
       - 0 if you want to affect the message bust.
       - 1 through 10 if you want to affect the screen busts.
     - (Optional) Replace duration with how long it takes to change tone.
       - If no duration is used, then use the value in the plugin parameters
     - Examples:
       - $bust(0).dim()
       - $bust(5).light(60)
Mass Bust Script Calls

To have multiple busts do a bunch of things at once, you can use this piece of code in a script to accomplish it with whatever script call listed above.

[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10].forEach(function(i) {
  $bust(i).slideIn(20);
  $bust(i).moveType('OutBounce');
  $bust(i).scaleTo(1.25, 20);
});

Replace the numbers in the array with the bust ID's that you want it to affect and whatever script calls in the middle after the $bust(i). Do not replace the i because that tells the code which bust to affect.

Any number that's not listed in that array won't have the bust associated with it performing any of the listed actions in the middle.