🛠️ Paper 1.21.6 - 1v1 Room 插件開發需求書
- 指令系統 (Commands)
開發者需要實作 /1v1 核心指令,並包含以下子指令:
/1v1 select
行為:進入選取模式。玩家點擊方塊後,需記錄兩個對角點(Pos1, Pos2)以定義一個長方體區域。
顯示:需在聊天室提示「點位 1 已設定 (座標)」與「點位 2 已設定 (座標)」。
/1v1 create <名稱>
行為:將目前的選取區域儲存為房間。
顯示:成功時顯示綠色字體 [1v1] 房間 <名稱> 創建成功。
/1v1 remove <名稱>
行為:刪除資料庫/設定檔中的房間,並立即清除該區域可能存在的門方塊。
/1v1 list
行為:列出所有已建立的房間名稱。
/1v1 debug
行為:顯示開發資訊(例如:目前區域內人數、區域座標、目前的門方塊材質狀態)。
- 核心邏輯:自動門系統 (The Gate Logic)
這是插件的核心機制,運作邏輯如下:
監測頻率:插件需每秒(20 Ticks)掃描一次所有已註冊的房間區域。
人數偵測:
當區域內玩家 = 2 人:觸發「鎖門」。
當區域內玩家 < 2 人:觸發「開門」。
方塊操作:
鎖門時:遍歷該長方體區域的六個外平面(牆壁、天花板、地板)。如果該位置原本是「空氣」,則將其替換為設定檔中指定的材質(預設:GLASS)。
開門時:將剛才填充的方塊重新替換回「空氣」。
- 配置文件 (config.yml) 結構
開發者需提供可自定義的設定檔,支援顏色代碼(如 &a 或 MiniMessage 格式):
文字格式:包含 prefix(前綴)、msg-join(進入訊息)、msg-leave(離開訊息)。
門材質:gate-block-type: GLASS(需檢查是否為有效的 Bukkit Material 名稱)。
掃描延遲:scan-interval: 20(掃描週期設定)。
- 開發注意事項 (Important Notes)
邊界計算:確保選取區域時,不論玩家點擊的順序(高處到低處或反之),插件都能正確計算出 minX/maxX, minY/maxY, minZ/maxZ。
離線處理:如果兩名玩家在 1v1 期間,其中一人突然斷線(QuitEvent),插件必須立刻執行「開門」邏輯,防止另一人被困住。
非同步安全:方塊填充建議在主執行緒(Sync)進行,但人數統計可以考慮優化效能,避免區域過多時造成伺服器卡頓。
方塊防護:應防止玩家手動挖掘「門方塊」,或在門開啟後,原本該位置的方塊(如裝飾品)被意外清空(只針對空氣進行操作)
No files in this session