discord.py

by: 呂家睿

自介

建中資訊38th學術長+副社
原神好玩，貓戰也好玩，~~釣魚好玩?~~
我很菜，都被電爛
有程式(或數學?)相關的問題可以問我
頭像是應急食品

其他咚咚

C++
python
~~競程是什麼可以吃嗎?~~
數學好難
喜歡做遊戲開發，歡迎問我、找我、煩我
上面這點很重要，再讀一次

discord.py

What is

BOTS

幫助管理

提供娛樂

結合其他平台

discord.py

TOKEN

Setup

~~理論可行，無法實踐~~

安裝vscode

1. 點我下載vscode

2. 打開下載的檔案，勾選同意然後一直按繼續，最後按安裝

這裝的是windows版，如果回家想裝符合自己裝置的版本點這裡

開file

開一個folder

2. 用code editor 或 IDE (我們會用vscode)開啟那個folder

3. 加一個file

PyPI

Python Package Index

big code

你想/會寫的

PyPI

你不會/懶得寫的

pip

Pip installs package

是一個指令，可以幫助你處理有關套件的東西。下面是一些常用的指令

pip install package_name 	#從PyPI幫你把你要的套件下載

pip uninstall package_name	#解安裝

pip show package_name		#顯示這個套件的一些資訊

pip list					#顯示你有的所有套件

pip install discord.py

現在在你的terminal打上這個

discord application

OK所以我們要先領取一個機器人然後再寫他的程式

1.取名字好難

點new application然後給你的機器人取名

2.點選左邊bot的欄位

把三個priveledge gateway intent 打開

discord application

接著要把它丟進你想要的伺服器

3. 點選左邊OAuth2

在OAuth2 URL Generator的地方把bot打勾
把bot permission的 administrator也打勾
最下面會有一個URL，複製你的URL在新分頁把它打開

4. 選擇你想要丟的伺服器

我個人建議你開一個自己的然後丟上去

discord application

現在如果你打開你的伺服器, 然後看到機器人在裡面你就成功了!!!!

終於可以寫扣了

Event

是bot的登入憑證(像是密碼)
有他就可以控制你的bot
不要洩漏出去!!

Token

點這個他會幫你生Token

簡單的東西?

import discord
from discord.ext import commands

TOKEN = "Type Your Token"
intents = discord.Intents.all()
bot = commands.Bot(command_prefix = "?", intents = intents)

bot.run(TOKEN)

先import一些需要的東西

這個是指令前綴，比如說!?*>&%$之類的，可以自己選自己想要的

先import一些需要的東西

記得加這行你的機器人才會運作

把重要資料存在另外一個檔案
可以保密重要資訊(ex: TOKEN)

Token & .env

import discord
from discord.ext import commands

from dotenv import load_dotenv
import os

load_dotenv()
TOKEN = os.getenv("DISCORD_TOKEN")

intents = discord.Intents.all()
bot = commands.Bot(command_prefix = "?", intents = intents)

bot.run(TOKEN)

DISCORD_TOKEN = "Your TOKEN"

1. 開一個.env

2. install python-dotenv

pip install python-dotenv

簡單的東西?

如果你Run這個程式的話，應該會看到妳的bot變成online了

bot該起床了

@bot.event
async def on_ready():
    print(f"阿~~ {bot.user.name} 起床了!")

在你的機器人on_ready(啟動)的時候會叫這個函式

裝飾器

(這個我們有空再講)

機器人的名字

函式名字要打一樣的

async def & await

宣告一個特殊函式，裡面可以進行await功能

加在一行程式前面
告訴電腦這行程式很慢，讓他去先執行別的事情
必須要是awaitable物件才能加await

講白了就是讓電腦不要白等，讓程式更快

async def & await

import time

def weird_func(num):
    print(num)
    time.sleep(2)


start_time = time.time()

for i in range(5):
    weird_func(i)
print(f"Total time = {time.time() - start_time}")

飯粒

沒用async

用async

import time
import asyncio

async def weird_func(num):
    print(num)
    await asyncio.sleep(2)

async def main():
    await asyncio.gather(*(weird_func(i) for i in range(5)))

start_time = time.time()
asyncio.run(main())
print(f"Total time {time.time() - start_time} seconds")

其他event

@bot.event
async def on_member_join(member: discord.Member):
    await member.send(f"很高興認識你{member.name}!\n我是機器人{bot.user.name}!\n祝你抽卡不歪!!")

@bot.event
async def on_message(message: discord.Message):
    if message.author == bot.user:
        return
    if "金" in message.content:
        await message.reply("一發出金!!")
        
    await bot.process_commands(message)

有成員加入時會呼叫

有人發訊息時會呼叫

.send會私訊

會回覆這則訊息

這行很重要一定要加

full code

import discord
from discord.ext import commands


TOKEN = "Your token"
intents = discord.Intents.all()
bot = commands.Bot(command_prefix = "?", intents = intents)


@bot.event
async def on_ready():
    print(f"阿~~ {bot.user.name} 起床了!")

@bot.event
async def on_member_join(member: discord.Member):
    await member.send(f"很高興認識你{member.name}!\n我是機器人{bot.user.name}!\n祝你抽卡不歪!!")

@bot.event
async def on_message(message: discord.Message):
    if message.author == bot.user:
        return
    if "金" in message.content:
        await message.reply("一發出金!!")

    await bot.process_commands(message)

    
bot.run(TOKEN)

其他還有很多的event

這邊給幾個建議的可以看看

Prefix Command

!?*>&%$

hello world

@bot.command()
async def hello(ctx: commands.Context):
    await ctx.send(f"{ctx.author.mention}很高興認識你")

從event變成了command呢

這個是會@發訊息的人

大概長這樣子

如果不行的話可能是你的on_message函式沒加這行

await bot.process_commands(message)

from datetime import datetime

@bot.command()
async def time(ctx: commands.Context):
    cur_time = datetime.now()
    cur_time_string = cur_time.strftime("%Y/%m/%d %H:%M:%S")
    await ctx.reply(f"讓我掐指一算，現在大概是{cur_time_string}左右")

記得import才能用喔

一些有趣的飯粒

指令也可以結合python的其他library

這個就是簡單的求時間指令

datetime的簡單教學

英文版(我覺得寫得比較好)

中文版

大概長這樣

import random

rng = random.SystemRandom()

@bot.command()
async def wish(ctx: commands.Context):
    await ctx.reply(f"Hmmm所以你想要抽卡是吧?那就助你出金囉\n**請自行腦補抽卡介面**")
    wish_rng = rng.randint(1, 1000)
    if wish_rng <= 970:
        await ctx.reply(f"恩好吧你抽到了垃圾呢")
    elif wish_rng <= 997:
        await ctx.reply(f"歐優不錯喔出紫了")
    else:
        await ctx.reply(f"OMG出金了!!!!woooooooooooooooooooo")

非常簡易的賭博抽卡模擬器

random也是非常實用的library大家成發時也可以多多使用!

random的簡單教學

python官方給的

我覺得稍微容易一點的

權限和error

有些指令可能不想給所有人使用，這時候就可以設定role權限

@bot.command()
@commands.has_role("mod")
async def wish(ctx: commands.Context):
    await ctx.reply(f"Hmmm所以你想要抽卡是吧?那就助你出金囉\n**請自行腦補抽卡介面**")
    wish_rng = rng.randint(1, 1000)
    if wish_rng <= 970:
        await ctx.reply(f"恩好吧你抽到了垃圾呢")
    elif wish_rng <= 997:
        await ctx.reply(f"歐優不錯喔出紫了")
    else:
        await ctx.reply(f"OMG出金了!!!!woooooooooooooooooooo")

@wish.error
async def wish_error(ctx: commands.Context, error):
    if isinstance(error, commands.MissingRole):
        await ctx.send("You don't have the permission to use that command")

這行限制command的使用

出error的時候要做的事情

error大概長這樣

Slash Command

/////////////////////////////////

slash指令

打指令的時候會出現提示
可以加描述
可以加上option讓使用更直觀

slash指令

@bot.event
async def on_ready():
    print(f"阿~~ {bot.user} 起床了!")
    slash_commands = await bot.tree.sync()
    for i in slash_commands:
            print(f"已註冊: {i}")
        

@bot.tree.command(name = "hello", description = "Says hello to you")
async def hello(interaction: discord.Interaction):
    await interaction.response.send_message(f"你好啊{interactions.user.mention}")

slash command前面要加這行裝飾器

name的地方填指令名字

description就填你想給使用者看的描述

如果你的指令註冊成功把它印出來

options

@bot.tree.command(name = "hello", description = "Says hello to you")
async def hello(interaction: discord.Interaction, message: str):
    await interaction.response.send_message(f"你好啊{interactions.user.mention}\n{message}")

跟前面prefix command一樣使用更多參數時，你可以加上option操作

程式上也跟prefix command差不多

會幫你生出神奇的小框框

小缺點:

1. 參數不能太長(小於100字元)

2. 不能像prefix command *args吃全部內容

option promax

import typing

@bot.tree.command(name = "hello", description = "Says hello to you")
async def hello(interaction: discord.Interaction, message: typing.Optional[str] = "祝你一發出金"):
    await interaction.response.send_message(f"你好啊{interactions.user.mention}\n{message}")

剛剛的參數，但是不強制要求要填

也能做到選擇題的效果

@bot.tree.command(name = "hello", description = "Says hello to you")
async def hello(interaction: discord.Interaction, message: typing.Literal["你", "好", "阿"]):
    await interaction.response.send_message(f"你好啊{interactions.user.mention}\n{message}")

auto complete

簡單講就是可以讓你的option變得像google搜尋那樣聰明

infor38 = ["陳柏安", "張雲淞", "江彥成", "呂家睿", "李家睿", 
           "葉倚誠", "邱楷鈞", "葉彥辰", "彭星寶", "林禹喆"]

@bot.tree.command(name = "do_you_know", description = "可以問我知不知道這個人")
async def do_you_know(interaction: discord.Interaction, name: str):
    await interaction.response.send_message(f"那必須的{name}那麼電!")

@do_you_know.autocomplete("name")
async def name_autocomplete(interaction: discord.Interaction, current: str):
    matches = []
    for name in infor38:
        if current in name:
            matches.append(discord.app_commands.Choice(name = name, value = name))
    return matches[:25]

一個帶option的指令

~~google本狗在此~~

找推薦選項的邏輯

Guild 欄位

全球通用

只能在一個伺服器

1.點使用者設定

2.進階 -> 開發者模式打開

3.右鍵伺服器點複製伺服器ID

GUILD_ID =  discord.Object(id = your id number)


@bot.event
async def on_ready():
    print(f"阿~~ {bot.user} 起床了!")
    guild_only = await bot.tree.sync(guild = GUILD_ID)
    slash_commands = await bot.tree.sync()
    for i in slash_commands:
        print(f"已註冊: {i}")
    for i in guild_only:
        print(f"已註冊: {i}")


@bot.tree.command(name = "hello", description = "Says hello to you", guild = GUILD_ID)
async def hello(interaction: discord.Interaction):
    await interaction.response.send_message(f"你好啊{interactions.user.mention}")

記得sync不然指令會找不到

Guild 欄位

其他伺服器

有許可的伺服器

@bot.tree.command(name = "hello", description = "Says hello to you", guild = GUILD_ID)
async def hello(interaction: discord.Interaction):
  	if not interaction.user.guild_permissions.send_messages:
        return
    
    if interaction.user.guild_permissions.administrator:
        await interaction.response.send_message(f"{interaction.user.mention}管理員大人好!\n")
    else:
        await interaction.response.send_message(f"你好啊{interaction.user.mention}\n")

權限和error again

也可以用role名稱來判斷

role = discord.utils.get(interaction.guild.roles, name = "mod")
if role not in interaction.user.roles:

Fancy Stuff

Embed Message

@bot.tree.command(name = "embed", description = "example embed message", guild = GUILD_ID)
async def embed_create(interaction: discord.Interaction):
    embed = discord.Embed(title = "My title", 
                          url = "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                          description = "Click the title!", color = discord.Color.blurple())
    embed.set_thumbnail(url = "https://preview.redd.it/mq2hik89nqt01.png?auto=webp&s=d5544eea984961c596c4e68452300183a28add61")
    embed.add_field(name = "欄位1", value = "這是一個欄位沒什麼神奇的")
    embed.add_field(name = "欄位2", value = "這是另一個欄位，也沒什麼神奇的")
    embed.set_footer(text = "確定不點一下標題嗎?")
    embed.set_author(name = interaction.user.name)

    await interaction.response.send_message(embed = embed)

Buttons

class View(discord.ui.View):
    @discord.ui.button(label = "button 1", style = discord.ButtonStyle.green, emoji = "⚡")
    async def button_call(self, button, interaction):
        await button.response.send_message("You are so dian!")

    @discord.ui.button(label = "button 2", style = discord.ButtonStyle.blurple, emoji = "💀")
    async def button_2_call(self, button, interaction):
        await button.response.send_message(":skull:")
    
    @discord.ui.button(label = "button 3", style = discord.ButtonStyle.red, emoji = "🤯")
    async def button_3_call(self, button, interaction):
        await button.response.send_message("CPU overload")


@bot.tree.command(name = "button", description = "example button", guild = GUILD_ID)
async def buttons(interaction: discord.Interaction):
    await interaction.response.send_message(view = View())

一些其他東西

AIBOT

with Gemini

瑣碎的作業

1. 拿gemini api key

3. 一些基本的code

2. pip install google

pip install -q -U google-genai

from google import genai

GEMINI_API_KEY = "Your api key"

my_ai = genai.Client(api_key = GEMINI_API_KEY)
ai_model = "gemini-2.5-flash"

用API key建立你的模型

注重安全性或想要做成github public project記得也把API KEY放在.env裡面

拿來用

def ask_ai(question: str):
    answer =  my_ai.models.generate_content(model =  ai_model, contents = question)
    return answer
 
@bot.command()
async def chat(ctx: commands.Context, *, question: str):
    answer =  ask_ai(question).text
    await ctx.reply(answer)

生成gemini回復

bot command

恩真的好爛的笑話

gemini生成設定

GENERATION_CONFIG = {
    "system_instruction": "You are a weird guy, like a quirky but funny one.",
    "temperature": 0.8,     
    "top_p": 0.8,             
    "top_k": 4,            
    "max_output_tokens": 1000,
    "safety_settings" : [
    {"category": "HARM_CATEGORY_HARASSMENT",       "threshold": "BLOCK_NONE"},
    {"category": "HARM_CATEGORY_HATE_SPEECH",      "threshold": "BLOCK_NONE"},
    {"category": "HARM_CATEGORY_SEXUALLY_EXPLICIT","threshold": "BLOCK_ONLY_HIGH"},
    {"category": "HARM_CATEGORY_DANGEROUS_CONTENT","threshold": "BLOCK_ONLY_HIGH"},
    ]
}

0~1, 越大越有創意(抽象?

最多能生成的字元

HARM_CATEGORY_HARASSMENT 騷擾

HARM_CATEGORY_HATE_SPEECH 仇恨言論

HARM_CATEGORY_SEXUALLY_EXPLICIT 煽情露骨

HARM_CATEGORY_DANGEROUS_CONTENT 危險內容

HARM_CATEGORY_CIVIC_INTEGRITY 公民誠信

篩選等級:

BLOCK_NONE

BLOCK_ONLY_HIGH

BLOCK_MEDIUM_AND_ABOVE

BLOCK_LOW_AND_ABOVE

HARM_BLOCK_THREHOLD_UNSPECIFIED

不額外篩選

全部擋掉

上完啦!

~~是不是感覺解脫了~~

總之大家成發加油啦!!!有問題歡迎問我

discord.py

自介

其他咚咚

discord.py

What is

Setup

安裝vscode

開file

PyPI

pip

discord application

discord application

discord application

終於可以寫扣了

Token

簡單的東西?

Token & .env

簡單的東西?

bot該起床了

飯粒

其他event

full code

Prefix Command

!?*>&%$

hello world

一些有趣的飯粒

更多飯粒

更多指令參數

更多更多指令參數

權限和error

Slash Command

/////////////////////////////////

slash指令

slash指令

options

option promax

auto complete

Guild 欄位

Guild 欄位

權限和error again

Fancy Stuff

Embed Message

Buttons

一些其他東西

AIBOT

瑣碎的作業

拿來用

gemini生成設定

上完啦!