使い始め方

StormMin は 3 つの形態で利用できます。ビークルに貼る Lua を手元で minify するだけなら Web 版、ビルドスクリプトに組み込むなら CLI、Node/ブラウザアプリに minify 機能を組み込むならライブラリを選んでください。

Web 版
CLI
ライブラリ

インストールは不要です。

Web 版を開く

https://www.makkii.jp/tools/stormworks/stormmin/ にアクセスします。

Lua コードを貼り付ける

左側の “Original Lua” エディタに、ビークル/マイクロコントローラーの Lua コードを貼り付けます。

最短化実行を押す

右側の Output タブにある「最短化実行」を押すと、WASM 上のコンパイラがブラウザの Worker 内で minify を実行します。

出力を取得する

中央の “Optimized Lua” に結果が表示されます。右側の Output タブから Copy、Lua ファイル保存、Source Map を有効にした場合は .map 保存を利用できます。

外部AI / Agentへ現在のLua・設定・結果を渡す場合は、ヘッダーの「AIに渡す」から Markdown / JSON Handoff を作成できます。利用できるdocs MCPやCLI/npm APIは AI / Agent 連携を参照してください。

StormMin 全体が β 版のため、Web 版の画面には「β版につき、出力コードにコンパイラ起因のバグが含まれる可能性があります。ゲーム内で必ず動作確認してください。」という警告が常に表示されます。CLI やライブラリで minify した場合も同様に、ゲーム内での動作確認を必ず行ってください。

Web 版は単一ファイルの Lua コードのみに対応しています。require を使った複数モジュール構成を minify するには CLI かライブラリを使ってください。詳細は require によるモジュール分割を参照してください。

インストールする

npm から CLI をグローバルインストールします。

npm i -g @stormcat-works/stormmin

インストールせずに使う場合は npx でも実行できます。

npx @stormcat-works/stormmin input.lua -o output.lua

minify を実行する

入力ファイルを指定し、-o で出力先を指定します。

stormmin input.lua -o output.lua

標準入力/標準出力も使えます。

cat input.lua | stormmin > output.lua

結果を確認する

--json を付けると、圧縮後コードだけでなく元のサイズ・削減量・診断情報などを含む JSON が出力されます。

echo 'function onTick() output.setNumber(1,1+2) end' | stormmin --json

CLI の全オプションは CLI リファレンスを参照してください。native バイナリを直接使いたい場合は、GitHub Release から stormmin-vX.Y.Z-<target>.tar.gz（Windows は .zip）形式のアーカイブを入手できます。<target> は linux-x64 / win32-x64 / darwin-arm64 / darwin-x64 の 4 種類です。

Node.js またはブラウザから、minify 機能をコードに組み込めます。

インストールする

npm i @stormcat-works/stormmin

compile を呼び出す

import { compile } from '@stormcat-works/stormmin';

const result = await compile(source, { mode: 'smallest' });
if (!result.ok) throw new Error(result.error);
console.log(result.code);

ブラウザでは compile() はメインスレッドをブロックせず、内部で Web Worker 上に WASM をロードして実行します。Node.js では同じ WASM を同一プロセス内で同期的にロードして実行します。両者の違いはライブラリの使い方で説明しています。

パッケージが同梱するのはコンパイル済みの WASM/native バイナリのみです。StormMin のコンパイラ本体（Rust）はクローズドソースで、ソースコードは公開されていません。

次に読むもの

CLI の使い方

サブコマンド、--options の指定方法、プロジェクトモードでのビルド組み込み手順

ライブラリの使い方

compile / compileProject / analyze の呼び出し方とオプション

require によるモジュール分割

複数ファイルの Lua コードを 1 つの vehicle Lua にリンクする方法

目標サイズ探索 (OBJ-2)

8192 文字制限などの目標サイズに到達した時点で探索を打ち切る機能

はじめに

ガイド

リファレンス

FAQ・トラブルシューティング

次に読むもの

CLI の使い方

ライブラリの使い方

require によるモジュール分割

目標サイズ探索 (OBJ-2)

​次に読むもの

CLI の使い方

ライブラリの使い方

require によるモジュール分割

目標サイズ探索 (OBJ-2)

次に読むもの