What a custom menu does and why you might build one

A custom menu in RPG Maker MZ replaces or extends the default menu that appears when a player presses Escape during gameplay. The default menu shows items, equipment, status, and save options in a fixed layout. A custom menu lets you change what appears, where it appears, add new commands, rearrange sections, or style everything to match your game's look.

You build a custom menu because the default one may not fit your game's design. A survival game might need a hunger or temperature display. A game with a crafting system needs a crafting command. A visual novel might hide combat options entirely. Custom menus also let you match the visual style of your world — a sci-fi game can have a sleek blue interface, a fantasy game can use parchment textures.

RPG Maker MZ uses JavaScript to handle menus, so you will be writing or modifying code. You do not need to be a programmer to follow this — the engine provides templates and the community has written plugins that do much of the work for you.

Key Takeaways

  • The default menu is defined in the Scene_Menu.js and Window_MenuCommand.js files in your project's js/rmmz_core folder, and you can edit these directly or use plugins to override them.
  • Adding a new command to the menu requires changing the addCommand() calls in Window_MenuCommand.prototype.makeCommandList, then adding a handler for what happens when the player selects it.
  • Plugins are the safer way to modify menus because they do not touch the core files, so your changes survive when you update RPG Maker MZ.
  • Testing your menu changes requires running the game in test mode (F5 in the editor) and navigating to the menu to see the results when ready.
  • The most common custom menus use existing plugins from the RPG Maker community rather than writing code from scratch.

Understanding the default menu structure

When you start a new RPG Maker MZ project, the menu system is built from several files working together. The main file is Scene_Menu.js, which controls what happens when the menu opens. This file creates the windows (the boxes that hold text and options) and decides what to display. Window_MenuCommand.js is the file that builds the list of commands — Item, Equip, Status, Save, Load, Exit.

Each window is a rectangle on the screen that holds information or options. The menu has a command window (the list on the left), a gold window (showing money), and a status window (showing the party). When you click or press a direction key, the command window highlights the next option. When you press Enter, the game runs the handler for that command — for example, pressing Enter on "Item" opens the item selection screen.

You can see these files in your project folder at js/rmmz_core/. Do not edit them directly if you can avoid it, because updating RPG Maker MZ will overwrite your changes. Instead, use plugins or create a custom Scene_Menu.js in your js/plugins folder, which overrides the core version.

Adding a new command without writing code

The easiest way to add a command is to use a plugin that someone else has already written. The RPG Maker community shares plugins freely on sites like GitHub, itch.io, and the official RPG Maker forums. Search for "RPG Maker MZ custom menu plugin" or "add menu command plugin" and you will find options.

A popular choice is VisuStella's MenuCore plugin, which lets you add, remove, and rearrange menu commands through the plugin settings in the editor, with no code required. You read the plugin file, place it in your js/plugins folder, add it to your project through the Plugin Manager (in the Tools menu), and then configure it in the plugin settings panel. The settings show checkboxes for which commands to display and text fields for custom command names.

Another option is YEP_MainMenuManager by Yanfly, which works similarly. Both plugins let you add commands that run common events — a common event is a sequence of actions (show a message, play a sound, open a shop) that you build visually in the editor without touching code.

Writing a custom menu command in JavaScript

If you want to write your own code, the process has three steps: add the command to the list, add a handler that runs when the player selects it, and add the window or scene that appears when the handler runs.

Open your project's js/plugins folder and create a new file called CustomMenu.js. At the top, write a comment block that tells RPG Maker what this plugin does:

/*: * @target MZ * @plugindesc Adds a custom command to the main menu. * @author YourName * * @help * This plugin adds a "Crafting" command to the main menu. * * @param commandName * @text Command Name * @desc The text shown in the menu. * @default Crafting */

Next, add the code that modifies the menu command window. You will hook into the makeCommandList function, which is where the default commands are created:

const _Window_MenuCommand_makeCommandList = Window_MenuCommand.prototype.makeCommandList; Window_MenuCommand.prototype.makeCommandList = function() { _Window_MenuCommand_makeCommandList.call(this); this.addCommand("Crafting", "crafting", true); };

This code saves the original makeCommandList function, then replaces it with a new version that calls the original (so you keep all the default commands) and then adds your new command. The addCommand function takes three arguments: the text shown ("Crafting"), the symbol used internally ("crafting"), and whether it is enabled (true means the player can select it).

Now add a handler that runs when the player selects your command:

const _Scene_Menu_createCommandWindow = Scene_Menu.prototype.createCommandWindow; Scene_Menu.prototype.createCommandWindow = function() { _Scene_Menu_createCommandWindow.call(this); this._commandWindow.setHandler("crafting", this.commandCrafting.bind(this)); }; Scene_Menu.prototype.commandCrafting = function() { SceneManager.push(Scene_Crafting); };

This adds a handler called commandCrafting that pushes a new scene (Scene_Crafting) onto the scene stack. "Push" means the new scene opens on top of the menu, and when the player closes it, they return to the menu.

Finally, you need to create the Scene_Crafting class that the handler calls. This is a new window or scene that appears when the player selects your command. For a straightforward example, you could create a scene that shows a message:

function Scene_Crafting() { this.initialize(...arguments); } Scene_Crafting.prototype = Object.create(Scene_MenuBase.prototype); Scene_Crafting.prototype.constructor = Scene_Crafting; Scene_Crafting.prototype.create = function() { Scene_MenuBase.prototype.create.call(this); this.createWindow(); }; Scene_Crafting.prototype.createWindow = function() { const rect = this.windowAreaRect(); this._window = new Window_Base(rect); this._window.drawText("Crafting System", 0, 0, rect.width); this.addWindow(this._window); };

Once you have written the code, save the file, add it to your Plugin Manager (Tools > Plugin Manager, then add CustomMenu.js to the list), and test the game. Press F5 to run the test, open the menu, and your new command should appear.

Styling your menu with colors, fonts, and layouts

After you have the command working, you can change how it looks. RPG Maker MZ uses a system of colors defined in the database. Open the System tab in the database editor and scroll to Colors. Each color has a number (0 through 31). You can assign colors to text, backgrounds, and borders.

To change the color of your command text, modify the addCommand line to include a color index:

this.addCommand("Crafting", "crafting", true, null, 3);

The last argument (3) is the color index. Color 3 is typically yellow in the default palette. You can also change fonts by editing the Window_Base.prototype.resetTextColor or by creating a custom window class that overrides the text drawing functions.

For layout changes, you can modify the window positions and sizes by editing the windowAreaRect() function in Scene_Menu, or by creating custom window classes with different dimensions. If you want the menu to appear on the right side instead of the left, you would change the x position of the command window in createCommandWindow.

Testing and debugging your custom menu

After you make changes, always test them in the editor. Press F5 to launch the test game, navigate to the menu, and check that your command appears, is selectable, and runs the correct action. If something does not work, check the browser console for error messages. In most browsers, you can open the console by pressing F12, then clicking the Console tab.

Common errors include typos in function names, missing semicolons, or handlers that reference scenes or windows that do not exist. If your command does not appear, check that you added it to the Plugin Manager and that the plugin file is in the js/plugins folder. If the command appears but does not do anything when selected, check that the handler function name matches the symbol you used in addCommand.

If you are using a plugin from another creator, check the plugin's documentation or comments at the top of the file. Most plugins include instructions for how to use them and what parameters you can change. If the plugin conflicts with another plugin, try changing the order in the Plugin Manager — plugins run in the order they appear in the list, and later plugins can override earlier ones.

Using existing plugins instead of building from scratch

For most games, using an existing plugin is faster and more reliable than writing your own menu code. The RPG Maker community has created plugins for nearly every menu feature you might want: custom layouts, animated menus, menus that show character portraits, menus with tabs, menus that hide certain commands based on story progress.

Start by searching the RPG Maker forums or GitHub for plugins that match what you need. Read the documentation and look at the plugin parameters to see if it does what you want. read the plugin, place it in js/plugins, add it to the Plugin Manager, and configure the settings. Test the game to make sure it works with your other plugins.

If you find a plugin that is close but not exactly what you need, you can often modify it. Open the plugin file in a text editor, find the section that controls the behavior you want to change, and edit it. Keep a backup of the original file in case you need to revert. Many plugin creators include comments explaining what each section does, which makes it easier to find what to change.

Frequently Asked Questions

Can I have multiple custom menus for different parts of the game?

Yes. You can create different Scene_Menu classes for different situations — for example, a battle menu that appears during combat and a town menu that appears in towns. Use conditional logic in your game to push the correct menu scene based on the current game state. You can check variables, switches, or the current map to decide which menu to show.

What if my custom menu command does not appear?

Check three things: the plugin file is in the js/plugins folder, the plugin is added to the Plugin Manager and enabled (not commented out), and the plugin file has no syntax errors. Open the browser console (F12) while running the test game and look for red error messages. If you see an error, it will tell you which line has the problem.

Can I remove commands from the default menu?

Yes. In a plugin or custom code, you can override the makeCommandList function and only add the commands you want. For example, if you do not want a Save command, straightforward do not call addCommand for it. Many existing plugins let you toggle commands on and off through the plugin settings.

How do I make my menu match my game's visual style?

Use custom window skins (the image files that define how windows look), change the text colors and fonts through the database, and adjust window positions and sizes in your code. You can also create custom window classes that draw graphics directly instead of using the default window frame. Look for tutorials on window skins and custom graphics in the RPG Maker community.

Do I need to know JavaScript to create a custom menu?

Not if you use a plugin that handles it for you. Many plugins let you add and configure menu commands through the plugin settings in the editor, with no code required. If you want to write your own code, learning basic JavaScript will help, but you can also start by copying and modifying existing plugin code.