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

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

MZ plugins

MNKR Common Popup Core MZ - MNKR_CommonPopupCoreMZ.js

Plugin desc : This is a base plugin that provides a general-purpose popup mechanism.

License : MIT License

Author : munokura

Website : http://x.com/munokura

Desc page : https://raw.githubusercontent.com/munokura/MNKR-MZ-plugins/master/MNKR_CommonPopupCoreMZ.js

File name : MNKR_CommonPopupCoreMZ.js

Help of plugin :

@target MZ
@url https://raw.githubusercontent.com/munokura/MNKR-MZ-plugins/master/MNKR_CommonPopupCoreMZ.js
@plugindesc This is a base plugin that provides a general-purpose popup mechanism.
@author munokura
@license MIT License

@help
This plugin provides a general-purpose popup mechanism.
This plugin alone does not have any functionality beyond adding plugin
commands.

-----------------------------------------------------
Plugin Commands
------------------------------------------------------
CommonPopup add param1 param2 param3 ...

You can specify only the necessary parameters.
Example: Pop up a test popup above the player for 240 frames.
CommonPopup add text:test count:240 eventId:-1

Parameter Details:
text: Display text
eventId: Event ID to display
count: Display time
delay: Display delay
moveX: Destination X (relative coordinates)
moveY: Destination Y (relative coordinates)
sx: Pop-up position offset X
sy: Pop-up position offset Y
pattern: Display pattern. 0 is fade, -1 is horizontal stretch, -2 is vertical
stretch
back: -1: transparent background, 0: background color gradient
bx: Text display position offset X
by: Text display position offset Y
extend:
Specify an array to adjust the display timing.
Example: extend:[20,50] Appears over 20 frames and starts disappearing on the
50th frame.

Added features not yet implemented in the original version.
backImage: Filename (in img/pictures)

Deemed less necessary, removed from plugin commands.
anchorX: Popup origin X. Right edge of the 0 event. In tiles.
anchorY: Popup origin Y. Bottom edge of the 0 event. In tiles.

Features likely to be unimplemented
fixed: Fixed to the screen? Specify true/false.
slideCount: The speed at which a new popup slides up when it appears.

When using an event command script,

this.addPopup([”add”,”text:test”,”count:120”…]);

You can create a popup using a script by writing something like this.
Similarly, if you want to use it in a script within an event command’s
movement route, you can use it by writing:

$gameMap._interpreter.addPopup([”add”,”text:test”,”count:120”…]);

# Contact Information
This is a plugin originally created for RPG Maker MV ported for MZ.
Please contact the modifier for any inquiries.

# Terms of Use
MIT License.
http://opensource.org/licenses/mit-license.php
You may modify and redistribute this without permission, and there are no
restrictions on its use (commercial, R18+, etc.).

@command CommonPopupAdd
@text Pop-up display
@desc Pop up the text.
@arg text
@text Display Text
@desc Enter the display text.
@type string
@arg eventId
@text Event ID
@desc The ID of the event to display.
@type number
@default -1
@min -1
@arg count
@text Display Time
@desc Number of frames to complete the popup
@type number
@default 60
@arg delay
@text Display Delay
@desc Number of frames to start popup
@type number
@default 0
@arg moveX
@text Destination point X (relative coordinates)
@desc X position correction when pop-up is completed
@type number
@default 0
@min -9007
@max 9007
@arg moveY
@text Destination point Y (relative coordinate)
@desc Y position correction when pop-up is completed
@type number
@default -48
@min -9007
@max 9007
@arg sx
@text Pop Position Correction X
@desc Popup X position offset
@type number
@default 0
@min -9007
@max 9007
@arg sy
@text Pop position correction Y
@desc Popup Y position correction
@type number
@default 0
@min -9007
@max 9007
@arg pattern
@text Display Pattern
@desc Pop-up display transformation pattern
@type select
@default Normal
@option fade
@value Normal
@option Horizontal stretch
@value Stretch
@option Vertical stretch
@value GrowUp
@arg back
@text background color
@desc Background color: Red, Green, Blue, Alpha / Transparency: -1
@type string
@default 0,0,0,0.6
@arg backImage
@text background image
@desc Specifies a background image. If a background image is used, the background color will be ignored.
@type file
@require 1
@dir img/pictures
@arg bx
@text Text Alignment X
@desc Text display position correction X
@type number
@default 0
@min -9007
@max 9007
@arg by
@text Text position offset Y
@desc Text display position correction Y
@type number
@default 0
@min -9007
@max 9007
@arg extend
@text Display timing adjustment
@desc Specify an array for adjusting the display timing. Example: [20,50] Appears over 20 frames and starts disappearing from the 50th frame.
@type string

@command CommonPopupClear
@text Remove Pop-up
@desc Dismisses the displayed popup.

スポンサードリンク

-MZ plugins

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