GS2-Experience GS2-Deploy/CDK リファレンス
エンティティ
Namespace
ネームスペース
ネームスペースは一つのプロジェクトで同じサービスを異なる用途で複数利用できるようにするための仕組みです。
GS2 のサービスは基本的にネームスペースというレイヤーがあり、ネームスペースが異なれば同じサービスでもまったく別のデータ空間として取り扱われます。
そのため、各サービスの利用を開始するにあたってネームスペースを作成する必要があります。
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| name | string | ✓ | ~ 128文字 | ネームスペース名 | |
| description | string | ~ 1024文字 | 説明文 | ||
| transactionSetting | TransactionSetting | トランザクション設定 | |||
| rankCapScriptId | string | ~ 1024文字 | ランクキャップを動的に決定するスクリプト | ||
| changeExperienceScript | ScriptSetting | 経験値変化したときに実行するスクリプト | |||
| changeRankScript | ScriptSetting | ランク変化したときに実行するスクリプト | |||
| changeRankCapScript | ScriptSetting | ランクキャップ変化したときに実行するスクリプト | |||
| overflowExperienceScript | string | ~ 1024文字 | 経験値あふれしたときに実行するスクリプト | ||
| logSetting | LogSetting | ログの出力設定 |
GetAttr
| 型 | 説明 | |
|---|---|---|
| Item | Namespace | 作成したネームスペース |
実装例
Type: GS2::Experience::Namespace
Properties:
Name: namespace1
Description: null
TransactionSetting: null
RankCapScriptId: null
ChangeExperienceScript: null
ChangeRankScript: null
ChangeRankCapScript: null
OverflowExperienceScript: null
LogSetting:
LoggingNamespaceId: grn:gs2:ap-northeast-1:YourOwnerId:log:namespace1from gs2_cdk import Stack, core, experience
class SampleStack(Stack):
def __init__(self):
super().__init__()
experience.Namespace(
stack=self,
name="namespace-0001",
options=experience.NamespaceOptions(
log_setting=core.LogSetting(
logging_namespace_id='grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001',
),
),
)
print(SampleStack().yaml()) # Generate Templateclass SampleStack extends \Gs2Cdk\Core\Model\Stack
{
function __construct() {
parent::__construct();
new \Gs2Cdk\Experience\Model\Namespace_(
stack: $this,
name: "namespace-0001",
options: new \Gs2Cdk\Experience\Model\Options\NamespaceOptions(
logSetting: new \Gs2Cdk\Core\Model\LogSetting(
loggingNamespaceId: "grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001"
)
)
);
}
}
print((new SampleStack())->yaml()); // Generate Template
class SampleStack extends io.gs2.cdk.core.model.Stack
{
public SampleStack() {
super();
new io.gs2.cdk.experience.model.Namespace(
this,
"namespace-0001",
new io.gs2.cdk.experience.model.options.NamespaceOptions() {
{
logSetting = new io.gs2.cdk.core.model.LogSetting(
loggingNamespaceId = "grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001"
);
}
}
);
}
}
System.out.println(new SampleStack().yaml()); // Generate Templateimport core from "@/gs2cdk/core";
import experience from "@/gs2cdk/experience";
class SampleStack extends core.Stack
{
public constructor() {
super();
new experience.model.Namespace(
this,
"namespace-0001",
{
logSetting: new core.LogSetting(
"grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001"
)
}
);
}
}
console.log(new SampleStack().yaml()); // Generate Template
public class SampleStack : Gs2Cdk.Core.Model.Stack
{
public SampleStack() {
new Gs2Cdk.Gs2Experience.Model.Namespace(
this,
"namespace-0001",
new Gs2Cdk.Gs2Experience.Model.Options.NamespaceOptions {
logSetting = new Gs2Cdk.Core.Model.LogSetting(
LoggingNamespaceId = "grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001"
)
}
);
}
}
Debug.Log(new SampleStack().Yaml()); // Generate TemplateCurrentExperienceMaster
現在有効なマスターデータ
GS2ではマスターデータの管理にJSON形式のファイルを使用します。
ファイルをアップロードすることで、実際にサーバーに設定を反映することができます。
JSONファイルを作成する方法として、マネージメントコンソール上でのマスターデータエディタを提供していますが
よりゲームの運営に相応しいツールを作成し、適切なフォーマットのJSONファイルを書き出すことでもサービスを利用可能です。
Note
JSONファイルの形式については GS2-Experience マスターデータリファレンス をご参照ください。| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 | |
| settings | string | ✓ | ~ 5242880文字 | マスターデータ |
GetAttr
| 型 | 説明 | |
|---|---|---|
| Item | CurrentExperienceMaster | 更新した現在有効な経験値設定 |
実装例
Type: GS2::Experience::CurrentExperienceMaster
Properties:
NamespaceName: namespace1
Settings: {
"version": "2019-01-11",
"experienceModels": [
{
"name": "character_ssr",
"defaultRankCap": 50,
"maxRankCap": 80,
"rankThreshold":
{
"metadata": "CHARACTER",
"values": [
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
},
"metadata": "SSR"
},
{
"name": "character_sr",
"defaultRankCap": 40,
"maxRankCap": 70,
"rankThreshold":
{
"metadata": "CHARACTER",
"values": [
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
},
"metadata": "SR"
},
{
"name": "character_r",
"defaultRankCap": 30,
"maxRankCap": 60,
"rankThreshold":
{
"metadata": "CHARACTER",
"values": [
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
},
"metadata": "R"
},
{
"name": "equipment",
"defaultRankCap": 30,
"maxRankCap": 50,
"rankThreshold":
{
"metadata": "EQUIPMENT",
"values": [
200,
400,
600,
800,
1000,
1200,
1400,
1600,
1800,
2000,
2200,
2400,
2600,
2800,
3000,
3200,
3400,
3600,
3800,
4000,
4200,
4400,
4600,
4800,
5000,
5200,
5400,
5600,
5800,
6000,
6200,
6400,
6600,
6800,
7000,
7200,
7400,
7600,
7800,
8000,
8200,
8400,
8600,
8800,
9000,
9200,
9400,
9600,
9800
]
},
"metadata": "EQUIPMENT",
"acquireActionRates": [
{
"name": "rate-0001",
"mode": "big",
"bigRates": [
"1",
"10",
"100",
"1000",
"10000",
"100000",
"1000000",
"10000000",
"100000000",
"1000000000",
"10000000000",
"100000000000",
"1000000000000",
"10000000000000",
"100000000000000",
"1000000000000000",
"10000000000000000",
"100000000000000000",
"1000000000000000000",
"10000000000000000000",
"100000000000000000000",
"1000000000000000000000",
"10000000000000000000000",
"100000000000000000000000",
"1000000000000000000000000",
"10000000000000000000000000",
"100000000000000000000000000"
]
}
]
},
{
"name": "skill",
"defaultRankCap": 10,
"maxRankCap": 20,
"rankThreshold":
{
"metadata": "SKILL",
"values": [
300,
600,
900,
1200,
1500,
1800,
2100,
2400,
2700,
3000,
3300,
3600,
3900,
4200,
4500,
4800,
5100,
5400,
5700
]
},
"metadata": "SKILL"
}
]
}from gs2_cdk import Stack, core, experience
class SampleStack(Stack):
def __init__(self):
super().__init__()
experience.Namespace(
stack=self,
# 省略
).master_data(
experience_models=[
experience.ExperienceModel(
name='character_ssr',
default_rank_cap=50,
max_rank_cap=80,
rank_threshold=experience.Threshold(
metadata='CHARACTER',
values=[
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
options=experience.ExperienceModelOptions(
metadata='SSR',
),
),
experience.ExperienceModel(
name='character_sr',
default_rank_cap=40,
max_rank_cap=70,
rank_threshold=experience.Threshold(
metadata='CHARACTER',
values=[
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
options=experience.ExperienceModelOptions(
metadata='SR',
),
),
experience.ExperienceModel(
name='character_r',
default_rank_cap=30,
max_rank_cap=60,
rank_threshold=experience.Threshold(
metadata='CHARACTER',
values=[
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
options=experience.ExperienceModelOptions(
metadata='R',
),
),
experience.ExperienceModel(
name='equipment',
default_rank_cap=30,
max_rank_cap=50,
rank_threshold=experience.Threshold(
metadata='EQUIPMENT',
values=[
200,
400,
600,
800,
1000,
1200,
1400,
1600,
1800,
2000,
2200,
2400,
2600,
2800,
3000,
3200,
3400,
3600,
3800,
4000,
4200,
4400,
4600,
4800,
5000,
5200,
5400,
5600,
5800,
6000,
6200,
6400,
6600,
6800,
7000,
7200,
7400,
7600,
7800,
8000,
8200,
8400,
8600,
8800,
9000,
9200,
9400,
9600,
9800
]
),
options=experience.ExperienceModelOptions(
metadata='EQUIPMENT',
acquire_action_rates=[
experience.AcquireActionRate(
name='rate-0001',
mode='big',
big_rates=[
'1',
'10',
'100',
'1000',
'10000',
'100000',
'1000000',
'10000000',
'100000000',
'1000000000',
'10000000000',
'100000000000',
'1000000000000',
'10000000000000',
'100000000000000',
'1000000000000000',
'10000000000000000',
'100000000000000000',
'1000000000000000000',
'10000000000000000000',
'100000000000000000000',
'1000000000000000000000',
'10000000000000000000000',
'100000000000000000000000',
'1000000000000000000000000',
'10000000000000000000000000',
'100000000000000000000000000'
]
),
],
),
),
experience.ExperienceModel(
name='skill',
default_rank_cap=10,
max_rank_cap=20,
rank_threshold=experience.Threshold(
metadata='SKILL',
values=[
300,
600,
900,
1200,
1500,
1800,
2100,
2400,
2700,
3000,
3300,
3600,
3900,
4200,
4500,
4800,
5100,
5400,
5700
]
),
options=experience.ExperienceModelOptions(
metadata='SKILL',
),
),
],
)
print(SampleStack().yaml()) # Generate Templateclass SampleStack extends \Gs2Cdk\Core\Model\Stack
{
function __construct() {
parent::__construct();
(new \Gs2Cdk\Experience\Model\Namespace_(
stack: $this,
// 省略
))->masterData(
[
new \Gs2Cdk\Experience\Model\ExperienceModel(
name:"character_ssr",
defaultRankCap:50,
maxRankCap:80,
rankThreshold:new \Gs2Cdk\Experience\Model\Threshold(
metadata: "CHARACTER",
values: [
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
options: new \Gs2Cdk\Experience\Model\Options\ExperienceModelOptions(
metadata:"SSR"
)
),
new \Gs2Cdk\Experience\Model\ExperienceModel(
name:"character_sr",
defaultRankCap:40,
maxRankCap:70,
rankThreshold:new \Gs2Cdk\Experience\Model\Threshold(
metadata: "CHARACTER",
values: [
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
options: new \Gs2Cdk\Experience\Model\Options\ExperienceModelOptions(
metadata:"SR"
)
),
new \Gs2Cdk\Experience\Model\ExperienceModel(
name:"character_r",
defaultRankCap:30,
maxRankCap:60,
rankThreshold:new \Gs2Cdk\Experience\Model\Threshold(
metadata: "CHARACTER",
values: [
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
options: new \Gs2Cdk\Experience\Model\Options\ExperienceModelOptions(
metadata:"R"
)
),
new \Gs2Cdk\Experience\Model\ExperienceModel(
name:"equipment",
defaultRankCap:30,
maxRankCap:50,
rankThreshold:new \Gs2Cdk\Experience\Model\Threshold(
metadata: "EQUIPMENT",
values: [
200,
400,
600,
800,
1000,
1200,
1400,
1600,
1800,
2000,
2200,
2400,
2600,
2800,
3000,
3200,
3400,
3600,
3800,
4000,
4200,
4400,
4600,
4800,
5000,
5200,
5400,
5600,
5800,
6000,
6200,
6400,
6600,
6800,
7000,
7200,
7400,
7600,
7800,
8000,
8200,
8400,
8600,
8800,
9000,
9200,
9400,
9600,
9800
]
),
options: new \Gs2Cdk\Experience\Model\Options\ExperienceModelOptions(
metadata:"EQUIPMENT",
acquireActionRates:[
new \Gs2Cdk\Experience\Model\AcquireActionRate(
name: "rate-0001",
mode: "big",
bigRates: [
"1",
"10",
"100",
"1000",
"10000",
"100000",
"1000000",
"10000000",
"100000000",
"1000000000",
"10000000000",
"100000000000",
"1000000000000",
"10000000000000",
"100000000000000",
"1000000000000000",
"10000000000000000",
"100000000000000000",
"1000000000000000000",
"10000000000000000000",
"100000000000000000000",
"1000000000000000000000",
"10000000000000000000000",
"100000000000000000000000",
"1000000000000000000000000",
"10000000000000000000000000",
"100000000000000000000000000"
]
),
]
)
),
new \Gs2Cdk\Experience\Model\ExperienceModel(
name:"skill",
defaultRankCap:10,
maxRankCap:20,
rankThreshold:new \Gs2Cdk\Experience\Model\Threshold(
metadata: "SKILL",
values: [
300,
600,
900,
1200,
1500,
1800,
2100,
2400,
2700,
3000,
3300,
3600,
3900,
4200,
4500,
4800,
5100,
5400,
5700
]
),
options: new \Gs2Cdk\Experience\Model\Options\ExperienceModelOptions(
metadata:"SKILL"
)
)
]
);
}
}
print((new SampleStack())->yaml()); // Generate Template
class SampleStack extends io.gs2.cdk.core.model.Stack
{
public SampleStack() {
super();
new io.gs2.cdk.experience.model.Namespace(
this,
// 省略
).masterData(
Arrays.asList(
new io.gs2.cdk.experience.model.ExperienceModel(
"character_ssr",
50L,
80L,
new io.gs2.cdk.experience.model.Threshold(
"CHARACTER",
Arrays.asList(
100L,
200L,
300L,
400L,
500L,
600L,
700L,
800L,
900L,
1000L,
1100L,
1200L,
1300L,
1400L,
1500L,
1600L,
1700L,
1800L,
1900L,
2000L,
2100L,
2200L,
2300L,
2400L,
2500L,
2600L,
2700L,
2800L,
2900L,
3000L,
3100L,
3200L,
3300L,
3400L,
3500L,
3600L,
3700L,
3800L,
3900L,
4000L,
4100L,
4200L,
4300L,
4400L,
4500L,
4600L,
4700L,
4800L,
4900L,
5000L,
5100L,
5200L,
5300L,
5400L,
5500L,
5600L,
5700L,
5800L,
5900L,
6000L,
6100L,
6200L,
6300L,
6400L,
6500L,
6600L,
6700L,
6800L,
6900L,
7000L,
7100L,
7200L,
7300L,
7400L,
7500L,
7600L,
7700L,
7800L,
7900L
)
),
new io.gs2.cdk.experience.model.options.ExperienceModelOptions() {
{
metadata: "SSR";
}
}
),
new io.gs2.cdk.experience.model.ExperienceModel(
"character_sr",
40L,
70L,
new io.gs2.cdk.experience.model.Threshold(
"CHARACTER",
Arrays.asList(
100L,
200L,
300L,
400L,
500L,
600L,
700L,
800L,
900L,
1000L,
1100L,
1200L,
1300L,
1400L,
1500L,
1600L,
1700L,
1800L,
1900L,
2000L,
2100L,
2200L,
2300L,
2400L,
2500L,
2600L,
2700L,
2800L,
2900L,
3000L,
3100L,
3200L,
3300L,
3400L,
3500L,
3600L,
3700L,
3800L,
3900L,
4000L,
4100L,
4200L,
4300L,
4400L,
4500L,
4600L,
4700L,
4800L,
4900L,
5000L,
5100L,
5200L,
5300L,
5400L,
5500L,
5600L,
5700L,
5800L,
5900L,
6000L,
6100L,
6200L,
6300L,
6400L,
6500L,
6600L,
6700L,
6800L,
6900L,
7000L,
7100L,
7200L,
7300L,
7400L,
7500L,
7600L,
7700L,
7800L,
7900L
)
),
new io.gs2.cdk.experience.model.options.ExperienceModelOptions() {
{
metadata: "SR";
}
}
),
new io.gs2.cdk.experience.model.ExperienceModel(
"character_r",
30L,
60L,
new io.gs2.cdk.experience.model.Threshold(
"CHARACTER",
Arrays.asList(
100L,
200L,
300L,
400L,
500L,
600L,
700L,
800L,
900L,
1000L,
1100L,
1200L,
1300L,
1400L,
1500L,
1600L,
1700L,
1800L,
1900L,
2000L,
2100L,
2200L,
2300L,
2400L,
2500L,
2600L,
2700L,
2800L,
2900L,
3000L,
3100L,
3200L,
3300L,
3400L,
3500L,
3600L,
3700L,
3800L,
3900L,
4000L,
4100L,
4200L,
4300L,
4400L,
4500L,
4600L,
4700L,
4800L,
4900L,
5000L,
5100L,
5200L,
5300L,
5400L,
5500L,
5600L,
5700L,
5800L,
5900L,
6000L,
6100L,
6200L,
6300L,
6400L,
6500L,
6600L,
6700L,
6800L,
6900L,
7000L,
7100L,
7200L,
7300L,
7400L,
7500L,
7600L,
7700L,
7800L,
7900L
)
),
new io.gs2.cdk.experience.model.options.ExperienceModelOptions() {
{
metadata: "R";
}
}
),
new io.gs2.cdk.experience.model.ExperienceModel(
"equipment",
30L,
50L,
new io.gs2.cdk.experience.model.Threshold(
"EQUIPMENT",
Arrays.asList(
200L,
400L,
600L,
800L,
1000L,
1200L,
1400L,
1600L,
1800L,
2000L,
2200L,
2400L,
2600L,
2800L,
3000L,
3200L,
3400L,
3600L,
3800L,
4000L,
4200L,
4400L,
4600L,
4800L,
5000L,
5200L,
5400L,
5600L,
5800L,
6000L,
6200L,
6400L,
6600L,
6800L,
7000L,
7200L,
7400L,
7600L,
7800L,
8000L,
8200L,
8400L,
8600L,
8800L,
9000L,
9200L,
9400L,
9600L,
9800L
)
),
new io.gs2.cdk.experience.model.options.ExperienceModelOptions() {
{
metadata: "EQUIPMENT";
acquireActionRates: Arrays.asList(
new io.gs2.cdk.experience.model.AcquireActionRate(
"rate-0001",
"big",
Arrays.asList(
"1",
"10",
"100",
"1000",
"10000",
"100000",
"1000000",
"10000000",
"100000000",
"1000000000",
"10000000000",
"100000000000",
"1000000000000",
"10000000000000",
"100000000000000",
"1000000000000000",
"10000000000000000",
"100000000000000000",
"1000000000000000000",
"10000000000000000000",
"100000000000000000000",
"1000000000000000000000",
"10000000000000000000000",
"100000000000000000000000",
"1000000000000000000000000",
"10000000000000000000000000",
"100000000000000000000000000"
)
)
);
}
}
),
new io.gs2.cdk.experience.model.ExperienceModel(
"skill",
10L,
20L,
new io.gs2.cdk.experience.model.Threshold(
"SKILL",
Arrays.asList(
300L,
600L,
900L,
1200L,
1500L,
1800L,
2100L,
2400L,
2700L,
3000L,
3300L,
3600L,
3900L,
4200L,
4500L,
4800L,
5100L,
5400L,
5700L
)
),
new io.gs2.cdk.experience.model.options.ExperienceModelOptions() {
{
metadata: "SKILL";
}
}
)
)
);
}
}
System.out.println(new SampleStack().yaml()); // Generate Templateimport core from "@/gs2cdk/core";
import experience from "@/gs2cdk/experience";
class SampleStack extends core.Stack
{
public constructor() {
super();
new experience.model.Namespace(
this,
// 省略
).masterData(
[
new experience.model.ExperienceModel(
"character_ssr",
50,
80,
new experience.model.Threshold(
"CHARACTER",
new number[
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
{
metadata: "SSR"
}
),
new experience.model.ExperienceModel(
"character_sr",
40,
70,
new experience.model.Threshold(
"CHARACTER",
new number[
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
{
metadata: "SR"
}
),
new experience.model.ExperienceModel(
"character_r",
30,
60,
new experience.model.Threshold(
"CHARACTER",
new number[
100,
200,
300,
400,
500,
600,
700,
800,
900,
1000,
1100,
1200,
1300,
1400,
1500,
1600,
1700,
1800,
1900,
2000,
2100,
2200,
2300,
2400,
2500,
2600,
2700,
2800,
2900,
3000,
3100,
3200,
3300,
3400,
3500,
3600,
3700,
3800,
3900,
4000,
4100,
4200,
4300,
4400,
4500,
4600,
4700,
4800,
4900,
5000,
5100,
5200,
5300,
5400,
5500,
5600,
5700,
5800,
5900,
6000,
6100,
6200,
6300,
6400,
6500,
6600,
6700,
6800,
6900,
7000,
7100,
7200,
7300,
7400,
7500,
7600,
7700,
7800,
7900
]
),
{
metadata: "R"
}
),
new experience.model.ExperienceModel(
"equipment",
30,
50,
new experience.model.Threshold(
"EQUIPMENT",
new number[
200,
400,
600,
800,
1000,
1200,
1400,
1600,
1800,
2000,
2200,
2400,
2600,
2800,
3000,
3200,
3400,
3600,
3800,
4000,
4200,
4400,
4600,
4800,
5000,
5200,
5400,
5600,
5800,
6000,
6200,
6400,
6600,
6800,
7000,
7200,
7400,
7600,
7800,
8000,
8200,
8400,
8600,
8800,
9000,
9200,
9400,
9600,
9800
]
),
{
metadata: "EQUIPMENT",
acquireActionRates: [
new experience.model.AcquireActionRate(
"rate-0001",
"big",
new string[
"1",
"10",
"100",
"1000",
"10000",
"100000",
"1000000",
"10000000",
"100000000",
"1000000000",
"10000000000",
"100000000000",
"1000000000000",
"10000000000000",
"100000000000000",
"1000000000000000",
"10000000000000000",
"100000000000000000",
"1000000000000000000",
"10000000000000000000",
"100000000000000000000",
"1000000000000000000000",
"10000000000000000000000",
"100000000000000000000000",
"1000000000000000000000000",
"10000000000000000000000000",
"100000000000000000000000000"
]
),
]
}
),
new experience.model.ExperienceModel(
"skill",
10,
20,
new experience.model.Threshold(
"SKILL",
new number[
300,
600,
900,
1200,
1500,
1800,
2100,
2400,
2700,
3000,
3300,
3600,
3900,
4200,
4500,
4800,
5100,
5400,
5700
]
),
{
metadata: "SKILL"
}
)
]
);
}
}
console.log(new SampleStack().yaml()); // Generate Template
public class SampleStack : Gs2Cdk.Core.Model.Stack
{
public SampleStack() {
new Gs2Cdk.Gs2Experience.Model.Namespace(
this,
// 省略
).MasterData(
new [] {
new Gs2Cdk.Gs2Experience.Model.ExperienceModel(
"character_ssr",
50L,
80L,
new Gs2Cdk.Gs2Experience.Model.Threshold(
metadata: "CHARACTER",
values: new long[] {
100L,
200L,
300L,
400L,
500L,
600L,
700L,
800L,
900L,
1000L,
1100L,
1200L,
1300L,
1400L,
1500L,
1600L,
1700L,
1800L,
1900L,
2000L,
2100L,
2200L,
2300L,
2400L,
2500L,
2600L,
2700L,
2800L,
2900L,
3000L,
3100L,
3200L,
3300L,
3400L,
3500L,
3600L,
3700L,
3800L,
3900L,
4000L,
4100L,
4200L,
4300L,
4400L,
4500L,
4600L,
4700L,
4800L,
4900L,
5000L,
5100L,
5200L,
5300L,
5400L,
5500L,
5600L,
5700L,
5800L,
5900L,
6000L,
6100L,
6200L,
6300L,
6400L,
6500L,
6600L,
6700L,
6800L,
6900L,
7000L,
7100L,
7200L,
7300L,
7400L,
7500L,
7600L,
7700L,
7800L,
7900L
}
),
new Gs2Cdk.Gs2Experience.Model.Options.ExperienceModelOptions {
metadata = "SSR"
}
),
new Gs2Cdk.Gs2Experience.Model.ExperienceModel(
"character_sr",
40L,
70L,
new Gs2Cdk.Gs2Experience.Model.Threshold(
metadata: "CHARACTER",
values: new long[] {
100L,
200L,
300L,
400L,
500L,
600L,
700L,
800L,
900L,
1000L,
1100L,
1200L,
1300L,
1400L,
1500L,
1600L,
1700L,
1800L,
1900L,
2000L,
2100L,
2200L,
2300L,
2400L,
2500L,
2600L,
2700L,
2800L,
2900L,
3000L,
3100L,
3200L,
3300L,
3400L,
3500L,
3600L,
3700L,
3800L,
3900L,
4000L,
4100L,
4200L,
4300L,
4400L,
4500L,
4600L,
4700L,
4800L,
4900L,
5000L,
5100L,
5200L,
5300L,
5400L,
5500L,
5600L,
5700L,
5800L,
5900L,
6000L,
6100L,
6200L,
6300L,
6400L,
6500L,
6600L,
6700L,
6800L,
6900L,
7000L,
7100L,
7200L,
7300L,
7400L,
7500L,
7600L,
7700L,
7800L,
7900L
}
),
new Gs2Cdk.Gs2Experience.Model.Options.ExperienceModelOptions {
metadata = "SR"
}
),
new Gs2Cdk.Gs2Experience.Model.ExperienceModel(
"character_r",
30L,
60L,
new Gs2Cdk.Gs2Experience.Model.Threshold(
metadata: "CHARACTER",
values: new long[] {
100L,
200L,
300L,
400L,
500L,
600L,
700L,
800L,
900L,
1000L,
1100L,
1200L,
1300L,
1400L,
1500L,
1600L,
1700L,
1800L,
1900L,
2000L,
2100L,
2200L,
2300L,
2400L,
2500L,
2600L,
2700L,
2800L,
2900L,
3000L,
3100L,
3200L,
3300L,
3400L,
3500L,
3600L,
3700L,
3800L,
3900L,
4000L,
4100L,
4200L,
4300L,
4400L,
4500L,
4600L,
4700L,
4800L,
4900L,
5000L,
5100L,
5200L,
5300L,
5400L,
5500L,
5600L,
5700L,
5800L,
5900L,
6000L,
6100L,
6200L,
6300L,
6400L,
6500L,
6600L,
6700L,
6800L,
6900L,
7000L,
7100L,
7200L,
7300L,
7400L,
7500L,
7600L,
7700L,
7800L,
7900L
}
),
new Gs2Cdk.Gs2Experience.Model.Options.ExperienceModelOptions {
metadata = "R"
}
),
new Gs2Cdk.Gs2Experience.Model.ExperienceModel(
"equipment",
30L,
50L,
new Gs2Cdk.Gs2Experience.Model.Threshold(
metadata: "EQUIPMENT",
values: new long[] {
200L,
400L,
600L,
800L,
1000L,
1200L,
1400L,
1600L,
1800L,
2000L,
2200L,
2400L,
2600L,
2800L,
3000L,
3200L,
3400L,
3600L,
3800L,
4000L,
4200L,
4400L,
4600L,
4800L,
5000L,
5200L,
5400L,
5600L,
5800L,
6000L,
6200L,
6400L,
6600L,
6800L,
7000L,
7200L,
7400L,
7600L,
7800L,
8000L,
8200L,
8400L,
8600L,
8800L,
9000L,
9200L,
9400L,
9600L,
9800L
}
),
new Gs2Cdk.Gs2Experience.Model.Options.ExperienceModelOptions {
metadata = "EQUIPMENT",
acquireActionRates = new Gs2Cdk.Gs2Experience.Model.AcquireActionRate[] {
new Gs2Cdk.Gs2Experience.Model.AcquireActionRate(
name: "rate-0001",
mode: "big",
bigRates: new string[] {
"1",
"10",
"100",
"1000",
"10000",
"100000",
"1000000",
"10000000",
"100000000",
"1000000000",
"10000000000",
"100000000000",
"1000000000000",
"10000000000000",
"100000000000000",
"1000000000000000",
"10000000000000000",
"100000000000000000",
"1000000000000000000",
"10000000000000000000",
"100000000000000000000",
"1000000000000000000000",
"10000000000000000000000",
"100000000000000000000000",
"1000000000000000000000000",
"10000000000000000000000000",
"100000000000000000000000000"
}
),
}
}
),
new Gs2Cdk.Gs2Experience.Model.ExperienceModel(
"skill",
10L,
20L,
new Gs2Cdk.Gs2Experience.Model.Threshold(
metadata: "SKILL",
values: new long[] {
300L,
600L,
900L,
1200L,
1500L,
1800L,
2100L,
2400L,
2700L,
3000L,
3300L,
3600L,
3900L,
4200L,
4500L,
4800L,
5100L,
5400L,
5700L
}
),
new Gs2Cdk.Gs2Experience.Model.Options.ExperienceModelOptions {
metadata = "SKILL"
}
)
}
);
}
}
Debug.Log(new SampleStack().Yaml()); // Generate TemplateAcquireActionRate
報酬加算テーブルマスター
ランクに応じて報酬の量を調整することができます。
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| name | string | ✓ | ~ 128文字 | 報酬加算テーブル名 | |
| mode | enum { “double”, “big” } | ✓ | “double” | ~ 128文字 | 報酬加算テーブルの種類 |
| rates | List<double> | {mode} == “double” | 1 ~ 10000 items | ランクごとの加算量(倍率) | |
| bigRates | List<string> | {mode} == “big” | 1 ~ 10000 items | ランクごとの加算量(倍率) |
mode に指定する列挙型の定義
| 定義 | 説明 |
|---|---|
| double | 2^48 未満の浮動小数点数 |
| big | 文字列表記で1024桁未満の浮動小数点数 |
VerifyActionResult
検証アクションの実行結果
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| action | enum { } | ✓ | ~ 128文字 | 検証アクションで実行するアクションの種類 | |
| verifyRequest | string | ✓ | ~ 1048576文字 | リクエストのJSON | |
| statusCode | int | ~ 999 | ステータスコード | ||
| verifyResult | string | ~ 1048576文字 | 結果内容 |
action に指定する列挙型の定義
| 定義 | 説明 |
|---|
ConsumeActionResult
消費アクションの実行結果
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| action | enum { } | ✓ | ~ 128文字 | 消費アクションで実行するアクションの種類 | |
| consumeRequest | string | ✓ | ~ 1048576文字 | リクエストのJSON | |
| statusCode | int | ~ 999 | ステータスコード | ||
| consumeResult | string | ~ 1048576文字 | 結果内容 |
action に指定する列挙型の定義
| 定義 | 説明 |
|---|
AcquireActionResult
入手アクションの実行結果
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| action | enum { } | ✓ | ~ 128文字 | 入手アクションで実行するアクションの種類 | |
| acquireRequest | string | ✓ | ~ 1048576文字 | リクエストのJSON | |
| statusCode | int | ~ 999 | ステータスコード | ||
| acquireResult | string | ~ 1048576文字 | 結果内容 |
action に指定する列挙型の定義
| 定義 | 説明 |
|---|
TransactionResult
トランザクション実行結果
サーバーサイドでのトランザクションの自動実行機能を利用して実行されたトランザクションの実行結果
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| transactionId | string | ✓ | 36 ~ 36文字 | トランザクションID | |
| verifyResults | List<VerifyActionResult> | ~ 10 items | 検証アクションの実行結果リスト | ||
| consumeResults | List<ConsumeActionResult> | ~ 10 items | 消費アクションの実行結果リスト | ||
| acquireResults | List<AcquireActionResult> | ~ 100 items | 入手アクションの実行結果リスト |
AcquireAction
入手アクション
GitHubCheckoutSetting
GitHubからマスターデータをチェックアウトする設定
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| apiKeyId | string | ✓ | ~ 1024文字 | GitHub のAPIキーGRN | |
| repositoryName | string | ✓ | ~ 1024文字 | リポジトリ名 | |
| sourcePath | string | ✓ | ~ 1024文字 | ソースコードのファイルパス | |
| referenceType | enum { “commit_hash”, “branch”, “tag” } | ✓ | ~ 128文字 | コードの取得元 | |
| commitHash | string | {referenceType} == “commit_hash” | ~ 1024文字 | コミットハッシュ | |
| branchName | string | {referenceType} == “branch” | ~ 1024文字 | ブランチ名 | |
| tagName | string | {referenceType} == “tag” | ~ 1024文字 | タグ名 |
referenceType に指定する列挙型の定義
| 定義 | 説明 |
|---|---|
| commit_hash | コミットハッシュ |
| branch | ブランチ |
| tag | タグ |
ScriptSetting
スクリプト設定
GS2 ではマイクロサービスのイベントに関連づけて、カスタムスクリプトを実行することができます。
このモデルは、スクリプトの実行をトリガーするための設定を保持します。
スクリプトの実行方式は大きく2種類あり、それは「同期実行」と「非同期実行」です。
同期実行は、スクリプトの実行が完了するまで処理がブロックされます。
かわりに、スクリプトの実行結果を使ってAPIの実行を止めたり、APIの結果を改ざんすることができます。
一方、非同期実行は、スクリプトの実行が完了するまで処理がブロックされません。
かわりに、スクリプトの実行結果を使ってAPIの実行を止めたり、APIの結果を改ざんすることはできません。
しかし、非同期実行は、スクリプトの実行が完了するまで処理がブロックされないため、APIの応答に影響を与えないため、原則非同期実行を使用することをおすすめします。
非同期実行には実行方式が2種類あり、GS2-Script と Amazon EventBridge があります。
Amazon EventBridge を使用することで、Lua 以外の言語で処理を記述することができます。
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| triggerScriptId | string | ~ 1024文字 | スクリプトGRN | ||
| doneTriggerTargetType | enum { “none”, “gs2_script”, “aws” } | ✓ | “none” | ~ 128文字 | 完了通知の通知先 |
| doneTriggerScriptId | string | {doneTriggerTargetType} == “gs2_script” | ~ 1024文字 | スクリプトGRN | |
| doneTriggerQueueNamespaceId | string | {doneTriggerTargetType} == “gs2_script” | ~ 1024文字 | ネームスペースGRN |
doneTriggerTargetType に指定する列挙型の定義
| 定義 | 説明 |
|---|---|
| none | なし |
| gs2_script | GS2-Script |
| aws | Amazon EventBridge |
LogSetting
ログの書き出し設定
ログデータの書き出し設定を管理します。この型は、ログデータを書き出すために使用されるログ名前空間の識別子（Namespace ID）を保持します。
ログ名前空間IDは、ログデータを集約し、保存する対象の GS2-Log の名前空間を指定します。
この設定を通じて、この名前空間以下のAPIリクエスト・レスポンスログデータが対象の GS2-Log へ出力されるようになります。
GS2-Log にはリアルタイムでログが提供され、システムの監視や分析、デバッグなどに利用できます。
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| loggingNamespaceId | string | ✓ | ~ 1024文字 | ネームスペースGRN |
TransactionSetting
トランザクション設定
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| enableAutoRun | bool | ✓ | false | 発行したトランザクションをサーバーサイドで自動的に実行するか | |
| enableAtomicCommit | bool | {enableAutoRun} == true | false | トランザクションの実行をアトミックにコミットするか | |
| transactionUseDistributor | bool | {enableAtomicCommit} == true | false | トランザクションを非同期処理で実行する | |
| acquireActionUseJobQueue | bool | {enableAtomicCommit} == true | false | 入手アクションを実行する際に GS2-JobQueue を使用するか | |
| distributorNamespaceId | string | ✓ | “grn:gs2:{region}:{ownerId}:distributor:default” | ~ 1024文字 | トランザクションの実行に使用する GS2-Distributor ネームスペース |
| queueNamespaceId | string | ✓ | “grn:gs2:{region}:{ownerId}:queue:default” | ~ 1024文字 | トランザクションの実行に使用する GS2-JobQueue のネームスペース |