プラグインとは†
プラグインとは、BakinのツールおよびエンジンをC#によるプログラムで機能拡張できる機能です。
プラグインには大きく分けて下記の2種類があります。
・ツールプラグイン(.dll形式)
・エンジンプラグイン(.cs形式)
2023年3月時点で作成環境が公開されているのはエンジンプラグインのみとなります。
プラグインの種別†
- エンジンプラグインはBakinエンジンの動作を拡張するためのものです。
エンジンプラグインには現在下記の2種類の機能があります。
- ・イベントスクリプト イベントにC#プログラムを割り当てる
- ・バトルプラグイン BakinのバトルシステムをC#プログラムで差し替える
プラグインの使い方†
- エンジンプラグインは、編集中のプロジェクトフォルダの直下に下記の説明で指定するフォルダを作成し、プラグインを格納してください。
- ・イベントスクリプト
まずscript フォルダを作成し、その中に .cs ファイルを追加してください。
Bakinを起動後、イベントシートの左下にある「C#プログラムの割り当て」欄にて矢印をクリック。
開いたリストから割り当てるスクリプトを選択してください。
- ・バトルプラグイン
battlescript フォルダを作成し、その中に .cs ファイル一式を追加してください。
プロジェクトを起動すれば自動的に適用され、ツール上の操作は必要ありません。
プラグインの削除†
- ・イベントスクリプトの場合、 scriptフォルダ から 削除したい.cs ファイルを削除してください。
- ・バトルプラグインの場合、 battlescript フォルダごと削除してください。
マップエディター上部メニュー>機能>拡張機能にある「バトル関連ソースをゲームファイルから削除」をお使いいただくこともできます。
プラグインの作り方†
(!)Bakinのアップデートに伴い、作成したプラグインの動作に影響が出る可能性があります。アップデート発生時は都度差分を確認するといったご対応をお願いいたします。
- イベントスクリプト
Bakinを起動後、イベントシートの左下にある「C#プログラムの割り当て」欄にて矢印をクリック。
上部にある「新規作成」ボタンを押すとエディタ(.csと関連付けられているエディタ)が起動します。
※Visual Studio(Community版で可)を、C#開発できる状態でインストールしておくことをお勧めします。
※Bakinを経由せず、他のエディターを使って.csファイルを作成し、scriptフォルダに入れる方法でも構いません。
- バトルプラグイン
マップエディター上部メニュー>機能>拡張機能にある「バトル関連ソースをゲームファイルにコピー」を実行します。
実行すると現在編集中のプロジェクトフォルダ内にbattlescript フォルダが作成され、その中にバトルプラグインの雛形(デフォルトのバトル処理と同じもの)が作成されます。
作成されたファイルをお使いのエディターで編集してください。
- メタデータの設定
- ・イベントスクリプトにはメタデータはありません
- ・バトルプラグインは BattlePluginDef.cs 冒頭の // @@version xx.xx.xx.xx を対応するBakinバージョンに書き換えてください。
- プラグインのヘルプ
プラグインを配布するにあたって、内容についての説明が必要な場合は、readme.txtを作成し同梱してください。
- プラグインの設定
プラグインの環境設定をする機能は現時点ではありません。
プラグインの配布†
- ・イベントスクリプトの場合 作成した cs ファイルを任意の方法で配布してください。
- ・バトルプラグインの場合 battlescript フォルダ全体を圧縮して任意の方法で配布してください。
プラグインリファレンス†
現在参照できるクラスのリファレンスは下記のURLから参照できます。
RPG Developer Bakin プラグインリファレンス:https://rpgbakin.com/csreference/
2023年3月時点では、イベントスクリプト、バトルプラグインの作成で使用するクラスについて公開しています。