[Minecraft 插件] 服務器插件開發教程(零)- 插件開發環境配置


UPD1 (2022-2-4):完全重制了 2022-1-14 的教程。

UPD2 (2023-5-3):調整了部分文字的格式。


 

  許多人可能對於插件開發望而卻步,認為它需要高深的編程知識。但是,事實並非完全如此,它和許許多多的技能一樣,只要通過簡單的動手嘗試,就可以快速上手——當然,精通就是后話了。話不多說,讓我們開始。

  首先介紹一下插件(plugin)。插件是一類可以擴展已有程序功能的組件,這里說“擴展”,意思是插件不僅僅可以改變已有程序的行為,還能實現新的功能。許多擁有插件功能的程序可以實現高度的自定義。放在游戲上來說,擁有插件功能的游戲可以收獲更加廣大且持久的用戶群——無論什么時候,都有玩家熱衷於開發和使用插件並樂此不疲。

  插件,一般來說必須依賴程序開發者提供的接口或者符合開發者制定的規范才能正常地工作。之所以提到這一點,是因為它與我們接下來要講的服務端有很大關系。

  Minecraft 服務器是依賴服務端(server)工作的,而玩家使用的游戲程序是客戶端(client),服務端負責生成世界,管理世界中的各種邏輯(生物生成與移動、時間推進等等),而玩家的客戶端通過下載服務端里的世界數據等,並進行渲染,同時每隔一定周期上傳自己的數據,從而得以在世界中同步游玩。

  Minecraft 原版服務端是不支持插件的,但是許多熱心的開發者對其進行了二次開發,從而使其擁有了插件功能。現在比較常用的服務端有 bukkit 、 spigot 和比較新的 paper 和 sponge 。不同服務端的插件通常不能互通,因此在編寫插件之前我們首先要確定目標服務端類型。由於 paper 服務端兼容 bukkit 和 spigot ,我自己的服務器也基於 paper,因此下面就以 paper 服務端為例進行講解。

  工欲善其事,必先利其器。插件的開發需要工具,在這里我推薦 JetBrains 的 IntelliJ IDEA,可以從他們的官網上下載免費版本(即 Community 版),地址如下:https://www.jetbrains.com/idea/download/#section=windows。安裝完畢之后,打開,進入 Plugins 界面,搜索並安裝 Minecraft Development 插件(這里也用到了插件,它是用來擴展 IDEA 的功能的,使其開發 Minecraft 插件變得更加方便),你應該會看到如下窗口:

 

如果你打開后是這樣的,則從左上角的 File - Settings... 進入,同樣可以找到 Plugins 界面。

 

安裝完畢后,打開 IDEA 的新建項目選項,此時已經可以看到 Minecraft 一欄了,我們勾選 Paper Plugin,然后點擊 Next:

 

出現以下界面,並填寫全部信息(GroupId 是組織名或者說開發者名, ArtifactId 是插件名, Version 是版本號),然后點擊 Next。

 

在這個界面我們首先要在右邊的 Minecraft Version 中選擇好 Minecraft 版本,注意不同 Minecraft 版本的插件通常也是無法互通的。然后窗口下方是一些選填信息,根據個人需要填寫即可,完畢后點擊 Next。

 

這個窗口主要是確定我們項目的位置,依據個人喜好填寫,然后點擊 Finish:

 

右下角會顯示一個下載框,請等待其下載完成。這里下載的是對應 Minecraft 版本的插件開發庫。

 

然后點擊窗口上方的 Run 來編譯代碼,測試環境是否正確配置:

 

然后你就能找到編譯好的插件文件了:

 

至此,插件開發的基本環境已經配置完畢。

 注:如果有些界面不一樣,可能是因為你在項目創建時右邊選擇的是 Gradle 而不是 Maven(從上往下第四張圖片)。Gradle 一樣可以使用,只是最后編譯好的插件在 項目根目錄 / build / libs 下。

 


[Minecraft 插件] 服務器插件開發教程(壹)- 事件機制(上)


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM