opjjjidj

🛠️ Paper 1.21.6 - 1v1 Room 插件開發需求書

  1. 指令系統 (Commands)

開發者需要實作 /1v1 核心指令,並包含以下子指令:

/1v1 select

行為:進入選取模式。玩家點擊方塊後,需記錄兩個對角點(Pos1, Pos2)以定義一個長方體區域。

顯示:需在聊天室提示「點位 1 已設定 (座標)」與「點位 2 已設定 (座標)」。

/1v1 create <名稱>

行為:將目前的選取區域儲存為房間。

顯示:成功時顯示綠色字體 [1v1] 房間 <名稱> 創建成功。

/1v1 remove <名稱>

行為:刪除資料庫/設定檔中的房間,並立即清除該區域可能存在的門方塊。

/1v1 list

行為:列出所有已建立的房間名稱。

/1v1 debug

行為:顯示開發資訊(例如:目前區域內人數、區域座標、目前的門方塊材質狀態)。

  1. 核心邏輯:自動門系統 (The Gate Logic)

這是插件的核心機制,運作邏輯如下:

監測頻率:插件需每秒(20 Ticks)掃描一次所有已註冊的房間區域。

人數偵測:

當區域內玩家 = 2 人:觸發「鎖門」。

當區域內玩家 < 2 人:觸發「開門」。

方塊操作:

鎖門時:遍歷該長方體區域的六個外平面(牆壁、天花板、地板)。如果該位置原本是「空氣」,則將其替換為設定檔中指定的材質(預設:GLASS)。

開門時:將剛才填充的方塊重新替換回「空氣」。

  1. 配置文件 (config.yml) 結構

開發者需提供可自定義的設定檔,支援顏色代碼(如 &a 或 MiniMessage 格式):

文字格式:包含 prefix(前綴)、msg-join(進入訊息)、msg-leave(離開訊息)。

門材質:gate-block-type: GLASS(需檢查是否為有效的 Bukkit Material 名稱)。

掃描延遲:scan-interval: 20(掃描週期設定)。

  1. 開發注意事項 (Important Notes)

邊界計算:確保選取區域時,不論玩家點擊的順序(高處到低處或反之),插件都能正確計算出 minX/maxX, minY/maxY, minZ/maxZ。

離線處理:如果兩名玩家在 1v1 期間,其中一人突然斷線(QuitEvent),插件必須立刻執行「開門」邏輯,防止另一人被困住。

非同步安全:方塊填充建議在主執行緒(Sync)進行,但人數統計可以考慮優化效能,避免區域過多時造成伺服器卡頓。

方塊防護:應防止玩家手動挖掘「門方塊」,或在門開啟後,原本該位置的方塊(如裝飾品)被意外清空(只針對空氣進行操作)

Kodari can make mistakes. Review important code before using.
Files

No files in this session

Code