MSW Scripting (.mlua) — Framework + File Workflow + Playtest & Debugging
mlua is Lua-based, but it has MSW-specific annotations, a lifecycle, and an execution-space model.
General Lua knowledge alone will not produce working code. All work is done by
editing files in the workspace directly
,
and code is validated in the order
build logs → runtime logs
.
1. Core Principles (must follow)
1.1 Existing Script First
Before creating a new
.mlua
, glob/keyword-search under
./RootDesk/MyDesk/
for an existing script with the same purpose —
extending an existing file is always the first choice
. Duplicate implementations raise maintenance cost and conflict risk.
1.2 Folder Structure for New Scripts — Never Dump Files Flat
When a new
.mlua
is unavoidable, place it under a feature/category subfolder.
Required path shape
:
./RootDesk/MyDesk/
msw-scripting
安装
npx skills add https://github.com/msw-git/msw-ai-coding-plugins-official --skill msw-scripting