File format — data/SimpleVisual.json

Format version 1. A file without "version" is treated as v0 and migrated. Missing properties keep the standard value.

Root

{
  "version": 1,
  "baseResolution": { "width": 816, "height": 624 },
  "theme": "default",
  "themes": { },
  "scenes": { },
  "menuCommands": [ ],
  "presets": { }
}

Keys starting with _, comment and extends are never reported as unknown.

Sizes and positions

anchor: top-left (default), top, top-right, left, center, right, bottom-left, bottom, bottom-right. x / y are offsets from the anchor point.

Expressions

Numeric properties (x, y, width, height, rotation, opacity, picture settings, particle numbers) accept expressions of MF.Units (MF_Core 1.1.0). No eval.

• Operators: + - * / ^ ( ), % of the container, < > <= >= == != (1 / 0), && || !, cond ? a : b.
• Functions: min max abs sign floor ceil round trunc sqrt pow exp log mod clamp lerp step between if hypot dist sin cos tan asin acos atan atan2 sind cosd tand atan2d angle deg rad; constants pi, e.
• Fallback after |: {actor.9.hp|100}, \V[5|0] — used when the value is missing, empty or not a number. Without it: 0 (in text — empty).
• An error (syntax, division by zero) keeps the standard value, with a console warning; the editor shows it under the field.
• Recalculated every 10 frames when inputs change; with {mouse.}, {self.}, {el.}, map tokens — every frame.

{ "id": "hpBar", "type": "shape", "x": 8, "y": 8, "height": 12, "width": "{leader.hpRate}*2", "fill": "#d04040", "radius": 6 }

Game values

Usable in text and expressions.

Map tokens

"rotation": "angle({self.centerX}, {self.centerY}, {event.3.uiX|0}, {event.3.uiY|0})"

Mouse, self, el

• {mouse.*}: x y uiX uiY left right middle pressed dragging dragX dragY dragStartX dragStartY clickX clickY clicks rightClicks wheel idle, over.<id> down.<id> relX.<id> relY.<id>.
• {self.*} — the element / window itself, {el.<id>.*} — another element: x y width height centerX centerY right bottom rotation opacity visible hover down relX relY clicks hoverTime time parentWidth parentHeight. Geometry from the previous layout pass.

Themes

"themes": {
  "default": { "windowskin": "Window", "fontFace": "rmmz-mainfont", "fontSize": 26, "backOpacity": 192, "padding": 12 },
  "dark":    { "extends": "default", "label": "Dark", "backOpacity": 230 }
}

Style properties: windowskin fontFace fontSize opacity backOpacity contentsOpacity padding + text style, extends, label (name shown to the player). Applied to all windows of a scene; window properties override it.

Scenes and inheritance

"Scene_Menu": {
  "theme": "dark",
  "windows":  { "_goldWindow": { "visible": false } },
  "sprites":  { },
  "elements": [ ]
}

The key is the class name; layouts of parent classes are inherited and more specific classes override them: Scene_MenuBase → all menus, Scene_File → Scene_Save / Scene_Load, Scene_Message → Scene_Map / Scene_Battle. Elements with the same id in a child class override inherited ones.

Windows

Key — scene field name (_commandWindow).

Windows of scenes

Text style and fonts

Windows, text elements and themes: textColor (palette index 0–31 or "#rrggbb"), outlineColor, outlineWidth, fontBold, fontItalic.

fontFace: a family (rmmz-mainfont) or a file in fonts/ ("PixelFont.ttf"; ttf, otf, woff, woff2) — loaded at startup.

Rows and commands of standard windows

"_statusWindow": {
  "rowHeight": 120,
  "template": [
    { "type": "face", "anchor": "top-left", "width": 100, "height": "100%-2" },
    { "type": "text", "text": "{name}  Lv {level}", "anchor": "top-left", "x": 110 },
    { "type": "actorGauge", "stat": "hp", "anchor": "top-left", "x": 110, "y": 40 }
  ]
},
"_commandWindow": {
  "commands": {
    "item": { "icon": 176 }, "formation": { "visible": false }, "gameEnd": { "order": 0, "text": "Quit" },
    "status": { "action": { "type": "custom", "id": "Custom_Party" }, "enabled": { "switch": 3 } }
  }
}

template replaces the standard drawing (see row templates). Row data: Window_MenuStatus / Window_BattleStatus — actor fields; Window_ItemList — item + count; Window_SkillList — skill + mpCost tpCost; Window_Command — name symbol index status iconIndex.

commands (Window_Command only): key — symbol or #<index>; text visible order icon align color background action enabled.

• action — an action (or a list) run instead of the command's own handler, like a button. Works in any command window: title, main menu, options, shop…
• enabled — condition; false greys the command out.

Editor: select the window › Edit commands. In the main menu, + item adds an own command (menuCommands); own commands can be deleted, standard ones hidden.

Sprites

scenes.<X>.sprites.<field>: _backSprite1 _backSprite2 _gameTitleSprite (title), _backgroundSprite (menus), _cancelButton (battle), _menuButton (map).

Properties: x y (percent of Graphics.width/height), scaleX scaleY opacity visible image; title: titleText titleFontFace titleFontSize titleColor titleOutlineColor titleOutlineWidth.

Resolution

"scaleMode": "scale" at the root scales plain pixel x y width height written for baseResolution to the current UI area; "scaleFonts": true scales fontSize. Percentages, auto and expressions are unchanged. Scaling is off in the editor.

Compatibility

• scenes.<X>.skip: true or parameter skipScenes — scene and its child classes stay standard.
• autoCompat: scenes rebuilt by known plugins are skipped unless force: true.

Extend: MF.SimpleVisual.KNOWN_PLUGINS.MyPlugin = ["Scene_Status"] before scenes load. Presets altMenu / altSave of the demo replace AltMenuScreen / AltSaveScreen.