功能說明
這一頁逐項說明桌伴 Discord 機器人提供的功能，以及每款遊戲的角色、流程與勝負條件。想直接開始玩，請看 使用教學；完整指令列表也在那裡。
一、遊戲暱稱自動管理
遊戲開始時，機器人會依座號修改每位玩家在這個伺服器的暱稱，讓大家一眼看出座位與存活狀態；場次結束時自動改回原本的名字。
- 預設格式：
{icon} {seat} {tag}{name}，例如 🟢 03 [警長] 小明。座號固定兩位數。
- 四種狀態：🟢 存活、💀 死亡、❌ 出局、👀 觀戰。GM 遊戲會自動更新；自由模式由主持人用
/game status 調整。
- 標籤：最多 8 個字（例如警長、預言家），用
/game tag 加上或清除；GM 遊戲也會自動標記，例如阿瓦隆的「隊長」、血染鐘樓的「說書人」。
- 長度限制：Discord 暱稱最多 32 字，超過時會自動截短名字部分。
- 自訂：伺服器管理員可在控制台的「設定」修改格式（必須包含
{name}）與各狀態圖示，儲存後立即套用到進行中的遊戲。
- 中途加入：遊戲開始後才按「加入」的人會以觀戰身分加入。
- 重啟也能還原：場次資料會存檔，機器人重新啟動後大廳按鈕仍可使用，結束時也能正確還原暱稱。
機器人的身分組必須排在玩家身分組之上才能改暱稱；而 Discord 不允許任何機器人修改伺服器擁有者的暱稱（遊戲照常進行，只是擁有者的名字不會變）。
二、🐺 狼人殺（機器人 GM）
人數：6～18 人；在「⚙️ 遊戲設定」自訂角色時最少 4 人。狼人數量必須少於總人數的一半。
角色
| 角色 | 陣營 | 能力 |
|---|
| 🐺 狼人 | 狼人陣營 | 每晚與狼隊友選擇一名玩家殺害，可以空刀。 |
| 🔮 預言家 | 神職 | 每晚查驗一名玩家，得知他是好人還是狼人。 |
| 🧪 女巫 | 神職 | 解藥與毒藥各一瓶、各限用一次；同一晚只能用一瓶，不能自救。解藥用完後不再得知刀口。 |
| 🏹 獵人 | 神職 | 死亡時可以開槍帶走一名玩家；被女巫毒死則不能開槍。 |
| 🛡️ 守衛 | 神職 | 每晚守護一名玩家免於狼刀，可以守自己，但不能連續兩晚守同一人；同守同救會死亡。 |
| 🧑🌾 村民 | 村民 | 沒有特殊能力，白天靠推理投票放逐狼人。 |
預設配套
沒有自訂時，機器人依開局人數自動配置，其餘位置補村民：
| 人數 | 配置 |
|---|
| 6 人 | 狼人×2、預言家、女巫、村民×2 |
| 7 人 | 狼人×2、預言家、女巫、獵人、村民×2 |
| 8 人 | 狼人×3、預言家、女巫、獵人、村民×2 |
| 9 人 | 狼人×3、預言家、女巫、獵人、村民×3 |
| 10 人 | 狼人×3、預言家、女巫、獵人、守衛、村民×3 |
| 11 人 | 狼人×4、預言家、女巫、獵人、守衛、村民×3 |
| 12 人 | 狼人×4、預言家、女巫、獵人、守衛、村民×4 |
| 13～18 人 | 狼人為人數÷3（無條件捨去），四種神職各一，其餘為村民 |
自訂時可設定狼人數量（至少 1）與各神職（每種 0 或 1），村民自動補滿。
流程
- 夜晚：有技能的玩家在 ⚡行動 頻道的面板按「⚡ 行動」秘密操作；主持人可按「⏭️ 下一階段」跳過未行動的玩家。
- 天亮：機器人公布死訊或平安夜；首夜死亡的玩家可發表遺言，獵人死亡時可開槍（被毒死除外）。
- 白天討論：存活玩家依座號發言，結束後主持人按「⏭️ 下一階段」。
- 放逐投票：所有存活玩家在投票訊息選擇（可棄票），票數最高者出局；平票進入 PK 重投一次，再平票則無人出局。
- 遺言：被放逐的玩家發表遺言，結束後主持人按「⏭️ 下一階段」進入黑夜。
勝負（屠邊）：狼人全滅好人獲勝；所有神職或所有村民死亡則狼人獲勝。
面板按鈕：「🔍 查看身分」看自己的角色與資訊（狼隊友、查驗紀錄、藥水狀態等）、「⚡ 行動」、「⏭️ 下一階段（主持人）」。
三、🏰 阿瓦隆（機器人 GM）
人數：5～10 人。梅林與刺客固定登場，其餘位置由亞瑟的忠臣與莫德雷德的爪牙補滿。
角色
| 角色 | 陣營 | 能力 |
|---|
| 🧙 梅林 | 好人 | 知道所有壞人（莫德雷德除外），但千萬別讓刺客發現。 |
| 🛡️ 派西維爾（可選） | 好人 | 知道誰可能是梅林，但莫甘娜也會出現在名單中。 |
| ⚔️ 亞瑟的忠臣 | 好人 | 沒有特殊能力，協助好人完成任務。 |
| 🗡️ 刺客 | 壞人 | 好人完成三個任務後可以刺殺一名玩家，刺中梅林則壞人翻盤獲勝。 |
| 🧝♀️ 莫甘娜（可選） | 壞人 | 在派西維爾眼中偽裝成梅林。 |
| 👑 莫德雷德（可選） | 壞人 | 梅林看不到你。 |
| 🌑 奧伯倫（可選） | 壞人 | 不認識其他壞人，其他壞人也不認識你，但梅林看得到你。 |
| 😈 莫德雷德的爪牙 | 壞人 | 沒有特殊能力，協助壞人破壞任務。 |
各人數的壞人數量、每個任務的出征人數與預設特殊角色
| 人數 | 壞人 | 任務 1～5 人數 | 預設可選角色 |
|---|
| 5 人 | 2 | 2 / 3 / 2 / 3 / 3 | 派西維爾、莫甘娜 |
| 6 人 | 2 | 2 / 3 / 4 / 3 / 4 | 派西維爾、莫甘娜 |
| 7 人 | 3 | 2 / 3 / 3 / 4 / 4 | 派西維爾、莫甘娜、奧伯倫 |
| 8 人 | 3 | 3 / 4 / 4 / 5 / 5 | 派西維爾、莫甘娜 |
| 9 人 | 3 | 3 / 4 / 4 / 5 / 5 | 派西維爾、莫甘娜、莫德雷德 |
| 10 人 | 4 | 3 / 4 / 4 / 5 / 5 | 全部四種 |
流程
- 隊長組隊：隊長（暱稱會標上「隊長」）按「⚡ 行動」選出這次任務的隊員，可以選自己。
- 表決隊伍：所有玩家公開投票，過半數贊成才出發；連續 5 次否決則壞人直接獲勝。
- 執行任務：隊員秘密出牌，好人只能出成功；出現失敗牌則任務失敗（7 人以上的第 4 個任務需要 2 張失敗）。
- 刺殺梅林：3 個任務成功後由刺客刺殺，刺中梅林壞人翻盤，否則好人獲勝。3 個任務失敗則壞人獲勝。
每次組隊、每個人的贊成／反對、任務失敗牌數都會即時寫入行動紀錄；誰出了失敗牌則到遊戲結束才公開。
四、🩸 血染鐘樓（說書人模式）
人數：5～15 名玩家＋1 位說書人。使用暗流湧動（Trouble Brewing）劇本。說書人必須先加入場次，再由主持人在「⚙️ 遊戲設定」選出（預設為主持人）。
開局設定
- 選角：可以隨機配置，也可以手動挑選角色（數量必須等於玩家人數，且剛好一個惡魔）。
- 隨機配置會依人數分配鎮民／外來者／爪牙／惡魔；抽到男爵時自動多 2 名外來者、少 2 名鎮民。
- 機器人會處理酒鬼的假身分，並為惡魔準備三個不在場的偽裝角色。7 人以上時爪牙與惡魔彼此認識；少於 7 人時邪惡玩家互不認識。
隨機配置的角色類型數量（不含說書人）
| 玩家人數 | 鎮民 | 外來者 | 爪牙 | 惡魔 |
|---|
| 5 | 3 | 0 | 1 | 1 |
| 6 | 3 | 1 | 1 | 1 |
| 7 | 5 | 0 | 1 | 1 |
| 8 | 5 | 1 | 1 | 1 |
| 9 | 5 | 2 | 1 | 1 |
| 10 | 7 | 0 | 2 | 1 |
| 11 | 7 | 1 | 2 | 1 |
| 12 | 7 | 2 | 2 | 1 |
| 13 | 9 | 0 | 3 | 1 |
| 14 | 9 | 1 | 3 | 1 |
| 15 | 9 | 2 | 3 | 1 |
角色池：鎮民 13 種（洗衣婦、圖書管理員、調查員、廚師、共情者、占卜師、送葬者、僧侶、守鴉人、貞潔者、殺手、士兵、鎮長）、外來者 4 種（管家、酒鬼、陌客、聖徒）、爪牙 4 種（投毒者、間諜、紅唇女郎、男爵）、惡魔（小惡魔）。完整能力可在 Discord 輸入 /gm rules 查看。
玩家怎麼玩
- 「🔍 我的資訊」：查看自己的角色、能力、狀態與說書人傳來的訊息，以及現在該做什麼。
- 「✉️ 傳訊給說書人」：夜晚告知你的選擇，或私下詢問說書人。
- 死亡的玩家白天仍可發言，但整局只剩一次鬼魂票。
說書人的魔典（按「📖 魔典（說書人）」）
魔典會顯示所有角色、首夜／夜晚行動順序、惡魔偽裝與玩家來訊，並提供：
- 🌙 入夜／天亮、💀 死亡／復活、📝 提示標記（例如中毒、紅鯡魚）、✉️ 傳訊給玩家
- 🗳️ 發起提名（公開舉手投票，自動計算處決台）、🪓 處決、🔄 重新整理
- 📢 召集回主廳：把私聊語音房的玩家移回 🔊 語音交流
- 🔵 善良獲勝／🔴 邪惡獲勝：由說書人宣告結果
開局時依人數建立 🤫 私聊語音房（大約每 3 名玩家一間，至少 2 間），方便白天私下討論。
五、🎲 自由模式
建立場次時 mode 選「自由模式」，機器人不主持遊戲，只負責報名、座號與暱稱，適合誰是臥底、自訂規則或任何需要座號的遊戲。主持人用 /game status、/game tag、/game shuffle、/game kick 手動管理，或在控制台的「遊戲場次」直接用下拉選單修改。
六、專屬遊戲頻道
建立場次時（/game create 或控制台），機器人會自動建立分類 🎲 場次名稱：
| 頻道 | 用途 |
|---|
| 💬文字交流 | 自由聊天 |
| 🔊 語音交流 | 語音；開局時機器人會在 ⚡行動 邀請所有玩家加入，GM 遊戲夜晚自動靜音 |
| ⚡行動 | 遊戲面板、階段公告與公開投票；只有機器人能發言，面板不會被洗掉 |
| 📜行動紀錄 | 只有機器人能寫入的遊戲歷程 |
| 🤫 私聊 1、2… | 僅血染鐘樓：開局時依人數建立的私聊語音房 |
- 權限：場次玩家（含主持人）可以打字與說話；其他成員可以看、聽，但不能發言。玩家加入、離開或被移出時自動更新。
- 結束：
/game end 會刪除分類與其他頻道，📜行動紀錄 改名為 📜場次名稱-月日-時分 並移到共用的 🗂️ 遊戲紀錄 分類，所有人唯讀。
- 機器人缺少「管理頻道」或「管理身分組」權限，或在控制台關閉「自動建立遊戲頻道」時，遊戲會直接在建立場次的頻道進行（缺權限時會提醒主持人）。
七、行動紀錄與秘密公開
遊戲進行中，📜行動紀錄 只即時記錄公開資訊，例如：
- 狼人殺：死訊、誰投給誰、PK、獵人開槍
- 阿瓦隆：每次組隊、每個人的贊成／反對、任務失敗牌數
- 血染鐘樓：晝夜、提名、舉手與處決
身分、夜晚行動（查驗、用藥、守護、狼刀）、阿瓦隆誰出了失敗牌、說書人與玩家的私訊等秘密資訊，只會在遊戲結束（或中止）時以「🔓 完整秘密紀錄」一次公開，避免旁觀者提前看到。
八、夜晚語音自動靜音
- 狼人殺：入夜時所有人靜音，天亮解除；死亡玩家保持靜音（遺言期間除外）。
- 血染鐘樓：夜晚所有玩家靜音；死亡玩家白天仍可發言。
- 阿瓦隆沒有夜晚，不會自動靜音。
需要機器人擁有「將成員靜音」權限，且玩家要在場次的 🔊 語音交流 裡。
九、一個人也能測試（測試模式）
- 建立場次後、開局前，輸入
/game testplayers count:5（0～20，0 代表全部移除），或在控制台的場次卡片設定測試玩家數量。
- 開局後遊戲面板會多出「🎭 切換扮演（測試）」按鈕。主持人選擇要扮演的玩家後，按面板、投票、開魔典都會以該玩家身分進行。
- 選單上的 ⏳ 表示輪到該玩家行動。
測試玩家不會改暱稱，也不佔語音。適合主持人事先熟悉流程，或伺服器管理員確認權限設定是否正確。
十、揪團
輸入 /lfg game:APEX slots:3 time:今晚9點 note:需要麥克風 ping:@APEX玩家：
game 遊戲名稱、slots 總人數（含發起人，2～30）為必填；time、note、ping 選填（沒填時間會顯示「人齊就開」）。- 成員按「加入／退出」報名，額滿時機器人自動 @ 所有成員；發起人按「結束揪團」關閉。
- 通知身分組時，該身分組必須可被提及，或你擁有「提及所有人」權限（通知 @everyone 也需要此權限）。
- 揪團按鈕在機器人重新啟動後仍然可以使用。
十一、網頁控制台
在 控制台 用 Discord 帳號登入，就能管理你擁有「管理伺服器」權限、而且已經邀請機器人的伺服器：
- 總覽：成員數、機器人延遲、場次統計，並檢查管理暱稱、將成員靜音、管理頻道、管理身分組、移動成員等權限是否齊全。
- 遊戲場次：選頻道與遊戲模式建立場次並發送面板；開始／重新分配座號／結束；逐一修改玩家狀態與標籤、移出玩家、設定測試玩家；顯示場次的遊戲頻道連結。每 5 秒自動同步 Discord 上的變化。
- 揪團：以你的名義在頻道發起揪團。
- 發送公告：編輯標題、內容、顏色與通知身分組，附 Discord 樣式即時預覽，以機器人身分發送。
- 設定：開關「自動建立遊戲頻道」；自訂暱稱格式與狀態圖示，附即時預覽。
控制台的資料來自機器人本身，所以機器人離線時控制台會顯示「控制台後端目前離線或尚未設定」。架設方式請看 使用教學的控制台架設。