Animated Sideview Enemies (YEP)

From Yanfly.moe Wiki
Jump to navigation Jump to search


System

This is a plugin created for RPG Maker MV.

For help on how to install plugins, click here.

For help on how to update plugins, click here.

Got errors with your RPG Maker MV plugin? Click here.

Download

Required Plugins

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

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

Yanfly Engine Plugins

This plugin is a part of the Yanfly Engine Plugins library.

Click here if you want to help support Team Yanfly on Patreon.

Introduction

This plugin requires YEP_BattleEngineCore.
Make sure this plugin is located under YEP_BattleEngineCore in the
plugin list.

This extension plugin allows you to animate enemies in a number of ways,
from giving static enemies breathing, floating, and scaled attributes to
utilizing animated sideview actors as potential battlers for your enemies
instead of static graphics to help make your enemies appear more lively!

If you are using YEP_X_ActSeqPack2, and would like the ability to add in
floating enemies, place this plugin under YEP_X_ActSeqPack2 as well.

To use this plugin, insert within the enemy's notebox the notetags you see
in the section below:

Notetags

NotetagsMV.png

RPG Maker MV's editor is unable to allow for custom traits/properties that a game dev may wish to associate with a database object, event, map, etc. Notetags are used to work around such limitations by allowing the game dev to tag certain traits/properties using specific Notetags declared by the related plugin.

Here is a list of Notetag(s) that you may use.

Insert these notetags into the enemy noteboxes below to change their
sidewview battler aspects.

Enemy Notetags:

  --- General ---

  <Breathing>
  <No Breathing>
  Enables or disables a 'breathing' effect for the enemy sprite.

  <Breathing Speed: x>
  How many frames does it take to make a full breathing cycle? The lower the
  x value, the faster the enemy breathes. The higher the x value, the slower
  the enemy breathes.

  <Breathing Rate X: x.y>
  <Breathing Rate Y: x.y>
  Sets the horizontal and vertical breathing rate to x.y. 1.0 is a 100%
  variance change while 0.0 is a 0% variance.

  <Enable HP Link Breathing>
  <Disable HP Link Breathing>
  Will enable/disable HP Link Breathing. The lower the HP on the enemy, the
  slower the enemy will breathe.

  <Floating>
  Sets the enemy to be animated as if it was floating.

  <Floating Speed: x>
  How many frames does it take to do a full floating cycle? The lower the x
  value, the faster the enemy floats. The higher the x value, the slower the
  enemy floats.

  <Floating Rate: x.y>
  Sets the floating rate for the enemy to x.y. 1.0 is a 100% variance change
  while 0.0 is a 0% variance change.

  <Floating Height: x>
  Sets the minimum float height for the enemy to x.

  <Floating Death>
  <No Floating Death>
  Decide whether or not this particular enemy will float while dead or
  instead, drop to the ground instantly and will bypass the 'Floating Death'
  plugin parameter for the particular enemy.

  <Scale Sprite: x%>
  This allows you to scale the sprite larger or smaller by x% of the
  original sprite size. If you wish to only scale either the width or the
  height, use the notetags below:

  <Scale Sprite Width: x%>
  <Scale Sprite Height: x%>
  This will scale the sprite's width or height by x% amount specifically
  rather than the whole sprite itself by the same ratio.

  --- Sideview ---

  <Sideview Battler: filename>
  This is the filename used for the sideview battler found within your
  project's img/sv_actors/ folder. Doing this will enable the following
  notetags to be applied to the battler. This is case-sensitive and used
  without the image's file extension.

  *Example: SF_Actor3_8.png would be <Sideview Battler: SF_Actor3_8>

  *Note: If more than one of these tags is used, the sideview battler
  selected will be picked from a random pool. Their settings, however, will
  match all of the other sideview settings set in the notetags for the sake
  of simplicity.

  --- Sideview Specific ---

  <Sideview Anchor X: y.z>
  <Sideview Anchor Y: y.z>
  This sets the anchor location for the enemy's sideview battler at y.z.
  This is used for the event you have an odd-proportioned sideview battler.

  <Sideview Width: x>
  <Sideview Height: x>
  Sets the width/height of the sideview battler. This is for the event
  you're using a battler image that may have different proportions than
  normal sideview battlers.

  <Sideview Collapse>
  Sets it so that the enemy when it dies will collapse and vanish.

  <Sideview No Collapse>
  Sets it so that the enemy when it dies will leave behind a corpse and
  will not vanish.

  <Sideview Frame Speed: x>
  Sets the frame speed of this sideview battler to x. The lower the x value,
  the faster the sideview battler animates. The higher it is, the slower the
  battler animates.

  --- State Overlays ---

  <Sideview Show State Overlay>
  <Sideview Hide State Overlay>
  This will either show or hide the state overlay for the sideview enemy and
  ignore the default setting within the plugin parameters.

  --- Motions ---

  <Sideview Attack Motion: swing>
  <Sideview Attack Motion: thrust>
  <Sideview Attack Motion: missile>
  Sets the basic attack motion for your sideview enemy if the sideview
  enemy is not using any weapons. You can use any of the following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  <Sideview Weapon: x>
  This sets the sprite's weapon image to x. If you haven't modified your
  system images of the weapons, they would be as follows:

  0 - Nothing
  1 - Dagger   7 - Long Bow  13 - Mace       19 - Slingshot  25 - Book
  2 - Sword    8 - Crossbow  14 - Rod        20 - Shotgun    26 - Custom
  3 - Flail    9 - Gun       15 - Club       21 - Rifle      27 - Custom
  4 - Axe     10 - Claw      16 - Chain      22 - Chainsaw   28 - Custom
  5 - Whip    11 - Glove     17 - Sword#2    23 - Railgun    29 - Custom
  6 - Staff   12 - Spear     18 - Iron Pipe  24 - Stun Rod   30 - Custom

  * Note: Inserting multiple of these notetags will put them inside a random
  pool of weapons to use. Keep in mind if you use this notetag, it will use
  all the default settings found in the plugin's parameters. If you wish to
  use more unique settings, use the notetag below:

  <Sideview Weapon: x, y, z>
  This sets the sprite's weapon image to x, motion to y, and attack
  animation to z. An example of how this notetag would be used would be
  as such:

     <Sideview Weapon: 2, swing, 6>

  This will give the battler a sword with the swing motion and playing
  battle animation 6 when attacking.

  <Sideview Idle Motion: x>
  Sets the idling motion for your sideview enemy. You can use any of the
  following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead
  * Note: Inserting multiple of these notetags will put them inside a random
  pool of motions to use.

  <Sideview Damage Motion: x>
  Sets the damaged motion for your sideview enemy. You can use any of the
  following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  <Sideview Evade Motion: x>
  Sets the evasion motion for your sideview enemy. You can use any of the
  following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  <Sideview Escape Motion: x>
  Sets the escaping motion for your sideview enemy. You can use any of the
  following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  <Sideview Guard Motion: x>
  Sets the guard motion for your sideview enemy. You can use any of the
  following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  <Sideview Abnormal Motion: x>
  Sets the abnormal motion for your sideview enemy. You can use any of the
  following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  <Sideview Sleep Motion: x>
  Sets the sleep motion for your sideview enemy. You can use any of the
  following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  <Sideview Dying Motion: x>
  Sets the dying (crisis) motion for your sideview enemy. You can use any
  of the following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  <Sideview Dead Motion: x>
  Sets the dead motion for your sideview enemy. You can use any of the
  following motions:
  walk     wait     chant     guard     damage     evade
  thrust   swing    missile   skill     spell      item
  escape   victory  dying     abnormal  sleep      dead

  --- Shadows ---

  <Sideview Show Shadow>
  Sets it so the enemy will show its shadow for its sideview sprite. The
  default setting of this is tied to Battle Engine Core's 'Show Shadows'.

  <Sideview Hide Shadow>
  Sets it so the enemy will hide its shadow for its sideview sprite. The
  default setting of this is tied to Battle Engine Core's 'Show Shadows'.

  <Sideview Shadow Width: x%>
  Sets the shadow width to x% larger/smaller than the default shadow size
  found within the img/system folder.

  <Sideview Shadow Height: x%>
  Sets the shadow height to x% larger/smaller than the default shadow size
  found within the img/system folder.

State Notetags:

  <Hide Sideview Weapon>
  This will cause the animated sideview enemy battler to hide its sideview
  weapon effect. The attack motion will revert back to the barehanded attack
  motion set for the enemy and the attack animation will be the enemy's
  default attack animation.

Changelog

Version 1.20:
- Bugfix provided by YoraeRasante regarding the animation positioning on
animated sideview enemies.

Version 1.19:
- Bugfix provided by SwiftIllusion regarding the animation positioning on
animated sideview enemies.

Version 1.18:
- Updated for RPG Maker MV version 1.5.0.

Verison 1.17:
- Visual graphic update to sync attack animations properly with how actor
animations are now handled in the more updated RPG Maker MV versions.

Version 1.16:
- Added 'Floating Death' plugin parameter.
- Optimization update.

Version 1.15:
- Updated for RPG Maker MV version 1.3.2.

Version 1.14:
- Pixi4 update to fix bug that caused state icons to fly off the screen.
- Fixed a compatibility issue with YEP_X_VisualStateFX regarding state
sprites being disabled and causing crashes.

Version 1.13:
- Compatibility update with YEP_X_VisualStateFX to disable State Overlays on
enemies properly.

Version 1.12:
- Fixed a bug that caused the <Sideview Show State Overlay> and
<Sideview Hide State Overlay> notetags to not work.
- Fixed a bug that caused scaled enemies to have their state icons and
overlays appear in odd places.

Version 1.11:
- Fixed a bug that caused hidden enemies to appear early on.

Version 1.10:
- Optimized plugin to use less resources. Animated enemies will no longer
have a static graphic once the game is loaded.

Version 1.09:
- Added a fix for state icons appearing behind battlers for the users who
aren't using the Action Sequence Packs.

Version 1.08:
- State Icon and State Overlays will now synch together for floating and
jumping battlers.

Version 1.07:
- Updated for RPG Maker MV version 1.1.0.

Version 1.06a:
- Fixed a bug that prevented animated sideview enemies from not mirroring.
- Added <Sideview Show State Overlay> and <Sideview Hide State Overlay>
notetags to make certain enemies show/hide state overlays.
- Fixed a bug that was caused by motion notetags not retrieved properly.

Version 1.05:
- Made adjustments to the <Sprite Height: x> notetag to also affect the
location of the state icons and effects.

Version 1.04:
- Fixed a bug with Sprite Smoothing disabled on Shadows.
- Fixed a bug with the anchor Y positions being overwritten.

Version 1.03:
- Fixed a bug that would cause <Sideview Width: x> & <Sideview Height: x>
notetags to crash the game.

Version 1.02:
- Synchronized state icons and overlays with floating enemies.

Version 1.01:
- Added 'HP Link Breathing' plugin parameter. If enabled, the lower the HP,
the slower the enemy breathes.
- Added <Enable HP Link Breathing> and <Disable HP Link Breathing> notetags.

Version 1.00:
- Finished plugin! Hooray!