Interface Guide

When a project is open, the standalone Git button opens Git integration for changes, commit history, file comparisons, and branch operations.

Every menu item now shows a small icon next to its label so you can spot commands faster. The menus, left to right, are File, Edit, View, Map, Tools, Mods, Help.

File: Open Project, Open Recent (recently opened projects, plus Clear Recent Projects), Close Project (returns to the Welcome page), Open Project Folder (opens your project’s folder in Windows Explorer / Finder / your file manager — handy for dropping in graphics or checking what the editor wrote), Open Saves Folder (opens the folder the game writes its save files to — see Map Management), Save, Save All, Create Project File… (creates a .mkst file; legacy .makerstudio files remain supported), Run Game, Clear Proton Preference (Linux only — forgets your remembered Proton/Wine launch choice so the picker dialog shows again next time you press Run; it is only listed when there is such a choice to forget)
Edit: Undo, Redo, Cut, Copy, Paste, Advanced Clipboard (Copy All Layers, Cut All Layers, Paste in Selected Layers, Cross-Project Clipboard toggle — see below), Select All, Deselect, Shadows (Generate from Selection, Delete All Shadows)
- Cross-Project Clipboard is off by default. When ticked, copying tiles, events, or event commands also places them on your system clipboard so a second open Maker Studio window can paste them. Turn it on in each window you want to share between. (Deleting a tile selection still works with the Delete key; only the old menu entry was replaced by this toggle.)
View: Panels submenu (Maps, Tile Palette, Layers, Tile Properties, Tile Info, Events, Minimap — clicking an entry focuses that panel, bringing it to the front or reopening it as a floating window if closed; it never closes a panel, and the checkmark still shows which panels are open), Show Grid, Show Collision, Show Events, Show Event Cells (see below), Create Events on Double-Click (see below), Dim Inactive Layers, Show MS-Exclusive Indicators (see below), Zoom In/Out/100%, Dark Mode, Language submenu (see below), Layout submenu (Refresh Layout, Import/Export Configuration)
- Create Events on Double-Click is on by default, matching RPG Maker: with the Brush on the Events layer, clicking an empty tile selects it and a double-click creates the event there. Turn it off if you would rather have a single click create the event straight away.
- Show Event Cells is off by default. Events with no graphic always show a marker box on their tile; with this on, events that do have a graphic are outlined too — a thin border around their cell plus a small corner square — so you can tell exactly which tile every event sits on without hiding its sprite. It is greyed out while Show Events is off. Your choice is remembered across sessions.
Map: New Map, Duplicate Map, Map Versions…, Resize / Shift Map, Change Tileset, Change Battleback…, Map Audio…, Import Map from JSON, Export Map submenu (Export as JSON / PNG / GIF / WebP)
Tools: Tool selection (Brush/Eraser/Magic Eraser/Fill/Rectangle/Eyedropper/Select/Wand/Pan), Rotate CW/CCW, Flip Horizontal/Vertical, Brush Editor…, Database, Scripts
Mods: Mod Manager (+ any mod-contributed menu items and panels)
Help: Settings… (see Settings), Documentation (opens this online documentation in your browser), Keyboard Shortcuts, Reset App (reloads Maker Studio to the Welcome page — your panel layout is kept; Ctrl+R), Show Application Warnings Again submenu (re-enable all application warnings, or choose large tileset, game integration, or Proton prompts individually), Check for Updates (shows the version you are running next to the newest published one), Stats, About Maker Studio, Toggle Render Diagnostics (temporary map overlay with render timings; select it again to close), Toggle DevTools
- Re-enable All Application Warnings resets all three categories. The submenu also offers Re-enable Large Tileset Warnings, Re-enable Game Integration Prompts, and Re-enable Proton Launch Choice separately; all apply across projects. Mods → Show Dependency Warnings Again remains separate and only controls mod dependency warnings. File → Clear Proton Preference still clears the saved choice for the open project.

Language

The interface is available in English and Español, and installed mods can add more languages — any language a mod provides appears in the same menu automatically (if the mod that provides your chosen language is disabled, the editor falls back to its default language and switches back when the mod returns). Switch under View → Language — the change applies immediately and is remembered across sessions. On first launch the editor picks your system language (Spanish systems start in Español; everything else defaults to English). The whole interface is translated — menus, panels, dialogs, the event editor and its command forms, the simulator, and notifications. A few technical terms stay in English on purpose (for example tile, tileset, autotile, script, mod, and audio kinds like BGM/SE) so they match RPG Maker and the modding API.

MS-Exclusive Feature Indicators

Some editor features go beyond what stock RPG Maker XP supports — they only work in the running game if your project has the MakerStudio plugin installed (the integration that ships with the editor). A tiny MS badge marks those features throughout the interface so you always know which ones depend on the plugin. Hover a badge for a reminder of why — most say “Maker Studio exclusive — requires the MakerStudio plugin in-game”, while some explain their specific reason.

You will see the badge on, for example:

Menu items such as Edit → Shadows and Map → Map Versions… (also on the matching Map Tree right-click entries).
Map → Change Battleback… — the battleback is stored on the map (not on its tileset), and the plugin is what applies it in-game, so this item and the version submenu’s “(this version)” entry both carry the badge. (Panoramas are no longer changed from a menu — they are edited as the Panorama Layers group in the Layer panel; see the Layers Guide.)
Layer panel rows for the fog/panorama layer groups (and any mod-added groups), shadow groups, and extra (non-native) tile layers.
The Autotiles section of the Tile Palette — Maker Studio uses its own autotile system that is not tied to a map’s tileset, so all painted autotiles need the plugin in-game (the badge’s tooltip says so). Also a small badge over the tileset search box while you are browsing a tileset other than the map’s own (cross-tileset painting).
The Tile Properties panel header, and plugin-dependent event command forms (Change Map Settings when its type is set to Fog or Panorama, fog color/opacity, the move-route Set Frame section). In tight spots — like the Sheet Cols/Rows fields in the graphic picker — the badge appears as a small dot instead.

If you use these features in a game that does not have the plugin, the game simply ignores them (or they are unavailable) at runtime — your maps still load fine in stock RPG Maker XP.

The badges are on by default. Hide or show them with View → Show MS-Exclusive Indicators; your choice is remembered across sessions.

The toolbar sits at the top of the window and provides quick access to common actions:

Left to right, the toolbar groups are:

Save, Run — Save writes the current map (Shift+Click saves every open map); Run launches the game (on Linux, Shift+Click lets you choose the Proton/Wine prefix or, if available, a native Linux build). (Creating a new map now lives in the Maps panel header — see Map Tree below.)
Saves — appears after the first Run; opens the folder where the game stores its save files. On Windows this is the native saves folder; on macOS and Linux it is the folder inside the Wine/Proton prefix the game ran in, or — after a native Linux build run — the game’s own Linux save folder. See Running the Game.
Sim Map — opens the Game Simulator on the current map with player input enabled.
Tools — drawing tools appear as same-width buttons with centered icons. Select/Wand and Eraser/Magic Eraser each share a button that keeps the selected tool’s icon; a bordered chevron sits beside the icon to show that more tools are available. Hover to open a styled menu with each option’s icon, name, and shortcut. The Brush also shows a bordered chevron for its options. Size and other options appear beside the active tool. Continuous appears only for Fill, Wand, and Magic Eraser.
Brush tool — its popover has a quick brush switcher (saved Custom Shape Brush presets plus Default/Custom) and a Brush Editor… opener. The active tool’s size control is shown beside the tools. When a custom brush is active, a compact indicator next to the tools shows the brush’s name with a ✕ to clear it. See Custom Shape Brush.
Zoom — shows the current zoom percentage; hover to reveal zoom in/out controls.
Database / Scripts — open the Database window and the Scripts editor. (Also available under the Tools menu.) Switches, Variables, and Tilesets no longer have their own toolbar buttons — they are now tabs inside the Database (where you can still rename entries inline, add more slots, and edit tilesets).
Versions — shows the current map version as a badge (e.g. V2/3) and opens the Version Manager. Relevant once a map has extra versions.
Grid / Col / Dim — icon + text toggle buttons for Show Grid, Show Collision, and Dim Inactive Layers.
Theme — sun/moon toggle switch. Thumb left = light mode (☀ visible on the right); thumb right = dark mode (☾ visible on the left). Your choice is remembered across sessions. (Themes and individual colours live in Help → Settings… → Appearance, below.)
Refresh Layout — available under View then Layout (restores the default panel arrangement).

If the window is too narrow to show every toolbar group at once, the groups that don’t fit collapse into a ”…” (More) button at the right end of the toolbar. Click it to reveal the hidden groups in a dropdown. Widening the window brings them back into the toolbar automatically.

Map Tree (left panel)

The Map Tree shows a hierarchical view of every map in your project. The panel header has a + button that creates a new blank map. You can:

Double-click a map name to rename it.
Right-click for a context menu: Open, Rename, Change Tileset, Resize/Shift, Delete.
Use Ctrl+click to toggle map rows or Shift+click to select a visible range. Drag a selected row to move all selected roots and their descendants together while preserving order.
Delete selected maps with Delete or the context menu. If maps have descendants, choose to promote them into the deleted maps’ positions or delete the subtrees too. The confirmation warns about open maps with unsaved changes, and deleted map files are backed up.
Click the arrow next to a map that has children to fold it away. Folded folders stay folded the next time you open the project, and the map you were last editing reopens with it — see Opening Maps.

Tab Bar

Each open map gets its own tab along the top of the editor area.

A dot indicator means the map has unsaved changes.
Italic text means it is a preview tab that auto-closes when you open another map.
Double-click a preview tab to make it permanent.
Right-click a tab to pin/unpin it or use the close actions. Pinned tabs show a pin and stay at the beginning of the tab bar; drag to reorder within the pinned or regular group. Pinning a preview makes it permanent.
The context menu can close the clicked tab, other tabs, tabs to its right, saved tabs, or all regular tabs. Group actions leave pinned tabs open; close the clicked tab directly to close a pinned one.
Click the x button or middle-click a tab to close it.
Drag a tab to reorder it. A line marks where it will land, and the tab drops into that slot.
When you reopen a project, every map you had open comes back, with pinned tabs restored, and the map you were last editing becomes the active one. An intentionally empty tab bar remains empty. (Opening a map file directly — by double-clicking it in your file manager — still opens just that one map.) This is remembered per project, on this computer only.

Status Bar (bottom)

The status bar displays useful context at a glance: cursor coordinates (X, Y), the event name under your cursor, the current tool, brush size, the active layer’s name, zoom level, and whether undo history is available.

On very large or animation-heavy maps, autotile animation may slow to 2 or 1 updates per second at intermediate zooms to keep the editor responsive. It remains at 4 updates per second at 10% zoom or lower and at 200% or higher. If direct tile drawing or rebuilding the cached image takes more than 20ms, animation pauses until a later render takes 10ms or less; the status bar then shows ”⏸ Animations paused (performance)”. Panning, painting, and zooming remain available. (Animations also pause, without the indicator, while a dialog is open or the simulator is running.)

When you draw a map whose tileset image is taller than 16,064 pixels, a dialog shows the tileset name and height. Choose View Tileset to open that record in Database → Tilesets. Don’t show this warning again silences these dialogs across projects until you re-enable Help → Show Application Warnings Again → Re-enable Large Tileset Warnings. If several maps trigger the warning, their dialogs appear one at a time.

Choose Help → Toggle Render Diagnostics to see repaint frequency, atlas dimensions, and JavaScript render timings. The timings do not include macOS graphics/compositor work.

Dockable Panels

Every panel in the editor can be dragged, floated as a separate window, and rearranged to suit your workflow. If you ever want to start fresh, use View → Layout → Refresh Layout to restore the default arrangement. (To just reload the editor while keeping your layout, use Help → Reset App / Ctrl+R.)

Detach a panel: right-click a tab or empty header area and pick Detach to floating window. The panel pops out as a draggable, resizable floating window inside the editor.
Floating windows stay on-screen: if a floating panel is dragged or resized past the editor bounds, it auto-snaps back inside on release.
Reattach: drag the floating window’s tab back onto a dock zone, or close the panel.
Focus from the menu: View → Panels brings a panel to the front (or reopens it floating if you closed it) — it never closes panels.

Resizing dialogs

Every dialog window — Event Editor, Database, Tileset Editor, the pickers, all of them — can be resized by dragging any edge or corner, and moved by dragging its title bar. Clicking the dimmed area outside a dialog closes it, but a click that just misses an edge counts as a resize grab, not a dismiss. Esc closes the top-most dialog only, so closing a picker opened on top of the Event Editor no longer closes the editor underneath it.

Number fields

Every numeric field in the editor — map sizes, brush values, animation frames, simulator settings — can be emptied while you type. Select the contents and delete them, type the number you want, and it is applied when you leave the field (or press Tab/Enter). Minimums and maximums are applied at that point too, so typing “160” into a field whose minimum is 160 no longer fights you at the first digit. An empty field left as-is falls back to that field’s minimum.

Mod panels and layouts

Panels added by mods keep their place in your layout. If a mod is disabled, uninstalled, or reloading, its panel slot stays where you docked it and shows a placeholder (“Panel provided by mod … — not loaded”) until the mod is back; close the placeholder if you don’t want to keep the slot. Exported layout configurations (View → Layout → Export Configuration) also record which mods provided which panels — importing a layout that uses panels from mods you don’t have installed warns you with the list of missing mods and keeps those panels as placeholders. Older exported configurations still import fine.

Minimap

Bottom-right panel. Shows a scaled view of the entire map (all native + extended layers + shadows) with a yellow viewport rectangle. Click or drag to recenter the main canvas.

Events display: when View → Events is on, events render on the minimap with their active-page graphic (character or tile). Events with no graphic on any page are hidden so the minimap stays clean.

Settings (Help → Settings…)

Editor-wide preferences, separate from anything stored in your project. They are split across four tabs: Editor (how the Maker Studio window itself opens), Appearance (theme and colours), Game (where the game window opens), and Supporter (your licence and the extras it unlocks).

Changes are only kept when you press Save. If you close the dialog with unsaved changes — Cancel, the ×, Esc, or a click outside — Maker Studio asks first and offers Discard or Save & Close. Discarding also puts the theme and Dark Mode back the way they were, so trying a theme out and changing your mind costs nothing.

Editor tab

Window size at startup — leave it at the default (1400 × 900, centred), remember the size and position from last time, always open maximized or fullscreen, or give it an exact size.

Which monitor — the one Maker Studio is launched from (in practice, the screen your pointer is on), the one it was closed on last time, or always a specific one. Screens are listed by number and resolution, and remembered by name: if that screen isn’t connected the window falls back to the one it was launched from instead of opening off in the dark.

A specific size can’t go below 1280 × 720 — that’s the smallest the window can be.

Both apply the next time Maker Studio starts.

Show my activity in Discord — on by default. While it is on and the Discord app is running, your Discord status shows the project and the map you have open. This activity is available during the Free Trial; a Supporter licence adds a small badge. This replaces the Discord Rich Presence example mod; if you had it installed, disable it, as the two overwrite each other.

Appearance tab

Theme — Default (Maker Studio’s own look) or any theme added by an installed mod. The same list is in View → Theme; this tab just puts it next to the colours.

Dark mode — the same switch as the toolbar’s sun/moon toggle. A theme that only comes in one shade locks it, and the tab says so.

Colours — every colour the editor uses, grouped by what it paints: Surfaces (backgrounds, panels, borders), Text, Accent, Status (danger/warning/success), Map canvas, Event commands (the colour coding of the command list in the event editor), Script editor (Ruby syntax highlighting) and Individual commands (one row per event command).

RPG Maker XP palette, the button under Individual commands, fills every command with the classic RPG Maker XP ink — navy branches, teal variables, green comments, maroon battle commands. It dresses light and dark mode in one press (same colours, brightened so they read on a dark panel), and everything it writes is an ordinary colour you can then change or revert row by row.
Event commands sets one colour per kind of command (all conditionals, all audio commands…), and Individual commands below it holds one row for every single command — Show Text, Conditional Branch, Play SE and the rest. A row you never touch shows the colour it inherits from its category, so changing the category still moves them all; change one row and that command alone leaves the group.
Click a swatch to pick a colour, or type a value in the field beside it — the field takes anything CSS understands, including rgba(...) if you want something semi-transparent. (The swatch picker itself has no transparency slider, which is why the text field is there.)
The circular arrow at the end of a row puts that one colour back to the theme’s; Reset N changes at the top puts them all back. The filter box narrows the list when you know roughly what you’re after.
Colours are saved per theme and per light/dark mode. Recolouring the dark theme leaves the light one alone, and each mod theme keeps its own set — switch away and back and your edits are still there. The header above the list tells you which combination you are editing.
Your colours are stored on this computer, not in your project, so they follow you between projects and never end up in your game.

Game tab

Game names — the only two settings here that belong to the project, not to the editor, so they change with the project you have open and Restore defaults leaves them alone.

Save folder name — the game’s title in Game.ini. RPG Maker creates the saved-games folder from it (%AppData%\<name> on Windows), which is the folder the toolbar’s Saves button opens. Changing it means the saves are stored somewhere else from then on. It cannot be empty or contain \ / : * ? " < > |, since it has to work as a folder name.
Window title — the windowTitle in mkxp.json, the caption of the game’s own window. Purely cosmetic; it has no effect on saves, and unlike the name above it may contain anything, including accents. The field is greyed out with “(no mkxp.json in this project)” when the project doesn’t ship one.

Both are written straight into Game.ini / mkxp.json when you press Save, leaving the rest of those files — comments included — exactly as they were. They apply at your next Run.

Which monitor the game opens on (Windows only) — The same one as the editor (the default) puts the game on whichever screen the Maker Studio window is on when you press Run. Left to itself RPG Maker always centres the game on your primary screen, wherever you happen to be working, which is what this setting exists to fix. Pick Always this monitor instead to pin it to one screen no matter where the editor is. Unlike the two settings above, this one applies at your next Run Game, not at the next start. If the screen you picked isn’t connected, the game is left where it opened.

RPG Maker moves its own window back to the primary screen while the game is booting, so Maker Studio keeps putting it back for the first ~20 seconds. On a slow-loading project you may see the window jump between screens once or twice before it settles — that is the two fighting, and Maker Studio wins as long as the game finishes booting inside that window.

On macOS and Linux the setting is shown but greyed out, and says so: there the game runs through Wine or Proton, which owns its window, so the editor can’t place it.

Supporter tab

Features such as connecting an AI client through the MCP server need a licence. Without one, the tab has the activation box: paste your License key and press Activate, or use Start 7-day free trial / Buy lifetime license. Below it, What you get as a supporter lists every feature with its description and access state. Free Trial and Supporter include all common features, including MCP, window icon, coloured title bar, welcome screen personalization and Favorite projects. Supporter also includes the Supporter title and badges, the Discord badge and the Discord role. Supporter may receive selected new features before they become available to everyone.

During the trial, the top of the tab shows Free Trial, the days remaining and the trial end date. A paid licence shows a Supporter badge and your plan with its expiry date (or Perpetual) beside it. The lease email appears for both trial and paid licences, masked by default as its first character before @, five asterisks, then @domain; use the eye button beside it to show or hide the full address. The date is the licence’s expiry, not the short lease refresh date. Deactivate this computer frees the activation so you can use the key on another machine; the number of computers per key is limited.

Activation needs an Internet connection once. After that the licence renews itself in the background, and supporter features keep working offline for up to a week between renewals. If it cannot renew in time, connect to the Internet and reopen this tab.

Below the status, a compact vertical feature list keeps every feature visible, including features not in your licence. Select an entry to see its explanation and settings in the panel beside it; each entry shows whether it is Included in this license, No access to this feature, or Temporarily unavailable. Included states are green, missing access is red, partial access is amber, and unavailable states stay muted. The Up and Down arrow keys move between entries. Discord shows separate access states for the server role and the Supporter badge in Discord Rich Presence. Login and role controls appear only when your licence includes the Discord role feature. Supporter title and badges share one entry, with each access state shown separately; this same order appears in the no-license benefits list. Every selected feature panel uses the same heading, description and access card before its controls; features with multiple entitlements also show each entitlement’s state. The list and panel scroll independently when their content exceeds the available height.

Discord — adds the Supporter role on the Maker Studio Discord server; supporters get priority when asking for help there. Link Discord account opens your browser to sign in with Discord when your licence includes the Discord role feature; otherwise the tab shows its access state and no login control. Once linked, the panel shows your Discord name and whether you are In the server (or Join the server) and have the Supporter role (or Get the role); the refresh button checks again. One Discord account per licence: to use another, press Unlink first (this also removes the role). The role is also removed if the licence is revoked or expires.
Welcome screen — untick Use the personalized welcome screen to go back to the standard welcome screen. Choose background… puts a picture behind the welcome screen (the one with Open Game Folder and your recent projects); Background dim darkens it so the text stays readable and Blur softens it. Remove takes it away. The preview above the buttons shows the result as you drag the sliders, or No background when none is set.
Window icon — pick one of the variants (Maker Studio, in your theme’s accent colours, then Gold, Emerald, Sapphire, Ruby, Amethyst, Frost), or Choose image… to use any picture of your own; Reset goes back to the standard icon. It changes the icon of the window and the taskbar at once, and the welcome screen shows it too.
Coloured title bar — Colour the title bar with the theme (Windows 11) makes the window’s own title bar take the panel colour of your current theme and follow it when you switch themes or light/dark mode.
Supporter title and badges — adds Supporter to the Maker Studio window title and welcome screen, and shows a badge on the welcome screen and About dialog.
Favorite projects — star projects from the personalized welcome screen, drag them by the six-dot handle to reorder them, and launch them from Windows taskbar and Start, the Linux app menu, or the macOS Dock. Both Free Trial and Supporter licences include this feature.
MCP server — works with local AI apps that support stdio MCP servers. The panel shows the Current project (or No project open) and offers a one-time user-scope setup command for Codex or Claude Code, plus JSON config for other local stdio clients. Run the copied command for Codex or Claude Code; paste the JSON into another client’s user-level MCP settings. Active-project mode requires an open project, follows the focused Maker Studio window and includes unsaved map edits; switch focus to another Maker Studio window to target its project. Fixed --project <game-dir> mode remains available to pin a project and edit its files while Maker Studio is closed. The Free Trial can use the personalized welcome screen and, when projects are available, its Continue, Recent and Most Used launcher. The classic welcome screen keeps its original side-by-side Recent and Most Used columns and does not show tabs or favorite controls. The Favorite projects feature is included in both Free Trial and Supporter licences: star projects into a separate Favorites list from the personalized welcome screen, drag them by the six-dot handle to reorder, and launch them from the Windows Jump List (right-click the Maker Studio taskbar icon or its Start menu entry), Linux app actions, or macOS Dock menu. On Windows, each favorite uses the project’s launcher icon when available. Enable Show recently opened items in Start, Jump Lists, and File Explorer under Settings → Personalization → Start for favorite shortcuts to appear. The paid Supporter features add the Maker Studio Supporter title and badges in the welcome screen, About and Discord status.