跳到主要內容
新手入門

你的第一個專案

一步步帶你完成一個真實的第一個專案：一個 Paper 家園插件，從需求到測試過的 JAR。

更新於

本頁內容
  1. 需求
  2. 接下來會發生什麼
  3. 看看成果
  4. 修改一些東西
  5. 建置並測試
  6. 下一步

這份逐步說明會做出一個小而真實的插件，讓你把每個階段都看過一遍。同樣的流程適用於每一種專案類型。

#需求

在建立頁面上，選擇 Bukkit/Spigot/Paper Plugin (Java)，然後寫下：

Text
A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

注意它包含了什麼：平台和版本、每個指令和它的作用、時間規則、儲存方式、權限，以及哪些東西應該可以設定。這些就是讓第一次的成果能直接使用的關鍵。

#接下來會發生什麼

  1. Codexe 會逐步送出檔案：Maven 的 pom.xml、主類別、指令和監聽器類別、plugin.yml 和 config.yml。
  2. 橫幅會切換成正在檢查專案…，接著是正在建置…。Codexe 會編譯這個插件。
  3. 如果編譯器回報錯誤（例如錯誤的 import），你會看到正在修正問題…。Codexe 會修復程式碼並再次建置。這不會用到你的 token。
  4. 專案變成就緒。

#看看成果

  • 打開 plugin.yml，確認指令和權限和你要求的一致。
  • 打開 config.yml：冷卻時間和訊息應該都在裡面。
  • 大致瀏覽一下主類別。你不需要看懂每一行，但可以看出明顯的缺漏。

#修改一些東西

在專案聊天中輸入：

Text
Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

Codexe 會編輯現有的檔案，而不是從頭來過。後續修改的費用比新專案低得多，因為只有受影響的檔案會被重寫。當修改涉及可建置的專案時，Codexe 會再驗證一次。

#建置並測試

按下編譯重新建置，然後按下載 JAR。把 JAR 放進你伺服器的 plugins/ 資料夾並重新啟動。測試每個指令，包括邊界情況（在預熱期間移動、冷卻時間、重新啟動）。

#下一步

你的第一個專案 | Codexe Docs