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 Choice Custom MZ - MNKR_ChoiceCustomMZ.js

Plugin desc : Adds a plugin command to change the number of columns, rows, and Y-axis position of the options.

License : MIT License

Author : munokura

Website : http://x.com/munokura

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

File name : MNKR_ChoiceCustomMZ.js

Help of plugin :

@target MZ
@url https://raw.githubusercontent.com/munokura/MNKR-MZ-plugins/master/MNKR_ChoiceCustomMZ.js
@plugindesc Adds a plugin command to change the number of columns, rows, and Y-axis position of the options.
@author munokura
@license MIT License

@help
# Function
Adds a plugin command to change the number of columns, rows, and Y-axis
position of choices.

# How to Use the Plugin Command

Open the ”Plugin Command” event command and select this plugin name
”MNKR_ChoiceCustomMZ.”
The following commands will be displayed. Select the function you want to use
and set the arguments.

## Set Columns (SetChoiceColumns)
- Sets the number of columns of choices.
- Specify 1 or more for the ”Columns” argument.

## Example: Displaying Two Columns
Plugin Command: MNKR_ChoiceCustomMZ
Command Name: Set Columns
Arguments:
Number of Columns: 2

## Set Rows (SetChoiceRows)
- Sets the number of rows displayed for choices.
- Specify 1 or more for the ”Rows” argument.

### Usage Example: 2-Column Display
Plugin Command: MNKR_ChoiceCustomMZ
Command Name: Set Number of Rows
Arguments:
Number of Rows: 2

## Setting Y-Axis Position (SetChoiceYPosition)
- Sets the Y-axis position of the choice.
- Specify a value greater than or equal to 0 for the ”Y Coordinate” argument.

## Usage Example: Top of Screen
Plugin Command: MNKR_ChoiceCustomMZ
Command Name: Set Y-Axis Position
Arguments:
Y Coordinate: 0

## Reset Settings (ResetChoiceSettings)
- Resets all settings to default (e.g., single-column display).
- Settings are retained even after moving locations, so if you no longer need
them, use this command to reset them.

# Notes

## About Y-Axis Position
- If the specified Y-position value is too large and extends off the screen,
it will automatically be adjusted to the top of the screen.
- If the specified number of rows results in a window size that exceeds the
resolution,
the window size will be automatically adjusted and
displayed at the top of the screen.

## Combination of Rows and Columns
- Specifying the number of rows can be used in combination with specifying the
number of columns.
- If the ”number of rows × number of columns” is less than the total number of
options,
the window will be scrollable.

### Usage Example: Displaying 2 columns x 3 rows (displaying up to 6 options)
Execute the following two plugin commands in succession.

Plugin Command: Set Number of Columns (Number of Columns: 2)
Plugin Command: Set Number of Rows (Number of Rows: 3)

# Terms of Use
MIT License.
http://opensource.org/licenses/mit-license.php
Modification and redistribution are permitted without the author’s permission,
and there are no restrictions on usage (commercial, R18+, etc.).

@command SetChoiceCustom
@text Custom options
@desc Set the number of columns, rows, and Y-axis position of the options.
@arg rows
@text Number of rows
@desc Please specify a number greater than or equal to 1.
@type number
@default 6
@min 1
@arg columns
@text number of columns
@desc Please specify a number greater than or equal to 1.
@type number
@default 2
@min 1
@arg yPosition
@text Y coordinate
@desc Please specify a number greater than or equal to 0.
@type number
@default 0
@min 0

@command ResetChoiceSettings
@text Reset settings
@desc Reset all settings to default.

スポンサードリンク

-MZ plugins

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