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.
Character Picture Manager - CharacterPictureManager.js
Plugin desc : Character image display management plugin
License : MIT License
Author : Triacontane
Website : https://triacontane.blogspot.com
Desc page : https://github.com/triacontane/RPGMakerMV/tree/mz_master/CharacterPictureManager.js
Download Page : https://raw.githubusercontent.com/munokura/triacontane-MZ-plugins/refs/heads/main/CharacterPictureManager.js
File name : CharacterPictureManager.js
Help of plugin :
@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/CharacterPictureManager.js
@plugindesc Character image display management plugin
@author Triacontane
@license MIT License
@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help,
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/triacontane-MZ-plugins ).
Original plugin by Triacontane.
Please check the latest official version at:
https://triacontane.blogspot.com
-----
CharacterPictureManager.js
Manages and displays character portraits composed of multiple images.
Register images， display conditions， and the desired scene via plugin
parameters.
Features include:
- Character portraits change based on conditions such as HP remaining， state，
equipment， job， and switches.
- Images change during battle based on battle status， such as when taking
action or taking damage.
- Create costume and facial expression variations using multiple images.
- The same character portrait can be reused across battle， menu， and map
screens.
Also， by combining it with the separately released APNG Picture Plugin，
character portraits can be animated. However， be careful not to overuse them.
APNG images are not supported by the crossfade function.
● How to Specify Memo Field Conditions
If you specify ”aaa” in the memo field of the display conditions， the
character portrait will be displayed if the target actor’s database (※)
contains the following memo fields.
<StandPicture:aaa>
*Applies to actors， jobs， weapons， armor， and states.
●Image Coordinate Selection Support
During test play only， you can check and adjust the coordinates of the stand
picture by dragging it.
The current base and unique coordinates are displayed on the screen.
Holding the Ctrl key selects the back image， while not holding it selects the
front image.
Holding the Shift key adjusts the base coordinates， while not holding it
adjusts the unique coordinates.
●Dynamic Stand Picture File Settings (For Advanced Users)
If you want to use a large number of stand pictures， you can dynamically
determine file names according to a naming convention.
This is for advanced users only， as an error will occur if the file does not
exist， and files may be deleted by the automatic deletion function for unused
files.
File names are converted according to the following rules:
{hp:40，60，80}
HP rating is converted to an index according to the specified threshold.
In the above example， it would be converted to the following values:
0%-39%: 0
40%-59%: 1
60%-80%: 2
80%-100%: 3
{stateId}
Converted to the highest priority state ID.
However， entering <NoStandPicture> in the state’s memo field will not affect
this.
{switch:3}
Converted to [1] when switch [3] is ON， and [0] when OFF.
{variable:4}
Converted to the value of variable [4].
{action}
Converted to [1] when in action， and [0] otherwise.
{damage}
Converted to [1] when taking damage， and [0] otherwise.
{note}
Converted to the value specified in the <StandPicture> field in the database
memo field.
Entering <StandPicture:aaa> will convert to aaa.
This applies to actor， job， weapon， armor， and state memo fields.
This plugin requires the base plugin ”PluginCommonBase.js.”
”PluginCommonBase.js” is located in the following folder under the RPG Maker
MZ installation folder:
dlc/BasicResources/plugins/official
Terms of Use:
You may modify and redistribute this plugin without permission from the
author， and there are no restrictions on its use (commercial， R18+， etc.).
This plugin is now yours.
@param PictureList
@text Character image list
@desc This is a list of standing images for each actor. Multiple images can be displayed for one actor. (The image at the bottom of the list is displayed in front.)
@type struct<StandPictureActor>[]
@default []
@param SceneList
@text Displayed scene list
@desc This is a list of scenes in which you want to display character portraits. Set the reference coordinates for each scene. You cannot define multiple data for the same scene.
@type struct<Scene>[]
@default [”{￥”SceneName￥”:￥”Scene_Battle￥”，￥”MemberPosition￥”:￥”[￥￥￥”{￥￥￥￥￥￥￥”X￥￥￥￥￥￥￥”:￥￥￥￥￥￥￥”160￥￥￥￥￥￥￥”，￥￥￥￥￥￥￥”Y￥￥￥￥￥￥￥”:￥￥￥￥￥￥￥”480￥￥￥￥￥￥￥”}￥￥￥”，￥￥￥”{￥￥￥￥￥￥￥”X￥￥￥￥￥￥￥”:￥￥￥￥￥￥￥”320￥￥￥￥￥￥￥”，￥￥￥￥￥￥￥”Y￥￥￥￥￥￥￥”:￥￥￥￥￥￥￥”480￥￥￥￥￥￥￥”}￥￥￥”，￥￥￥”{￥￥￥￥￥￥￥”X￥￥￥￥￥￥￥”:￥￥￥￥￥￥￥”480￥￥￥￥￥￥￥”，￥￥￥￥￥￥￥”Y￥￥￥￥￥￥￥”:￥￥￥￥￥￥￥”480￥￥￥￥￥￥￥”}￥￥￥”，￥￥￥”{￥￥￥￥￥￥￥”X￥￥￥￥￥￥￥”:￥￥￥￥￥￥￥”640￥￥￥￥￥￥￥”，￥￥￥￥￥￥￥”Y￥￥￥￥￥￥￥”:￥￥￥￥￥￥￥”480￥￥￥￥￥￥￥”}￥￥￥”]￥”，￥”ActorPosition￥”:￥”[]￥”，￥”ScaleX￥”:￥”100￥”，￥”ScaleY￥”:￥”100￥”，￥”ShowPictureSwitch￥”:￥”0￥”，￥”ShakeSwitch￥”:￥”0￥”，￥”UnFocusSwitch￥”:￥”0￥”，￥”MirrorSwitch￥”:￥”0￥”，￥”TouchSwitch￥”:￥”0￥”，￥”Priority￥”:￥”0￥”，￥”FadeFrame￥”:￥”0￥”，￥”CrossFadeFrame￥”:￥”0￥”，￥”UpdateInterval￥”:￥”1￥”，￥”UpdateSwitch￥”:￥”0￥”}”]
@param Origin
@text origin
@desc This is the origin of the character image. This setting is common to all images. When displaying battle animations on character images， set it to ”bottom center.”
@type select
@default 2
@option upper left
@value 0
@option center
@value 1
@option bottom center
@value 2
@param UsePointAdjust
@text Using the coordinate adjustment function
@desc When enabled， you can use the function to adjust the coordinates by dragging the character image during test play.
@type boolean
@default true
@param ShakeOnDamage
@text Shake when damaged
@desc When enabled， the character portrait will shake when taking damage.
@type boolean
@default false
@param ShakePower
@text Shake Strength
@desc Sheik’s strength is evident in his standing image.
@type number
@default 5
@min 1
@param ShakeSpeed
@text Shake speed
@desc The speed of the character shake.
@type number
@default 8
@min 1
@param ShakeDuration
@text Shake Time
@desc Standing character shake time (number of frames).
@type number
@default 30
@min 1
@param ShakeRotation
@text Shake Direction
@desc Character shake direction (0-360).
@type number
@default 0
@min 0
@max 360
@param UnFocusPower
@text Unfocused Strength
@desc The strength (darkness) of the character image when it is out of focus. The larger the value， the darker it will be.
@type number
@default 68
@min -255
@max 255
@param MenuActorOnly
@text Show Menu Actors Only
@desc The equipment， skills， status， and name screens will only display the profile picture of the actor being displayed.
@type boolean
@default true
@param SelectActorOnly
@text Show selected actors only
@desc The item and skill screens will only display the portrait of the actor currently selected in the actor window.
@type boolean
@default false
@param DressUp
@text Try-on function
@desc When you select equipment on the shop screen or equipment screen， it will be reflected in the character portrait.
@type boolean
@default true
@param UseAnimationTarget
@text Target battle animation
@desc The target of the front view battle animation will be the standing character. Set the display priority of the standing character to ”Below animation.”
@type boolean
@default false