11. ミニゲーム（フリーモード）

1.0.3 から、ノベルゲームの選択肢からミニゲームへ進み、結果（クリア・失敗）で会話を分けられるようになりました。 制作者が自分のミニゲームを作れます。

ADV・ノベルの会話の途中で、 2D のミニゲーム （神経衰弱・3 つ並べ・反射と連打のような短い遊び）を遊ばせる方法です。 ミニゲームは システムスクリプト で作り、 シナリオ から呼び出して、結果（クリア・失敗）で会話を分けます。

11.1 しくみ

• ミニゲームは「 フリーモード 」（ Game2D.begin の 4 つ目の引数 "free" ）で作ります。決まった遊び方の無いモードで、スクリプトが置いた物（絵・文字・四角）を、イベント（押した・タイマーが鳴った・動きが終わった など）に応えて動かします。
• 毎フレームの動き（動かす・点滅・アニメ・押した所の判定・タイマー）はエンジンがします。スクリプトは「画面を作る」と「イベントに応える」だけです。
• この版で使える 2D のモードはフリーモードだけです。環境変数などの設定は要りません。作品のリリース（ReleaseBuilder で作る配布物）でもそのまま動きます。

11.2 いちばん小さな例

マスを 3 つとも押すとクリアになるミニゲームです。 data0\system\MyFree.txt として保存します。

// @lumina
function MyBuild() {
    if (Game2D.begin(1280, 720, 60, "free") == 0) { return 0; }
    Game2D.loadAtlas("cards", "data4/game2d/mg_cards");      // スプライトシート（定義は data0/game2d/mg_cards.txt）
    for (var i = 0; i < 3; i = i + 1) {
        Game2D.addSprite("c" + i, "cards:back_f", 400 + i * 240, 360, 1);   // (名前, "シート:絵", x, y, 層)
        Game2D.setSprite("c" + i, "hit", 1);                   // 押せるようにする → イベント "tap:c0" など
    }
    Game2D.addText("title", "3 枚とも押す", 40, 24, 30, "#FFFFFF", 5);
    Game2D.on("tap:*", "score 10; return");                     // このイベントが来たらスクリプトへ戻る
    Game2D.attach(5);                                           // レイヤ 5 にゲームの画面を出す
    return 1;
}
if (MyBuild() == 1) {
    GameState.set("my_lit", 0);
    while (1) {
        var ev = Game2D.run(0);                                 // イベントが来るまで遊ばせる
        if (ev.indexOf("tap:") == 0) {
            var id = ev.substring(4);
            Game2D.setSprite(id, "hit", 0);
            Game2D.tween(id, "rgb=#60E090; scale=1.12", 0.2, "out_back");
            GameState.add("my_lit", 1);                          // 数は GameState に持つ（11.7）
            if (GameState.get("my_lit") >= 3) { Game2D.setResult("clear"); break; }
        } else { Game2D.setResult(ev); break; }                  // pause・cancel など
    }
}

シナリオでは、会話の選択肢で選んだ後に呼びます（見本の mg_sample.txt も、楓の「どれから遊ぶ？」の選択肢から 3 本のどれかへ進みます）。

name 楓
	「ミニゲームで遊んでいく？」
select "遊ぶ" *play "やめておく" *next
*play
g2d_run MyFree ev
g2d_event_is "clear" *won
	だめだったね。
g2d_end
jump *next
*won
	クリア！
g2d_end
*next

ふつうのシナリオと同じく、タイトルの「はじめから」→ 会話 → 選択肢 → ミニゲーム → 会話に戻る、という流れで遊ばれます。特別な起動のしかたは要りません。

• g2d_run スクリプト 変数 は system/スクリプト を動かし、結果の番号（0 やめた・1 クリア・2 失敗・3 ほか）を変数へ入れます。返したイベントの名前は g2d_event_is で見ます。
• 終わったら g2d_end でゲームの画面を外します。
• イベントは Game2D.on を付けた物だけがスクリプトへ戻ります （ on("tap:*", "return") のように。付けなければ戻りません）。

11.3 シナリオの命令（13 個）

シナリオの変数は整数だけなので、文字の値は gs:名前 で GameState に受けて gs_if で比べます。

11.4 システムスクリプトの関数

開始・実行・結果

スプライト（置く・動かす）

指・マウス・キー

• setSprite(名前, "hit", 1) の物を押すとイベント "tap:名前" 、長押しすると "longpress:名前" 、ドラッグすると "drag:名前" 、離すと "drop:名前" 、スワイプすると "swipe:left" ・ right ・ up ・ down が出ます。スワイプを始めた物は Game2D.swipeFrom() 。
• 関数: pointerX() ・ pointerY() ・ pointerDown() ・ pointerPressed() ・ pointerReleased() ・ pointerHeld() ・ pointerCount() ・ setPointerParam(名前, 値) （判定の値 tap_move long_press swipe_min swipe_time drag_start ）。
• キー・パッド: イベント "key:up" ・ down ・ left ・ right ・ confirm ・ jump など（押した時に 1 回。上下左右は押し続けると繰り返す）。押しているかは Game2D.keyHeld("confirm") 。割り当ては getKey ・ setKey ・ keyName ・ resetKeys 、タッチ操作用のパッドの表示は setTouchPad(0 / 1) 。
• Z キー・パッドの A は 1 回で key:confirm と key:jump の両方が出ます。 両方を受けるときは、同じ時間（ Game2D.elapsed() ）の 2 つ目を捨てます（見本 MgReflex.txt の書き方）。

画面の部品・音・時間

イベント（ message:done ・ choose:名前 ・ tween:名前 ・ key:* ・タイマー）も、 on を付けた物だけが戻ります。

11.5 グリッド・リスト・表・GameState

• グリッド Grid.* （マスごとに整数を持つ表。1〜256 四方・64 個まで）: create remove has width height get set fill randomFill count findLines （縦・横に同じ値が並んだマス） removeLines lastCells collapse （落とす） rotate flood swap toText fromText setSeed 。
• リスト List.* （文字列のリスト。4,096 個まで）: create remove has size at set push pop insert removeAt indexOf shuffle move clear toText fromText setSeed 。
• グリッド・リストは ミニゲームの外（ADV の上）でも 使えます。ミニゲームが結果をグリッドやリストに残し、シナリオが g2d_grid_get ・ g2d_list_size で読む形にできます。中身と乱数はセーブに入ります。
• 表 Table.* : load rowCount columnCount findRow getInt getFloat getStr （ data0\table の表）。
• GameState GameState.* : set get getStr add has remove clear （セーブに入る値）、 setPersist getPersist addPersist maxPersist （作品全体に残る整数。ハイスコアなど）。

11.6 途中の会話とセーブ

• ミニゲームの途中で会話をはさむときは、スクリプトが Game2D.setResult("mg:half") のようなイベントを返してシナリオへ戻り、会話の後にシナリオが g2d_resume ev で続きを動かします。
• 会話の間（ g2d_run の後・ g2d_end の前でゲームを実行していない間）はセーブできます。ロードすると、ミニゲームのスクリプトが最初から実行し直され（グリッド・リスト・GameState はロードした中身のまま）、続きから遊べます。画面を作る所では GameState を書き換えない（「はじめ」の値は GameState が無いときだけ入れる）のがこつです。
• メッセージウィンドウ・選択肢の一覧が開いている間はセーブしません（ Game2D.canSave() が 0）。

11.7 つまずきやすい所

• 関数の中から外の var に代入しても、外の値は変わりません。 回数や段階は GameState に持つか、関数が値を返す形にします。
• 配列 a[i] = x は使えません。 リスト・グリッドは List.* ・ Grid.* で持ちます。
• イベントは on を付けないと戻りません。
• 同じ瞬間に戻るイベントが 2 つ以上あると、2 つ目からは次の Game2D.run の頭で順に返ります。

11.8 見本のファイル

Copyright (C) ALC Software Laboratory. All Rights Reserved.