> 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/reactionrole.md).

# 反應身份組（reactionrole）

使用 `/reactionrole` 開啟管理面板，將 Discord 訊息的**表情符號**與身份組綁定。一般成員點擊反應即可領取身份組，取消反應即可移除透過此功能取得的身份組，無須管理權限。

## 新增綁定

1. 輸入 `/reactionrole` 並點擊「新增綁定」。
2. 選擇欲發放的身份組。
3. 輸入**本伺服器的 Discord 訊息連結**以及表情符號（一般或可用的自訂表情符號）。
4. Miulien 確認訊息可讀取、能新增反應且身份組可操作後儲存規則。

每個伺服器最多 **50 條綁定**。同一身份組不能重複綁定；同一訊息上的同一表情符號也不能重複綁定。

## 領取與移除身份組

* **按下反應**：若尚未擁有對應身份組，Miulien 會嘗試賦予。
* **取消反應**：若該身份組原本是透過此功能取得，Miulien 會嘗試移除。
* **原本就有身份組**：不會重複賦予；若不是由此功能發放，取消反應也不會移除原有身份組。

> 如果成員先透過反應取得身份組，之後管理員又手動調整同一身份組，取消反應時仍可能移除它。

## 管理面板

* **新增綁定**：建立新的訊息、表情符號與身份組對應。
* **刪除綁定**：選取並確認刪除規則，**不會直接收回已授予的身份組**。
* **同步校正**：重新核對訊息上的反應與身份組，補發或移除需要調整的身份組。
* **上一頁／下一頁／重新整理**：瀏覽及更新管理面板。

面板中的「**追蹤訂閱關聯**」與「**訂閱者**」為目前功能介面顯示的統計項目，分別代表系統記錄的使用者與身份組對應數，以及去除重複後的人數；原本就有身份組的成員可能不計入。

## 原始訊息與同步校正

原始訊息的**文字或 Embed 可以自由編輯**，不需要重新設定綁定。

如果刪除原始訊息並重新發送，則需要對新訊息重新建立綁定。

Miulien 重新上線後會嘗試校正身份組狀態；管理員也可以隨時使用「同步校正」進行核對。

## 權限與限制

* **管理綁定**：需要 Discord「管理身份組」權限，或透過 `/permissions` 取得 `reactionrole` 指令的額外授權。
* **一般成員領取與移除身份組**：不需要管理權限。
* Miulien 必須具有管理身份組權限，且目標身份組必須低於 Miulien 的最高身份組。
* 非伺服器擁有者只能操作低於自己最高身份組的身份組，即使有 `/permissions` 額外授權也一樣。
* 伺服器擁有者不受自身階層限制；`@everyone` 和整合服務管理的身份組不可綁定。

相關功能：[身份組管理（role）](/bot/utilities/role.md)。
