NAV
GS2-Deploy

GS2-Experience

GS2-Deploy のテンプレートで使用できるリソース定義のリファレンス

エンティティ

Namespace

Namespace

Type: GS2::Experience::Namespace
Properties:
  Name: namespace1
  Description: null
  ExperienceCapScriptId: null
  ChangeExperienceScript: null
  ChangeRankScript: null
  ChangeRankCapScript: null
  OverflowExperienceScript: null
  LogSetting: 
    LoggingNamespaceId: grn:gs2:ap-northeast-1:YourOwnerId:log:namespace1

ネームスペースは一つのプロジェクトで同じサービスを異なる用途で複数利用できるようにするための仕組みです。 GS2 のサービスは基本的にネームスペースというレイヤーがあり、ネームスペースが異なれば同じサービスでもまったく別のデータ空間として取り扱われます。

そのため、各サービスの利用を開始するにあたってネームスペースを作成する必要があります。

必須 デフォルト 値の制限 説明
name string ~ 32文字 ネームスペース名
description string ~ 1024文字 説明文
experienceCapScriptId string ~ 1024文字 ランクキャップを動的に決定するスクリプト
changeExperienceScript ScriptSetting 経験値変化したときに実行するスクリプト
changeRankScript ScriptSetting ランク変化したときに実行するスクリプト
changeRankCapScript ScriptSetting ランクキャップ変化したときに実行するスクリプト
overflowExperienceScript ScriptSetting 経験値あふれしたときに実行するスクリプト
logSetting LogSetting ログの出力設定

ExperienceModelMaster

ExperienceModelMaster

Type: GS2::Experience::ExperienceModelMaster
Properties:
  NamespaceName: namespace1
  Name: experience-model-0001
  Description: null
  Metadata: null
  DefaultExperience: null
  DefaultRankCap: 50
  MaxRankCap: 50
  RankThresholdName: $threshold1.name

経験値の種類とは、ランクアップに必要な経験値の閾値や、デフォルトのランクキャップ・最大ランクキャップ毎に設定するエンティティです。

必須 デフォルト 値の制限 説明
namespaceName string ~ 32文字 ネームスペース名
name string ~ 128文字 経験値の種類名
description string ~ 1024文字 説明文
metadata string ~ 2048文字 メタデータ
defaultExperience long 0 ~ 9223372036854775807 経験値の初期値
defaultRankCap long ~ 9223372036854775807 ランクキャップの初期値
maxRankCap long ~ 9223372036854775807 ランクキャップの最大値
rankThresholdName string ~ 128文字 ランクアップ閾値

ThresholdMaster

ThresholdMaster

Type: GS2::Experience::ThresholdMaster
Properties:
  NamespaceName: namespace1
  Name: threshold-0001
  Description: null
  Metadata: null
  Values: 
    - 100
    - 200
    - 300

ランクアップ閾値は経験値からランク(レベル)を決定するために必要な数列です。 [10, 20] という値を設定した場合、経験値の値が 1~9 の間はランク1 10~19 の間はランク2 経験値の値が 20 でランク3 となりそれ以上経験値を入手することが出来なくなります。

必須 デフォルト 値の制限 説明
namespaceName string ~ 32文字 ネームスペース名
name string ~ 128文字 ランクアップ閾値名
description string ~ 1024文字 説明文
metadata string ~ 2048文字 メタデータ
values long[] ランクアップ経験値閾値リスト

CurrentExperienceMaster

CurrentExperienceMaster

Type: GS2::Experience::CurrentExperienceMaster
Properties:
  NamespaceName: namespace1
  Settings: {\n  "version": "2019-01-11",\n  "experienceModels": [\n    {\n      "name": "character_ssr",\n      "metadata": "SSR",\n      "defaultExperience": 0,\n      "defaultRankCap": 50,\n      "maxRankCap": 80,\n      "rankThreshold": {\n        "metadata": "CHARACTER",\n        "values": [\n          100,\n          200,\n          300,\n          400,\n          500,\n          600,\n          700,\n          800,\n          900,\n          1000,\n          1100,\n          1200,\n          1300,\n          1400,\n          1500,\n          1600,\n          1700,\n          1800,\n          1900,\n          2000,\n          2100,\n          2200,\n          2300,\n          2400,\n          2500,\n          2600,\n          2700,\n          2800,\n          2900,\n          3000,\n          3100,\n          3200,\n          3300,\n          3400,\n          3500,\n          3600,\n          3700,\n          3800,\n          3900,\n          4000,\n          4100,\n          4200,\n          4300,\n          4400,\n          4500,\n          4600,\n          4700,\n          4800,\n          4900,\n          5000,\n          5100,\n          5200,\n          5300,\n          5400,\n          5500,\n          5600,\n          5700,\n          5800,\n          5900,\n          6000,\n          6100,\n          6200,\n          6300,\n          6400,\n          6500,\n          6600,\n          6700,\n          6800,\n          6900,\n          7000,\n          7100,\n          7200,\n          7300,\n          7400,\n          7500,\n          7600,\n          7700,\n          7800,\n          7900\n        ]\n      }\n    },\n    {\n      "name": "character_sr",\n      "metadata": "SR",\n      "defaultExperience": 0,\n      "defaultRankCap": 40,\n      "maxRankCap": 70,\n      "rankThreshold": {\n        "metadata": "CHARACTER",\n        "values": [\n          100,\n          200,\n          300,\n          400,\n          500,\n          600,\n          700,\n          800,\n          900,\n          1000,\n          1100,\n          1200,\n          1300,\n          1400,\n          1500,\n          1600,\n          1700,\n          1800,\n          1900,\n          2000,\n          2100,\n          2200,\n          2300,\n          2400,\n          2500,\n          2600,\n          2700,\n          2800,\n          2900,\n          3000,\n          3100,\n          3200,\n          3300,\n          3400,\n          3500,\n          3600,\n          3700,\n          3800,\n          3900,\n          4000,\n          4100,\n          4200,\n          4300,\n          4400,\n          4500,\n          4600,\n          4700,\n          4800,\n          4900,\n          5000,\n          5100,\n          5200,\n          5300,\n          5400,\n          5500,\n          5600,\n          5700,\n          5800,\n          5900,\n          6000,\n          6100,\n          6200,\n          6300,\n          6400,\n          6500,\n          6600,\n          6700,\n          6800,\n          6900,\n          7000,\n          7100,\n          7200,\n          7300,\n          7400,\n          7500,\n          7600,\n          7700,\n          7800,\n          7900\n        ]\n      }\n    },\n    {\n      "name": "character_r",\n      "metadata": "R",\n      "defaultExperience": 0,\n      "defaultRankCap": 30,\n      "maxRankCap": 60,\n      "rankThreshold": {\n        "metadata": "CHARACTER",\n        "values": [\n          100,\n          200,\n          300,\n          400,\n          500,\n          600,\n          700,\n          800,\n          900,\n          1000,\n          1100,\n          1200,\n          1300,\n          1400,\n          1500,\n          1600,\n          1700,\n          1800,\n          1900,\n          2000,\n          2100,\n          2200,\n          2300,\n          2400,\n          2500,\n          2600,\n          2700,\n          2800,\n          2900,\n          3000,\n          3100,\n          3200,\n          3300,\n          3400,\n          3500,\n          3600,\n          3700,\n          3800,\n          3900,\n          4000,\n          4100,\n          4200,\n          4300,\n          4400,\n          4500,\n          4600,\n          4700,\n          4800,\n          4900,\n          5000,\n          5100,\n          5200,\n          5300,\n          5400,\n          5500,\n          5600,\n          5700,\n          5800,\n          5900,\n          6000,\n          6100,\n          6200,\n          6300,\n          6400,\n          6500,\n          6600,\n          6700,\n          6800,\n          6900,\n          7000,\n          7100,\n          7200,\n          7300,\n          7400,\n          7500,\n          7600,\n          7700,\n          7800,\n          7900\n        ]\n      }\n    },\n    {\n      "name": "equipment",\n      "metadata": "EQUIPMENT",\n      "defaultExperience": 0,\n      "defaultRankCap": 30,\n      "maxRankCap": 50,\n      "rankThreshold": {\n        "metadata": "EQUIPMENT",\n        "values": [\n          200,\n          400,\n          600,\n          800,\n          1000,\n          1200,\n          1400,\n          1600,\n          1800,\n          2000,\n          2200,\n          2400,\n          2600,\n          2800,\n          3000,\n          3200,\n          3400,\n          3600,\n          3800,\n          4000,\n          4200,\n          4400,\n          4600,\n          4800,\n          5000,\n          5200,\n          5400,\n          5600,\n          5800,\n          6000,\n          6200,\n          6400,\n          6600,\n          6800,\n          7000,\n          7200,\n          7400,\n          7600,\n          7800,\n          8000,\n          8200,\n          8400,\n          8600,\n          8800,\n          9000,\n          9200,\n          9400,\n          9600,\n          9800\n        ]\n      }\n    },\n    {\n      "name": "skill",\n      "metadata": "SKILL",\n      "defaultExperience": 0,\n      "defaultRankCap": 10,\n      "maxRankCap": 20,\n      "rankThreshold": {\n        "metadata": "SKILL",\n        "values": [\n          300,\n          600,\n          900,\n          1200,\n          1500,\n          1800,\n          2100,\n          2400,\n          2700,\n          3000,\n          3300,\n          3600,\n          3900,\n          4200,\n          4500,\n          4800,\n          5100,\n          5400,\n          5700\n        ]\n      }\n    }\n  ]\n}

GS2ではマスターデータの管理にJSON形式のファイルを使用します。 ファイルをアップロードすることで、実際にサーバーに設定を反映することができます。

JSONファイルを作成する方法として、マネージメントコンソール上でのマスターデータエディタを提供していますが よりゲームの運営に相応しいツールを作成し、適切なフォーマットのJSONファイルを書き出すことでもサービスを利用可能です。

JSONファイルの形式についてはドキュメントを参照ください。

必須 デフォルト 値の制限 説明
namespaceName string ~ 32文字 ネームスペース名
settings string ~ 5242880文字 マスターデータ