> For the complete documentation index, see [llms.txt](https://miulien.gitbook.io/bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://miulien.gitbook.io/bot/utilities/reply.md).

# 自動回覆（reply）

**Reply 不只是關鍵字自動回覆。** 透過 Discord 內建的設定面板，不必修改 Bot 程式碼，就能建立歡迎訊息、定時公告、條件判斷、自訂文字指令，甚至讓 Miulien 幫訊息加上表情反應或開啟遊戲。

使用 `/reply` 或 `m!reply` 開啟設定面板，選擇「新增規則」、指定觸發方式，再設定要輸出的回覆內容。單條規則可建立多則回覆，依權重隨機選擇；也能設定觸發率。

### 🧩 四種觸發規則

| 規則類型    | 可以做什麼              |
| ------- | ------------------ |
| 💬 訊息觸發 | 依玩家訊息內容自動回覆、進行條件判斷 |
| 👋 成員加入 | 向新成員發送歡迎訊息         |
| 🚪 成員離開 | 發送離開提醒或告別訊息        |
| ⏰ 時間觸發  | 在指定時間自動發送公告或提醒     |

**訊息規則**另有三種比對方式：

* **完全相符**：整則訊息符合指定文字才觸發。
* **部分相符**：訊息包含指定文字即可觸發。
* **條件式**：可判斷訊息、數字、日期、身份組等條件，組合出更靈活的互動。

時間觸發支援**每天、每週指定星期、每月指定日期，以及單次指定日期時間**。例如 `每天 08:00`、`每週一,三,五 20:30`。排程採台灣時間（UTC+8），並可選擇要發送的頻道。

### ✨ 不只回覆文字：幾個實用玩法

#### 🧮 讓聊天頻道變成計算機

利用「條件式」搭配 `{isexpression}`，可以只回覆能計算的內容，避免一般聊天也觸發。例如讓玩家輸入 `!calc 1+2*3` 就得到 `7`。

條件式規則：

```
{and|{contains|{message}|!calc}|{isexpression|{after|{message}|!calc}}}
```

回覆內容：

```
{count|{args}}
```

這樣就能把指定前綴與算式檢查組合起來，不需要另外開發一個計算機指令。更複雜的計算也可使用數值函數與錯誤處理模板。

#### 🔎 一次辨識多個關鍵字

在「條件式」規則中，`{contains|來源|搜尋文字}` 用來判斷文字包含關係，不分大小寫。若要搜尋多個項目，可以把 `{and}`、`{or}`、`{not}` 包在 `{contains}` 的搜尋欄位裡。

**包含指定文字**

```
{contains|{message}|蘋果}
```

當訊息包含「蘋果」時，條件成立。

**全部符合：同時包含兩個關鍵字**

```
{contains|{message}|{and|蘋果|香蕉}}
```

**任一符合：包含其中一個關鍵字即可**

```
{contains|{message}|{or|蘋果|香蕉}}
```

**排除關鍵字：不包含指定文字**

```
{contains|{message}|{not|香蕉}}
```

`{contains}` 無法直接決定多關鍵字下需採用全部符合還是任一符合，需配合內置的邏輯判斷模板，如 `{and}`、`{or}`、`{not}`，才得以判斷。

這些邏輯模板亦能巢狀組合，例如：

```
{contains|{message}|{and|{or|蘋果|香蕉}|{not|腐爛}}}
```

表示訊息提到了蘋果或香蕉，但沒有提到腐爛。需要搭配其他判斷（例如使用者 ID）時，仍可把 `{and}`、`{or}` 放在外層。若要依條件決定**輸出內容**，再使用 `{if|條件|成立時|不成立時}`。

#### 🦜 讓 Miulien 接話：使用 `{message}`

`{message}` 代表觸發 Reply 的**完整原始訊息文字**。例如設定「部分相符」規則，觸發文字為 `鸚鵡說`，回覆設為：

```
🦜 收到！你剛剛說的是：{message}
```

如果玩家輸入 `鸚鵡說 今天吃香蕉`，Miulien 就能把這句話帶入回覆。若只想取得觸發文字**後方**的內容，可改用 `{args}`，例如回覆 `🦜 {args}`，就只會顯示 `今天吃香蕉`。

#### 🪪 指定發訊者的專屬彩蛋：使用 `{message_user}`

`{message_user}` 回傳**觸發訊息作者的 Discord 使用者 ID**（純數字，不是暱稱或 Mention），因此改名也不會影響判斷。它僅適用於訊息觸發。

例如，只有指定使用者說出「布丁」才觸發的條件式規則：

```
{and|{message_user}=123456789012345678|{contains|{message}|布丁}}
```

回覆內容可設定為：

```
🍮 特別來賓出現！今天的布丁由你領走。
```

將示例 ID 換成真正的 Discord 使用者 ID 即可。**比對 ID 時建議使用 `=` 精確相等**，不要用 `{contains}` 的子字串比對，以免比到另一個 ID 的部分數字。

也能把發訊者條件加在多關鍵字規則外層：

```
{and|{message_user}=123456789012345678|{contains|{message}|{or|布丁|西瓜}}}
```

#### 💬 把訊息當成自訂指令

利用 `{args}` 取得觸發文字後的完整參數，或用 `{arg|1}`、`{arg|2}` 取得個別參數。例如設定部分相符規則 `!選擇`，玩家輸入 `!選擇 火鍋 壽司`，就可以讓回覆依序讀取「火鍋」與「壽司」。也能搭配文字處理、條件判斷或隨機選項做互動。

#### 🎯 不寫程式也能控制抽選機率：`{item}` + `{weight}`

`{item|普通|稀有|傳說}` 原本是等機率抽選。現在可以直接替**每個選項**指定相對權重：

```
{item|{weight|普通|8}|{weight|稀有|2}}
```

這個例子會得到約 **80% 普通、20% 稀有**。未包住 `{weight}` 的選項權重預設為 1，也可使用數值算式搭配 `{count}`、`{get}` 動態決定權重。權重可以設為 0，但不能全部為 0；`{weight}` 必須直接放在 `{item}` 的選項中。

它和 Reply 面板原有的「**多則回覆權重**」不同：後者決定抽中哪一則回覆，`{weight}` 則控制**同一則文字模板內**的選項。也可以配合 `{react}` 讓不同表情出現的機率不同。

#### 🎲 一次抽選，整則回覆保持一致

如果直接寫兩次 `{random}`，就會各自抽出不同結果。使用 `{set}` 與 `{get}`，可以把同一次抽到的數字或選項暫存下來，後續顯示與判斷都使用同一份結果：

```
{set|roll|{random|1|100}}🎲 抽到 {get|roll}！{if|{get|roll}>=80|大成功！|繼續加油}
```

暫存值只在**這一次回覆**中有效，不會跨訊息永久儲存。

#### 🔢 進階數字玩法：進制轉換

如果需要處理二進位、十六進位等表示法，可以使用 `{base|數值|來源進制|目標進制}`，例如：

```
{base|FF|16|10}
```

結果為 `255`。支援 2～36 進制整數。這是特定情境下很有用的工具，不需要背下所有語法；更多格式及限制可直接查看內建「📖 模板語法」。

#### 🔐 Base64 文字編碼與解碼

除了整數進制轉換，Reply 也支援文字的 Base64 編碼與解碼。例如 `{base64|encode|Hello}` 會得到 `SGVsbG8=`，而 `{base64|decode|SGVsbG8=}` 能還原為 `Hello`。支援中文與巢狀變數，例如 `{base64|encode|{message}}`。

Base64 是**編碼，不是加密**；詳細格式、限制與錯誤處理請查看 Bot 內建的「📖 模板語法」。

#### 🎉 自動幫玩家加上 Reaction

Reply 不一定要發送新訊息，也能直接對觸發訊息加入表情反應。例如從三種表情中隨機挑選一種：

```
{react|{item|👍|🎉|👀}}
```

也能讓 `{react}` 和文字回覆一起出現，或搭配 `{if}`、身份組條件使用。此功能**只適用於訊息觸發**，不適用於加入、離開或定時規則。

#### 🕒 跨時區資訊與動態內容

`{time}` 與 `{date}` 預設使用台灣時間，也支援指定 UTC 時區偏移，例如 `{time|9}`（UTC+9）、`{date|0}`（UTC）。還能使用使用者名稱、伺服器資訊、隨機成員等變數，讓每次回覆依情境改變。

#### 🎮 從自動回覆啟動遊戲

`{game|work}` 可替觸發者開啟 Work 面板，**不會直接代替玩家工作**；`{game|pvz}` 會開啟或接續 PvZ 草坪，**不會自動推進回合**；新增的 **`{game|wheel}`** 可開啟轉盤面板，**按下「轉動轉盤」才會抽獎**。

目前支援：`slot`、`wheel`、`waterfire`、`snake`、`skating`、`garden`、`2048`、`work`、`rps`、`pvz`。可搭配 `{item}`、`{weight}` 隨機選擇遊戲。

`{game}` 僅支援訊息觸發，單次 Reply 至多開啟一款遊戲，並遵守各遊戲本身的限制。Wheel 不接受額外參數；完整玩法請見[轉盤（wheel）](/bot/economy-games/wheel.md)。

### 🛠️ 管理規則，不用反覆刪掉重做

* **編輯規則／回覆**：修改觸發文字、條件或回覆內容，保留原有規則。
* **停用／啟用規則**：暫時停止觸發，之後隨時重新啟用，**不用刪除重建**。
* **設定頻道**：訊息規則支援「所有頻道」、「僅指定頻道」（白名單）及「排除指定頻道」（黑名單）；成員事件與定時規則可指定發送頻道。
* **重排編號**：調整規則或回覆的排列；當多條訊息規則的優先條件相同時，規則順序也可能影響哪條先被採用。
* **搜尋與分頁**：規則和回覆很多時，仍能快速定位及管理。
* **權重與觸發率**：調整同一規則下各回覆被抽中的機率，以及訊息規則的觸發機率。

同一則訊息即使符合多條規則，**也只會選擇其中一條**；有效的原生指令會優先交給原本的指令系統處理。

### 📖 模板語法在哪裡？

在 `/reply` 面板按下 **「📖 模板語法」**，就能使用內建的**分類說明、目錄、上一頁／下一頁與跳頁**查看詳細語法。

內建分類涵蓋**使用者與身份組、訊息與參數、伺服器與頻道、日期時間、隨機、數學運算、條件判斷、文字處理、暫存變數、Reaction、遊戲啟動**等功能。這裡只介紹代表性的應用，不逐條複製整份模板手冊。

### 📚 Reply 模板與變數總覽

目前共有 **62 種功能模板**與 **26 種一般變數**，合計 **88 個語法項目**。以下只列名稱，詳細用法請在 `/reply` → **📖 模板語法** 查閱。

#### 功能模板（62）

**條件與邏輯（8）**

`{if}`、`{and}`、`{or}`、`{not}`、`{contains}`、`{iferror}`、`{isnumber}`、`{isexpression}`

**隨機與暫存（6）**

`{item}`、`{weight}`、`{random}`、`{arg}`、`{set}`、`{get}`

**Discord 與遊戲（7）**

`{mention}`、`{react}`、`{game}`、`{role}`、`{hasrole}`、`{rolecount}`、`{jackpot}`

**日期與格式（6）**

`{time}`、`{date}`、`{quote}`、`{code}`、`{codeblock}`、`{spoiler}`

**數學與進制（21）**

`{count}`、`{base}`、`{round}`、`{floor}`、`{ceil}`、`{fraction}`、`{mod}`、`{min}`、`{max}`、`{abs}`、`{clamp}`、`{sin}`、`{cos}`、`{tan}`、`{asin}`、`{acos}`、`{atan}`、`{rad}`、`{deg}`、`{log}`、`{number}`

**文字與編碼（14）**

`{base64}`、`{len}`、`{replace}`、`{escape}`、`{trim}`、`{upper}`、`{lower}`、`{capitalize}`、`{proper}`、`{left}`、`{right}`、`{slice}`、`{before}`、`{after}`

`{weight}` 是 `{item}` 的輔助模板，不能獨立使用。

#### 一般變數（26）

**使用者與成員（11）**

`{user}`、`{username}`、`{display_name}`、`{global_name}`、`{user_id}`、`{status}`、`{activity}`、`{random_online_member}`、`{random_member}`、`{random_member_a}`、`{random_member_b}`

**伺服器與頻道（7）**

`{server}`、`{server_id}`、`{channel}`、`{channel_name}`、`{member_count}`、`{server_count}`、`{online_count}`

**訊息與特殊內容（8）**

`{message}`、`{message_user}`、`{args}`、`{br}`、`{nbsp}`、`{jackpot}`、`{time}`、`{date}`

註：`{time}`、`{date}`、`{jackpot}` 在兩種類型中都有對應語法，所以 **88 是分類項目總數，去重後是 85 個名稱**。

### 🔐 權限與防刷屏

* 管理 Reply 需要伺服器的\*\*「管理訊息」權限\*\*，或由 `permissions` 功能授權可使用 Reply 的身份組。
* 訊息型 Reply 設有速率限制：**同頻道每秒最多 1 次**、**同使用者每 5 秒最多 5 次**；超出限制直接略過，不會排隊補發。
* 回覆內容須遵守 Discord **單則訊息 2,000 字**上限。Reaction 需要機器人具有相應權限。

> 想快速上手，可以先做一條「部分相符」文字回覆，再試試 `{arg}`、`{item}`、`{weight}` 或 `{react}`。需要更多邏輯時，再打開「📖 模板語法」查看對應分類。
