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

PGMV - The Community-Driven Plugin Library for RPG Maker MV

MV plugins

Extend Escape Characters - ExtendEscapeCharacters.js

Plugin desc : ver1.01/Extends control characters.

License : MIT License

Author : Yana

Website : https://w.atwiki.jp/pokotan/pages/3.html

Desc page : https://github.com/munokura/Yana-MV-plugins

Download Page : https://raw.githubusercontent.com/munokura/Yana-MV-plugins/refs/heads/master/Map_Message/ExtendEscapeCharacter/ExtendEscapeCharacters.js

File name : ExtendEscapeCharacters.js

Help of plugin :

@plugindesc ver1.01/Extends control characters.
@author Yana
@url https://github.com/munokura/Yana-MV-plugins
@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/Yana-MV-plugins ).
Original plugin by Yana.
-----
Installation Notes
------------------------------------------------------
* The following plugins are configuration plugins for this plugin.
It will work without these, but Traits requiring the configuration plugins will be unavailable.
EECSetting_Audio (Required if using music-related control characters)
EECSetting_Macro (Required if using ¥m[x])
EECSetting_Picture (Optional. Required if using picture-related control characters, such as PIC<x>)

* If using this plugin in conjunction with FaceEC, place this plugin below it.
Also, in this case, this plugin's parameter, SetFace, will not be available.
The FaceEC parameter will be used.

* If using in conjunction with MessageAlignmentsEC, place this plugin above it.

* This plugin changes the face portion of messages to a sprite.
Therefore, it may be difficult to use it in conjunction with plugins that change the drawing of the face portion of messages.

* The following processing is very heavy, so it may be best not to use it too often.
- Resizing the window with the specified operation frame
(Increasing the WindowFrameSkip value will prevent the frame rate from dropping, but will result in less smooth operation.)

------------------------------------------------------
Plugin Commands
------------------------------------------------------
EEC MoveNumberInput x,y,w,h
- Changes the position of the number input window to x,y and the size to w,h.
- Only affects number input windows called after this command.

EEC MoveEventItem x,y,w,h
- Changes the position of the item selection window to x,y and the size to w,h.
- Only affects item selection windows called after this command.

EEC BindPicture n1,n2[,n3…]
- Binds n2[,n3…] with n1 as the master.
- Binding pictures will synchronize their behavior.
- Since it takes time for a picture to be displayed after being called,
before using this command, please wait a short time after displaying the picture.

-----------------------------------------------------
Setting Method
------------------------------------------------------
Adds control characters that can be used with the "Show Text" Event's Contents.
The following control characters are added.

--Initial Settings---
Changes the initial window settings.
You can set the display position, size, face, etc. when called.
Control characters beginning with _ are initial setting characters.

-Window Settings-
_MMW[x,y] Changes the initial window display position to x,y. The anchor is the top left (x=0,y=0).
_RMW[w,h] Sets the initial window size to w,h.
_OMW[o] Sets the initial window transparency to o.
_WC[r,g,b] Sets the window color to r,g,b.
_DWC Resets the window color to the one set in $gameSystem.
*MMW and RMW can also be used in the option display by setting them as the first option.

-Face Settings-
_FCR Changes the face display to the right.
_AF[n+i] Sets the face to the index i from actor n.
_SF[n+i] Sets the face to index i of actor n set in the plugin parameters.
_FRT[r] Sets the face angle to r°.
_FFH Sets the face to be mirrored horizontally.
_FFV Sets the face to be mirrored vertically.
_FO[o] Sets the face transparency to o.

--Replacement--
Converted by Window_Base and replaced with specific text.
¥M[n] Replaces with the nth text set in EECSetting_Macro.
¥PDAF[n] Replaces the nth actor's face with the character size displayed vertically.
¥PDSF[n,i] Replaces with the ith face of the nth face set in SetFace plugin parameters.
¥PDE[n] Replaces with the xxx image of <PDE:xxx> set in the nth enemy's note.
*PDAF control characters are displayed with y as the center of the face if the actor's note field contains a <PDA_CY:y> note.

--Action--
Control characters are processed by Window_Message and perform some action.

--Weight--
¥WT[n] Applies a wait of n frames.

-Window Operation--
Basically, all d's are optional. If omitted, they are treated as 0.
Also, setting d to a negative value will wait for the previous action to finish before proceeding to the specified action.
¥MMW[x,y[,d]] Moves the window position by x,y multiplied by d frames.
¥RMW[w,h[,d]] Changes the window size by x,y multiplied by d frames. (This is heavy.)
¥OMW[o[,d]] Changes the window transparency to o multiplied by d frames.
¥WC[r,g,b[,d]] Changes the window color to r,g,b multiplied by d frames.
¥DWC[d] Resets the window color to the $gameSystem setting multiplied by d frames.

-Face Control-
Basically, all d parameters are optional. If omitted, they will be treated as 0.
Also, setting d to a negative value will wait for the previous action to finish before proceeding to the specified action.
¥FRT[r[,d]] Rotates the face angle by r° multiplied by d frames.
¥FFV[d] Flips a face horizontally over d frames.
¥FFH[d] Flips a face vertically over d frames.
¥FO[o[,d]] Changes face transparency to o over d frames.
¥FCI[n[,d]] Changes face index to n over d frames.
¥AF[n[+i,d]] Changes face to actor n by shifting index i over d frames.
¥SF[n[+i,d]] Changes face to index i of actor n specified in the plugin parameters over d frames.
*Note* If you call ¥FCI, ¥AF, or ¥SF while using either of the following two, the change will not be made correctly!
¥FCT[r,g,b,gr[,d]] Changes face ColorTone to r,g,b,gr over d frames.
¥FBC[r,g,b,a[,d]] Changes the BlendColor of a face to r,g,b,a over d frames.

-Event-related-
n is -1 for the player, 0 for the trigger event, and 1 or higher for the corresponding event ID.
¥ANI can be set to -2 to target a face.
¥BLN[n,i] Displays the i-th speech bubble on the n-th character.
¥ANI[n,i] Displays the i-th animation on the n-th character.

-Music-related-
Volume (v), pitch (p), and phase (pn) can be omitted. If omitted, the default settings will be used.
n will use the name set in EECSetting_Audio.
You can also stop playback by setting n to 0.

¥BGM[n[,v,p,pn]] Plays the BGM specified by n.
¥BGS[n[,v,p,pn]] Plays the BGS specified by n.
¥SE[n[,v,p,pn]] Plays the sound effect specified by n.
¥ME[n[,v,p,pn]] Plays the medium effect specified by n.

¥BGMFI[n,s[,v,p,pn]] Fades in the background music specified by n over s seconds.
¥BGMFO[s] Fades out the background music over s seconds.
¥BGSFI[n,s[,v,p,pn]] Fades in the background music specified by n over s seconds.
¥BGSFO[s] Fades out the background music over s seconds.

-Picture-
¥SPIC[n,name[,or,x,y,sx,sy,op,bm]]
Displays the picture of the image specified by name at number n with origin:or, X coordinate:x, Y coordinate:y, scale X:sx, scale Y:sy,
transparency:op, blend mode:bm. The parts after name are optional.
The following special specifications are also available for name:
P<n> Replaces with the nth picture set in EECSetting_Picture.
A<n> Replaces with xxx in the <Standing Picture: xxx> entry in the nth actor's Note field.
DT<xxx n> Displays the xxx string picture with font size n. (Requires the Dynamic String Picture Generation Plugin.)
*When using control characters, change [] to <>.

¥MPIC[n,x,y[,d]] Moves the nth picture by x,y over d frames.
¥ZPIC[n,sx,sy[,d]] Changes the nth picture to sx%,sy% over d frames.
¥OPIC[n,op[,d]] Changes the opacity of the nth picture to op over d frames.
¥ORPIC[n,or] Changes the origin of the nth picture to or. For or, 0 is the top left and 1 is the center.
¥RPIC[n,rs] Rotates picture n at rotation speed rs.
¥APIC[n,a] Changes the angle of picture n to a°.
¥TPIC[n,r,g,b,gr[,d]] Changes the color tone of picture n to r,g,b,gr over d frames.
¥NCPIC[n1,n2] Swaps the numbers of pictures n1 and n2.
¥CFPIC[n,name[,d]] Changes picture n to the image named name over d frames, fading.
¥CTPIC[n,name[,d]] Changes picture n to the image named name over d frames, flipping it.
¥CXPIC[n,name[,d]] Changes picture n to the image named name over d frames, crossfading.
¥BNPIC[n1,n2[,n3…]] Combines images n2[,n3…] with picture n1 as the master.
¥FIPIC[n,nm[,d,x,y,t]] Sets image name to picture n and fades it in from direction d. x and y are offsets for the display position.
¥FOPIC[n[,d,x,y]] Fades picture n in direction d. x and y are offsets for the display position.

When using ¥OPIC, the image position changes along with the origin. However, if the picture was rotated before use, the coordinates will not be calculated correctly.
------------------------------------------------------
Terms of Use
------------------------------------------------------
This plugin is released under the MIT License.
http://opensource.org/licenses/mit-license.php
------------------------------------------------------
Update History:
ver1.01:
Removed unused methods.
ver1.00:
Released

@param ToneRate
@desc This sets how many frames the tone changes every.
@default 2

@param WindowFrameSkip
@desc This setting determines how many frames the window size should change at each time.
@default 2

@param FadeDuration
@desc The time it takes for the picture to fade in and out.
@default 10

@param FadePosY
@desc This is the Y coordinate of the picture display position used for fading in and out pictures. It is the coordinate of the center of the image.
@default 225

@param ---------------

@param SetFace1
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace2
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace3
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace4
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace5
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace6
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace7
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace8
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace9
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace10
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param ---------------

@param SetFace11
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace12
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace13
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace14
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace15
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace16
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace17
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace18
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace19
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace20
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param ---------------

@param SetFace21
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace22
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace23
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace24
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace25
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace26
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace27
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace28
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace29
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace30
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param ---------------

@param SetFace31
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace32
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace33
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace34
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace35
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace36
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace37
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace38
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace39
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace40
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param ---------------

@param SetFace41
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace42
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace43
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace44
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace45
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace46
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace47
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace48
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace49
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param SetFace50
@desc The file name of the face to be recalled.
@type file
@require 1
@dir img/faces/

@param ---------------

スポンサードリンク

-MV plugins

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