Commands zh TW

English | 繁體中文

NextVoiceCord 提供的每個指令的完整參考，依可執行者分組列出。

執行指令

文字指令是搭配機器人的前綴輸入的。預設前綴是提及機器人本身 （@BotName play never gonna give you up）；也可以在機器人的設定檔中設定一個固定前綴（以及一個 可選的第二備用前綴），而每個伺服器也能用 prefix 指令覆寫自己的前綴（見 Permissions-and-Server-Settings-zh-TW）。

斜線指令（/play、/queue 等）是直接向 Discord 註冊的，因此會出現在 Discord 自己的指令選擇器中， 並附帶參數提示——你不需要記住確切語法。輸入 /help（或文字指令 help）會在 Discord 內開啟一份 互動式指令清單，範圍僅限於你個人被允許執行的指令；它涵蓋的內容與本頁相同。

以下大多數指令同時存在兩種形式——一個斜線指令，以及一個同名的文字指令。若某個指令只有一種形式， 表格中會特別註明。**參數（Arguments）**欄顯示的是文字指令形式的語法；斜線指令形式則是透過 Discord 自身的參數欄位詢問相同資訊。

有一小部分指令僅有文字形式、沒有對應的斜線指令：lyrics、scsearch、nowplaying，以及除了 clearchannel 以外的所有擁有者（Owner）指令（autoplaylist、debug、eval、playlist、 setavatar、setgame、setname、setstatus、shutdown）。反過來，help 與 controller 則只存在斜線指令形式。

存取層級的完整說明請見 Permissions-and-Server-Settings-zh-TW；以下每個標題底下也附有簡短說明。

任何人

伺服器中的任何成員都可以執行這些指令——不需要任何身分組或權限。

指令	形式	參數	功能
help	僅斜線	—	顯示一份互動式指令清單，範圍僅限於你可以執行的指令。
history	兩者皆有	[pagenum]	顯示最近播放過的曲目（歷史佇列）。
lyrics	僅文字	[song name]	出現在說明清單中，但實際上沒有作用——它所需要的 JLyrics 相依套件已從專案中移除。請勿依賴此指令。
nowplaying	僅文字	—	顯示目前正在播放的歌曲。
play	兩者皆有	<title|URL|subcommand>	播放指定的歌曲，或依子指令內容繼續／恢復播放。
playlists	兩者皆有	—	顯示這個伺服器上可用的播放清單。
queue	兩者皆有	[pagenum]	顯示目前的佇列。
remove	兩者皆有	<position|ALL>	依位置從佇列中移除一首歌，或用 ALL 清除你自己加入的所有歌曲。
scsearch	僅文字	—	在 SoundCloud 上搜尋查詢字串，並讓你從結果中選擇。
search	兩者皆有	<query>	在 YouTube 上搜尋查詢字串，並讓你從結果中選擇。
seek	兩者皆有	[+ | -] <HH:MM:SS | MM:SS | SS> 或 <0h0m0s | 0m0s | 0s>	在目前歌曲內跳轉播放位置，可為絕對時間或相對於目前位置的時間。
settings	兩者皆有	—	開啟設定面板。面板內容如何依開啟者不同而有差異，見 Permissions-and-Server-Settings-zh-TW。
shuffle	兩者皆有	—	將你個人加入佇列的歌曲重新洗牌排序。
skip	兩者皆有	—	對跳過目前歌曲投下一票。你單獨一票是否就足以跳過，取決於伺服器設定的跳過比例（見 Permissions-and-Server-Settings-zh-TW）。

DJ

需要 DJ 身分組（或「管理伺服器」〔Manage Server〕權限，或是機器人擁有者——見 Permissions-and-Server-Settings-zh-TW）。

指令	形式	參數	功能
forceremove	兩者皆有	<user>	移除指定使用者加入佇列的所有項目。
forceskip	兩者皆有	—	立即跳過目前歌曲，不需要投票。
movetrack	兩者皆有	<from> <to>	將佇列中的一首曲目從某個位置移動到另一個位置。
pause	兩者皆有	—	暫停目前的歌曲。
playnext	兩者皆有	<title|URL>	將一首歌加入佇列，並排在目前歌曲之後立即播放。
repeat	兩者皆有	[off|all|single]	設定重複模式：關閉、循環整個佇列，或循環目前曲目。
skipto	兩者皆有	<position>	跳到佇列中指定位置的歌曲。
stop	兩者皆有	—	停止播放並清空佇列。
volume	兩者皆有	[0-150]	設定播放音量（0–150），若未給定數值則顯示目前音量。

Admin（管理員）

需要「管理伺服器」（Manage Server）權限，或是機器人擁有者——見 Permissions-and-Server-Settings-zh-TW。

指令	形式	參數	功能
controller	僅斜線	—	自訂這個伺服器的正在播放控制面板。完整語法見 Controller-Panel-zh-TW。
npbuttons	兩者皆有	<on|off|inherit>	設定這個伺服器的正在播放訊息是否顯示互動按鈕。
nplayout	兩者皆有	<full|minimal|inherit>	設定這個伺服器的正在播放訊息版面模式。
prefix	兩者皆有	<prefix|NONE>	設定此伺服器專屬的文字指令前綴；NONE 會恢復為機器人的預設前綴。
queuetype	兩者皆有	[linear|fair]	變更佇列在不同使用者之間的排序方式。
setdj	兩者皆有	<rolename|NONE>	設定這個伺服器的 DJ 身分組；NONE 會清除設定。設定為 @everyone 的效果請見 Permissions-and-Server-Settings-zh-TW。
setskip	兩者皆有	<0-100>	設定這個伺服器上跳過一首歌所需的聽眾投票百分比。
settc	兩者皆有	<channel|NONE>	將音樂指令限制在單一文字頻道；NONE 會移除此限制。
setvc	兩者皆有	<channel|NONE>	將機器人限制在單一語音頻道播放；NONE 會移除此限制。

除了 controller 以外，以上所有指令也都可以從 /settings 面板設定——見 Permissions-and-Server-Settings-zh-TW。

Owner（擁有者）

僅限於設定檔中 discord.owner 所指定的單一 Discord 使用者 ID。

指令	形式	參數	功能
autoplaylist	僅文字	<name|NONE>	設定這個伺服器的預設播放清單。
clearchannel	兩者皆有	—	清除以 settc 設定的文字頻道中的所有訊息。
debug	僅文字	—	顯示除錯資訊。
eval	僅文字	—	對執行中的機器人執行 Nashorn（JavaScript）程式碼。
playlist	僅文字	<append|delete|make|setdefault>	管理播放清單。
setavatar	僅文字	<url>	設定機器人的頭像。
setgame	僅文字	[action] [game]	設定機器人的 Discord 活動狀態（正在玩／正在直播／正在聽／正在看）。
setname	僅文字	<name>	設定機器人的 Discord 使用者名稱。
setstatus	僅文字	<status>	設定機器人的線上狀態。
shutdown	僅文字	—	安全地關閉機器人。

這些指令是給實際運行機器人的人使用的，而不是給伺服器管理者使用的——即使是伺服器擁有者，只要其 Discord 使用者 ID 不是設定檔中指定的那一個，也無法使用這些指令。

另請參閱

安裝與啟動機器人請見 Getting-Started-zh-TW，誰能執行什麼指令與如何設定伺服器請見 Permissions-and-Server-Settings-zh-TW，自訂 controller 所編輯的正在播放面板請見 Controller-Panel-zh-TW，若某個指令的行為與本頁描述不符，請見 Troubleshooting-zh-TW。