GS2-Formation API リファレンス

装備機能やパーティ編成機能を実現するためのサービスです。

編成情報を記録する フォーム(Form) と、編成した フォーム を保存する フォームの保存領域(Mold) があります。
パーティ編成を例にすると、キャラクターを フォーム に設定し、パーティを編成します。
編成したパーティ情報を複数記録する場合は フォームの保存領域 を使って実現できます。

フォームの保存領域 に保存できる数にはキャパシティを設定でき、キャパシティの値は引き上げることができます。

フォーム に編成するプロパティはプロパティIDで指定することになりますが、プロパティの正規表現で値を限定することができます。
また、GS2-Inventory のリソースを設定する場合は、GS2-Inventory が発行する 署名付きアイテムセット を使って編成対象に指定できます。
署名付きアイテムセット とは、該当のアイテムを所有していることを保証する署名付きプロパティ情報で、こちらを使う場合はクライアントから直接編成することを許します。

この「所有していることを保証する」とは編成時点での保証であり、編成後にプロパティを手放した場合のフォローはありません。
GS2-Inventory でプロパティを消費したり売却したりする場合は、事前に GS2-Formation で編成に使用されていないかの判定はクライアントまたはスクリプトで実装する必要があります。

スタンダードインベントリ(GS2-Inventory)を使用している場合は、ItemSet の referenceOf フィールドを利用することで、編成中のアイテムが誤って削除されることを防ぐことができます。
フォームのスロットにアイテムをセットする際に、そのスロットを識別する文字列(GRN など)を ItemSet.referenceOf に設定します。
スタンダードインベントリのインベントリモデル設定には「referenceOf に値が存在する場合は消費を禁止する」オプションがあります。
このオプションを有効にすると、ItemSet.referenceOf が空でないアイテムは消費・売却できなくなるため、編成中のアイテムに対して削除の制限をかけることができます。