Quick Start
公開使用前的設定順序
這個順序能避免最常見的問題:Bot 看不到頻道、音樂沒聲音、Ticket 建不了、私人語音被審核認為不受管理員監管。
邀請 Bot
使用細項權限邀請連結,不需要管理員權限。
/help
跑設定檢查
先看總覽,再依功能逐項檢查缺少的權限。
/setupcheck
設定專用頻道
把通知、日誌、音樂、生日、Ticket 放到指定頻道。
/setup view
啟用進階功能
私人語音、Ticket、新聞、自動身分組依伺服器需求開啟。
/voice setup
Setup Wizard
功能設定精靈
切換分類查看需要的 Discord 權限、建議指令和常見修正。
快速總覽
先跑一次總檢查,再針對會用到的功能進一步檢查。
- Bot 最高身分組要高於它需要管理的身分組。
- 有頻道覆寫時,要額外確認 Bot 在該頻道可查看、發送、嵌入、讀取紀錄。
- 觸發詞和 AI 相關功能需要 Developer Portal 的 Message Content Intent。
音樂播放
檢查語音權限、Lavalink 狀態與音樂指令頻道。
- 需要加入語音、語音說話、使用語音活動。
- 如果限制音樂指令頻道,該頻道也要允許 Bot 發送嵌入訊息。
- 播放失敗時先看 `/musicdoctor`,再看 Lavalink 是否正常。
管理工具
檢查警告、停權、踢出、封鎖、語音管理與身分組管理。
- 管理訊息、停權成員、踢出、封鎖要依功能需求開啟。
- 管理身分組只會對低於 Bot 最高身分組的位置生效。
- 建議設定重大操作審計日誌,方便公開使用後追蹤管理行為。
私人語音
管理員先建立分類和語音大廳,成員加入大廳後才自動建立私人語音。
- 需要管理頻道與移動語音成員。
- 分類與大廳都由管理員指定,避免被認為是未受監管的私人語音。
- 建立者會拿到私人語音控制權,空房會自動刪除。
Ticket
用面板建立客服單頻道,適合支援、申訴、審核或私下回報。
- 需要管理頻道、查看頻道、發送訊息、嵌入連結。
- Bot 身分組要能在分類下建立新文字頻道。
- 面板頻道建議放在公告或規則附近,方便成員找到。
通知與日誌
把進退群、訊息日誌、重大操作、地震、天氣與新聞分流到指定頻道。
- 通知頻道需要查看、發送、嵌入、讀取訊息紀錄。
- 新聞與氣象資料依賴外部服務,偶發異常時可能延遲。
- 公開伺服器建議把管理日誌頻道設成只有管理員可見。
Checklist
上線前檢查表
勾選狀態會保存在這台裝置的瀏覽器,方便你部署前逐項確認。