2026-03-04 00:05:28 +08:00
|
|
|
|
# Discord 猜謎互動機器人 (Lottery Bot)
|
2026-02-27 05:22:43 +00:00
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
這是一個基於 `discord.py` 開發的互動式 Discord 機器人，專門用於舉辦「看圖猜寶可夢」或「經典動畫角色」的猜謎活動。支援斜線指令 (Slash Commands) 並具備自動倒數計時與總複習功能。
|
2026-02-27 16:05:14 +08:00
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
## 🌟 功能亮點
|
2026-02-27 16:05:14 +08:00
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
* **看圖猜謎**：內建寶可夢（150+隻）與經典動畫角色資料庫。
|
|
|
|
|
|
* **倒數計時**：出題後自動進入倒數，時間到自動公佈答案與圖片。
|
|
|
|
|
|
* **清單管理**：自動洗牌題目，並記錄目前進度，避免重複出現相同題目。
|
|
|
|
|
|
* **總複習模式**：自動播放模式，每秒巡迴顯示一位角色。
|
|
|
|
|
|
* **基礎工具**：提供延遲測試 (Ping) 與機器人資訊查詢。
|
2026-02-27 16:05:14 +08:00
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
## 🛠️ 專案結構
|
|
|
|
|
|
|
|
|
|
|
|
* `discord-bot.py`: 機器人啟動入口，處理 Cog 載入與指令同步。
|
|
|
|
|
|
* `cogs/`
|
|
|
|
|
|
* `base.py`: 存放基礎指令（如 info, ping）。
|
|
|
|
|
|
* `lottery.py`: 核心功能，處理猜謎邏輯、清單管理與倒數計時。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* `pokemon.json`: 寶可夢圖片與名稱資料庫。
|
|
|
|
|
|
* `animate.json`: 動畫角色圖片與作品資料庫。
|
|
|
|
|
|
* `.env`: 存放敏感資訊（如 Token、Guild ID）。
|
|
|
|
|
|
|
|
|
|
|
|
## ⚙️ 安裝教學
|
|
|
|
|
|
|
|
|
|
|
|
### 1. 準備環境
|
|
|
|
|
|
|
|
|
|
|
|
確保您的環境已安裝 Python 3.8 或以上版本。
|
|
|
|
|
|
|
|
|
|
|
|
### 2. 安裝必要套件
|
|
|
|
|
|
|
|
|
|
|
|
在終端機執行以下指令：
|
2026-02-27 16:05:14 +08:00
|
|
|
|
|
|
|
|
|
|
```bash
|
2026-03-04 00:05:28 +08:00
|
|
|
|
pip install discord.py python-dotenv
|
|
|
|
|
|
|
2026-02-27 16:05:14 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
### 3. 設定環境變數
|
|
|
|
|
|
|
|
|
|
|
|
建立一個 `.env` 檔案（或參考 `.env.example`），並填入您的資訊：
|
2026-02-27 16:05:14 +08:00
|
|
|
|
|
|
|
|
|
|
```env
|
2026-03-04 00:05:28 +08:00
|
|
|
|
DISCORD_BOT_TOKEN=你的機器人Token
|
|
|
|
|
|
GUILD_ID=你的伺服器ID
|
|
|
|
|
|
|
2026-02-27 16:05:14 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
### 4. 啟動機器人
|
|
|
|
|
|
|
2026-02-27 16:05:14 +08:00
|
|
|
|
```bash
|
|
|
|
|
|
python discord-bot.py
|
2026-03-04 00:05:28 +08:00
|
|
|
|
|
2026-02-27 16:05:14 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
## 🎮 指令說明
|
|
|
|
|
|
|
|
|
|
|
|
### 猜謎指令 (`/`)
|
|
|
|
|
|
|
|
|
|
|
|
| 指令 | 說明 |
|
|
|
|
|
|
| --- | --- |
|
|
|
|
|
|
| `/建立抽選清單` | 重新打亂並初始化寶可夢或動畫角色的題目清單。 |
|
|
|
|
|
|
| `/抽選清單` | 顯示目前剩餘的題目數量。 |
|
|
|
|
|
|
| `/抽寶可夢 [秒數]` | 隨機出一題寶可夢，並在指定秒數後揭曉答案。 |
|
|
|
|
|
|
| `/抽動畫 [秒數]` | 隨機出一題動畫角色，並在指定秒數後揭曉答案。 |
|
|
|
|
|
|
| `/動畫角色總複習` | 開始自動播放所有動畫角色圖片。 |
|
|
|
|
|
|
| `/停止` | 停止進行中的總複習模式。 |
|
2026-02-27 16:05:14 +08:00
|
|
|
|
|
|
|
|
|
|
### 基礎指令
|
|
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
| 指令 | 說明 |
|
|
|
|
|
|
| --- | --- |
|
|
|
|
|
|
| `/info` | 查看機器人當前狀態與伺服器統計。 |
|
|
|
|
|
|
| `/ping` | 測試網路延遲。 |
|
|
|
|
|
|
| `/echo [文字]` | 讓機器人重複你說的話。 |
|
2026-02-27 16:05:14 +08:00
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-03-04 00:05:28 +08:00
|
|
|
|
**開發者**：唐宋
|
|
|
|
|
|
|
|
|
|
|
|
**技術棧**：Python, Discord.py, JSON
|
