スコアボード
編集目次
プラグインの利用方法
プラグインでスコアボードを利用するには以下のようにします。
- プラグインのダウンロード：AtsumaruScoreboards.js を右クリックで「名前をつけて保存」してダウンロード
- プロジェクトに追加：ダウンロードしたファイルをプロジェクトのプラグインフォルダに設置
- 有効化：プロジェクトのプラグイン設定でプラグインをONにする
機能の呼び出し
スコアボードへの記録
公式プラグインを利用してスコアボードへの記録を行う場合、プラグインコマンドで次のいずれかのように指定します（どちらでも動作は同じです）。
SetRecordToScoreboard <boardId> <variableId>あるいは
スコア送信 <boardId> <variableId><boardId> にはスコアを記録したいスコアボードのIDを半角数字で指定してください。また、 <variableId> にはスコアが格納されている変数のIDを記載してください。スコアの値としてゲームアツマールがサポートしている範囲は -999,999,999,999,999 ～ +999,999,999,999,999 です。
スコアボードへの記録：応用
スコアボードへの記録を行いながら、記録に成功したかチェックする場合、プラグインコマンドで次のいずれかのように指定します（どちらでも動作は同じです）。
SetRecordToScoreboard <boardId> <variableId> <errorVariableId>あるいは
スコア送信 <boardId> <variableId> <errorVariableId>記録に失敗した場合、<errorVariableId>で指定されたIDの変数にエラーメッセージがセットされます。記録に成功した場合は、単に0がセットされます。
スコアボードの表示
公式プラグインを利用してスコアボードへの記録を行う場合、プラグインコマンドで次のいずれかのように指定します（どちらでも動作は同じです）。
DisplayScoreboard <boardId>あるいは
記録に失敗した場合、`<errorVariableId>`で指定されたIDの変数にエラーメッセージがセットされます。記録に成功した場合は、単に0がセットされます。<boardId>には表示したスコアボードのIDを半角数字で指定してください。
スコアボード内の情報利用
スコアボード内に格納されている情報を利用するには、事前に上述の方法でスコアボードからデータを読み込み、下記の方法で利用する情報をターゲットとして指定し変数に格納してください。
公式プラグインを利用してスコアボード内の情報を変数に格納するには、プラグインコマンドで次のいずれかのように指定します。（どちらでも動作は同じです）
GetDataFromScoreboardRecords <target> <variableId>あるいは
スコア取得 <target> <variableId><target>には取得したいターゲットを指定(下部に利用できるターゲットを記載)。<variableId>には格納したい変数のIDを指定してください。
利用できるターゲットの一覧
| ターゲット | 説明 |
|---|---|
| myRecord | 今回の自己レコードの有無を取得。ある場合は1、ない場合は0がセットされる |
| myRecord.rank | 今回の自己レコードのランキング順位を取得。ない場合は0がセットされる |
| myRecord.score | 今回の自己レコードのスコアを取得。ない場合は0がセットされる |
| myRecord.isNewRecord | 今回の自己レコードが自己新記録かどうかを取得。自己新記録なら1、そうでない場合は0がセットされる |
| myBestRecord | 自己ベスト記録の有無を取得。ある場合は1、ない場合（または非ログイン）は0がセットされる |
| myBestRecord.rank | 自己ベスト記録のランキング順位を取得。ない場合（または非ログイン）は0がセットされる |
| myBestRecord.score | 自己ベスト記録のスコアを取得。ない場合（または非ログイン）は0がセットされる |
| ranking.length | ランキングデータの長さの取得 |
| ranking[n].rank | n+1番目のランキングを取得 |
| ranking[n].userName | n+1番目のランクのユーザ名を取得 |
| ranking[n].score | n+1番目のランクのスコアを取得 |
| errorMessage | スコアの読み込みに失敗した場合、エラーメッセージを取得する。成功した場合は0がセットされる |
関連ドキュメント
| ドキュメント | リンク | 備考 |
|---|---|---|
| 機能解説 | スコアボード | 機能概要や全般的な解説 |
| APIでの利用方法 | スコアボード | 他ゲームエンジンやより高度な利用を必要とするユーザー向け |
最終更新日
- 2020/02/28