Skip to main content
Playgroundは、SDK全体を小さな確認例で試すためのアプリです。Luaの実行、描画、解析・ビルド・短縮、デバッガ、Addon、値と保存、ホスト関数の接続を扱います。完全なIDEやゲーム世界のシミュレータではありません。
Playgroundを開く。SDK v0.4.0の機能をブラウザ内で確認できます。ソースはサーバーへ送信しません。

Webの操作

確認例を選び、Luaソース・環境・「SDK操作列」を確認して「最初から実行」を押します。「1操作進める」は同じセッションで1件ずつ操作し、「中断」はWorkerを終了します。 解析・ビルド・最適化だけではLuaを実行しません。loadがトップレベルを実行し、tick/drawなども別の明示操作です。ページを開く、入力を編集する、保存内容を復元する操作では、自動実行しません。 結果はSDKのレスポンスとして表示されます。描画結果はモニター、診断やエラーは結果欄に出ます。生成Luaはコピーでき、入力と操作列はversion付きJSONで書き出し・読み込みができます。

16種類の確認例

ホスト関数の固定戻り値、地図の単色画像、HTTPの手入力返信は、選択したテスト入力です。未提供の機能が実ゲームと同じように動くよう装うものではなく、実ネットワークへのプロキシもありません。

Source Mapの検査

「Source Map / 最適化を説明する」を実行し、生成物のマップを開きます。原文か生成Luaの範囲を選んで調べると、対応候補・精度・理由・関連元・inline文脈・除去記録を表示します。原文は生成時のsnapshotであり、その後編集した入力とは区別されます。 「元ファイルへ戻る」は通常/LifeBoatの複数module、「停止・ログ・エラー」は実SDKの実行位置を確認する例です。マップ閲覧だけではLuaを実行せず、「生成物をVMへロード」が必要です。実行時に生成行しか分からない場合は列を推測せず、複数候補を表示します。 コード、map、その組の成果物JSONを保存できます。取り込んだ成果物はSDKで検証し、異なるコードのmapや破損データを拒否します。マップには原文全文や固定化された設定を含むため、共有するファイルの内容を確認してください。 v0.4.0で生成するmapの拡張情報はschema 2です。schema 1のmapは読み込めないため、旧版で保存した生成物は元ソースと設定から再生成してください。成果物JSONのversion:1とmap内のx_storm.schemaVersion:2は別の形式版です。0.4への移行も参照してください。

操作列を変更する

操作列の{"$source":true}はソース欄、{"$environment":true}は環境の選択を参照します。操作にasを付けて結果へ名前を付け、{"$ref":"compiled.code"}で後続のloadへ渡せます。公開APIを試す薄い接続処理であり、独自のLua最適化器や描画式を含みません。

CLI

EngineリポジトリでSDKをビルドし、appの依存を導入した後、npm --prefix app run cli -- --listで例を一覧できます。npm --prefix app run cli -- --recipe vehicleで実行し、--project FILEでWebから書き出したケースを実行します。 --jsonlは標準入力の1行につき1操作を同じセッションへ渡します。単一ファイルにはminify FILE、run FILEもあり、minify FILE --source-mapで理由付きmapを取得できます。map-inspect ARTIFACT_FILE GENERATED_BYTEは保存した生成物の詳細を調べます。拡張環境には--extendedを明示します。ヘルプは--helpです。

保存と注意点

同じ端末では入力・選択・生成物・直近の結果・最新モニターをIndexedDBから復元できます。生成物と選択を含むworkspace JSONで、別端末へ移せます。ただしLua VMのメモリや停止位置を保存したものではありません。リロード後に実行する場合は、明示的にやり直してください。 旧localStorage形式の端末保存は自動変換せず、元データの救出と明示的なimportを案内します。入力project JSON v1は継続して読めます。不正なJSONや未対応versionをimportしても、現在の入力を破棄しません。古いAddon Lab形式は自動変換せず、未対応として返します。保存に失敗した場合は警告を表示し、JSONへの書き出しを利用できます。秘密情報や実サービスの認証情報を保存する機能はありません。 SDKの使い分けとStormMinも参照してください。