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ファイルを書き出すことでもサービスを利用可能です。
JSONファイルの形式についてはドキュメントを参照ください。
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| 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 ~ 1000 items | ランクごとの加算量(倍率) | |
| bigRates | List<string> | {mode} == “big” | 1 ~ 1000 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文字 | タグ名 |
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 |
LogSetting
ログの書き出し設定
ログデータの書き出し設定を管理します。この型は、ログデータを書き出すために使用されるログ名前空間の識別子（Namespace ID）を保持します。 ログ名前空間IDは、ログデータを集約し、保存する対象の GS2-Log の名前空間を指定します。 この設定を通じて、この名前空間以下のAPIリクエスト・レスポンスログデータが対象の GS2-Log へ出力されるようになります。 GS2-Log にはリアルタイムでログが提供され、システムの監視や分析、デバッグなどに利用できます。
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| loggingNamespaceId | string | ✓ | ~ 1024文字 | ネームスペースGRN |
TransactionSetting
トランザクション設定
| 型 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|
| enableAutoRun | bool | ✓ | false | 発行したスタンプシートをサーバーサイドで自動的に実行するか | |
| distributorNamespaceId | string | ✓ | “grn:gs2:{region}:{ownerId}:distributor:default” | ~ 1024文字 | スタンプシートの実行に使用する GS2-Distributor ネームスペース |
| queueNamespaceId | string | ✓ | “grn:gs2:{region}:{ownerId}:queue:default” | ~ 1024文字 | スタンプシートの実行に使用する GS2-JobQueue のネームスペース |