Welcome to PGMZ! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.
Actor Pictures - ActorPictures.js
Plugin desc : Manages actor pictures.
License : MIT License
Author : nz_prism
Website : https://github.com/nz-prism/RPG-Maker-MZ/blob/master/ActorPictures/js/plugins/ActorPictures.js
Desc page : https://github.com/nz-prism/RPG-Maker-MZ/blob/master/ActorPictures/js/plugins/ActorPictures.js
Download Page : https://raw.githubusercontent.com/nz-prism/RPG-Maker-MZ/master/ActorPictures/js/plugins/ActorPictures.js
File name : ActorPictures.js
Help of plugin :
* @target MZ * @plugindesc Manages actor pictures. * @author nz_prism * @url https://github.com/nz-prism/RPG-Maker-MZ/blob/master/ActorPictures/js/plugins/ActorPictures.js * * @help ActorPictures.js * ver 1.3.4 * * [History] * 06/20/2021 1.0.0 Released * 06/23/2021 1.1.0 Fixed the State Picture priority and preloading * functionality * 07/01/2021 1.1.1 Added arguments for drawActorPicture function * 07/02/2021 1.2.0 Added a plugin parameter which calibrates picture positions * 07/05/2021 1.3.0 Added animation settings for pictures * 07/06/2021 1.3.1 Supported sub-folder improvement of RMMZ 1.3.2 * 07/10/2021 1.3.2 Added some functions for PictureMessage.js * 02/14/2022 1.3.3 Changed the default value for auto preload to true * 03/19/2022 1.3.4 Fixed an issue Picture Animation Settings didn’t reflect * the default parameters * * This plugin manages pictures for actors. * You can set normal， stated and damaged pictures for each actor. * Stated pictures are shown when an actor is affected by a specific state. * Damaged pictures are shown when the HP percentage of an actor is at a * specific rate or less. * Normal pictures are shown if none of the stated/damaged pictures can be * applied. * The priority is Stated > Damaged > Normal. * * You can set multiple pictures for each of normal， stated and damaged * pictures in order to use as costumes or facial expressions. * By setting Picture Index with a plugin command ”Set Picture Index”， a * corresponding picture out of the pictures is shown. * Picture Index is used in common with Normal， Stated and Damaged pictures. * * Some pictures don’t locate their face at the horizontal center or locate * them lower because of upper accessories， such as hats. If those are * misaligned， use a plugin parameter ”Picture Calibrations” to calibrate the * alignment for each picture. * * Actor pictures are sometimes not shown for the first time they are * displayed. In that case， preloading them may solve the issue. * There are 2 ways to preload pictures; automatic method using a plugin * parameter and manual method using a plugin command. * If an plugin parameter ”Preload All Pictures Automatically at Every Scene” * is set true， all the actor pictures will be preloaded automatically at the * start of every scene. * If there are so many pictures that the performance gets low， set it false. * In this case， use a plugin command ”Preload Pictures” to preload actor * pictures manually. * * You can also configure animation settings for pictures. If you want to * animate a picture， create a image with as many patterns aligned horizontally * as you like. Specify that number of patterns into a plugin parameter * ”Animation Patterns”. Animation frames can be calibrated with plugin * parameters. Configure them seeing actual animations in the game. * * * This plugin is released under MIT license. * https://opensource.org/licenses/mit-license.php * * @param actorPictures * @text Actor Pictures * @desc Settings for actor pictures. * @default [] * @type struct<picture>[] * * @param pictureCalibrations * @text Picture Calibrations * @desc The calibration settings for each picture file which requires offsetting. * @default [] * @type struct<calibration>[] * * @param animationPictures * @text Picture Animation Settings * @desc The settings to animate pictures. * @default [] * @type struct<animation>[] * * @param preloadAllPicturesAtEveryScene * @text Preload All Pictures Automatically at Every Scene * @desc By setting it ON， all the actor pictures will be preloaded automatically at the start of every scene. * @default true * @type boolean * * * @command setPictureIndex * @text Set Picture Index * @desc Set the Picture Index for an actor in order to switch costumes/facial expressions. * * @arg actorId * @text Actor ID * @desc Specify the Actor ID. * @type actor * @min 1 * * @arg pictureIndex * @text Picture Index * @desc Specify the Picture Index. Note it starts from 0. * @type number * @min 0 * * @command preloadPictures * @text Preload Pictures * @desc Preload actor pictures manually. * * @arg pictureScope * @text Picture Scope * @desc Select the scope for pictures to be preloaded. * @default all * @type select * @option All * @value all * @option Party Actors * @value party *