Bot 機能(モジュール)

通貨レート

通貨レート機能は、通貨を換算できる /currency コマンドを提供する機能です。外部のレートを用いてリアルタイムで換算し、from と to の通貨を入れ替える「反転ボタン」を結果に付けることもできます。コマンドの有効状態や権限、反転ボタンの表示をダッシュボードから設定できます。

通貨レート機能は本来プレミアム向けの機能ですが、ベータ版のあいだは全ユーザーに無料でプレミアムが付与されているため、追加の費用なくご利用いただけます(ベータ終了後はプレミアム限定になる予定です)。プレミアムの扱いはモジュールの基本と共通操作をご覧ください。

できること

  • /currency コマンドで、金額をある通貨から別の通貨へ換算できます。
  • 換算結果に、from と to を入れ替えて再換算する反転ボタンを付けられます。
  • /currency コマンドの有効/無効と権限を設定できます。

設定の手順

機能を有効化する

通貨レート機能の設定ページを開き、ページ上部にある「機能の有効化」のスイッチをオンにします。このスイッチがオフのままだと、以下で設定した内容は反映されません。

コマンドの有効状態と権限を設定する

「コマンド権限設定」のブロックで、/currency の有効/無効を切り替え、必要に応じて権限を設定します。

項目説明
「個別権限設定を有効化」オンにすると BotShade 独自の権限設定を使い、オフのときは通常の Discord 権限判定を使います。
「Discord権限より個別設定を優先」個別権限設定を、Discord 側の既存権限よりも優先して適用します(取り扱いに注意が必要な設定です)。

権限設定の詳しい考え方は コマンドの権限設定 を参照してください。

反転ボタンの表示を選ぶ

「表示設定」で、換算結果に反転ボタンを表示するかどうかを切り替えます(既定はオン)。オフにすると、結果に反転ボタンが付かなくなります。

保存する

設定を変更すると画面下部に保存バーが表示されるので、「保存」または「破棄」を選びます。

コマンド一覧

/currency <amount> <from> <to>

amount(数値)を from 通貨から to 通貨へ換算します。

  • from / to には、ISO4217 の通貨コード(USDJPYEUR など)のほか、別名(例:「ドル」)を受け付けます。
  • from / to の入力時には候補(オートコンプリート)が表示されます。

実際の動作と既定値

  • 換算の取得方法: 外部のレートを取得してから結果を返すため、表示まで少し時間がかかることがあります。
  • 反転ボタン: 反転ボタンを押すと、同じ金額のまま from と to を入れ替えて再換算します。
  • 反転ボタンの操作者: 反転ボタンを操作できるのは、コマンドを実行した本人だけです。
  • レートの出典・時点: 換算に使ったレートの出典や時点は、メッセージのフッターに表示されます。
項目既定
反転ボタンの表示オン
クールダウン約 5 秒

注意点・うまくいかないとき

  • 反転ボタンが表示されない: 「表示設定」で反転ボタンの表示がオフになっている可能性があります。利用するにはオンにしてください。
  • 通貨が認識されない: from / to には ISO4217 の通貨コードや別名を指定できます。入力候補(オートコンプリート)から選ぶと確実です。

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

最終更新:

目次