GS2-Formation Master Data Reference
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. |
Model
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. |