如何使用計算器
- 只勾選你的機器人需要的權限。
- 複製上方顯示的整數。
- 貼到邀請連結的權限參數中,或在你的程式中使用。
機器人邀請連結長得像這樣,其中包含你的應用程式 Client ID 和你的整數:
https://discord.com/oauth2/authorize?client_id=YOUR_ID&scope=bot+applications.commands&permissions=68608
bot 這個 scope 會把機器人加入伺服器,applications.commands 則讓它能註冊斜線指令。
這個數字代表什麼
Discord 以位元集合(bit set)儲存權限。每項權限各占一個位元,整數就是所有選取位元的總和。例如檢視頻道是 1024,發送訊息是 2048,讀取訊息歷史是 65536,所以擁有這三項的機器人,數值就是 68608。API 會以字串形式傳送這些數值,因為數字已經大到某些程式語言無法用一般整數安全地存放。如果你要在程式中處理,請把它們當成大整數(big integer)。
重要權限的用途
- 管理員(8): 授予所有權限,並忽略頻道的權限覆寫。
- 管理伺服器(32): 更改伺服器設定,例如名稱和圖示。
- 管理身分組(268435456): 建立和編輯比機器人自己最高身分組更低的身分組。
- 管理頻道(16): 建立、編輯和刪除頻道。
- 踢出成員(2)和停權成員(4): 移除成員,但只能移除最高身分組低於機器人的人。
- 管理訊息(8192): 刪除和釘選其他人的訊息。
- 管理 Webhook(536870912): 建立 Webhook,它可以用任何名稱和頭像發布訊息。
- 提及 @everyone(131072): 允許標註 @everyone、@here 和所有身分組。
為什麼管理員權限有風險
管理員是最省事的選擇,卻也是最糟的預設值。它讓機器人擁有完整控制權,並跳過你設定的所有頻道限制。如果這個機器人出現安全漏洞,或權杖外洩,持有權杖的人就能刪除頻道、停權成員並發放身分組。好的機器人會告訴你它需要哪些權限,並且只用這些權限運作。對於沒有明確理由卻要求管理員權限的機器人,請務必小心,也建議閱讀我們的 Discord 安全指南。
為什麼我的機器人還是不能做某件事?
整數只是整體的一部分。頻道的權限覆寫可能在某個頻道中拒絕了某項權限,而且身分組階層也會限制管理操作:機器人只能踢出、停權或更改最高身分組比它低的使用者的暱稱。如果是這個問題,請在伺服器設定中把機器人的身分組往上移。
管理機器人需要管理員權限嗎?
通常不需要。大多數管理機器人只需要一小串權限,例如踢出成員、停權成員、管理訊息和禁言成員。請查看該機器人自己的說明文件。
加入機器人之後還能更改權限嗎?
可以。伺服器管理員隨時都能編輯機器人的身分組,所以大部分的更動不需要重新取得邀請連結。
permissions=0 會怎樣?
機器人加入時不帶有任何自己的權限,只會取得它的身分組和伺服器預設值所允許的權限。
正在挑選機器人嗎?請參考最佳 Discord 機器人清單。當設定要求輸入 ID 時,ID 查詢可以派上用場。