discord.py で埋め込み(Embed)メッセージを作る方法|色・画像・フィールドまで
左に色の線が付いた、タイトルや項目つきのメッセージを「埋め込み(Embed)」と呼びます。お知らせ・ヘルプ・ステータス表示など、見やすい Bot を作るには欠かせません。このページでは、discord.py での Embed の作り方を、基本から画像・フィールド・よくあるエラーまで説明します。
基本の Embed
@bot.tree.command(name="info", description="サーバーの情報を表示します")
async def info(interaction: discord.Interaction):
embed = discord.Embed(
title="サーバー情報",
description="このサーバーの基本情報です。",
color=discord.Color.green(),
)
embed.add_field(name="メンバー数", value=str(interaction.guild.member_count))
embed.add_field(name="作成日", value=interaction.guild.created_at.strftime("%Y/%m/%d"))
await interaction.response.send_message(embed=embed)
Embed で設定できる項目
| 項目 | 書き方 | 表示される場所 |
| タイトル | title="..." | 一番上の太字 |
|---|---|---|
| 説明文 | description="..." | タイトルの下 |
| 色 | color=0x22c55e | 左の線の色 |
| リンク | url="https://..." | タイトルがリンクになる |
| フィールド | add_field(name, value, inline) | 本文の項目 |
| 作成者 | set_author(name, icon_url) | タイトルの上 |
| サムネイル | set_thumbnail(url) | 右上の小さい画像 |
| 画像 | set_image(url) | 下の大きい画像 |
| フッター | set_footer(text, icon_url) | 一番下の小さい文字 |
| 時刻 | timestamp=discord.utils.utcnow() | フッターの横 |
画像・アイコン・フッターを付ける
embed = discord.Embed(title="プロフィール", color=0x22c55e, timestamp=discord.utils.utcnow())
member = interaction.user
embed.set_author(name=member.display_name, icon_url=member.display_avatar.url)
embed.set_thumbnail(url=member.display_avatar.url)
embed.add_field(name="参加日", value=member.joined_at.strftime("%Y/%m/%d"), inline=True)
embed.add_field(name="ロール数", value=str(len(member.roles) - 1), inline=True)
embed.set_footer(text="Steller Bot")
inline=True のフィールドは横に並び(最大3つ)、inline=False は1行を使います。
手元の画像ファイルを使う
インターネット上の URL ではなく、手元の画像を Embed に表示するには、ファイルとして一緒に送り、attachment://ファイル名 で指定します。
file = discord.File("images/banner.png", filename="banner.png")
embed = discord.Embed(title="お知らせ")
embed.set_image(url="attachment://banner.png")
await interaction.response.send_message(embed=embed, file=file)
送った Embed をあとから書き換える
msg = await channel.send(embed=embed)
embed.description = "更新しました"
await msg.edit(embed=embed)
ステータス表示やランキングなど、内容が変わるメッセージに便利です。
文字数などの上限
- タイトル:256文字まで
- 説明文:4096文字まで
- フィールド:25個まで(名前256文字・値1024文字まで)
- フッター:2048文字まで
- 1つの Embed 全体で6000文字まで、1メッセージに Embed は10個まで
上限を超えると 400 Bad Request (error code: 50035): Invalid Form Body というエラーになります。長いデータは複数の Embed やページ分けにしましょう。
よくあるエラー
Embed が表示されない(リンクのテキストだけ出る)
Bot に「埋め込みリンク(Embed Links)」の権限がありません。サーバー設定のロールで権限を付けてください。
画像が表示されない
URL が画像そのものを指しているか(.png などで終わる直リンクか)、ローカル画像なら attachment:// のファイル名が一致しているかを確認します。
まとめ
discord.Embed(title, description, color)で作り、add_fieldで項目を足す- 画像は
set_image、ローカル画像はattachment:// - 文字数の上限と「Embed Links」権限に注意
Discord Bot を、月 ¥180 で24時間。
支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →ほかのガイド
discord.py でボタン・セレクトメニューを作る方法|再起動後も動く永続ボタンまでdiscord.ui を使ったボタン・セレクトメニュー・入力フォーム(モーダル)の作り方と、Bot を再起動しても押せる永続ボタンの作り方を解説します。読む →
Discord Bot で参加時の歓迎メッセージ・ロール自動付与を作る方法discord.py でメンバーの参加・退出を検知し、歓迎メッセージ・ロールの自動付与・DM 送信を作る方法と、動かないときの確認ポイントを解説します。読む →
Discord Bot のレート制限(429 Too Many Requests)の原因と対処法Bot のログに出る 429・We are being rate limited の意味と、ループでの連続送信や短すぎる定期処理などの原因、待ち時間を入れるなどの対処法を解説します。読む →
discord.py のよくあるエラー一覧と解決方法【まとめ】LoginFailure・PrivilegedIntentsRequired・ModuleNotFoundError・Missing Permissions・インタラクションに失敗しました など、discord.py でよく出るエラーの意味と直し方を一覧にまとめました。読む →
requirements.txt の書き方|Bot に必要なライブラリをサーバーに入れる方法サーバーで ModuleNotFoundError が出る原因と、requirements.txt の書き方・自動で作る方法・バージョン指定・import 名とインストール名が違うライブラリの一覧を解説します。読む →
discord.py の Cog でコマンドをファイルごとに分ける方法discord.py 2.x の Cog を使って、コマンドやイベントを機能ごとのファイルに分ける方法を解説。setup・load_extension・再読み込み・よくあるエラーまで紹介します。読む →