An open library of RPG Maker MZ plugins, powered by the community.

PGMZ - The Community-Driven Plugin Library for RPG Maker MZ

MZ plugins

Character Graphic Extend - CharacterGraphicExtend.js

Plugin desc : Character graphic display extension plug-in

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com

Desc page : https://github.com/triacontane/RPGMakerMV/tree/mz_master/CharacterGraphicExtend.js

Download Page : https://raw.githubusercontent.com/munokura/triacontane-MZ-plugins/refs/heads/main/CharacterGraphicExtend.js

File name : CharacterGraphicExtend.js

Help of plugin :

@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/CharacterGraphicExtend.js
@plugindesc Character graphic display extension plug-in
@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
-----

Expands the event graphic display method, allowing for a wider variety of
expressions.
Enter the event’s memo field using the specified format.
Separate items with commas. The same control characters as for text display
can be used.
Also, entering ”A” for the page number will target all pages.

<CG Picture: (Page Number), (File Name)>
Retrieves the graphic to be displayed when the specified page is activated
from the picture image.
An extension is not required. Walking animation and standby animation will be
disabled.

The file name can contain the control characters ”¥mi[aaa]” from the official
plugin ”MaterialBase.js.”

Example: <CG Picture: 1, Test> or <CGPicture: 1, Test>

〇 Additional Features
If you want to assign different images to multiple pages,
create a tag for each page.
In the example below, aaa.png is used for page 1, and bbb.png is used for page
2.
Other tags work similarly.
Example: <CG Picture: 1, aaa><CG Picture: 2, bbb>

<CG Enemy: (Page Number), (File Name), (Hue)>
Retrieves the graphic for the specified page from the enemy image.
No extension is required. Walking and standby animations will be disabled.

Example: <CG Enemy: 1, Bat, 90> or <CGEnemy: 1, Bat, 90>

<CG Icon: (Page Number), (Index)>
Retrieves the graphic for the specified page from the icon image.
Walking and standby animations will be disabled.

Example: <CG Icon: 1, 128> or <CGIcon: 1, 128>

<CG Face: (Page Number), (File Name), (Index)>
Retrieves the graphic for the specified page from the face image.
No extension is required. Walking and standby animations will be disabled.

Example: <CG Face:1,Actor1,4> or <CGFace:1,Actor1,4>

<CG Actor:(Page Number),(File Name),(Index)>
Retrieves the graphic for the specified page from the butler image when it is
activated.
No extension is required. Walking and standby animations will be disabled.

Example: <CG Actor:1, Actor1_1,0> or <CGActor:1, Actor1_1,0>

<CG Background:(Page Number),(File Name)>
Retrieves the graphic for the specified page from the background image when it
is activated.
No extension is required. Walking and standby animations will be disabled.

Example: <CG Background:1,Test> or <CGParallax:1,Test>

Caution! If you specify files in these memo fields, they may be excluded as
unused files during deployment.
If this occurs, you will need to take appropriate measures, such as replacing
the deleted files.

<CG Tile: (Number of Pages), (Width), (Height)>
Retrieves the graphic for the specified page from the tile image.
You can specify the width and height to display a bookshelf or bed in a single
event.
Select the top-left tile from the event image selection.

Example: <CG Tile: 1, 2, 2> or <CGTile: 1, 2, 2>

<CG Tile Set: (Number of Pages), (Tile Set ID)>
Specifies the tile set to display when the specified page is activated.
You can use tile set images other than the tile set used on the map.

Example: <CG Tile Set: 1, 2> or <CGTileset: 1, 2>

<CG Shift: (Number of Pages), (X Coordinate), (Y Coordinate)>
Shifts the graphic display position by the specified number of pixels when the
specified page is activated.

Example: <CG Shift: 1, 16, -16> or <CGShift: 1, 16, -16>

<CG Priority: (Page Number), (Priority)>
Sets the display priority for the specified page when it is activated.

Can be set to a value between 1 and 9.

Example: <CG Priority: 1, 6> or <CGPriority: 1, 6>

*Priority values
0: Lower tile
1: Below the normal character
3: Same as the normal character
4: Upper tile
5: Above the normal character
6: Airship shadow
7: Speech bubble
8: Animation
9: Map touch destination (white glowing thing)

<CG Composite Method: (Page Number), (Composite Method)>
Sets the graphic composite method for the specified page when it is activated.
0: Normal 1: Add 2: Multiply 3: Screen

Example: <CG Blending Method: 1, 2> or <CGBlendType: 1, 2>

<CG Scale: (Number of Pages), (X Scale), (Y Scale)>
Sets the scale of the graphics when the specified page is activated.

A negative value will flip the image.

Example: <CG Scale: 1, 100, -100> or <CGScale: 1, 100, -100>

<CG Rotation Angle: (Number of Pages), (Rotation Angle)>
Sets the rotation angle of the graphics when the specified page is activated.
The center of rotation is at the character’s feet. Set within the range of 0
to 360.

Example: <CG Rotation Angle: 1,180> or <CGAngle: 1,180>

<CG Origin: (Page Number), (X Origin), (Y Origin)>
Sets the origin (0...100) of the graphic when the specified page is activated.
The default is 50 for X and 100 for Y (the origin is the bottom of the image).

Example: <CG Origin: 1,0,0> or <CGOrigin: 1,100,100>

<CG Absolute Coordinates: (Page Number), (X Coordinate), (Y Coordinate)>
When the specified page is activated, the graphic display position is set to
absolute coordinates (displayed independently of map scrolling, like a
picture).
However, the position of the event itself remains unchanged.

Example: <CG Absolute Coordinates: 1, 16, -16> or <CGAbsolute: 1, 16, -16>

<CG Color Tone: (Page Number), (R Value), (G Value), (B Value), (Grayscale)>
Sets the color tone (-255 to 255) when the specified page is active.
Grayscale is optional and will default to 0 if omitted.

Example: <CG Color Tone: 1, -255, 0, 255, 0> or <CGTone: 1, -255, 0, 255, 0>

<CG Opacity: (Page Number), (Compositing Method)>
Sets the opacity of the graphic when the specified page is active.
0: Transparent - 255: Opaque

Example: <CG Opacity: 1,64> or <CGOpacity: 1,64>

<CG Trimming: (Number of Pages), (X Coordinate), (Y Coordinate), (Width),
(Height)>
Crops the image to the specified rectangle.

Example: <CG Trimming: 1, 0, 0, 24, 24> or <CG Trimming: 1, 0, 0, 24, 24>

〇 Script (Advanced settings. Execute script by specifying the movement route)

・Setting the zoom ratio
this.setScale((X coordinate), (Y coordinate));
Example: this.setScale(100, 100);

・Setting the rotation angle
this.setAngle((Rotation angle));
Example: this.setAngle(180);

・Setting the pixel position
this.shiftPosition((X coordinate), (Y coordinate));
Example: this.shiftPosition(24, 24);

・Setting the color tone
this.setTone((R value), (G value), (B value), (Grayscale));
Example: this.setTone(255, -255, -255, 0);

・Changing the image
this.changeImage((new filename), (index));
Example: this.changeImage(’Package1’, 3);

*1 The image type (e.g., Picture ⇒ Distant View) cannot be changed.
*2 If the index is omitted, the previous value will be maintained.

This plugin does not have a plugin command.

If using in conjunction with EventEffects.js, place this plugin below.

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 EventHideInvalid
@text Event Clearing Disabled
@desc Disables the effect that momentarily erases the event when an encounter occurs.
@type boolean
@default false

スポンサードリンク

-MZ plugins

Copyright© PGMZ - The Community-Driven Plugin Library for RPG Maker MZ , 2026 All Rights Reserved.