GS2-Formation Master Data Reference

Reference for the master data format and the models to be imported

Master Data Format

{
  "version": "2019-09-09",
  "moldModels": [
    {
      "name": "[string]Form Storage Area Model name",
      "metadata": "[string?]Metadata",
      "initialMaxCapacity": "[int]Initial capacity to store forms",
      "maxCapacity": "[int]Maximum capacity to store forms",
      "formModel": {
        "formModelId": "[string]Form Model GRN",
        "name": "[string]Form Model name",
        "metadata": "[string?]Metadata",
        "slots": [
          {
            "name": "[string]Slot Model name",
            "propertyRegex": "[string]Regular expressions for values that can be set as properties",
            "metadata": "[string?]Metadata"
          }
        ]
      }
    }
  ],
  "propertyFormModels": [
    {
      "name": "[string]Property Form Model name",
      "metadata": "[string?]Metadata",
      "slots": [
        {
          "name": "[string]Slot Model name",
          "propertyRegex": "[string]Regular expressions for values that can be set as properties",
          "metadata": "[string?]Metadata"
        }
      ]
    }
  ]
}
Type Condition Required Default Value Limits Description
version string
2019-09-09 Format version of master data
moldModels List<MoldModel> ~ 100 items Form Storage Area Model
If it is a party composition, it is intended to be saved in the form of “fire attribute party” or “water attribute party”.
The number of areas that can be saved can be limited or expanded individually.
propertyFormModels List<PropertyFormModel> ~ 100 items Property Form Model
An entity that represents the composition status.
The difference between Mold / Form is that Mold / Form defines the number of slots and records the composition in each slot,
and Property Form is used to represent compositions that are difficult to determine the number of slots in advance, such as setting skills for owned equipment.

Models

FormModel

Form Model

Form Model is an entity representing the configuration status. You can define slots as areas that can be formed.

For weapons and armor, parts such as “right hand”, “left hand”, “body”, and “arm” can be used as slots, and for parties, positions such as “vanguard”, “midfield”, and “rear guard” can be expressed as slots.

Type Condition Required Default Value Limits Description
formModelId string
*
~ 1024 chars Form Model GRN
* Set automatically by the server
name string
~ 128 chars Form Model name
Form Model-specific name. Specified using alphanumeric characters, hyphens (-), underscores (_), and periods (.).
metadata string ~ 2048 chars Metadata
Arbitrary values can be set in the metadata.
Since they do not affect GS2’s behavior, they can be used to store information used in the game.
slots List<SlotModel>
1 ~ 10 items List of Slot Model
The ordered list of slot definitions that make up this form. Each slot represents an assignable position, and the slot names must be unique within the form. For equipment, this might include slots like “weapon”, “armor”, “accessory”. For parties, slots like “position_1”, “position_2”, etc.

SlotModel

Slot Model

Defines a single slot within a form model. A slot represents an assignable position where a game resource (such as an item, character, or equipment) can be placed. The property regex validates what values can be assigned to the slot.

Type Condition Required Default Value Limits Description
name string
~ 128 chars Slot Model name
A unique identifier for this slot within the form model. For equipment forms, names like “right_hand” or “body” are typical. For party forms, names like “vanguard” or “rear_guard” are used.
propertyRegex string “.*” ~ 512 chars Regular expressions for values that can be set as properties
A regex pattern that validates the property ID values assignable to this slot. For example, restricting to specific GS2-Inventory item GRNs or GS2-Dictionary entry GRNs. Defaults to “.*” which allows any value.
metadata string ~ 512 chars Metadata
Arbitrary values can be set in the metadata.
Since they do not affect GS2’s behavior, they can be used to store information used in the game.

MoldModel

Form Storage Area Model

If it is a party composition, it is intended to be saved in the form of “fire attribute party” or “water attribute party”. The number of areas that can be saved can be limited or expanded individually.

Type Condition Required Default Value Limits Description
moldModelId string
*
~ 1024 chars Form Storage Area GRN
* Set automatically by the server
name string
~ 128 chars Form Storage Area Model name
Form Storage Area Model-specific name. Specified using alphanumeric characters, hyphens (-), underscores (_), and periods (.).
metadata string ~ 2048 chars Metadata
Arbitrary values can be set in the metadata.
Since they do not affect GS2’s behavior, they can be used to store information used in the game.
initialMaxCapacity int
1 ~ 2147483646 Initial capacity to store forms
The default number of form save slots available to each player for this mold. For example, if set to 3, the player can initially save up to 3 different formations (e.g., “fire party”, “water party”, “wind party”). Can be expanded per-player up to maxCapacity.
maxCapacity int
1 ~ 2147483646 Maximum capacity to store forms
The absolute upper limit for the number of form save slots per player for this mold. Even through capacity expansion operations, the capacity cannot exceed this value. Must be greater than or equal to initialMaxCapacity.
formModel FormModel
Form Model

PropertyFormModel

Property Form Model

An entity that represents the composition status. The difference between Mold / Form is that Mold / Form defines the number of slots and records the composition in each slot, and Property Form is used to represent compositions that are difficult to determine the number of slots in advance, such as setting skills for owned equipment.

Type Condition Required Default Value Limits Description
propertyFormModelId string
*
~ 1024 chars Property Form Model GRN
* Set automatically by the server
name string
~ 128 chars Property Form Model name
Property Form Model-specific name. Specified using alphanumeric characters, hyphens (-), underscores (_), and periods (.).
metadata string ~ 2048 chars Metadata
Arbitrary values can be set in the metadata.
Since they do not affect GS2’s behavior, they can be used to store information used in the game.
slots List<SlotModel>
1 ~ 10 items List of Slot Model
The ordered list of slot definitions for this property form. Unlike Mold/Form where the number of forms is limited by capacity, property forms are identified by a property ID and can exist for any owned resource. Slot names must be unique within the form.