Extractioncraft 指令與權限

Extractioncraft 註冊了以下根指令：

/extractioncraft
/exc

子指令透過 MagmaCore 指令管理器在執行時註冊。

管理員指令

指令	權限	預設	發送者	說明
/exc initialize	extractioncraft.initialize	op	玩家	開啟首次設定選單
/exc setup	extractioncraft.setup	op	玩家	開啟內容包瀏覽器，用於安裝、解除安裝和管理內容
/exc protection bypass	extractioncraft.protection.bypass	op	玩家	切換對讀取此狀態的方塊和互動檢查的繞過。不會繞過比賽傳送限制或 PvP 禁令。
/exc reload	extractioncraft.*	op	任意	重新載入外掛程式。進行中的比賽會結束，其中的玩家保留各自的物品。如果重新載入未完全套用，建議完全重啟伺服器。

玩家指令

指令	權限	預設	發送者	說明
/exc createMatch <contentPackage.yml>	extractioncraft.creatematch	true	玩家	使用指定的內容包建立新比賽並將玩家放入其中。Tab 自動補全可用的內容包檔案名稱。
/exc start	extractioncraft.start	true	玩家	在滿足最低玩家數量的情況下，啟動玩家目前所在的比賽
/exc leave	（未設定）	true	玩家	離開目前的比賽，或在玩家的比賽仍在產生時取消它
/exc quit	（未設定）	true	玩家	與 /exc leave 相同。

MagmaCore 共用指令

MagmaCore 已內建於 Extractioncraft 中，因此這些指令也隨外掛一同提供。

指令	權限	預設	發送者	說明
/exc recommendedplugins	extractioncraft.setup	op	任意	開啟（對玩家）或印出（對主控台）為 Extractioncraft 推薦的搭配外掛清單。
/nightbreak plugins	nightbreak.plugins	op	任意	開啟 Nightbreak 外掛目錄，以瀏覽並下載 MagmaGuy 的其他外掛。由 MagmaCore 在全域註冊一次。
/nightbreaklogin <token>	nightbreak.login	op	任意	在遊戲內註冊您的 nightbreak.io 帳號權杖，讓伺服器能夠取得授權內容。由 MagmaCore 在全域註冊一次。
/nightbreaklogout	nightbreak.login	op	任意	從伺服器清除已儲存的 nightbreak.io 帳號權杖。由 MagmaCore 在全域註冊一次。
/logify	logify.*	op	任意	將目前的 latest.log 張貼到 mclo.gs，讓管理員更容易回報錯誤。由 MagmaCore 在全域註冊一次。
/extractioncraftchangelog	op、extractioncraft.*、extractioncraft.setup 或 extractioncraft.initialize	op	玩家	顯示來自 Nightbreak 的未讀 Extractioncraft 發行說明。dismiss 會將其標記為已讀，disable 則停止加入時的提醒。在 Extractioncraft 完成啟動後註冊。請參閱更新日誌通知。

權限摘要

權限	預設	說明
extractioncraft.initialize	op	存取 /exc initialize
extractioncraft.setup	op	存取 /exc setup 和 /exc recommendedplugins
extractioncraft.protection.bypass	op	存取 /exc protection bypass
extractioncraft.match.bypass	op	讓管理人員可以傳送進入比賽世界，並在比賽倒數或進行期間留在其中，而不會被拒絕或被送到主世界的重生點。它不會讓他們成為比賽參與者。
extractioncraft.*	op	存取 /exc reload
extractioncraft.creatematch	true	存取 /exc createMatch
extractioncraft.start	true	存取 /exc start
extractioncraft.leave	true	在 plugin.yml 中為 /exc leave 宣告，但執行時並未強制執行（已註冊的 quit/leave 指令沒有權限檢查）
nightbreak.plugins	op	存取 /nightbreak plugins（由 MagmaCore 註冊）
nightbreak.login	op	存取 /nightbreaklogin 和 /nightbreaklogout（由 MagmaCore 註冊）
logify.*	op	存取 /logify（由 MagmaCore 註冊）

注意事項

• plugin.yml 宣告了根指令 /extractioncraft 和 /logify。/extractioncraft 的子指令會在執行時透過 MagmaCore 指令管理器註冊。
• extractioncraft.* 被 /exc reload 使用，但並未在 plugin.yml 中宣告，因此它不是一個已註冊的權限節點。管理員（OP）會自動通過檢查；其他人則需要由權限外掛明確授予。
• quit 和 leave 是同一個指令的兩個別名，該指令沒有權限檢查。extractioncraft.leave 節點從未被強制執行。
• /logify、/nightbreak、/nightbreaklogin 和 /nightbreaklogout 由 MagmaCore（已內建於外掛中）在全域註冊，在伺服器上所有 MagmaCore 外掛之間各自只註冊一次。如果 MagmaGuy 的另一個外掛已經佔用了其中某個名稱，Extractioncraft 就會略過註冊，並改用既有的那一個。
• 執行不帶引數的 /exc 會列出發送者權限與類型所允許的已註冊子指令。quit/leave 的處理器未設定用法字串，因此其說明項目不完整。
• 註冊時未附帶權限節點的子指令（目前只有 quit/leave）會讓每一位發送者都通過權限檢查。
• 除了 /exc reload 和 /exc recommendedplugins 之外，所有 Extractioncraft 子指令都僅限玩家使用。主控台會收到 This command must be run as a player!。
• /exc createMatch 會拒絕已在比賽中或正在等待比賽產生的玩家，包括其他使用內建 MagmaCore 比賽系統的外掛所建立的比賽。
• Extractioncraft 沒有註冊共用的 downloadall 子指令，因此 /exc setup 中的資訊按鈕不會建議使用它。請直接使用設定選單本身來管理內容。
• Extractioncraft 也沒有註冊共用的 downloadpluginupdate 或 applypluginupdate 子指令，自動下載外掛程式更新後的通知也不會建議執行 applypluginupdate。請重新啟動伺服器以使用更新，或在下載前於 config.yml 中設定 nightbreak.applyPluginUpdatesWithoutRestart。