說明文件

將成員從伺服器封鎖。

永久停權。該成員被移出伺服器，在解除停權之前無法重新加入。

/ban <使用者> [原因] [私訊] [公開]

• 私訊在停權之前寄出：一旦被停權，機器人與該成員不再共處同一伺服器，也就聯絡不到對方。
• 處分在呼叫 Discord 之前先行記錄。若停權失敗（身分組層級、缺少權限），紀錄會被回復：歷史紀錄裡不會留下幽靈處分。
• 永久停權會取消由 /tempban 排定的任何自動解除。
• 你不能停權自己、機器人，也不能停權最高身分組高於或等於你的成員。

暫時封鎖一名成員（到期自動解封）

依設定的時長停權。解除由機器人排定，並在到期時執行。

/tempban <使用者> <時長> [原因] [私訊] [公開]

• 到期時，機器人會確認這次停權期間沒有被管理員重新施加：如果被重新施加了，它就不解除。
• 期間執行的 /ban 會取消自動解除。

透過 ID 解除使用者的封鎖。

解除停權。由於此人已不在伺服器上，需要用他的 Discord ID 指定。

/unban <編號>

• ID 可在開啟開發者模式後，從 Discord 的停權清單（伺服器設定 → 停權）中複製。
• 它是唯一一條預設工作人員等級為 3 的管理指令。

將成員從伺服器踢出。

把成員踢出。他們仍可以用新的邀請回來。

/kick <使用者> [原因] [私訊] [公開]

• 私訊在踢出之前寄出，理由和 /ban 一樣。

暫時禁言成員。

Discord 原生的暫時禁言：成員仍留在伺服器上，但無法再發言、加反應或在語音中說話。

/timeout <使用者> <時長> [原因] [私訊] [公開]

• 最長時長為 28 天：這是 Discord 的限制，不是機器人的。
• 禁言到期後自行解除，不需要機器人介入。

警告成員。

一次留下紀錄的警告。不施加任何技術性處分：它是一筆紀錄，事後查得到。

/warn <使用者> [原因] [私訊] [公開]

• 警告和其他條目一樣會取得處分編號：它會出現在 /history 或 /sanction 中，並可用 /unwarn 撤銷。

透過代碼撤銷一則警告

依編號撤銷某一則特定的警告。

/unwarn <代碼>

• 撤銷不會讓該條目從歷史紀錄中消失：它會被標記為已解除。

查看成員的所有處罰紀錄。

一位成員的完整檔案：所有處分，從最近到最早。

/history <使用者>

• 用訊息上的按鈕逐頁瀏覽；每個條目都顯示它的編號、類型、原因和執行者。

透過 ID 顯示處罰詳情。

某次處分的詳細紀錄：類型、原因、管理員、日期，以及附加的內部註記。

/sanction <代碼>

管理與處罰關聯的備註。

附加在某次處分上的內部註記。它們絕不會給相關成員看到：它們是為了管理員之間的溝通。

• 每次處分最多 25 則註記。再多，紀錄就會超過 Discord 訊息的長度上限。

刪除一定數量的訊息。

一次刪除某個頻道最近的訊息。

/clear <數量>

• Discord 拒絕批次刪除超過 14 天的訊息：這些會被略過，機器人會回報實際刪除了幾則。
• 紀錄中這次刪除算在管理員頭上，而不是訊息作者頭上。

設定頻道的慢速模式。

為同一位成員的兩則訊息之間設定最短間隔。

/slowmode <seconds> [channel]

• 0 關閉慢速模式。上限 21600 秒，對應 Discord 允許的 6 小時。

鎖定頻道（成員無法傳送訊息）。

取消 @everyone 身分組在該頻道發言的權利。訊息仍然讀得到。

/lock [channel] [原因]

解鎖先前鎖定的頻道。

讓被鎖住的頻道重新出聲。

/unlock [channel] [原因]

為成員新增或移除身分組。

新增或移除身分組，不必進到伺服器設定。

• 機器人只能處理層級低於它自己的身分組。
• 你永遠無法分配層級高於自己的身分組。而且，如果你是憑工作人員等級而不是「管理身分組」權限來使用它，帶有敏感權限的身分組（管理員、管理身分組、封鎖成員等）會被拒絕：豁免不該比它所取代的權限更大。

將所有人從一個語音頻道移動到另一個。

一次移動某個語音頻道裡的所有成員。

/massmove <來源> <目標> [公開]

• 適合把大家集合起來辦活動，或在不中斷任何人的情況下清空一個語音頻道。

設定歡迎與告別訊息

打開一個互動面板：歡迎訊息、道別訊息、頻道、產生的橫幅和配色都在這裡設定，不必記住任何子指令。

/welcome

• 文字中可用的變數：{user}, {username}, {displayname}, {tag}, {id}, {server}, {membercount}。
• 道別訊息獨立於歡迎訊息：頻道不同，開關也不同。
• 每位新成員抵達時都會產生一張橫幅，使用為該伺服器選定的配色。

設定並自訂伺服器日誌系統。

紀錄設定面板：21 種事件，可以逐一開關。

• 這些事件分成 5 個類別：訊息, 成員, 管理, 語音, 伺服器。
• 每個類別都能指向自己的頻道：管理在一邊，訊息在另一邊。
• 訊息內容從不寫入資料庫：它只出現在張貼出來的嵌入訊息裡，僅此而已。
• /logs disable 會清除設定，而不只是暫停它。

設定並自訂客服單系統。

客服單系統的設定面板：類型、表單、團隊、對話紀錄。

• 最多 25 種客服單類型，這是 Discord 下拉選單的上限。每一種都有自己的表情符號、顏色、歡迎訊息和開單表單。
• 結案時，對話會以 HTML 封存到選定的封存頻道。

設定網站驗證（按鈕 + 身分組）。

透過網站驗證：成員在 Discord 裡按下一個按鈕，在 omniaze.com 上完成，回來時拿到身分組。

• 隔離身分組是選填的：沒有它，驗證只是加上一個身分組；有它，驗證還會把成員帶出等候區。
• 如果面板訊息被刪掉，或改了措辭，/verify panel 可以重新張貼或更新它。

設定用於驗證新成員的驗證碼。

門口的驗證：新來者必須解開一道驗證碼才能拿到身分組。

• 分類是必填的：若成員關掉了私訊，機器人會在該分類下建立一個臨時驗證頻道，只有他本人看得到，之後刪除。
• 預設設定：3 次嘗試、5 分鐘作答時間，失敗就踢出。間隔、嘗試次數和處分方式在控制台中變更。
• 在通過驗證之前，成員會留在隔離身分組裡：你隨時可以手動放行他們。

設定反突襲保護。

偵測異常的加入浪潮，並自動做出反應。

• 預設為：10 秒內 8 次加入就會觸發防護，新來者會被放進隔離。
• 三種可能的反應：只發警報、隔離，或踢出。
• 帳號年齡可以當成篩選條件（預設 168 小時）：更早建立的帳號可以毫髮無傷地穿過浪潮。這項設定在控制台中完成。

建立可自助領取的身分組按鈕。

自助身分組面板：一則訊息、幾個按鈕，每個按鈕對應一個身分組。

• 每個伺服器最多 25 個面板，每個面板最多 25 個身分組。
• 疊加模式：成員可以隨意領取和交還任何身分組。唯一模式：面板中一次只能持有一個身分組，先前的會被自動移除。
• 面板分兩步搭建：先用 create 建立訊息，然後每個按鈕用一次 addrole。

設定臨時語音頻道（加入即建立）。

隨需建立的語音頻道：加入觸發頻道，就會建立一個由該成員擁有的頻道。

• 臨時頻道一空就被刪除：不留痕跡，不必清理。
• 它的擁有者可以重新命名、限制存取，或設定人數上限。

建立與管理抽獎。

抽獎，到期時自動開獎。

• 可接受的時長：從 10 秒到 28 天。格式自由：30m、2h、1h30m、3d。
• 每個伺服器最多 20 場進行中的抽獎，每次開獎最多 20 位獲獎者。
• 若第一位獲獎者始終沒有出面，reroll 可以事後重抽一位。

管理成員的經驗值。

手動調整某位成員的經驗值，不影響排行榜的其餘部分。

• give 和 remove 是相對調整，set 是絕對設定。
• 由這次調整帶來的升級，會和平常一樣發布公告。

自動發布 Twitch 與 YouTube 開台通知。

管理允許使用管理功能的管理團隊身分組。

權限控管的核心：三個工作人員等級綁定到你伺服器上的身分組，並為每條管理指令設定一個最低等級。

• 持有 Discord 原生權限的成員照樣通行：工作人員等級只開放權限，絕不關閉權限。
• /staff manage 打開完整面板；子指令則用於快速操作。
• 一位成員的等級，取自他等級最高的工作人員身分組。

管理允許控制音樂的 DJ 身分組。

獲准控制當前播放的身分組。

• DJ 指的是：伺服器擁有者、管理員、持有「管理伺服器」權限的成員，或持有這裡所加入之身分組的成員。
• 在還沒設定 DJ 身分組時，僅限 DJ 的指令因此只回應上述那三種人，並不會因此對所有人開放。
• 工作人員身分組（/staff）是另一份清單：它們不會給予 DJ 身分。

變更本伺服器的機器人語言。

整個伺服器的機器人語言：嵌入訊息、選單、錯誤訊息，以及指令的名稱和說明。

/語言 <語言>

• 十三種完整語言。變更一秒內生效，不必重新啟動。
• 成員個人的語言不影響這件事：這是一項伺服器設定。

備份並還原你的伺服器結構。

為伺服器的結構（身分組、頻道、權限）拍下快照，之後再還原。

• 每位擁有者保留 3 份備份。超過之後，用 delete 刪掉一份。
• 編號透過私訊寄出：正是它讓還原成為可能，絕不能流到頻道裡。
• 備份不含任何訊息：它不是聊天紀錄。
• 還原會在目前的伺服器中重建結構，因此把編號匯入別處，就能複製一個伺服器。

列出所有可用的指令。

所有可用指令的互動選單，依你有權使用的範圍篩選。

/help

• 在私訊中同樣可用。

顯示成員的等級和等級卡。

即時產生的等級卡：等級、已獲得的經驗值、在伺服器排行榜中的名次。

/rank [user]

顯示伺服器的經驗值排行榜。

伺服器依經驗值排列的排行榜，逐頁查看。

/leaderboard

顯示使用者的資訊。

一位成員的資料：加入伺服器的時間、帳號建立時間、身分組、ID。

/userinfo [user]

顯示本伺服器的資訊。

伺服器的資料：成員數、頻道、身分組、加成等級、建立日期。

/serverinfo

顯示使用者的頭像。

以完整尺寸顯示頭像，並附上下載連結。

/avatar [user]

• 在私訊中同樣可用。

查看機器人的延遲。

Discord 閘道延遲與機器人的回應時間。

/ping

• 在私訊中同樣可用。

給某人一個擁抱。

一條娛樂指令，不影響任何設定。

/hug <user>

拍打某人（純屬娛樂）。

一條娛樂指令，不影響任何設定。

/slap <user>

播放歌曲或將其加入佇列。

發起一次搜尋或接收一個連結，並把結果加進佇列。

/play <query> [source]

• 你必須已經連上某個語音頻道；機器人會到那裡與你會合。
• 播放清單連結會一次加入其中的所有曲目。
• 播放仰賴專門的音訊基礎設施：若它無法使用，這條指令會照實說明，其餘一切不受影響。

跳過目前的歌曲。

跳到佇列中的下一首。

/skip

暫停目前的歌曲。

暫停播放，並保留確切的播放位置。

/pause

• 僅限 DJ：伺服器擁有者、管理員、持有「管理伺服器」權限的成員，或持有由 /dj add 加入之身分組的成員。參見 /dj。

恢復播放。

繼續已暫停的播放。

/resume

• 僅限 DJ：伺服器擁有者、管理員、持有「管理伺服器」權限的成員，或持有由 /dj add 加入之身分組的成員。參見 /dj。

停止音樂並清空佇列。

停止播放，清空佇列並離開語音頻道。

/stop

• 僅限 DJ：伺服器擁有者、管理員、持有「管理伺服器」權限的成員，或持有由 /dj add 加入之身分組的成員。參見 /dj。

顯示目前的佇列。

完整的佇列，逐頁查看，並顯示總時長。

/queue

顯示正在播放的歌曲。

目前的曲目，附上進度列。

/nowplaying

設定循環模式。

重複目前的曲目、整個佇列，或都不重複。

/loop <mode>

• 僅限 DJ：伺服器擁有者、管理員、持有「管理伺服器」權限的成員，或持有由 /dj add 加入之身分組的成員。參見 /dj。

變更播放音量。

播放音量，從 1 到 150。

/volume [volume]

• 僅限 DJ：伺服器擁有者、管理員、持有「管理伺服器」權限的成員，或持有由 /dj add 加入之身分組的成員。參見 /dj。
• 超過 100 之後，音質會迅速變差。

清空佇列中所有即將播放的曲目。

清空後續曲目，不中斷正在播放的這一首。

/clearqueue

顯示目前曲目的歌詞。

目前曲目的歌詞，在有提供時顯示。

/lyrics