Mana

Mana

Actor-oriented scripting language for game events

ゲームのキャラクター、扉、イベント進行を Actor に分け、Request で連携させます。 C++ のゲーム本体へ組み込んで動かすことを前提に設計されています。

Get Started ブラウザで試す Documentation GitHub

Mana とは

Mana は、ゲーム内のキャラクターやイベントの進行を、テキストで記述するプログラミング言語です。

「案内役が話す → 門が開く → 次の案内をする」のように、複数の役割が関わる処理を、役割ごとに分けて書けます。処理のまとまりを Actor、その行動を Action、他の Actor への依頼を Request と呼びます。

Mana の全体像

Mana のソースコードは Compiler が Program Image へ変換し、VM が実行します。描画・音声・入力といった機能はゲーム本体が持ち、Mana はそれらを動かす順番と条件を記述します。

なぜ Mana を作ったのか

ゲームでは、会話、扉の開閉、敵の行動、演出が同時進行しているように見えます。これらを一つの長い処理へ集めると、ある処理の都合が別の処理へ影響しやすくなり、状態管理も複雑になります。

Mana は、この問題を言語の側から整理します。

イベントの進行そのものを言語の語彙で書けるため、ゲーム本体の C++ コードに進行管理を持ち込まずに済みます。

Actor / Action / Request

Actor は、自分の状態と処理を持つ実行単位です。キャラクターに限らず、扉やイベント進行役にも使います。

Action は、Actor の行動です。main と init は特別な Action で、Actor の開始時に実行されます。

Request は、他の Actor へ Action の実行を依頼する命令です。依頼した側はすぐ次へ進みます。

Request の流れ

依頼するだけでなく、相手が始めるまで待つ awaitStart、相手が終えるまで待つ await も使えます。

Priority

Request には Priority(優先度)を指定します。数が大きいほど優先されます。

Priority は、同じ Actor の中でどの Action を優先するかを表します。高い Priority の Action は実行中の Action へ割り込み、終わると元の Action へ戻ります。

Priority による割り込みと復帰

会話の途中で警告を割り込ませ、その後で会話へ戻る、といった進行をそのまま書けます。

小さな Mana コード

進行役が案内役の会話を待ち、門を開けるイベントです。

actor Event
{
    action main()
    {
        await(10, Guide->talk());
        await(10, Gate->open());
        print("Event: Finished.\n");
    }
}

actor Guide
{
    action talk()
    {
        print("Guide: Welcome!\n");
    }
}

actor Gate
{
    action open()
    {
        print("Gate: Open.\n");
    }
}

実行すると、会話、門、完了の順に出力されます。

Guide: Welcome!
Gate: Open.
Event: Finished.

変数、条件分岐、繰り返し、関数、namespace も使えます。書き方は Tutorial で順番に学べます。

Compiler と VM

Mana は Compiler と VM に分かれています。

Compiler は C++ のライブラリとして組み込めるため、開発中はゲーム内でスクリプトをコンパイルし、製品では事前に用意した Program Image だけを読み込む、といった使い分けができます。ゲーム側の関数は Native Function として Mana から呼び出します。

組み込み方法は C++ Integration にまとめてあります。

向いている用途

描画、物理、サウンドなどの重い処理はゲーム本体が担当し、Mana はそれらを呼び出す順番と条件を受け持ちます。

Documentation

学習と参照はすべて Wiki にあります。

GitHub

ソースコード、リリース、課題の報告は GitHub にあります。