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 Battle Background Mask - MNKR_BattleBackgroundMask.js

Plugin desc : You can mask the background of battle scenes to make them appear more windowed.

License : MIT License

Author : munokura

Website : http://x.com/munokura

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

File name : MNKR_BattleBackgroundMask.js

Help of plugin :

@target MZ MV
@url https://raw.githubusercontent.com/munokura/MNKR-MZ-plugins/master/MNKR_BattleBackgroundMask.js
@plugindesc You can mask the background of battle scenes to make them appear more windowed.
@author munokura
@license MIT License

@help
# Function
Masks the background of the battle scene, displaying only the enemy group’s
area.
A snapshot of the current map screen is displayed outside of that.

Set the mask range and position using the plugin parameters.

# Note
- During battle testing, or when starting a battle from a scene other than the
map scene,
there is no snapshot, so the area outside the frame will be black.

There are no plugin commands.

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

@param MaskSettings
@text Mask range and position settings

@param maskWidth
@text Mask Width
@desc Specifies the mask width in pixels (-1 is half the screen width).
@type number
@default -1
@min -1
@parent MaskSettings

@param maskHeight
@text Mask height
@desc Specifies the mask height in pixels (-1 is half the screen height).
@type number
@default -1
@min -1
@parent MaskSettings

@param maskX
@text X coordinate of the mask
@desc Specify the X coordinate (left edge) of the mask in pixels (-1 is the center of the screen).
@type number
@default -1
@min -1
@parent MaskSettings

@param maskY
@text Y coordinate of the mask
@desc Specify the Y coordinate (top) of the mask in pixels (-1 is the center of the screen).
@type number
@default 48
@min -1
@parent MaskSettings

@param FrameSettings
@text Frame Settings

@param frameColor
@text Frame color
@desc Specify the border color in hexadecimal (e.g. #FFFFFF for white, #808080 for gray)
@type string
@default #D0E0FF
@parent FrameSettings

@param frameWidth
@text Frame Thickness
@desc Specify the border thickness in pixels.
@type number
@default 6
@min 0
@parent FrameSettings

@param cornerRadius
@text Rounded corners of the frame
@desc Specifies the roundness of the border corners in pixels (affects border and background mask).
@type number
@default 8
@min 0
@parent FrameSettings

スポンサードリンク

-MZ plugins

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