Bot の管理

ストレージ(カスタム変数・データ型)

「ストレージ」(メニュー上の表記は「データストレージ」)は、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...」から登録済みのデータ型のプロパティをまとめて読み込めます。

次のステップ・関連ページ

最終更新:

目次