New Character Properties with Calls 2.2

[PK8]

New Character Properties with Calls

LINKS BROKEN

Introduction
This script adds additional properties from the Sprite class to Game_Character such as angle, color, mirror, tone, zoom_x, and zoom_y. For this version, I also combined my Event Angle/Color/Mirror/Tone/Zoom add-ons and my script calls with this script.

Features

• This gives Character sprites additional properties from the Sprite class such as Angle, Color, Mirror, Tone, Zoom, Wave Amp, Wave Length, and Wave Speed
  
• Change the angle, color, mirror, tone, zoom, wave amp, wave length, and wave speed of a character sprite using script calls.
  
• Set Angle, Color, Mirror, Tone, Zoom, Wave Amplitude, Wave Length, and Wave Speed of Events using special comments.
  
• Change certain properties of a character sprite to a desired value in a certain number of frames with a script call.
  

What's New?
For v2, I merged two add-ons I made for the original (Change Character Sprite Angle/Color/Size/Tone in frames and Event Angle/Color/Size/Tone) into one package and threw in several new script calls which should be useful (e.g.: zoom_change, color_*_change, tone_*_change).

Media
Images

Note the treasure chests, statues, and the flying imp hovering over Ralph.

Script
New Character Properties with Calls 2.2 (RMXP)

VX/Ace

Code:

begin

New Character Properties with Calls 2.2
by PK8
Created: 5/12/2009
Modified: 6/11/2012
──────────────────────────────────────────────────────────────────────────────
■ Author's Notes
   I wanted to work on letting game creators animate character sprites a little
   more through script calls. I noticed certain properties such as angle, color,
   mirror, tone, and angle were missing so I wanted to add them in.
──────────────────────────────────────────────────────────────────────────────
■ Introduction & Description
   This script adds additional properties from the Sprite class to
   Game_Character such as angle, color, mirror, tone, zoom_x, and zoom_y.
   For this version, I also combined my Event Angle/Color/Mirror/Tone/Zoom
   add-ons and my script calls with this script.
──────────────────────────────────────────────────────────────────────────────
■ Features
   o This gives Character sprites additional properties from the Sprite class
     such as Angle, Color, Mirror, Tone, Zoom, and Wave.
   o Change the angle, color, mirror, tone, and zoom of a character sprite using
     script calls.
   o Set Angle, Color, Mirror, Tone, Zoom, and Wave of Events using special
     comments.
   o Change certain properties of a character sprite to a desired value in a
     certain number of frames with a script call.
──────────────────────────────────────────────────────────────────────────────
■ Methods Aliased
   Sprite_Character.update
   Game_Character.initialize
   Game_Character.update
   Game_Event.refresh
──────────────────────────────────────────────────────────────────────────────
■ Thanks
   Charlie Fleed showed me how to create these special comments a few years ago.
   This one is more of a shoutout than a thanks. Okay, it's a bit of both. I'd
     like to send a shoutout to Prof. Meow Meow who showed me a demo of his a
     few years ago making use of a previous version of this script. I thought
     it was an awesome experience being able to see how other people would use
     it, and I enjoyed how Prof. Meow Meow made use of it. So hey Prof., if
     you're still RMing, thanks.
──────────────────────────────────────────────────────────────────────────────
■ Changelog (MM/DD/YYYY)
v1     (05/10/2009): Initial release.
v1.1   (05/10/2009): Replaced attr_reader with attr_accessor.
v1.2   (05/12/2009): Replaced initial zoom_x/zoom_y value of 1.0 with 100
v2     (04/14/2012): Combines Event Angle/Color/Mirror/Tone/Zoom and
                      changing properties in frames but throws in various
                      new calls to the mix while some of them are renamed,
                      such as sizex_change => zoom_x_change.
v2.1   (04/15/2012): Added relative arguments for all methods.
v2.1.1 (06/11/2012): Reduced the lines of code by about about a hundred, and
                      added new instance variables that can be written into via
                      script calls such as the @*_target and @*_duration
                      variables.
v2.2   (06/11/2012): Users can now use Arrays when changing Tones and Colors of
                      characters via script calls.
                      (Example: $game_player.tone = [0, -255, 0, 120])
──────────────────────────────────────────────────────────────────────────────
■ Usage
┌──────────────────────────────────────────────────────────────────────────┐
│ ■ Adjusting Character Sprites.                                           │
└┬───────────────┬─────────────────────────────────────────────────────────┘
  │ Setting Angle │
  └───────────────┘
              Syntax
   Player:    $game_player.angle = value
   Event:     $game_map.events[id].angle = value
   Vehicle:   $game_map.vehicle[id].angle = value
  
              Examples
   Player:    $game_player.angle = 90
   Event:     $game_map.events[1].angle = 90
   Vehicle:   $game_map.vehicle[1].angle = 90
  
└┬───────────────┬─────────────────────────────────────────────────────────┘
  │ Setting Color │
  └───────────────┘
              Min/Max values
   r/g/b:     0/255
   alpha:     0/255 (Optional)

              Syntax (All channels)
   Player:    $game_player.color = Color.new(red, green, blue[, alpha])
   Event:     $game_map.events[id].color = Color.new(red, green, blue[, alpha])
   Vehicle:   $game_map.vehicle[id].color = Color.new(red, green, blue[, alpha])
  
              Examples (All: without Alpha)
   Player:    $game_player.color = Color.new(255, 255, 255)
   Event:     $game_map.events[1].color = Color.new(255, 255, 255)
   Vehicle:   $game_map.vehicle[1].color = Color.new(255, 255, 255)
              
              Examples (All: with Alpha)
   Player:    $game_player.color = Color.new(255, 255, 255, 255)
   Event:     $game_map.events[1].color = Color.new(255, 255, 255, 255)
   Vehicle:   $game_map.vehicle[1].color = Color.new(255, 255, 255, 255)

              Syntax (Specific)
   Player:    $game_player.color.red = value
   Player:    $game_player.color.green = value
   Player:    $game_player.color.blue = value
   Player:    $game_player.color.alpha = value
  
   Event:     $game_map.events[id].color.red = value
   Event:     $game_map.events[id].color.green = value
   Event:     $game_map.events[id].color.blue = value
   Event:     $game_map.events[id].color.alpha = value
  
   Vehicle:   $game_map.vehicle[id].color.red = value
   Vehicle:   $game_map.vehicle[id].color.green = value
   Vehicle:   $game_map.vehicle[id].color.blue = value
   Vehicle:   $game_map.vehicle[id].color.alpha = value
  
              Examples (Specific)
   Player:    $game_player.color.red = 60
   Player:    $game_player.color.green = 120
   Player:    $game_player.color.blue = 180
   Player:    $game_player.color.alpha = 255
  
   Event:     $game_map.events[1].color.red = 60
   Event:     $game_map.events[1].color.green = 120
   Event:     $game_map.events[1].color.blue = 180
   Event:     $game_map.events[1].color.alpha = 255
  
   Vehicle:   $game_map.vehicle[1].color.red = 60
   Vehicle:   $game_map.vehicle[1].color.green = 120
   Vehicle:   $game_map.vehicle[1].color.blue = 180
   Vehicle:   $game_map.vehicle[1].color.alpha = 255

└┬────────────────┬────────────────────────────────────────────────────────┘
  │ Setting Mirror │
  └────────────────┘
              Values
   true:      Turns Mirror on.
   false:     Turns Mirror off.
  
              Syntax
   Player:    $game_player.mirror = value
   Event:     $game_map.events[id].mirror = value
   Vehicle:   $game_map.vehicle[id].mirror = value
  
              Examples
   Player:    $game_player.mirror = true
   Event:     $game_map.events[1].mirror = true
   Vehicle:   $game_map.vehicle[1].mirror = true
  
└┬──────────────┬──────────────────────────────────────────────────────────┘
  │ Setting Tone │
  └──────────────┘
              Min/Max values
   r/g/b:     -255/255
   gray:      0/255 (Optional)
  
              Syntax (All)
   Player:    $game_player.tone = Tone.new(red, green, blue[, gray])
   Event:     $game_map.events[id].tone = Tone.new(red, green, blue[, gray])
   Vehicle:   $game_map.vehicle[id].tone = Tone.new(red, green, blue[, gray])
  
              Examples (All: without Gray)
   Player:    $game_player.tone = Tone.new(255, 255, 255)
   Event:     $game_map.events[1].tone = Tone.new(255, 255, 255)
   Vehicle:   $game_map.vehicle[1].tone = Tone.new(255, 255, 255)
              
              Examples (All: with Gray)
   Player:    $game_player.tone = Tone.new(255, 255, 255, 255)
   Event:     $game_map.events[1].tone = Tone.new(255, 255, 255, 255)
   Vehicle:   $game_map.vehicle[1].tone = Tone.new(255, 255, 255, 255)

              Syntax (Specific)
   Player:    $game_player.tone.red = value
   Player:    $game_player.tone.green = value
   Player:    $game_player.tone.blue = value
   Player:    $game_player.tone.gray = value
  
   Event:     $game_map.events[id].tone.red = value
   Event:     $game_map.events[id].tone.green = value
   Event:     $game_map.events[id].tone.blue = value
   Event:     $game_map.events[id].tone.gray = value
  
   Vehicle:   $game_map.vehicle[id].tone.red = value
   Vehicle:   $game_map.vehicle[id].tone.green = value
   Vehicle:   $game_map.vehicle[id].tone.blue = value
   Vehicle:   $game_map.vehicle[id].tone.gray = value
  
              Examples (Specific)
   Player:    $game_player.tone.red = 60
   Player:    $game_player.tone.green = 120
   Player:    $game_player.tone.blue = 180
   Player:    $game_player.tone.gray = 255
  
   Event:     $game_map.events[1].tone.red = 60
   Event:     $game_map.events[1].tone.green = 120
   Event:     $game_map.events[1].tone.blue = 180
   Event:     $game_map.events[1].tone.alpha = 255
  
   Vehicle:   $game_map.vehicle[1].tone.red = 60
   Vehicle:   $game_map.vehicle[1].tone.green = 120
   Vehicle:   $game_map.vehicle[1].tone.blue = 180
   Vehicle:   $game_map.vehicle[1].tone.alpha = 255
  
└┬──────────────┬──────────────────────────────────────────────────────────┘
  │ Setting Zoom │
  └──────────────┘
              Values
   100:       Denotes actual pixel size
  
              Syntax
   Player:    $game_player.zoom_x = value
   Player:    $game_player.zoom_y = value
  
   Event:     $game_map.events[id].zoom_x = value
   Event:     $game_map.events[id].zoom_y = value
  
   Vehicle:   $game_map.vehicle[id].zoom_x = value
   Vehicle:   $game_map.vehicle[id].zoom_y = value
  
              Examples
   Player:    $game_player.zoom_x = 125
   Player:    $game_player.zoom_y = 125
  
   Event:     $game_map.events[1].zoom_x = 125
   Event:     $game_map.events[1].zoom_y = 125
  
   Vehicle:   $game_map.vehicle[1].zoom_x = 125
   Vehicle:   $game_map.vehicle[1].zoom_y = 125

└┬──────────────┬──────────────────────────────────────────────────────────┘
  │ Setting Wave │
  └──────────────┘
              Values
  Wave Length: Minimum is 2
  
              Syntax
  Player:     $game_player.wave_amp = value
  Player:     $game_player.wave_length = value
  Player:     $game_player.wave_speed = value
  
  Event:      $game_map.events[id].wave_amp = value
  Event:      $game_map.events[id].wave_length = value
  Event:      $game_map.events[id].wave_speed = value
  
  Vehicle:    $game_map.vehicle[id].wave_amp = value
  Vehicle:    $game_map.vehicle[id].wave_length = value
  Vehicle:    $game_map.vehicle[id].wave_speed = value
  
┌──────────────────────────────────────────────────────────────────────────┐
│ ■ Special Comments for Events                                            │
└──────────────────────────────────────────────────────────────────────────┘
   You get to set up how events would appear.

   Angle:       $angle value
   Color:       $color red green blue alpha
   Color Red:   $color_red value
   Color Green: $color_green value
   Color Blue:  $color_blue value
   Color Alpha: $color_alpha value
     * Red/Green/Blue/Alpha: 0/255
   Mirror:      $mirror
   Mirror False:$mirror false
   Mirror True: $mirror true
   Tone:        $tone red green blue gray
   Tone Red:    $tone red
   Tone Green:  $tone green
   Tone Blue:   $tone blue
   Tone Gray:   $tone gray
     * Red/Green/Blue: -255/255 | Gray: 0/255
   Zoom:        $zoom zoom_x zoom_y
   Zoom X:      $zoom_x value
   Zoom Y:      $zoom_y value
     * 100: Denotes actual pixel size
   Wave Amp:    $wave_amp value
   Wave Length: $wave_length value
     * Minimum value: 2
   Wave Speed:  $wave_speed value
  
┌──────────────────────────────────────────────────────────────────────────┐
│ ■ Changing properties in frames                                          │
└┬─────────────────────────┬───────────────────────────────────────────────┘
  │ Setting Angle in frames │
  └─────────────────────────┘
  Player:     $game_player.angle_change(value, duration, relative)
  Event:      $game_map.events[id].angle_change(value, duration, relative)
  Vehicle:    $game_map.vehicle[id].angle_change(value, duration, relative)
  * relative: Optional. Set to false by default.
  
└┬─────────────────────────┬───────────────────────────────────────────────┘
  │ Setting Color in frames │
  └─────────────────────────┘
              Syntax (All)
  Player:     $game_player.color_change([red, green, blue, alpha], duration,
              relative)
  Event:      $game_map.events[id].color_change([red, green, blue, alpha]),
              duration, relative)
  Vehicle:    $game_map.events[id].color_change([red, green, blue, alpha],
              duration, relative)
  * alpha: 0 - 255. Optional.
  * relative: Optional. Set to false by default.
                
              Syntax (Specific)
  Player:     $game_player.color_red_change(value, duration, rel)
  Player:     $game_player.color_green_change(value, duration, rel)
  Player:     $game_player.color_blue_change(value, duration, rel)
  Player:     $game_player.color_alpha_change(value, duration, rel)
  
  Event:      $game_map.events[id].color_red_change(value, duration, rel)
  Event:      $game_map.events[id].color_green_change(value, duration, rel)
  Event:      $game_map.events[id].color_blue_change(value, duration, rel)
  Event:      $game_map.events[id].color_alpha_change(value, duration, rel)
  
  Vehicle:    $game_map.vehicle[id].color_red_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].color_green_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].color_blue_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].color_alpha_change(value, duration, rel)
  * relative: Optional. Set to false by default.
  
└┬────────────────────────┬────────────────────────────────────────────────┘
  │ Setting Tone in Frames │
  └────────────────────────┘
              Syntax (All)
  Player:     $game_player.tone_change([red, green, blue, gray], duration,
              relative)
  Event:      $game_map.events[id].tone_change([red, green, blue, gray],
              duration, relative)
  Vehicle:    $game_map.vehicle[id].tone_change([red, green, blue, gray],
              duration, relative)
  * gray: 0 - 255. Optional.
  * relative: Optional. Set to false by default.
                
              Syntax (Specific)
  Player:     $game_player.tone_red_change(value, duration, rel)
  Player:     $game_player.tone_green_change(value, duration, rel)
  Player:     $game_player.tone_blue_change(value, duration, rel)
  Player:     $game_player.tone_gray_change(value, duration, rel)
  
  Event:      $game_map.events[id].tone_red_change(value, duration, rel)
  Event:      $game_map.events[id].tone_green_change(value, duration, rel)
  Event:      $game_map.events[id].tone_blue_change(value, duration, rel)
  Event:      $game_map.events[id].tone_gray_change(value, duration, rel)
  
  Vehicle:    $game_map.vehicle[id].tone_red_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].tone_green_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].tone_blue_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].tone_gray_change(value, duration, rel)
  * relative: Optional. Set to false by default.
  
└┬────────────────────────┬────────────────────────────────────────────────┘
  │ Setting Zoom in Frames │
  └────────────────────────┘
              Syntax (All)
  Player:     $game_player.zoom_change(zoom_x, zoom_y, duration, rel)
  Event:      $game_map.events[id].zoom_change(zoom_x, zoom_y, duration, rel)
  Vehicle:    $game_map.vehicle[id].zoom_change(zoom_x, zoom_y, duration, rel)
  * relative: Optional. Set to false by default.
  
              Syntax (Specific)
  Player:     $game_player.zoom_x_change(value, duration, rel)
  Player:     $game_player.zoom_y_change(value, duration, rel)
  
  Event:      $game_map.events[id].zoom_x_change(value, duration, rel)
  Event:      $game_map.events[id].zoom_y_change(value, duration, rel)
  
  Vehicle:    $game_map.vehicle[id].zoom_x_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].zoom_y_change(value, duration, rel)
  * relative: Optional. Set to false by default.

└┬────────────────────────┬────────────────────────────────────────────────┘
  │ Setting Wave in Frames │
  └────────────────────────┘
              Syntax (Wave Amplitude)
  Player:     $game_player.wave_amp_change(value, duration, rel)
  Event:      $game_map.events[id].wave_amp_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].wave_amp_change(value, duration, rel)
  
              Syntax (Wave Length)
  Player:     $game_player.wave_length_change(value, duration, rel)
  Event:      $game_map.events[id].wave_length_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].wave_length_change(value, duration, rel)
  
              Syntax (Wave Speed)
  Player:     $game_player.wave_speed_change(value, duration, rel)
  Event:      $game_map.events[id].wave_speed_change(value, duration, rel)
  Vehicle:    $game_map.vehicle[id].wave_speed_change(value, duration, rel)
  * relative: Optional. Set to false by default.
──────────────────────────────────────────────────────────────────────────────
■ FAQ
   o I am getting a FalseClass error whenever I apply Tone/Color. What do I do?
     Add "return true" (no quotes) into the script call.
  
=end

#==============================================================================
# ** Sprite_Character
#------------------------------------------------------------------------------
#  This sprite is used to display the character.It observes the Game_Character
#  class and automatically changes sprite conditions.
#==============================================================================

class Sprite_Character < Sprite_Base
  #---------------------------------------------------------------------------
  # * Alias Listings
  #---------------------------------------------------------------------------
  alias_method(:pk8_ncp_update, :update) unless method_defined?(:pk8_ncp_update)
  #--------------------------------------------------------------------------
  # * Frame Update
  #--------------------------------------------------------------------------
  def update
    pk8_ncp_update
    super
    self.tone = @character.tone
    self.angle = @character.angle
    self.zoom_x = @character.zoom_x / 100.0
    self.zoom_y = @character.zoom_y / 100.0
    self.mirror = @character.mirror
    self.color = @character.color
    self.wave_amp = @character.wave_amp
    self.wave_length = @character.wave_length
    self.wave_speed = @character.wave_speed
  end
end

#==============================================================================
# ** Game_Character
#------------------------------------------------------------------------------
#  This class deals with characters. It's used as a superclass for the
#  Game_Player and Game_Event classes.
#==============================================================================

class Game_Character
  #--------------------------------------------------------------------------
  # * Public Instance Variables
  #--------------------------------------------------------------------------
  attr_accessor :tone, :angle, :zoom_x, :zoom_y, :mirror, :color, :wave_amp,
                :wave_length, :wave_speed, :angle_target, :angle_duration,
                :tone_target, :tone_duration, :tone_red_target,
                :tone_red_duration, :tone_green_target, :tone_green_duration,
                :tone_blue_target, :tone_blue_duration, :tone_gray_target,
                :tone_gray_duration, :color_target, :color_duration,
                :color_red_target, :color_red_duration, :color_green_target,
                :color_green_duration, :color_blue_target, :color_blue_duration,
                :zoom_x_target, :zoom_x_duration, :zoom_y_target,
                :zoom_y_duration, :wave_amp_target, :wave_amp_duration,
                :wave_length_target, :wave_length_duration, :wave_speed_target,
                :wave_speed_duration
  #---------------------------------------------------------------------------
  # * Alias Listings
  #---------------------------------------------------------------------------
  unless method_defined?(:pk8_ncp_initialize)
    alias_method(:pk8_ncp_initialize, :initialize)
    alias_method(:pk8_ncp_update, :update)
  end
  #--------------------------------------------------------------------------
  # * Object Initialization
  #--------------------------------------------------------------------------
  def initialize
    pk8_ncp_initialize
    @tone = Tone.new(0, 0, 0, 0)
    @angle = 0
    @zoom_x, @zoom_y = 100.0, 100.0
    @mirror = false
    @color = Color.new(0, 0, 0, 0)
    @angle_target, @angle_duration             = 0, 0
    @tone_target, @tone_duration               = Tone.new(0,0,0,0), 0
    @tone_red_target, @tone_red_duration       = 0, 0
    @tone_green_target, @tone_green_duration   = 0, 0
    @tone_blue_target, @tone_blue_duration     = 0, 0
    @tone_gray_target, @tone_gray_duration     = 0, 0
    @color_target, @color_duration             = Color.new(0,0,0,0), 0
    @color_red_target, @color_red_duration     = 0, 0
    @color_green_target, @color_green_duration = 0, 0
    @color_blue_target, @color_blue_duration   = 0, 0
    @color_alpha_target, @color_alpha_duration = 0, 0
    @zoom_x_target, @zoom_x_duration           = 0, 0
    @zoom_y_target, @zoom_y_duration           = 0, 0
    @wave_amp_target, @wave_amp_duration       = 0, 0
    @wave_length_target, @wave_length_duration = 2, 0
    @wave_speed_target, @wave_speed_duration   = 0, 0
    @wave_amp, @wave_length, @wave_speed       = 0, 2, 0
  end
  #--------------------------------------------------------------------------
  # * Set Tone
  #--------------------------------------------------------------------------
  def tone=(value)
    value = Tone.new(*value) if value.is_a?(Array)
    @tone = value
  end
  #--------------------------------------------------------------------------
  # * Set Color
  #--------------------------------------------------------------------------
  def color=(value)
    value = Color.new(*value) if value.is_a?(Array)
    @color = value
  end
  #--------------------------------------------------------------------------
  # * Angle Change
  #     angle     : Picture angle
  #     duration  : Frame amount.
  #     relative  : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def angle_change(angle, duration, relative = false)
    @angle_target = (relative == true ? @angle + angle : angle)
    @angle_duration = duration
    @angle = @angle_target.clone if @angle_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Tone Change
  #     tone     : Target Tone. (Tone.new(red, green, blue[, gray))
  #     duration : Frame amount.
  #     relative : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def tone_change(tone, duration, relative = false)
    tone = Tone.new(*tone) if tone.is_a?(Array)
    if relative == true
      tone.red, tone.green = @tone.red + tone.red, @tone.green + tone.green
      tone.blue, tone.gray = @tone.blue + tone.blue, @tone.gray + tone.gray
    end
    @tone_target = tone.clone
    @tone_duration = duration
    @tone = @tone_target.clone if @tone_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Tone Red Change
  #     tone_red : Target Red Tone. (-255 - 255)
  #     duration : Frame amount.
  #     relative : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def tone_red_change(tone_red, duration, relative = false)
    @tone_red_target = (relative == true ? @tone.red + tone_red : tone_red)
    @tone_red_duration = duration
    @tone.red = @tone_red_target.clone if @tone_red_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Tone Green Change
  #     tone_green : Target Green Tone. (-255 - 255)
  #     duration   : Frame amount.
  #     relative   : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def tone_green_change(tone_green, duration, relative = false)
    @tone_green_target = (relative==true ? @tone.green+tone_green : tone_green)
    @tone_green_duration = duration
    @tone.green = @tone_green_target.clone if @tone_green_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Tone Blue Change
  #     tone_blue : Target Blue Tone. (-255 - 255)
  #     duration  : Frame amount.
  #     relative  : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def tone_blue_change(tone_blue, duration, relative = false)
    @tone_blue_target = (relative == true ? @tone.blue+tone_blue : tone_blue)
    @tone_blue_duration = duration
    @tone.blue = @tone_blue_target.clone if @tone_blue_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Tone Gray Change
  #     tone_blue : Target Gray Tone. (0 - 255)
  #     duration  : Frame amount.
  #     relative  : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def tone_gray_change(tone_gray, duration, relative = false)
    @tone_gray_target = (relative == true ? @tone.gray + tone_gray : tone_gray)
    @tone_gray_duration = duration
    @tone.gray = @tone_gray_target.clone if @tone_gray_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Color Change
  #     color     : Target Color. (Color.new(red, green, blue[, alpha))
  #     duration  : Frame amount.
  #     relative  : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def color_change(color, duration, relative = false)
    color = Color.new(*color) if color.is_a?(Array)
    if relative == true
      color.red, color.green = @color.red+color.red, @color.green+color.green
      color.blue, color.alpha = @color.blue+color.blue, @color.alpha+color.alpha
    end
    @color_target = color.clone
    @color_duration = duration
    @color = @color_target.clone if @color_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Color Red Change
  #     color_red : Target Red Color. (0 - 255)
  #     duration  : Frame amount.
  #     relative  : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def color_red_change(color_red, duration, relative = false)
    @color_red_target = (relative == true ? @color.red + color_red : color_red)
    @color_red_duration = duration
    @color.red = @color_red_target.clone if @color_red_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Color Green Change
  #     color_green : Target Green Color. (0 - 255)
  #     duration    : Frame amount.
  #     relative    : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def color_green_change(color_green, duration, relative = false)
    @color_green_target=(relative==true ?@color.green+color_green : color_green)
    @color_green_duration = duration
    @color.green = @color_green_target.clone if @color_green_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Color Blue Change
  #     color_blue : Target Blue Color. (0 - 255)
  #     duration   : Frame amount.
  #     relative   : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def color_blue_change(color_blue, duration, relative = false)
    @color_blue_target =(relative == true ? @color.blue+color_blue : color_blue)
    @color_blue_duration = duration
    @color.blue = @color_blue_target.clone if @color_blue_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Color Alpha Change
  #     color_alpha : Target Alpha. (0 - 255)
  #     duration    : Frame amount.
  #     relative    : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def color_alpha_change(color_alpha, duration, relative = false)
    @color_alpha_target=(relative==true ?@color.alpha+color_alpha : color_alpha)
    @color_alpha_duration = duration
    @color.alpha = @color_alpha_target.clone if @color_alpha_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Zoom Change
  #     zoom_x    : X-Axis Zoom Level
  #     zoom_y    : Y-Axis Zoom Level
  #     duration  : Frame amount.
  #     relative  : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def zoom_change(zoom_x, zoom_y, duration, relative = false)
    if relative == true
      @zoom_x_target, @zoom_y_target = @zoom_x + zoom_x, @zoom_y + zoom_y
    else
      @zoom_x_target, @zoom_y_target = zoom_x, zoom_y
    end
    @zoom_x_duration = duration
    @zoom_x = @zoom_x_target.clone if @zoom_x_duration == 0
    @zoom_y_duration = duration
    @zoom_y = @zoom_y_target.clone if @zoom_y_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Zoom_X Change
  #     zoom_x    : X-Axis Zoom Level
  #     duration  : Frame amount.
  #     relative  : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def zoom_x_change(zoom_x, duration, relative = false)
    @zoom_x_target = (relative == true ? @zoom_x + zoom_x : zoom_x)
    @zoom_x_duration = duration
    @zoom_x = @zoom_x_target.clone if @zoom_x_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Zoom_Y Change
  #     zoom_y    : Y-Axis Zoom Level
  #     duration  : Frame amount.
  #     relative  : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def zoom_y_change(zoom_y, duration, relative = false)
    @zoom_y_target = (relative == true ? @zoom_y + zoom_y : zoom_y)
    @zoom_y_duration = duration
    @zoom_y = @zoom_y_target.clone if @zoom_y_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Wave Amplitude Change
  #     wave_amp : Target Wave Amplitude. (0 > )
  #     duration : Frame amount.
  #     relative : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def wave_amp_change(wave_amp, duration, relative = false)
    @wave_amp_target = (relative == true ? @wave_amp + wave_amp : wave_amp)
    @wave_amp_duration = duration
    @wave_amp = @wave_amp_target.clone if @wave_amp_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Wave Length Change
  #     wave_length : Target Wave Length. (2 > )
  #     duration    : Frame amount.
  #     relative    : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def wave_length_change(wave_length, duration, relative = false)
    @wave_length_target=(relative==true ?@wave_length+wave_length : wave_length)
    @wave_length_target = 2 if @wave_length_target < 2
    @wave_length_duration = duration
    @wave_length = @wave_length_target.clone if @wave_length_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Wave Speed Change
  #     wave_speed : Target Wave Speed. (0 > )
  #     duration   : Frame amount.
  #     relative   : References current value and adds to it, if true.
  #--------------------------------------------------------------------------
  def wave_speed_change(wave_speed, duration, relative = false)
    @wave_speed_target = (relative==true ? @wave_speed+wave_speed : wave_speed)
    @wave_speed_duration = duration
    @wave_speed = @wave_speed_target.clone if @wave_speed_duration == 0
  end
  #--------------------------------------------------------------------------
  # * Frame Update
  #--------------------------------------------------------------------------
  def update
    pk8_ncp_update
    if @angle_duration >= 1         # Angle
      d = @angle_duration
      @angle = (@angle * (d - 1) + @angle_target) / d
      @angle_duration -= 1
    end
    if @color_duration >= 1         # Color
      d = @color_duration
      @color.red = (@color.red * (d - 1) + @color_target.red) / d
      @color.green = (@color.green * (d - 1) + @color_target.green) / d
      @color.blue = (@color.blue * (d - 1) + @color_target.blue) / d
      @color.alpha = (@color.alpha * (d - 1) + @color_target.alpha) / d
      @color_duration -= 1
    end
    if @color_red_duration >= 1    # Red color
      d = @color_red_duration
      @color.red = (@color.red * (d - 1) + @color_red_target) / d
      @color_red_duration -= 1
    end
    if @color_green_duration >= 1  # Green color
      d = @color_green_duration
      @color.green = (@color.green * (d - 1) + @color_green_target) / d
      @color_green_duration -= 1
    end
    if @color_blue_duration >= 1   # Blue color
      d = @color_blue_duration
      @color.blue = (@color.blue * (d - 1) + @color_blue_target) / d
      @color_blue_duration -= 1
    end
    if @color_alpha_duration >= 1  # Alpha
      d = @color_alpha_duration
      @color.alpha = (@color.alpha * (d - 1) + @color_alpha_target) / d
      @color_alpha_duration -= 1
    end
    if @tone_duration >= 1         # Tone
      d = @tone_duration
      @tone.red = (@tone.red * (d - 1) + @tone_target.red) / d
      @tone.green = (@tone.green * (d - 1) + @tone_target.green) / d
      @tone.blue = (@tone.blue * (d - 1) + @tone_target.blue) / d
      @tone.gray = (@tone.gray * (d - 1) + @tone_target.gray) / d
      @tone_duration -= 1
    end
    if @tone_red_duration >= 1     # Red Tone
      d = @tone_red_duration
      @tone.red = (@tone.red * (d - 1) + @tone_red_target) / d
      @tone_red_duration -= 1
    end
    if @tone_green_duration >= 1   # Green Tone
      d = @tone_green_duration
      @tone.green = (@tone.green * (d - 1) + @tone_green_target) / d
      @tone_green_duration -= 1
    end
    if @tone_blue_duration >= 1    # Blue Tone
      d = @tone_blue_duration
      @tone.blue = (@tone.blue * (d - 1) + @tone_blue_target) / d
      @tone_blue_duration -= 1
    end
    if @tone_gray_duration >= 1    # Gray Tone
      d = @tone_gray_duration
      @tone.gray = (@tone.gray * (d - 1) + @tone_gray_target) / d
      @tone_gray_duration -= 1
    end
    if @zoom_x_duration >= 1       # Zoom X
      d = @zoom_x_duration
      @zoom_x = (@zoom_x * (d - 1) + @zoom_x_target) / d
      @zoom_x_duration -= 1
    end
    if @zoom_y_duration >= 1       # Zoom Y
      d = @zoom_y_duration
      @zoom_y = (@zoom_y * (d - 1) + @zoom_y_target) / d
      @zoom_y_duration -= 1
    end
    if @wave_amp_duration >= 1     # Wave Amplitude
      d = @wave_amp_duration
      @wave_amp = (@wave_amp * (d - 1) + @wave_amp_target) / d
      @wave_amp_duration -= 1
    end
    if @wave_length_duration >= 1  # Wave Length
      d = @wave_length_duration
      @wave_length = (@wave_length * (d - 1) + @wave_length_target) / d
      @wave_length_duration -= 1
    end
    if @wave_speed_duration >= 1   # Wave Speed
      d = @wave_speed_duration
      @wave_speed = (@wave_speed * (d - 1) + @wave_speed_target) / d
      @wave_speed_duration -= 1
    end
  end
end

#==============================================================================
# ** Game_Event
#------------------------------------------------------------------------------
#  This class deals with events. It handles functions including event page
#  switching via condition determinants, and running parallel process events.
#  It's used within the Game_Map class.
#==============================================================================

class Game_Event < Game_Character
  #---------------------------------------------------------------------------
  # * Alias Listings
  #---------------------------------------------------------------------------
  alias_method(:pk8_ncp_refresh, :refresh) if !method_defined?(:pk8_ncp_refresh)
  #--------------------------------------------------------------------------
  # * Refresh
  #--------------------------------------------------------------------------
  def refresh
    pk8_ncp_refresh
    event_angle_commands(@page) if @page != nil
    event_color_commands(@page) if @page != nil
    event_color_red_commands(@page) if @page != nil
    event_color_green_commands(@page) if @page != nil
    event_color_blue_commands(@page) if @page != nil
    event_color_alpha_commands(@page) if @page != nil
    event_mirror_commands(@page) if @page != nil
    event_tone_commands(@page) if @page != nil
    event_tone_red_commands(@page) if @page != nil
    event_tone_green_commands(@page) if @page != nil
    event_tone_blue_commands(@page) if @page != nil
    event_tone_gray_commands(@page) if @page != nil
    event_zoom_commands(@page) if @page != nil
    event_zoom_x_commands(@page) if @page != nil
    event_zoom_y_commands(@page) if @page != nil
    event_wave_amp_commands(@page) if @page != nil
    event_wave_length_commands(@page) if @page != nil
    event_wave_speed_commands(@page) if @page != nil
  end
  #--------------------------------------------------------------------------
  # * Event Tone
  #--------------------------------------------------------------------------
  def event_tone_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,5].to_s.downcase.include?("$tone"
        ) and !c.parameters[0][0,9].to_s.downcase.include?("$tone_red") and
        !c.parameters[0][0,11].to_s.downcase.include?("$tone_green") and
        !c.parameters[0][0,10].to_s.downcase.include?("$tone_blue") and
        !c.parameters[0][0,10].to_s.downcase.include?("$tone_gray"))
        c_substrings = c.parameters[0].split(' ')
        red = c_substrings[1].to_i
        green = c_substrings[2].to_i
        blue = c_substrings[3].to_i
        gray = c_substrings[4].to_i
        @tone = Tone.new(red, green, blue, gray)
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Tone: Red
  #--------------------------------------------------------------------------
  def event_tone_red_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,9].to_s.downcase.include?(
        "$tone_red"))
        c_substrings = c.parameters[0].split(' ')
        @tone.red = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Tone: Green
  #--------------------------------------------------------------------------
  def event_tone_green_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,11].to_s.downcase.include?(
        "$tone_green"))
        c_substrings = c.parameters[0].split(' ')
        @tone.green = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Tone: Blue
  #--------------------------------------------------------------------------
  def event_tone_blue_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,10].to_s.downcase.include?(
        "$tone_blue"))
        c_substrings = c.parameters[0].split(' ')
        @tone.blue = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Tone: Gray
  #--------------------------------------------------------------------------
  def event_tone_gray_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,10].to_s.downcase.include?(
        "$tone_gray"))
        c_substrings = c.parameters[0].split(' ')
        @tone.gray = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Color
  #--------------------------------------------------------------------------
  def event_color_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,6].to_s.downcase.include?(
        "$color") and !c.parameters[0][0,10].to_s.downcase.include?("$color_red"
        ) and !c.parameters[0][0,12].to_s..downcase.include?("$color_green") and
        !c.parameters[0][0,11].to_s.downcase.include?("$color_blue") and
        !c.parameters[0][0,12].to_s.downcase.include?("$color_alpha"))
        c_substrings = c.parameters[0].split(' ')
        red, green = c_substrings[1].to_i, c_substrings[2].to_i
        blue, alpha = c_substrings[3].to_i, c_substrings[4].to_i
        @color = Color.new(red, green, blue, alpha)
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Color: Red
  #--------------------------------------------------------------------------
  def event_color_red_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,10].to_s.downcase.include?(
        "$color_red"))
        c_substrings = c.parameters[0].split(' ')
        @color.red = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Color: Green
  #--------------------------------------------------------------------------
  def event_color_green_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,12].to_s.downcase.include?(
        "$color_green"))
        c_substrings = c.parameters[0].split(' ')
        @color.green = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Color: Blue
  #--------------------------------------------------------------------------
  def event_color_blue_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,11].to_s.downcase.include?(
        "$color_blue"))
        c_substrings = c.parameters[0].split(' ')
        @color.blue = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Color: Alpha
  #--------------------------------------------------------------------------
  def event_color_alpha_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,12].to_s.downcase.include?(
        "$color_alpha"))
        c_substrings = c.parameters[0].split(' ')
        @color.alpha = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Zoom
  #--------------------------------------------------------------------------
  def event_zoom_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,5].to_s.downcase.include?(
        "$zoom") and !c.parameters[0][0,7].to_s.downcase.include?("$zoom_x") and
        !c.parameters[0][0,7].to_s.downcase.include?("$zoom_y"))
        c_substrings = c.parameters[0].split(' ')
        @zoom_x, @zoom_y = c_substrings[1].to_i, c_substrings[2].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Zoom: X
  #--------------------------------------------------------------------------
  def event_zoom_x_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,7].to_s.downcase.include?(
        "$zoom_x"))
        c_substrings = c.parameters[0].split(' ')
        @zoom_x = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Zoom: Y
  #--------------------------------------------------------------------------
  def event_zoom_y_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,7].to_s.downcase.include?(
        "$zoom_y"))
        c_substrings = c.parameters[0].split(' ')
        @zoom_y = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Angle
  #--------------------------------------------------------------------------
  def event_angle_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,6].to_s.downcase.include?(
        "$angle"))
        c_substrings = c.parameters[0].split(' ')
        @angle = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Mirror
  #--------------------------------------------------------------------------
  def event_mirror_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,7].to_s.downcase.include?(
        "$mirror"))
        c_substrings = c.parameters[0].split(' ')
        if c_substrings[1].to_s.downcase.empty?; @mirror = true
        else; @mirror = (c_substrings[1].to_s.downcase == "true" ? true : false)
        end
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Wave Amplitude
  #--------------------------------------------------------------------------
  def event_wave_amp_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,9].to_s.downcase.include?(
        "$wave_amp"))
        c_substrings = c.parameters[0].split(' ')
        @wave_amp = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Wave Length
  #--------------------------------------------------------------------------
  def event_wave_length_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,12].to_s.downcase.include?(
        "$wave_length"))
        c_substrings = c.parameters[0].split(' ')
        @wave_length = 2 if c_substrings[1].to_i < 2
        @wave_length = c_substrings[1].to_i
      end
    end
  end
  #--------------------------------------------------------------------------
  # * Event Wave Speed
  #--------------------------------------------------------------------------
  def event_wave_speed_commands(page)
    l = page.list
    for i in 0..l.length - 2
      c = l[i]
      if (c.code == 108 and c.parameters[0][0,11].to_s.downcase.include?(
        "$wave_speed"))
        c_substrings = c.parameters[0].split(' ')
        @wave_speed = c_substrings[1].to_i
      end
    end
  end
end

Author's Notes
I wanted to work on letting game creators animate character sprites a little more through script calls. I noticed certain properties such as angle, color, mirror, tone, and angle were missing so I wanted to add them in.

Thanks
Charlie Fleed for showing me how to script special comments a few years ago.
Prof. Meow Meow making fantastic use of it in a demo he showed me a few years ago.

License / Terms
Free for non-commercial and commercial purposes. Just credit me.

[PK8]

Indeed. :D

Also, yo! This script's been updated to version 1.2 as of today! This update particularly caters towards those who didn't like how the sprite's zoom level value 1.0 signifies actual pixel size. So I decided to do something about it and made 100.0 signify actual pixel size. I've also added a customization option for anyone who does not like the change.

[PK8]

Event Tone, Color, Size, Angle and Mirror

Introduction
The following five scripts I'm submitting allows the user to alter an event sprite's size, angle, tone, color and have it flip horizontally. These scripts will require the Character Sprite Add-ons script in order for them to work.

Features

• Change tone of event sprite. (Event Tone)
  
• Give it a color. (Event Color)
  
• Change the size of the event sprite. (Event Size)
  
• Change the angle of the event's sprite. (Event Angle)
  
• Flip event sprite horizontally. (Event Mirror)
  

Screenshots

Script
Event Angle
Event Color
Event Mirror
Event Size
Event Tone

Instructions
These scripts require the Character Sprite Add-ons script in order for them to work.

FAQ

How to change the angle of an event sprite

Go to a map event, select the Comment event command and type this:
$angle value

How to set the color of an event sprite

Go to a map event, select the Comment event command and type this:
$color red(0 - 255) green(0 - 255) blue(0 - 255) alpha(0 - 255)(optional)(default: 255)

How to flip the event sprite horizontally.

Go to a map event, select the Comment event command and type this:
$mirror

How to change the size of an event sprite.

Go to a map event, select the Comment event command and type this:
$size x-scale y-scale

Note that 1.0 denotes actual size of the sprite.
Example: $size 0.5 0.5 - Half the size of the normal sprite.

How to set the tone of an event sprite.

Go to a map event, select the Comment event command and type this:
$color red(-255 - 255) green(-255 - 255) blue(-255 - 255) saturation(0 - 255)(optional)(default: 0)

Compatibility
Methods aliased:

• Game_Event < Game_Character
  • refresh
    

Credits and Thanks
Charlie Lee: For teaching me how.
MGCaladtogel: I did a bit of code ripping from his NeoMode7 script.

Author's Notes
Boredom makes me do this.

Terms and Conditions
Credit me, I s'pose. :P

[This was a post of a script that used to be an add-on.]

[PK8]

Heya, sorry for the bump but since this topic is already over 600 views and counting, I'm assuming somebody must have installed this by now.

It's been given the upgrade to 1.1 and now the developer can change the tone, angle, color and size of a character's (player or event) sprite with script calls.

[DerVVulfman]

Waitaminute. :mellow:

The whole actual 'WORKING' code of this script is 30 lines? That's it? :o

BTW: Nice to see that more people like us are adding all those detailed instructions into the scripts. B)

[PK8]

Character Sprite Addons VX
Version: 1.2

Introduction
Adds on additional properties from the Sprite class to character sprites which weren't included before such as Angle, Tone, Color, Mirror, Zoom_X and Zoom_Y. As of version 1.1, it also allows devs to change certain properties of character sprites.

Features

• Gives character sprites additional properties from the Sprite class such as angle, tone, color, mirror, zoom_x and zoom_y.
  
• Change the color, tone, angle and size of character sprites with script calls.
  
• 1 customization option. (See Customization section in text file.)
  

Script

Character Sprite Add-ons VX

Code:

=begin
????????????????????????????????????????????????????????????????????????????????
? Character Sprite Addons                                                      ?
? Version 1.2 by PK8                                                           ?
????????????????????????????????????????????????????????????????????????????????
????????????????????????????????????????????????????????????????????????????????
? ? Description:                                                               ?
? ?? Adds on additional properties to character sprites which weren't included ?
?    before such as Angle, Tone, Color, Mirror, Zoom_X and Zoom_Y.             ?
????????????????????????????????????????????????????????????????????????????????
? ? Features:                                                                  ?
? ?? Gives character sprites additional properties from the Sprite class such  ?
? ?  as angle, tone, color, mirror, zoom_x and zoom_y.                         ?
? ?? Change the angle, size, color, tone of a character sprite as well as      ?
?    flipping it horizontally with script calls. (New to Version 1.1)          ?
????????????????????????????????????????????????????????????????????????????????
? ? Customization                                                              ?
? ?? For those who don't like how in the zoom functions, the value 1.0         ?
?    signifies "actual pixel size", I've changed it a bit to make the value    ?
?    100.0 signify actual pixel size. For those who may not like the update,   ?
?    you can disable this by jumping to the third line after this long box     ?
?    and set CharacterSpriteZoom100 to false.                                  ?
????????????????????????????????????????????????????????????????????????????????
? ? Usage:                                                                     ?
? ? ? Tones.                                                                   ?
? ?? How do I change the tone of the player's sprite?                          ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace red green blue saturation with values):          ?
? ?        $game_player.tone = Tone.new(red, green, blue(, sat))                  ?
? ?        return true                                                         ?
? ?? How do I change the tone of an event's sprite?                            ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace id with an event id):                            ?
? ?        $game_map.events[id].tone = Tone.new(red, green, blue(, sat))       ?
? ?        return true                                                         ?
? ?? Example usage? I may still be confused.                                   ?
? ?     $game_player.tone = Tone.new(100, 100, 100, 255);return true           ?
? ?     $game_player.tone = Tone.new(-64, 0, -64, 0);return true               ?
? ?     $game_player.tone = Tone.new(-64, 0, -64);return true                  ?
? ?                                                                            ?
? ? ? Angles.                                                                  ?
? ?? How do I change the angle of the player's sprite?                         ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace angle with a value):                             ?
? ?        $game_player.angle = value                                          ?
? ?? How do I change the angle of an event's sprite?                           ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace angle with a value, id with an event id):        ?
? ?        $game_map.events[id].angle = value                                  ?
? ?                                                                            ?
? ? ? Colors.                                                                  ?
? ?? How do I change the color of the player's sprite?                         ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace red green blue alpha with values):               ?
? ?        $game_player.color = Color.new(red, green, blue(, alpha))           ?
? ?        return true                                                         ?
? ?? How do I change the angle of an event's sprite?                           ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace id with an event id):                            ?
? ?        $game_map.events[id].color = Color.new(red, green, blue(, alpha))   ?
? ?        return true                                                         ?
? ?? Example usage? I may still be confused.                                   ?
? ?     $game_player.color = Color.new(100, 100, 100, 100);return true         ?
? ?     $game_player.color = Color.new(200, 0, 200, 255);return true           ?
? ?     $game_player.color = Color.new(200, 0, 200);return true                ?
? ?                                                                            ?
? ? ? zoom_x and zoom_y.                                                       ?
? ?? How do I change the sprite's x-axis zoom level?                           ?
? ?     For players: $game_player.zoom_x = value                               ?
? ?     For events: $game_map.events[id].zoom_x = value                        ?
? ?? How do I change the sprite's y-axis zoom level?                           ?
? ?     For players: $game_player.zoom_y = value                               ?
? ?     For events: $game_map.events[id].zoom_y = value                        ?
? ?                                                                            ?
? ? ? Mirror.                                                                  ?
? ?? How do I flip character sprites horizontally?                             ?
? ?     For players: $game_player.mirror = true                                ?
? ?     For events: $game_map.events[id].mirror = true                         ?
? ?? Okay, how do I unflip them?                                               ?
?       For players: $game_player.mirror = false                               ?
?       For events: $game_map.events[id].mirror = false                        ?
????????????????????????????????????????????????????????????????????????????????
? ? Methods Aliased:                                                           ?
? ?? update - Sprite_Character < Sprite_Base                                   ?
? ?? initialize - Game_Character                                               ?
????????????????????????????????????????????????????????????????????????????????
? ? Changelog:                                                                 ?
? ?? Version 1.1 (5/10/09) - Replaced attr_reader with attr_accessor.          ?
? ?? Version 1.2 (5/12/09) - Updated the zoom stuff. (More info below)         ?
????????????????????????????????????????????????????????????????????????????????
? ? About Version 1.2 change:                                                  ?
?   Originally, the value '1.0' for properties zoom_x and zoom_y stood for     ?
?   the character sprite's actual size. I felt like trying to explain that in  ?
?   the instructions of this script and add-ons made to it would just confuse  ?
?   some people. So I wanted to make the value 100.0 denote the actual pixel   ?
?   size of the sprite.                                                        ?
????????????????????????????????????????????????????????????????????????????????
=end

#???????????????????????????????????????????????????????????????????????????????
#? ? Customize                                                                 ?
#???????????????????????????????????????????????????????????????????????????????
class PK8
  CharacterSpriteZoom100 = true
  # If false, sprite's zoom level value 1.0 would denote actual pixel size.
  # If true, sprite's zoom level value 100.0 would denote actual pixel size.
end

#==============================================================================
# ** Sprite_Character
#------------------------------------------------------------------------------
#  This sprite is used to display characters. It observes a instance of the
# Game_Character class and automatically changes sprite conditions.
#==============================================================================
class Sprite_Character < Sprite_Base
  alias pk8_character_sprite_addons_update :update

  #--------------------------------------------------------------------------
  # * Frame Update
  #--------------------------------------------------------------------------
  def update
    pk8_character_sprite_addons_update
    self.tone = @character.tone
    self.angle = @character.angle
    if PK8::CharacterSpriteZoom100 == true
      self.zoom_x = @character.zoom_x / 100.0
      self.zoom_y = @character.zoom_y / 100.0
    elsif PK8::CharacterSpriteZoom100 == false
      self.zoom_x = @character.zoom_x
      self.zoom_y = @character.zoom_y
    end
    self.mirror = @character.mirror
    self.color = @character.color
  end
end

#==============================================================================
# ** Game_Character
#------------------------------------------------------------------------------
#  This class deals with characters. It's used as a superclass of the
# Game_Player and Game_Event classes.
#==============================================================================
class Game_Character
  #--------------------------------------------------------------------------
  # * Public Instance Variables
  #--------------------------------------------------------------------------
  attr_accessor :tone
  attr_accessor :angle
  attr_accessor :zoom_x
  attr_accessor :zoom_y
  attr_accessor :mirror
  attr_accessor :color
  
  alias pk8_character_sprite_addons_initialize :initialize
  #--------------------------------------------------------------------------
  # * Frame Update
  #--------------------------------------------------------------------------
  def initialize
    pk8_character_sprite_addons_initialize
    @tone = Tone.new(0, 0, 0, 0)
    @angle = 0
    if PK8::CharacterSpriteZoom100 == true
      @zoom_x = 100.0
      @zoom_y = 100.0
    elsif PK8::CharacterSpriteZoom100 == false
      @zoom_x = 1.0
      @zoom_y = 1.0
    end
    @mirror = false
    @color = Color.new(0, 0, 0, 0)
  end
end

Instructions
Copy-paste! Also, look for any add-on topics which may link to this as a requirement for use.

FAQ

Changing the tone of a character sprite

Player:

• Use Call script event command.
  
• Type this (replace red green blue saturation with values):
  $game_player.tone = Tone.new(red, green, blue(, sat))
  return true
  

Events:

• Use Call script event command.
  
• Type this (replace id with an event id):
  $game_map.events[id].tone = Tone.new(red, green, blue(, sat))
  return true
  

Example usage of changing character sprite tone?

• $game_player.tone = Tone.new(100, 100, 100, 255)
  return true
  
• $game_player.tone = Tone.new(-64, 0, 64, 0)
  return true
  
• $game_player.tone = Tone.new(-64, 0, 64)
  return true
  

Changing the color of a character sprite.

Player:

• Use Call script event command.
  
• Type this (replace red green blue alpha with values):
  $game_player.color = Color.new(red, green, blue(, alpha))
  return true
  

Events:

• Use Call script event command.
  
• Type this (replace id with an event id):
  $game_map.events[id].color = Color.new(red, green, blue(, alpha))
  return true
  

Example usage of changing character sprite color?

• $game_player.color = Color.new(100, 100, 100, 100)
  return true
  
• $game_player.color = Color.new(200, 0, 200, 255)
  return true
  
• $game_player.color = Color.new(200, 0, 200)
  return true
  

Changing the angle of a character sprite

Players:
$game_player.angle = value

Events:
$game_map.events[id].angle = value

Changing the x-axis and y-axis zoom level of a character sprite

Player:
$game_player.zoom_x = value
$game_player.zoom_y = value

Events:
$game_map.events[id].zoom_x = value
$game_map.events[id].zoom_y = value

Flipping character sprite horizontally

Players:
$game_player.mirror = boolean

Events
$game_map.events[id].mirror = boolean
* boolean meaning either true or false.

Compatibility
This aliases the following methods from the following classes.

• Sprite_Character < Sprite_Base
  • update
    
• Game_Character
  • initialize
    

Author's Notes
I want scripters to add on to it. :3

Terms and Conditions
It's not necessary to credit me for this.

------------------------------

Add-ons
Event Tone, Angle, Color, Mirror and Size comment commands.

[old vx version of the script was here]

[Alpha-Mad]

Hey hey! Not bad! I may incorporate this (at least the size and mirror ones). This would be great for monsters that grow in size before attacking and such.

[Rylius]

I like this, tho I dont have any uses for it atm. =/
Antialiasing would be f'king awesome, but as far as I know it's slow as hell in RGSS. And I dont have a clue how to do it. o.o
But who knows, maybe something for next version? ~.^

[PK8]

This script has gotten a major update!

v2: Both the Event Angle/Color/Mirror/Tone/Zoom/Wave and the Change Character Properties in frames script were combined into one script. New script calls were thrown in too.

v2.1: Added the optional truth value relative argument for all methods. Useful if you want to add ontosubtract from a character property.

[PK8]

I just updated the script to v2.1.1

This update improves the documentation, reduces the code by about a hundred lines, and provides some improvements to the documentation. If you're using the VX version, it's imperative that you update it. There was a game-breaking bug in there.

Edit: Just updated the script to v2.2
Now users can use arrays for setting tone/colors or changing them in frames.
To VX users: If you're still using v2.1, please update it.