Template:VisuMZ Lighting Effects Plugin Commands

From Yanfly.moe Wiki
Jump to navigation Jump to search

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

---

Overlay Plugin Commands

LightingEffects Quick3.png

---

OVERLAY: Change to Preset Color
- Change current darkness overlay to a preset color and opacity level.

  Color:
  - Pick a preset color.
  - This will also come with predetermined opacity values.

  Duration:
  - What is the duration of the color change?

---

OVERLAY: Change to Custom Color
- Change current darkness overlay to a custom color.

  Color:
  - Custom color.
  - This uses #rrggbb format.
  - Check your color here: https://htmlcolorcodes.com/

  Opacity:
  - Opacity level of the color.
  - Value between 0-255.
  - Transparent: 0. Opaque: 255.

  Duration:
  - What is the duration of the color change?

---

Battle Light Plugin Commands

LightingEffects BattleCore.png

---

BATTLE LIGHT: Change Actor(s) Settings
- Change the battle-radial light settings for target(s).

  Actor ID(s):
  - Target actor(s) you want to change light settings for.
  - You may use JavaScript code.

  Settings:
  - Change the radial light settings for the target(s).

  Behavior:
  - Change the behaviors for this radial light.

  Auto-Calc Radius:
  - Automatically calculates the radius size based on sprite's width/height.

---

BATTLE LIGHT: Change Enemy(s) Settings
- Change the battle-radial light settings for target(s).

  Enemy Index(es):
  - Select enemy troop index(es) to change light settings for.
  - You may use JavaScript code.

  Settings:
  - Change the radial light settings for the target(s).

  Behavior:
  - Change the behaviors for this radial light.

  Auto-Calc Radius:
  - Automatically calculates the radius size based on sprite's width/height.

---

Radial Light Plugin Commands

LightingEffects RadialLight.png

---

RADIAL LIGHT: Change Player Settings
- Change the radial light settings for the player.

  Settings:
  - Change the radial light settings for the player.
  - See "Radial Light Settings" section below.

  Behavior:
  - Change the behaviors for this radial light.
  - See "Behavior" section below.

---

RADIAL LIGHT: Change Follower Settings
- Change the radial light settings for followers.

  Settings:
  - Change the radial light settings for all followers.
  - See "Radial Light Settings" section below.

  Behavior:
  - Change the behaviors for this radial light.
  - See "Behavior" section below.

---

RADIAL LIGHT: Change Event(s) Settings
- Change the radial light settings for target event(s).

  Event ID(s):
  - Target event(s) to have their light settings changed.
  - Use 0 for "this event".
  - You may use JavaScript code.

  Settings:
  - Change the radial light settings for target event(s).
  - See "Radial Light Settings" section below.

  Behavior:
  - Change the behaviors for this radial light.
  - See "Behavior" section below.

---

RADIAL LIGHT: Change Boat Settings
- Change the radial light settings for the boat vehicle.

  Boarded:

    Radial Light:
    - Changed radial light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these radial lights?

  Unboarded:

    Radial Light:
    - Changed radial light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these radial lights?

---

RADIAL LIGHT: Change Ship Settings
- Change the radial light settings for the ship vehicle.

  Boarded:

    Radial Light:
    - Changed radial light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these radial lights?

  Unboarded:

    Radial Light:
    - Changed radial light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these radial lights?

---

RADIAL LIGHT: Change Airship Settings
- Change the radial light settings for the airship vehicle.

  Boarded:

    Radial Light:
    - Changed radial light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these radial lights?

  Unboarded:

    Radial Light:
    - Changed radial light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these radial lights?

---

Conical Light Plugin Commands

LightingEffects ConicalLight.png

---

CONICAL LIGHT: Change Player Settings
- Change the conical light settings for the player.

  Settings:
  - Change the conical light settings for the player.
  - See "Conical Light Settings" section below.

  Behavior:
  - Change the behaviors for this conical light.
  - See "Behavior" section below.

---

CONICAL LIGHT: Change Follower Settings
- Change the conical light settings for followers.

  Settings:
  - Change the conical light settings for all followers.
  - See "Conical Light Settings" section below.

  Behavior:
  - Change the behaviors for this conical light.
  - See "Behavior" section below.

---

CONICAL LIGHT: Change Event(s) Settings
- Change the conical light settings for target event(s).

  Event ID(s):
  - Target event(s) to have their light settings changed.
  - Use 0 for "this event".
  - You may use JavaScript code.

  Settings:
  - Change the conical light settings for target event(s).
  - See "Conical Light Settings" section below.

  Behavior:
  - Change the behaviors for this conical light.
  - See "Behavior" section below.

---

CONICAL LIGHT: Change Boat Settings
- Change the conical light settings for the boat vehicle.

  Boarded:

    Conical Light:
    - Changed conical light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these conical lights?

  Unboarded:

    Conical Light:
    - Changed conical light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these conical lights?

---

CONICAL LIGHT: Change Ship Settings
- Change the conical light settings for the ship vehicle.

  Boarded:

    Conical Light:
    - Changed conical light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these conical lights?

  Unboarded:

    Conical Light:
    - Changed conical light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these conical lights?

---

CONICAL LIGHT: Change Airship Settings
- Change the conical light settings for the airship vehicle.

  Boarded:

    Conical Light:
    - Changed conical light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these conical lights?

  Unboarded:

    Conical Light:
    - Changed conical light settings for this vehicle.

      Changed Behavior:
      - What are the changed behavioral settings for these radial lights?

---

Conical Offset Plugin Commands

LightingEffects ConicalHandDir.png

---

CONICAL OFFSET: Change Actor(s) Settings
- Change the conical light hand offset for target actor(s).

  Actor ID(s):
  - Target actor(s) you want to change offset settings for.
  - You may use JavaScript code.

  Enable:
  - Change the offset settings for the target(s).

  Hand Position Offsets:
  - Change target(s)'s offsets used for hand positions.

  VS8 Dash Offsets:
  - Change target(s)'s offsets used for hand positions for VS8 sprites
    while dashing.

  VS8 Jump Offsets:
  - Change target(s)'s offsets used for hand positions for VS8 sprites
    while jumping.

---

CONICAL OFFSET: Change Event(s) Settings
- Change the conical light hand offset for target event(s).

  Event ID(s):
  - Target event(s) you want to change offset settings for.
  - Use 0 for "this event".
  - You may use JavaScript code.

  Enable:
  - Change the offset settings for the target(s).

  Hand Position Offsets:
  - Change target(s)'s offsets used for hand positions.

  VS8 Dash Offsets:
  - Change target(s)'s offsets used for hand positions for VS8 sprites
    while dashing.

  VS8 Jump Offsets:
  - Change target(s)'s offsets used for hand positions for VS8 sprites
    while jumping.

---

CONICAL LIGHT: Change Ship Settings
- Change the conical light hand offset for the Ship vehicle.

  Boarded:

    Changed Offsets:
    - Changed offsets used for the "hand" positions of this vehicle.

  Unboarded:

    Changed Offsets:
    - Changed offsets used for the "hand" positions of this vehicle.

---

CONICAL LIGHT: Change Airship Settings
- Change the conical light hand offset for the airship vehicle.

  Boarded:

    Changed Offsets:
    - Changed offsets used for the "hand" positions of this vehicle.

  Unboarded:

    Changed Offsets:
    - Changed offsets used for the "hand" positions of this vehicle.

---

CONICAL LIGHT: Change Boat Settings
- Change the conical light hand offset for the boat vehicle.

  Boarded:

    Changed Offsets:
    - Changed offsets used for the "hand" positions of this vehicle.

  Unboarded:

    Changed Offsets:
    - Changed offsets used for the "hand" positions of this vehicle.

---

Spawn Light Plugin Commands

LightingEffects Spawn.gif

---

SPAWN LIGHT: Create Light(s) at Map X/Y
- Map only!
- Create new light spawn(s) locked to the map.
- Use tile coordinates for X and Y.

  Light Settings:

    Settings:
    - Change the radial light settings for the light spawn(s).

    Bheavior:
    - Change the behaviors for the light spawn(s).

  Coordinates X/Y:

    Origin X:
    Origin Y:
    - What is the origin X/Y position?
    - You may use JavaScript code.

  Spawn Settings:

    JS: Trajectory:
    - Code used to determine the trajectory of these lights.
    - These will revolve around the origin X/Y position.

    Initial Time:
    - What is the initial time value for this light spawn(s)?
    - You may use JavaScript code.

      Total Spawns:
      - How many light spawns should there be?
      - Minimum value: 1.
      - You may use JavaScript code.

      Time Increment:
      - What is the time increment between spawns?

    Expiration Timer:
    - After how many frames will light spawn(s) expire?
    - Use 0 for no expiration.
    - You may use JavaScript code.

---

SPAWN LIGHT: Create Light(s) at Screen X/Y
- Map only!
- Create new light spawn(s) locked to the screen.
- The light spawn(s) is unaffected by map scrolling.

  Light Settings:

    Settings:
    - Change the radial light settings for the light spawn(s).

    Bheavior:
    - Change the behaviors for the light spawn(s).

  Coordinates X/Y:

    Origin X:
    Origin Y:
    - What is the origin X/Y position?
    - You may use JavaScript code.

  Spawn Settings:

    JS: Trajectory:
    - Code used to determine the trajectory of these lights.
    - These will revolve around the origin X/Y position.

    Initial Time:
    - What is the initial time value for this light spawn(s)?
    - You may use JavaScript code.

      Total Spawns:
      - How many light spawns should there be?
      - Minimum value: 1.
      - You may use JavaScript code.

      Time Increment:
      - What is the time increment between spawns?

    Expiration Timer:
    - After how many frames will light spawn(s) expire?
    - Use 0 for no expiration.
    - You may use JavaScript code.

---

SPAWN LIGHT: Create Light(s) on Player
- Map only!
- Create new light spawn(s) following the player.
- The light spawn(s) is unaffected by map scrolling.

  Light Settings:

    Settings:
    - Change the radial light settings for the light spawn(s).

    Bheavior:
    - Change the behaviors for the light spawn(s).

  Spawn Settings:

    JS: Trajectory:
    - Code used to determine the trajectory of these lights.
    - These will revolve around the origin X/Y position.

    Initial Time:
    - What is the initial time value for this light spawn(s)?
    - You may use JavaScript code.

      Total Spawns:
      - How many light spawns should there be?
      - Minimum value: 1.
      - You may use JavaScript code.

      Time Increment:
      - What is the time increment between spawns?

    Expiration Timer:
    - After how many frames will light spawn(s) expire?
    - Use 0 for no expiration.
    - You may use JavaScript code.

---

SPAWN LIGHT: Create Light(s) on Follower
- Map only!
- Create new light spawn(s) following the player.
- The light spawn(s) is unaffected by map scrolling.

  Light Settings:

    Settings:
    - Change the radial light settings for the light spawn(s).

    Bheavior:
    - Change the behaviors for the light spawn(s).

  Target:

    Follower Index:
    - Which follower index should the light(s) follow?
    - Index starts at 0.
    - You may use JavaScript code.

  Spawn Settings:

    JS: Trajectory:
    - Code used to determine the trajectory of these lights.
    - These will revolve around the origin X/Y position.

    Initial Time:
    - What is the initial time value for this light spawn(s)?
    - You may use JavaScript code.

      Total Spawns:
      - How many light spawns should there be?
      - Minimum value: 1.
      - You may use JavaScript code.

      Time Increment:
      - What is the time increment between spawns?

    Expiration Timer:
    - After how many frames will light spawn(s) expire?
    - Use 0 for no expiration.
    - You may use JavaScript code.

---

SPAWN LIGHT: Create Light(s) on Event
- Map only!
- Create new light spawn(s) following the player.
- The light spawn(s) is unaffected by map scrolling.

  Light Settings:

    Settings:
    - Change the radial light settings for the light spawn(s).

    Bheavior:
    - Change the behaviors for the light spawn(s).

  Target:

    Event ID:
    - Which map event should the light(s) follow?
    - Use 0 for "this event".
    - You may use JavaScript code.

  Spawn Settings:

    JS: Trajectory:
    - Code used to determine the trajectory of these lights.
    - These will revolve around the origin X/Y position.

    Initial Time:
    - What is the initial time value for this light spawn(s)?
    - You may use JavaScript code.

      Total Spawns:
      - How many light spawns should there be?
      - Minimum value: 1.
      - You may use JavaScript code.

      Time Increment:
      - What is the time increment between spawns?

    Expiration Timer:
    - After how many frames will light spawn(s) expire?
    - Use 0 for no expiration.
    - You may use JavaScript code.

---

Light-Related Sub Settings

---

LightingEffects RadialLight.png

Radial Light Settings

  General:

    Enabled?:
    - Is this radial light enabled?

  Properties:

    Filename:
    - Filename used for the light effect image.
    - If used, ignore Color, Radius, and Intensity.
    - Image will be centered on the target where the center of the image is
      the anchor point and will be rotated.

    Color:
    - Color of the radial light in #rrggbb format.
    - For generated lights only.
    - Ignore if using image.

    Radius:
    - What is the radius of this radial light?
    - For generated lights only.
    - Ignore if using image.

    Intensity:
    - Radial light intensity. Use value between 0 & 1.
    - For generated lights only.
    - Ignore if using image.

  Optional:

    Angle:
    - What is the angle of this radial light?
    - Only noticeable with using images.

      Rotate Speed:
      - The rotation speed of this light?
      - Lower: slower. Higher: faster. Negative: reverse.

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

    Opacity:
    - What is the opacity (0 to 255)?
    - Lower: dimmer. Higher: Brighter.

  Offsets:

    Offset X:
    - Offset the X position of this light.
    - Negative: left. Positive: right.

    Offset Y:
    - Offset the Y position of this light.
    - Negative: up. Positive: down.

---

LightingEffects ConicalLight.png

Conical Light Settings

  General:

    Enabled?:
    - Is this conical light enabled?

  Properties:

    Filename:
    - Filename used for the light effect image.
    - If used, ignore Radius, Color, and Intensity.

      Angle Offset:
      - Offset the image angle by this many degrees.
      - Only applies to images.

      File Anchor X:
      File Anchor Y:
      - Anchor X/Y used for images.
      - For X - Left: 0.0; Center: 0.5; Right: 1.0
      - For Y - Top: 0.0; Middle: 0.5; Bottom: 1.0

    Color:
    - What is the radius of this conical light?
    - For generated lights only.
    - Ignore if using image.

    Radius:
    - What is the radius of this conical light?
    - For generated lights only.
    - Ignore if using image.

      Source Radius:
      - What is the radius of this light source?
      - For generated lights only.
      - Ignore if using image.

    Intensity:
    - Conical light intensity. Use value between 0 & 1.
    - For generated lights only.
    - Ignore if using image.

  Optional:

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

    Opacity:
    - What is the opacity (0 to 255)?
    - Lower: dimmer. Higher: Brighter.

  Angle:

    Arc Angle:
    - What is the angle of this conical light's arc?

    Angle Sway:
    - How many degrees should this light sway?
    - Use 0 for no sway.

    Sway Speed:
    - How fast should this light sway?
    - Lower: Slower; Higher: Faster

    Randomize Sway?:
    - Change the sway to offset at different starting points?

  Direction:

    Forced Direction?:
    - Force the conical light to face a certain direction?

    Follow Cursor?
    - Follow the mouse cursor?

  Offsets:

    Use Hand Offset?:
    - Put the light source on the target's "hand" position?
    - Disables the two settings below if on.

    Offset X (Non-Hand):
    - Offset the X position of this light.
    - Negative: left. Positive: right.

    Offset Y (Non-Hand):
    - Offset the Y position of this light.
    - Negative: up. Positive: down.

---

LightingEffects Blink.gif

LightingEffects Pattern.gif

Behavior

  Blink:

    Blink Rate:
    - What is the rate of occurance for this effect?
    - Use a decimal number between 0 and 1.

    Blink Modifier:
    - Static multiplicative opacity modifier. Before additive.
    - Use a decimal number between -1 and 1. Negatives allowed.

  Flicker:

    Flicker Rate:
    - What is the rate of occurance for this effect?
    - Use a decimal number between 0 and 1.

    Flicker Modifier:
    - Random multiplicative opacity modifier. Before additive.
    - Use a decimal number between -1 and 1. Negatives allowed.

  Flash:

    Flash Rate:
    - What is the rate of occurance for this effect?
    - Use a decimal number between 0 and 1.

    Flash Modifier:
    - Static additive opacity modifier. Before multiplicative.
    - Use a decimal number between -1 and 1. Negatives allowed.

  Flare:

    Flare Rate:
    - What is the rate of occurance for this effect?
    - Use a decimal number between 0 and 1.

    Flare Modifier:
    - Random additive opacity modifier. Before multiplicative.
    - Use a decimal number between -1 and 1. Negatives allowed.

  Glow:

    Glow Rate:
    - What is the glow change for this light?
    - Use a decimal number between 0 and 1.

    Glow Speed:
    - What is the speed at which glow oscillates at?
    - Use a decimal number between 0 and 1.

    Randomize Glow?:
    - Offset the glow to oscillate at different starting points?

  Pulse:

    Pulse Rate:
    - What is the pulse change for this light?
    - Use a decimal number between 0 and 1.

    Pulse Speed:
    - What is the speed at which pulse oscillates at?
    - Use a decimal number between 0 and 1.

    Randomize Pulse?:
    - Offset the pulse to oscillate at different starting points?

  Pattern:

    Pattern Name:
    - Select the pattern name for this light.
    - Ignore if using any Custom Pattern.

    Custom Pattern:
    - Create a custom pattern with letters from a to z.
    - Where 'a' is transparent and 'z' is opaque.

    Frame Delay:
    - What is the frame delay between pattern updates?

---