ストレージ(カスタム変数・データ型)
「ストレージ」(メニュー上の表記は「データストレージ」)は、Bot のコマンドやイベントで使い回せるカスタム変数と、変数の中身を構造化するためのデータ型を管理する画面です。変数に実際に保存された値の確認・修正もここで行います。ここで作成した変数は、データベースに保存され続ける**永続変数(BSVAR_ で始まる変数)**です。
変数そのものの考え方や式の中での使い方は、永続変数・コマンド内での変数の使い方・データ型で解説しています。
カスタム変数は 1 つの Bot につき最大 1000 件まで作成できます。
変数
変数を作成するときに決めるのは、表示名・データタイプ・スコープ・デフォルト値です。
「リファレンス名」は自分では決められません。 BSVAR_ の後ろに、表示名を英数字とアンダースコアへ整えた名前が自動で付きます(読み取り専用)。コマンドの式では、このリファレンス名を使います。
スコープ
| スコープ | 値の持ち方 |
|---|---|
| 「グローバル(Global)」 | Bot 全体で 1 つの値を共有します。 |
| 「サーバー毎(Guild)」 | サーバー(ギルド)ごとに別々の値を持ちます。 |
| 「ユーザー毎(User)」 | Discord ユーザーごとに別々の値を持ちます。 |
データタイプで「ユーザー(User)」「チャンネル(Channel)」を選んだときは、各ユーザー・各チャンネルに保存する中身の型をあわせて選びます。
変数を削除すると元に戻せません。すでにコマンドやイベントでその変数を使っている場合は、削除前に参照箇所を確認してください。
保存された値
- 「値を編集」で保存した値は、次の実行から使われます。実行中のコマンドが同じ変数を書き換えた場合は、あとから書かれたほうが残ります。
- 変数の定義を削除しても、保存された値は残ります。 残った値は「定義なし」と表示され、実行時には使われません。不要であれば「保存された値」タブから削除してください。
データ型
「データ型」タブでは、オブジェクト型の変数の「中身の形」を定義します。たとえば「名前」「レベル」「経験値」をまとめた RPGStats のような型を作っておくと、変数の作成時に同じ構造を繰り返し使えます。
最初から、よく使う既定のデータ型(User / Guild / Channel / Time / Money / Url など)が用意されています。これらも編集できますが、経済機能などで使われる Money だけは削除できません。
作成したデータ型は、変数作成フォームで「オブジェクト(Object)」を選んだとき、または「ユーザー(User)」「チャンネル(Channel)」の中身の型として選べます。オブジェクト型の変数では、「Load Type...」から登録済みのデータ型のプロパティをまとめて読み込めます。
次のステップ・関連ページ
- 永続変数 —
BSVAR_変数とスコープの考え方を詳しく - コマンド内での変数の使い方 — 作った変数を式の中で読み書きする方法
- データ型 — オブジェクト型・データ型の構造についての解説
- Bot概要 — Bot 管理画面全体の見取り図
最終更新: