わたくし"さかみち"が作成したのモジュール作成補助機能プラグインを紹介させていただきます。
今回紹介するのは、モジュールの作成の手間を軽減すべく、VASSALのプラグイン作成の研究を兼ねて作成したものです。
ユニットの登録や初期配置ヘクスへの配置が数も多く、それなりの手間をとります。
ですので作業しやすいExcelのような表計算ソフトを使って登録する駒の一覧表を作成しておいて、それをもとに一括してコマの作成ができないかと思い作成したプラグインです。
まだ全面的に安定した動作をしているわけではありませんが、通常使用していて問題を起こすことはなくなってきましたので、皆様にもご利用していただければと、内容と配布の紹介をさせていただこうと、このページを作成しております。
ご希望の方には、ウォーゲームSNS"MustAttack"のほうで"さかみち"あてにご連絡をいただければと思います。
どんなプラグインか
現在プラグインは2つに分かれています。
"Piece Creation Support"は、画像とコマの登録を自動的に行うものです。
"Stack Position Edit Support"は、コマの初期配置(At-Start Stack)の座標をまとめて編集するものです。
この画面は用意した組み込み済みのモジュールを最初に開いたときのもので、下の方にあるものが該当します。
ここからは、このプラグインの使用方法を、サンプルを作成しながらに説明していきます。
今回作成するサンプルについて
今回は、実際に自分がこのプラグインを利用して作成したDG版の「Napoleon's Last Battles」から一部を抜粋して説明のためのサンプルを作つくりました。
コマの作成では画像も作成します。
最初はSTEP１として、"Game Piece Palette"内に部隊のユニットのみを作成します。
次はSTEP2として、PrototypeとMarkerを追加していきます。
STEP3では、2種類の指揮官ユニットを作成していきます。
最後にSTEP4として"Game Piece Palette"ではなく、"Map"上に初期配置を変更してコマを作成し、初期配置の位置を変更していく方法を説明します。
一覧表のデータの作成について
ここで紹介するプラグインでは、先ほど述べたとおり、一覧表としてデータを作成して、これを取り込んで使用します。
使用する一覧表のデータは、テキストファイルで、特定のソフトウェアは必要ありません。
表の作成では私はExcelを使い慣れているため、Excelを利用していますが、表計算ソフトの多くであれば楽に作成できるかと思います。
またテキストファイルの文字コードはUTF-8を使用するようになっています。私個人はこれが一番便利なのですが、皆様のご要望があれば、この部分は容易に変更できますので、適宜変更したいと思っています。
STEP1 基本的な使い方
まずは、コマの画像を作成して、それを設定したコマを"Game Piece Palette"に配置していきます。
1. Game Piece Layoutを用意する。
コマ画像の作成では、VASSAL標準のコマ作成機能を利用していきますので、まずはこのレイアウト(Game Piece Layout)の作成から始めます。
VASSAL標準の機能を使ってコマの画像を作る場合、レイアウトを作るのはそれほど手間ではありませんが、このレイアウトに背景色や兵科記号の種類を指定したりして、個々のコマ画像を作るとなるとかなりの手間です。
このプラグインではレイアウトから個々の画像を作る時に指定する値を、一覧表から取得して設定して、まとめて複数のコマ画像を作りこの手間を軽減します。
ここはVASSALのヘルプなどを利用してレイアウトを作りましょう。
制約や注意点として次のようなことがあります。
特に制約はありませんが、配置したSymbolやLabelなどのNameの項目には後でわかりやすい名前をつけておくことと便利です。
一覧表のファイル形式の都合上、改行を含めることができないということで、TextBoxを作成して、ここに改行を含むような文章を設定することができません。
今回はまず以下のような"unit"という名前のレイアウトを作成しました。
あわせてコマの背景色などを指定するために[Named Color]も用意しておきます。
2. コマの配置先の用意
このプラグインでは"Game Piece Palette"にコマを配置することができます。
サンプルでは、もととなっているゲームでは、フランス軍とイギリスとその同盟軍、プロイセイン軍の3つの軍が登場しますので、ユニットを3つに分けて登録できるように次のようにGame Piece Paletteの中を設定しました。
3. コマの画像を作成しない場合について
コマの画像作成機能を利用しない場合には、その画像をあらかじめ用意しておく必要があります。
4. Piece Creation Supportの設定
いよいよコマ画像とコマを作成するために、プラグインを使用します。使用するプラグインは[Piece Creation Support]になります。
ここではまずPiece Creation Supportの設定の概要を説明した後、サンプルを使って説明しながら個別の解説を加えていきます。
5. Piece Creation Supportの概要
[Piece Creation Support]をダブルクリックして開く画面では、読み込む一覧表を保存したファイルと、動作全般を制御するための情報が保存されている項目の列番号を設定します。
[Piece Creation Support]の下位には4つのContainerが用意されていて、4種類の設定を追加できるようになっています。
Image Part Container
コマ画像を作成しない場合は、その駒画像自体、あるいはコマ画像に貼り付ける画像を登録する[Image Part]を追加するために利用できます。
Decorator Container
コマに設定する"Prototype"もしくは"Marker"の設定を追加していきます。詳細はSTEP2で説明します。
Layout Binding Container
用意した[Game Piece Layout]に、読み込んだ一覧表の各項目を結び付けていく、[Layout Buinding]を追加していきます。
Location Buinding Container
作成したコマの出力先を結び付けるための出力先を追加していきます。
6. 一覧表ファイルの内容の概要
一覧表の各行がひとつのコマ、もしくはコマの面になります。列にはそのコマないしはコマ画像を作成するために必要となる情報を設定することになります。
上述の通り各行がコマの1面となります。もし1面だけで構成させるコマの場合には、1行でひとつのコマとなり、画像を作成する場合には、その行のデータに基づいて画像が生成されます。
これらの動作を行うために、一覧表を作成する際にルールが存在します。
一覧表のいずれかの列に"コマ番号"を設定してください。実際のデータでは、同じコマの異なる面については同じ番号を設定することになります。
複数の面で構成されるコマの各面は、一覧表の中で連続する行としてください。
複数の面で構成される駒は一覧表の上から順番に、最初の状態、2番目の状態として作成されていきます。
複数の面で構成される駒のデータのうち、コマにひとつしか存在しない情報（作成したコマの配置先など）は、一番上の行のデータが使用されます。
今回作成するサンプルでは、このようなデータを用意することにしました。
1
1_F
...
1
1_R
...
2
2_F
...
2
2_R
...
先頭の列がコマ番号、二つ目の列が画像の名称です。3列目以降も実際のデータはもうこし列が続き、画像の生成などで使うことになります。
1列目のコマ番号では、1行目と2行目が一つのユニットであるため、同じ番号を付けています。
この例で2行目と3行目を入れ替えてしまうと、複数の面で構成される各面が連続していなければならないというルールに反してしまい、1行目と3行目、2行目と4行目が同じコマであるというように扱われなくなります。
7. [Piece Creation Support]の設定
それではサンプルの場合の設定を見ながら、具体的な設定を確認していきます。
最初はどのような項目を一覧表に含めるかを理解するために一通り見ていきます。
[Piece Creation Support]のプロパティ設定画面は以下の通りです。
"データファイル"には作成した一覧表を指定します。
それでは5つの列番号です。これは作成した一覧表の何列目を参照して自動作成の動作を行うかを決定します。
レイアウト設定の列番号
コマ画像を作成しない場合には0を設定してください。この場合画像の作成はスキップされます。
コマ番号の列番号
上述のコマ番号が登録されている列の番号を設定します。
画像名称の列番号
データファイルには、その駒に割り当てる画像の名称を含む必要があります。
両方を行う場合には、特に意識することなく、対応するコマとその画像が結び付けられます。
コマ名称の列番号
データファイルには、その駒に割り当てる名称を含む必要があります。
登録先設定の列番号
[Location Buinding Container]内の配置先の名前を含む列番号を指定します。
サンプルでは、先ほどの一覧表の説明で利用したように、コマ番号が1列目、画像が2列目です。
8. [Layout Buinding]の設定
次に画像を作成するための"Layout Buinding"の追加と設定を行っていきます。
最初に用意した"Game Piece Layout"の"Unit"にの各項目に一覧ファイルの値を結び付けていきます。
"Layout Buinding"を追加すると表示されるのは次のような画面です。
"名称"にはこの設定を識別するための名称を指定します。
今回は名称を"unit"、Piece Image Layoutの名称には"Unit"を設定します。
次は"項目の結びつけ"を設定します。
最初にLayout Buindingを作成した段階では、ここには何も設定されていません。
もし設定したPiece Image Layoutの内容を変更したり、Piece Image Layout自体を変えた場合には、このボタンを押してください。
さて列挙されている項目は"."で始まるか、そのPiece Image Layoutに配置したSymbolなどの項目の名前で始まりその直後に"."が続いているはずです。
いずれかの項目をダブルクリックすると、その文字列がボタンの上の入力欄に表示されます。
":"の右側にはどのような値を指定するのかは、その項目によって変わってきます。
色としては、[Named Color]で作成した色か、あらかじめ登録されている色の名前の名前になります。
あらかじめ設定されている色や、Symbolの種類や規模については、[Game Piece Image]のプロパティで確認できます。
":"の右側の値として、ここで説明した内容を直接設定すると、一覧表の値にかかわらず、すべての画像に同じ値が指定されます。
この部分については、申し訳ありませんが、いろいろと試してみて確認してください。
この画面をわかりやすくすることは、機能強化の対象と考えています。
今回、ユニットの画像では、以下のように指定しました。
一覧表を参照するのは以下の通りです。
ユニットの背景色を6列目
兵科記号の背景色を7列目
兵科記号のひとつ目を8列目
兵科記号のふたつ目を9列目 (兵科記号は二つまで重ねられるようになっています。Horse Artilleryは重ねて表現されます)
兵科記号の規模を10列目
ユニット名に11列目
ユニットの上位組織名に12列目
ユニットの戦闘力に13列目
ユニットの移動力に14列目となります。 9. [Fixed Location Buindeing]の設定
コマの配置先にはとりあえず、Fixed Locationを利用して、[Game Piece Palette]内にコマを登録することにします。
Fixed Location Buindeingは[Location Buinding Container]に追加します。
追加すると名称と配置先名称入力する箇所だけが存在します。
"名称"はLayout Buindingの場合と同じように、一覧表の中で指定するときに利用する名称です。
"配置先名称"は、実際の配置先となる名称です。"Single Piece"を追加できる場所ならどこでもかまいません。
今回用意した3つは次の通りです。
名称は"france"、配置先"Pieces/Root/Unit/France"。ここにはフランス軍のユニットを登録します。
名称は"angloallies"、配置先"Pieces/Root/Unit/AngloAllies"。ここにはイギリスとその同盟軍のユニットを登録します。
名称は"prussia"、配置先"Pieces/Root/Unit/Prussia"。ここにはプロイセン軍のユニットを登録します。 10. 一覧表を完成させて、実行する
STEP1で必要となる設定が終わりましたので、一覧表を完成させましょう。
3列目から14列目までに必要なで使うデータを埋めていきます。
1
1_F
a/I
unit
france
france
france_i
Infantry
None
Brigade
a
I
5
4
1
1_R
a/I(-)
unit
france
france
france_i
Infantry
None
Brigade
a
I
3
4
2
2_F
b/I
unit
france
france
france_i
Cavalry/Recon
None
Division
b
I
4
6
2
2_R
b/I(-)
unit
france
france
france_i
Cavalry/Recon
None
Division
b
I
2
6
3
3_F
c/1
unit
prussia
prussia
prussia_i
Artillery
None
Regiment
c
1
3
4
4
4_F
d/I
unit
angloallies
britain
angloallies_1
Artillery
Cavalry/Recon
Regiment
d
I
2
6
これを"units.txt"という名前のTABで区切られたテキストファイルに保存します。
ちなみにユニットとシンボルの背景色はそれぞれNamed Colorで用意しています。
[Piece Creation Support]のプロパティ画面を開き、"データファイル"の選択ボタンを押して、このファイルを指定します。
ここで「実行」ボタンを押します。
現在の機能では、駒の数の増減や、登録する場所の変更などがあって、モジュールの内容を表すツリービューの表示を変更しなくてはならないケースについても、ツリービューの内容を変更することができていません。
このため実行直後に一旦ファイルを保存し、再度開くという手順をとって下さい。それまで作成された結果を確認できない可能性があります。
というわけでモジュールを保存後、1回VASSALを終了して、再度開きます。
コマの画像及びコマが、[Game Piece Layout]及び[Game Piece Pallete]の中に生成されます。
小さくて醜いですね。こういった画像をあげるくらいなら、組み込み済みのモジュールを置いておいた方が適切かもしれませんね。
以下しばしお待ちを
STEP2
STEP3
STEP4
ご意見ご要望など。
最終更新：2009年06月07日 11:52
