グローバルサーバー変数

概要

グローバルサーバー変数はRPGアツマール内で動作する、ゲーム毎にユーザー共通の値をサーバーに記録できる仕組みです。

なにができるのか

ユーザー間で共通の値を参照し、トリガーという機能で値を増減・変更させるゲームが作成できます。
各ゲームごとに複数個のグローバルサーバー変数が利用できるので、変数ごとに違う値を記録し利用することができます。

利用想定／利用例

この機能は、以下のような使い方を想定しています。

• プレイヤーみんなで倒すレイドボス（ボスのHPをグローバルサーバー変数に設定、攻撃をトリガーに設定）
• 全プレイヤーでエンディングまで達成した回数カウントアップ（達成をトリガーにし、変数に+1していく）
• 毎日100人までしか入れない部屋（一人プレイされるごとにカウントアップしていく変数を制限人数として設定し、毎日0時に0を代入する）
• 毎週月曜15時に復活するレイドボス（定期実行(毎週)トリガーで月曜0時に、ボスのHPに最大値を代入する）
• 毎月1日だけ実施されるイベント告知を自動的に表示する（定期実行（毎月）トリガーに文字列型でキャンペーン告知を代入し、翌日は空を代入する）

例えば、次のサンプルゲームではこの機能を利用し、ボスのHPにグローバルサーバー変数を設定しています。

• 【ゲームAPIサンプル】レイドボス（グローバルサーバー変数API）
  • プロジェクトファイルダウンロードはこちら

機能詳細

• グローバルサーバー変数を利用するには、グローバルサーバー変数設定画面 から変数自体の設定と、対応するトリガーの設定が必要 です。
• 新しく変数を作成すると、変数IDが発行されます。IDはすべての変数で一意（ユニーク）の値になっているため、複数の変数を利用したい場合などには、異なるIDで情報の登録・取得を行ってください。
• 変数が作成されるとトリガーが作成できるようになります。トリガーIDもすべてのトリガーで一意（ユニーク）の値になっているため、複数のトリガーを利用したい場合などには、異なるIDで情報の登録・取得を行ってください。
• ゲーム内からトリガーIDまたはトリガー名を指定して変数の変更を行うことができます。
• ゲーム内からグローバルサーバー変数IDまたはグローバルサーバー変数名を指定して現在の値を取得することができます。
• グローバルサーバー変数は、 各ゲーム100個 まで設定可能です。

グローバルサーバ変数の型について

グローバルサーバ変数には整数値を入れることができる「数値型」と、文字列を入れることができる「文字列型」の2つが存在します。 それぞれ数値のみ、文字列のみを入れることができます。 変数の型は、変数設定時に選ぶことができます。

トリガーについて

グローバルサーバー変数をゲーム側から操作する機能を「トリガー」と呼びます。
現在、トリガーは三種類用意されています。 変数に指定できるトリガーは、変数の型ごとに決まっています。例えば「固定値を増減」トリガーを「文字列型」の変数に対して実行することはできません。

※実験的機能のため、動作が不安定になったり、大幅な仕様変更の可能性があります

利用方法

グローバルサーバー変数は次の方法で利用できます。

関連ドキュメント

• グローバルサーバー変数設定画面を利用する
• グローバルサーバー変数プラグインを利用する
• グローバルサーバー変数APIを利用する