- Authors
- Name
Discord Bot開発の準備
Discord開発者ポータルの設定
- Discord Developer PortalでNew Applicationを作成
- Botタブでトークンをコピー（絶対に公開しないでください！）
- OAuth2タブでボット招待URLを生成：
- Scopes:
bot,applications.commands - Permissions: 必要な権限を選択
- Scopes:
プロジェクト設定
# 仮想環境の作成
python -m venv venv
source venv/bin/activate
# Pycordのインストール
pip install py-cord python-dotenv aiohttp
# プロジェクト構造
# my-discord-bot/
# ├── bot.py # メインボットファイル
# ├── cogs/
# │ ├── __init__.py
# │ ├── general.py # 一般コマンド
# │ ├── moderation.py # 管理コマンド
# │ └── fun.py # お楽しみコマンド
# ├── utils/
# │ └── helpers.py
# ├── .env
# └── requirements.txt
.envファイル
DISCORD_TOKEN=your_bot_token_here
GUILD_IDS=123456789012345678
基本的なボット構造
# bot.py
import discord
from discord.ext import commands
import os
from dotenv import load_dotenv
load_dotenv()
# Intentsの設定
intents = discord.Intents.default()
intents.message_content = True
intents.members = True
bot = discord.Bot(intents=intents)
@bot.event
async def on_ready():
print(f"✅ {bot.user} ログイン完了！")
print(f"📊 {len(bot.guilds)}個のサーバーに接続済み")
await bot.change_presence(
activity=discord.Activity(
type=discord.ActivityType.watching,
name="サーバーを監視中 👀"
)
)
# Cogの読み込み
for filename in os.listdir("./cogs"):
if filename.endswith(".py") and not filename.startswith("_"):
bot.load_extension(f"cogs.{filename[:-3]}")
bot.run(os.getenv("DISCORD_TOKEN"))
スラッシュコマンド
# cogs/general.py
import discord
from discord.ext import commands
from discord import option
import aiohttp
from datetime import datetime
class General(commands.Cog):
def __init__(self, bot):
self.bot = bot
@discord.slash_command(name="ping", description="ボットの応答時間を確認します")
async def ping(self, ctx: discord.ApplicationContext):
latency = round(self.bot.latency * 1000)
embed = discord.Embed(
title="🏓 Pong!",
description=f"レイテンシ: **{latency}ms**",
color=discord.Color.green() if latency < 100 else discord.Color.red()
)
await ctx.respond(embed=embed)
@discord.slash_command(name="userinfo", description="ユーザー情報を表示します")
@option("user", description="情報を確認するユーザー", type=discord.Member, required=False)
async def userinfo(self, ctx: discord.ApplicationContext, user: discord.Member = None):
user = user or ctx.author
embed = discord.Embed(
title=f"👤 {user.display_name}",
color=user.color
)
embed.set_thumbnail(url=user.display_avatar.url)
embed.add_field(name="ID", value=user.id, inline=True)
embed.add_field(name="参加日", value=user.joined_at.strftime("%Y-%m-%d"), inline=True)
embed.add_field(name="アカウント作成日", value=user.created_at.strftime("%Y-%m-%d"), inline=True)
embed.add_field(
name="ロール",
value=", ".join([r.mention for r in user.roles[1:]]) or "なし",
inline=False
)
await ctx.respond(embed=embed)
@discord.slash_command(name="weather", description="天気情報を取得します")
@option("city", description="都市名", type=str, required=True)
async def weather(self, ctx: discord.ApplicationContext, city: str):
await ctx.defer() # 応答遅延の表示
async with aiohttp.ClientSession() as session:
url = f"https://wttr.in/{city}?format=j1"
async with session.get(url) as resp:
if resp.status != 200:
await ctx.followup.send("❌ 都市が見つかりません。")
return
data = await resp.json()
current = data["current_condition"][0]
embed = discord.Embed(
title=f"🌤 {city}の天気",
color=discord.Color.blue()
)
embed.add_field(name="🌡 気温", value=f"{current['temp_C']}°C", inline=True)
embed.add_field(name="💧 湿度", value=f"{current['humidity']}%", inline=True)
embed.add_field(name="💨 風速", value=f"{current['windspeedKmph']} km/h", inline=True)
embed.add_field(name="状態", value=current["weatherDesc"][0]["value"], inline=False)
await ctx.followup.send(embed=embed)
def setup(bot):
bot.add_cog(General(bot))
ボタンインタラクション
# cogs/fun.py
import discord
from discord.ext import commands
import random
class RockPaperScissorsView(discord.ui.View):
def __init__(self):
super().__init__(timeout=30)
@discord.ui.button(label="✊ グー", style=discord.ButtonStyle.primary, custom_id="rock")
async def rock(self, button: discord.ui.Button, interaction: discord.Interaction):
await self.play(interaction, "rock")
@discord.ui.button(label="✋ パー", style=discord.ButtonStyle.success, custom_id="paper")
async def paper(self, button: discord.ui.Button, interaction: discord.Interaction):
await self.play(interaction, "paper")
@discord.ui.button(label="✌️ チョキ", style=discord.ButtonStyle.danger, custom_id="scissors")
async def scissors(self, button: discord.ui.Button, interaction: discord.Interaction):
await self.play(interaction, "scissors")
async def play(self, interaction: discord.Interaction, user_choice: str):
choices = {"rock": "✊", "paper": "✋", "scissors": "✌️"}
bot_choice = random.choice(list(choices.keys()))
if user_choice == bot_choice:
result = "🤝 引き分け！"
color = discord.Color.yellow()
elif (user_choice == "rock" and bot_choice == "scissors") or \
(user_choice == "paper" and bot_choice == "rock") or \
(user_choice == "scissors" and bot_choice == "paper"):
result = "🎉 勝利！"
color = discord.Color.green()
else:
result = "😢 敗北！"
color = discord.Color.red()
embed = discord.Embed(title=result, color=color)
embed.add_field(name="あなた", value=choices[user_choice], inline=True)
embed.add_field(name="ボット", value=choices[bot_choice], inline=True)
# ボタンを無効化
for child in self.children:
child.disabled = True
await interaction.response.edit_message(embed=embed, view=self)
class Fun(commands.Cog):
def __init__(self, bot):
self.bot = bot
@discord.slash_command(name="rps", description="じゃんけんゲーム！")
async def rps(self, ctx: discord.ApplicationContext):
embed = discord.Embed(
title="✊✋✌️ じゃんけん！",
description="ボタンをクリックして選択してください！",
color=discord.Color.blue()
)
await ctx.respond(embed=embed, view=RockPaperScissorsView())
def setup(bot):
bot.add_cog(Fun(bot))
モーダルフォーム
class FeedbackModal(discord.ui.Modal):
def __init__(self):
super().__init__(title="📋 フィードバック送信")
self.add_item(discord.ui.InputText(
label="タイトル",
placeholder="フィードバックのタイトルを入力してください",
style=discord.InputTextStyle.short,
required=True,
max_length=100
))
self.add_item(discord.ui.InputText(
label="内容",
placeholder="詳細内容を入力してください",
style=discord.InputTextStyle.long,
required=True,
max_length=2000
))
self.add_item(discord.ui.InputText(
label="スコア (1-5)",
placeholder="1",
style=discord.InputTextStyle.short,
required=False,
max_length=1
))
async def callback(self, interaction: discord.Interaction):
title = self.children[0].value
content = self.children[1].value
rating = self.children[2].value or "未入力"
embed = discord.Embed(
title="📋 新しいフィードバック",
color=discord.Color.blue()
)
embed.add_field(name="タイトル", value=title, inline=False)
embed.add_field(name="内容", value=content, inline=False)
embed.add_field(name="スコア", value=f"{'⭐' * int(rating)}" if rating.isdigit() else rating)
embed.set_footer(text=f"作成者: {interaction.user.display_name}")
# フィードバックチャンネルに送信
feedback_channel = interaction.guild.get_channel(FEEDBACK_CHANNEL_ID)
if feedback_channel:
await feedback_channel.send(embed=embed)
await interaction.response.send_message(
"✅ フィードバックが送信されました！ありがとうございます。", ephemeral=True
)
# スラッシュコマンドでモーダルを開く
@discord.slash_command(name="feedback", description="フィードバックを送信します")
async def feedback(ctx: discord.ApplicationContext):
await ctx.send_modal(FeedbackModal())
セレクトメニュー
class RoleSelectView(discord.ui.View):
@discord.ui.select(
placeholder="ロールを選択してください（最大3つ）",
min_values=1,
max_values=3,
options=[
discord.SelectOption(label="開発者", emoji="💻", value="developer"),
discord.SelectOption(label="デザイナー", emoji="🎨", value="designer"),
discord.SelectOption(label="プランナー", emoji="📊", value="planner"),
discord.SelectOption(label="マーケター", emoji="📢", value="marketer"),
discord.SelectOption(label="データアナリスト", emoji="📈", value="analyst"),
]
)
async def select_callback(self, select: discord.ui.Select, interaction: discord.Interaction):
selected = ", ".join(select.values)
await interaction.response.send_message(
f"✅ 選択したロール: {selected}", ephemeral=True
)
エラーハンドリング
# bot.pyにグローバルエラーハンドラーを追加
@bot.event
async def on_application_command_error(ctx: discord.ApplicationContext, error):
if isinstance(error, commands.MissingPermissions):
await ctx.respond("❌ 権限が不足しています。", ephemeral=True)
elif isinstance(error, commands.CommandOnCooldown):
await ctx.respond(
f"⏳ クールダウン中です。{error.retry_after:.1f}秒後に再試行してください。",
ephemeral=True
)
elif isinstance(error, commands.MemberNotFound):
await ctx.respond("❌ ユーザーが見つかりません。", ephemeral=True)
else:
# ロギング
import traceback
traceback.print_exception(type(error), error, error.__traceback__)
await ctx.respond("❌ エラーが発生しました。", ephemeral=True)
管理コマンド
# cogs/moderation.py
class Moderation(commands.Cog):
def __init__(self, bot):
self.bot = bot
@discord.slash_command(name="clear", description="メッセージを削除します")
@commands.has_permissions(manage_messages=True)
@option("amount", description="削除するメッセージ数", type=int, min_value=1, max_value=100)
async def clear(self, ctx: discord.ApplicationContext, amount: int):
deleted = await ctx.channel.purge(limit=amount)
await ctx.respond(f"🗑️ {len(deleted)}件のメッセージを削除しました", ephemeral=True)
@discord.slash_command(name="slowmode", description="スローモードを設定します")
@commands.has_permissions(manage_channels=True)
@option("seconds", description="秒数（0=解除）", type=int, min_value=0, max_value=21600)
async def slowmode(self, ctx: discord.ApplicationContext, seconds: int):
await ctx.channel.edit(slowmode_delay=seconds)
if seconds == 0:
await ctx.respond("✅ スローモードが解除されました。")
else:
await ctx.respond(f"✅ スローモード: {seconds}秒に設定されました")
def setup(bot):
bot.add_cog(Moderation(bot))
デプロイ
systemdサービス
# /etc/systemd/system/discord-bot.service
[Unit]
Description=Discord Bot
After=network.target
[Service]
Type=simple
User=bot
WorkingDirectory=/opt/discord-bot
ExecStart=/opt/discord-bot/venv/bin/python bot.py
Restart=always
RestartSec=10
EnvironmentFile=/opt/discord-bot/.env
[Install]
WantedBy=multi-user.target
sudo systemctl enable discord-bot
sudo systemctl start discord-bot
sudo journalctl -u discord-bot -f
📝 確認クイズ（6問）
Q1. Discord BotのIntentsとは？
ボットが受信するイベントの種類を指定する設定です。Privileged Intents（message_content、members）はDeveloper Portalで別途有効化が必要です。
Q2. スラッシュコマンドでctx.defer()はいつ使いますか？
応答に3秒以上かかる場合に使用します。defer()の後、ctx.followup.send()で実際の応答を送信します。
Q3. ephemeral=Trueの意味は？
そのメッセージがコマンドを実行したユーザーにのみ表示されるようにします。他のユーザーには見えません。
Q4. Cogの利点は？
コマンドをモジュール別に分離して管理でき、動的にロード/アンロードできます。コード構造化とメンテナンスに有利です。
Q5. Viewのtimeoutパラメータは何を制御しますか？
ボタン/セレクトメニューが無効化されるまでの時間（秒）です。Noneに設定するとタイムアウトなしになります。
Q6. Modalと通常のメッセージの違いは？
Modalはユーザーに入力フォームを表示して構造化されたデータを受け取ることができます。通常のメッセージはテキストのみのやり取りです。