mf-docs

Changelog — MF_SimpleVisual / MF_SimpleVisualEditor

Формат: Keep a Changelog, версии — semver. Правила — как у MF_Core (docs/MF_Core/CHANGELOG.md).

Правила

Каждое изменение публичного API и формата data/SimpleVisual.json записывается сюда в том же коммите.

Метка Значение Где допустимо
Added Новое API / свойство / тип действия / тип элемента MINOR
Changed Совместимое изменение поведения MINOR
Deprecated Старое имя работает, перенаправляется на новое, одно предупреждение; указаны since и removeIn MINOR
Removed ⚠ BREAKING Удаление того, что было Deprecated MAJOR (до 1.0.0 — только в 1.0.0)
Breaking ⚠ BREAKING Несовместимое изменение MAJOR
Experimental change Изменение API с пометкой [experimental] MINOR
Fixed Исправление без изменения API PATCH

Стабильное API: reload, applyScene, layoutFor, registerAction, Settings, Hud, openCustomScene, setPreset, PresetIO.exportPreset/readPreset, Deprecated, VERSION, FORMAT_VERSION, а также все свойства файла, действия и типы элементов из документации. Остальные члены MF.SimpleVisual (LayoutStore, WindowPatcher, ElementFactory, Template, Dyn…) — [experimental], их использует редактор.

Жизненный цикл устаревшего

  1. Замена (MINOR): добавлено новое имя, старое работает через MF.SimpleVisual.Deprecated:
    Deprecated.method(MF.SimpleVisual, "oldName", { since: "0.9.0", removeIn: "1.0.0", replacement: "MF.SimpleVisual.newName", fn: MF.SimpleVisual.newName });
    Deprecated.renameProp("element", "oldKey", "newKey", { since: "0.9.0", removeIn: "1.0.0" });
    Deprecated.aliasAction("oldType", "newType", { since: "0.9.0", removeIn: "1.0.0" });
    Deprecated.aliasElementType("oldType", "newType", { since: "0.9.0", removeIn: "1.0.0" });
    

    Свойства файла переименовываются при загрузке; редактор сохраняет файл уже с новыми именами.

  2. Объявление: запись в Deprecated с since / removeIn.
  3. Удаление: только в указанной версии, запись в Removed. Всё устаревшее в 0.x живёт минимум до 1.0.0.

Формат файла ("version"): несовместимое изменение структуры поднимает FORMAT_VERSION и добавляет миграцию vN → vN+1 (MF.Migration). Файл более нового формата загружается с предупреждением.

Зависимые плагины

MF.Core.register("MF_MyPlugin", "1.0.0", { requires: { MF_Core: "1.1.0", MF_SimpleVisual: "0.8.0" } });

В @help: Requires: MF_SimpleVisual 0.8.0+ (written against 0.8.0), @base MF_SimpleVisual, @orderAfter MF_SimpleVisual.


[Unreleased]

Added

Changed

Docs

Deprecated

[0.8.0] + Editor [0.7.0] — 2026-09-23

Этап 7: совместимость и полировка. Формат файла остаётся v1. Редактор 0.7.0 требует MF_SimpleVisual 0.8.0.

Added

[0.7.0] + Editor [0.6.0] — 2026-09-23

Этап 6: боевой экран и HUD. Формат файла остаётся v1. Редактор 0.6.0 требует MF_SimpleVisual 0.7.0.

Added

[0.6.0] + Editor [0.5.0] — 2026-09-23

Картинки внутри рамки, цветокоррекция, мышь и сам объект в выражениях. Формат файла остаётся v1.

Changed

Added

Fixed

[0.5.0] + Editor [0.4.0] — 2026-09-23

Этапы 4.5 (вложенные элементы, содержимое стандартных окон) и 5 (темы и настройки игрока). Формат файла остаётся v1.

Added

Fixed

Changed

[0.4.1] + Editor [0.3.1] — 2026-09-23

Fixed

Added

[0.4.0] + Editor [0.3.0] — 2026-09-23

Этап 4: собственные меню.

Added

Fixed

Changed

[0.3.0] + Editor [0.2.0] — 2026-09-23

Этап 3: добавочные элементы.

Added

Changed

Editor [0.1.0] — 2026-09-23

Этап 2: js/plugins/MF_SimpleVisualEditor.js, требует MF_Core 1.0.0+ и MF_SimpleVisual 0.2.0+. Работает только в тест-режиме.

Added

[0.2.0] — 2026-09-23

Changed

Added

[0.1.0] — 2026-09-23

Первый выпуск runtime (этап 1). Переименование проекта: UIEditor → SimpleVisual (MF_UIEditor → MF_SimpleVisual, data/UILayouts.json → data/SimpleVisual.json, $dataUILayouts → $dataSimpleVisual, документация — docs/SimpleVisual).

Added