← 返回 Bot 首頁

網頁面板邀請機器人 GitHub 服務條款隱私權政策

Index-Based Tutorial

NoRule Bot 完整教學

這一頁已同步更新到 1.1.1，整理新版音樂面板、歡迎訊息、Web Dashboard、私人包廂與完整本地化調整，方便你快速上手、部署與對外說明。

重點功能打開網頁面板快速開始指令教學

重點功能

音樂面板升級

新增音量按鈕、歌曲封面、面板保留與即時刷新，並改善 YouTube Mix / Autoplay 穩定性。

重點功能

Web Dashboard

新增獨立歡迎訊息分頁，支援三語系、即時預覽卡片、發送預覽訊息與 modal 編輯。

重點功能

歡迎訊息

獨立於成員日誌之外，可分開設定頻道、標題、內文、圖片與多種佔位符。

重點功能

權限提示與本地化

客服單、日誌、私人包廂與設定頁已補齊更多明確提示，並修復大量未本地化與亂碼鍵名。

1.1.1 更新重點

Feature Map

音樂功能：新增音量控制、歌曲封面、公開統計與播放歷史，並整理 /playlist / /歌單。

音樂控制面板：保留最後一張面板、冷卻提示、文案全面本地化，音樂指令執行後會更新到頻道底部。

歡迎訊息：新增獨立 /歡迎訊息 / /welcome，並支援頻道、標題、內文、縮圖、大圖與變數。

Web UI：修正登入與語言問題，重建 web-en、web-zh-TW、web-zh-CN 三語內容。

私人包廂與日誌：新增房主轉讓、修正邀請連結與權限提示，成員通知同頻道模式可重新選擇頻道。

設定中心：中文 /設定 子指令重新整理，/設定模組開關 可直接控制歡迎訊息。

指令教學

音樂指令

/join

讓 Bot 進入你的語音頻道。

/play query:<關鍵字或URL>

播放歌曲或加入佇列。關鍵字模式會打開搜尋選單。

/skip

跳過目前歌曲。

/stop

停止播放並清空佇列。

/leave

讓 Bot 離開語音頻道。

/music-panel

建立新的音樂控制面板。

/repeat mode:<off|single|all>

設定循環模式。

/music stats / /音樂統計

查看音樂統計資料，現在會公開顯示，不再只有發送者可見。

/播放歷史

查看歷史播放紀錄，現在也會公開顯示。

/playlist / /歌單

新版已整理中英文指令結構，避免混用，/歌單 載入來源顯示也會標示為「歌單」。

範例

/play query:YOASOBI 群青
/play query:https://www.youtube.com/watch?v=xxxx

刪除訊息

/delete-messages channel channel:<頻道> amount:<1-99>

/delete-messages user user:<使用者> amount:<1-99>

/刪除訊息

中文別名。

說明

amount 不填預設為 99
會先顯示確認按鈕，避免誤刪
只能刪除 Discord API 允許範圍內的訊息（14 天內）

設定指令

/settings info

查看分頁化設定總覽。

/settings reload

重新讀取目前伺服器設定。

/settings reset

開啟重設選單，並帶二次確認。

/settings language code:<語言代碼>

切換伺服器語言，相關指令會優先讀取語言檔。

/settings template

用下拉 + 表單編輯通知模板。

/settings logs

用選單設定各類日誌頻道。

/settings music

用選單調整音樂 / 包廂相關設定。

/settings module

一鍵切換各模組開關。

模組開關（/settings module）

通知啟用
訊息日誌啟用
歡迎訊息啟用
成員加入通知
成員離開通知
語音日誌
指令使用日誌
頻道建立 / 刪除日誌
身分組變更日誌
封禁 / 踢出管理日誌
音樂自動離開啟用
音樂 Autoplay 啟用
私人包廂啟用

歡迎訊息

/歡迎訊息 / /welcome

獨立管理歡迎訊息，不再與管理員用的成員加入 / 離開日誌共用設定。

可設定內容

支援開關、頻道、標題、內文、縮圖與大圖，也能套用 {群組名稱}、{使用者} 等變數。

模組控制

歡迎訊息開關可以在 /設定模組開關 或 /settings module 中直接切換。

Web UI 配合

可在 Dashboard 進行預覽、內容編輯與發送預覽訊息，流程比舊版更簡潔。

私人包廂

/settings music

先設定私人包廂觸發頻道。

自動建立

使用者進入觸發語音後，自動建立「使用者名稱的包廂」並移動使用者。

/private-room-settings 或 /包廂設定

可上鎖 / 解鎖、設定人數（1-99，留空為無上限）、更改名稱（最多 10 字），也支援房主轉讓包廂。

操作細節

設定人數與改名送出後，會直接刷新同一個設定面板；缺少權限時也會顯示更清楚的提示。

快速開始

1. 在 config.yml 填入 token。
2. 建議直接使用 jar 啟動：

java -Dfile.encoding=UTF-8 -jar target/discord-music-bot-1.1.1-all.jar

3. 進 Discord 用 /help 檢查指令是否已註冊。
4. 先設定 /settings logs、/settings music 與 /welcome。
5. 打開 https://dashboard.norule.me/ 檢查語言、歡迎訊息與模組設定。
6. 再用 /play、/music stats 與歡迎訊息預覽確認新版功能。

編譯與部署

開發測試

mvn clean compile exec:java

正式打包

mvn clean package -DskipTests

建議正式環境直接執行打包後的 jar，Pterodactyl 也較適合用這個方式。

建議權限

設定類指令：Manage Server
刪除訊息：Manage Messages
音樂：Connect、Speak
私人包廂：Manage Channels、Move Members

其他文件

網頁面板：dashboard.norule.me
法務文件：隱私權政策、服務條款
原始碼：GitHub Repo