Minecraft 1.7.2 基於BukkitAPI的外掛編寫教程《一》
阿新 • • 發佈：2019-01-27
至此 我們正式進入了外掛的編寫環節
首先 我們新建一個Java 專案 如圖：
選擇新建>Java專案後,會出現 如圖所示
專案名：這是作為Java專案的名稱 屬於一種代號 方便你能找到他
位置：Java專案儲存在本地磁碟的位置 當你勾選使用預設位置的時候 Java專案所在的位置總是在{workspace}/{project}
最後 筆者編輯後的 如圖所示:
接下來 請不要點選完成 我們還需要為該Java專案新增依賴
點選下一步 選擇庫>新增外部JAR 如圖所示
圖中我們選定的bukkit-1.7.2-R0.2.jar正是本教程所使用的Bukkit API 外掛的編寫 全部依賴於這個jar檔案
下載地址:
當我們新增完成後 就可以點選完成了
當你完成這步後 你可以清晰的看到你的包資源瀏覽器中出現了一個叫做SimplePlugin的空專案
到此為止 我們已經完成了Bukkit 外掛編寫的第一步 專案的建立 當然如果你的外掛中出現了中文 請設定專案的編碼為UTF-8
接下來 這個專案我們就要為其新增原始碼
右擊這個專案 選擇新建>類
這裡筆者 已經填寫好了相關的資訊
包：關於包的概念 這裡我引用了http://blog.sina.com.cn/s/blog_4cd9865b010009h1.html這篇博文
在Java的編寫中 你有一些命名規則需要去了解 這只是作為一個潛規則存在
參考地址：
名稱：類的名稱 具體命名規則 請參考上方的參考資料
超類：這個類繼承的父類 在Bukkit 外掛編寫中 指定的主類你必須要繼承JavaPlugin這個類 當然你也可以實現JavaPlugin這個類中所實現的介面
當你新建好類 IDE會根據你的這些設定 自動幫你補全程式碼
這時你的外掛還需要對其過載 載入和關閉的方法
他們看起來是這樣的
當你完成對onEnable()和onDisable()的過載時 你的主類也就完成了 雖然並沒有什麼功能
為了讓外掛看起來cool 我們準備在這兩個方法中加入點什麼
JavaPlugin 作為Bukkit API 提供的一個類 當你繼承他時 會提供一些已經實現的功能給與作為外掛編寫者的你
this 是Java中的關鍵詞 用以表明當前例項
getLogger() 是JavaPlugin提供的一個方法 用於獲取外掛的Logger
這樣我們華而不實的主類就完成了。
對於Bukkit的編寫我們還缺少一步 那就是為Bukkit指明外掛的檔案
這個檔案就是plugin.yml
在Bukkit的外掛載入機制中 plugin.yml是至關重要的標識 如果沒有plugin.yml 外掛也就不會被載入
我們選中專案 右擊選擇 新建>檔案
檔名為plugin.yml
當我們建立完成後 IDE為我們預設開啟plugin.yml檔案
如圖所示 這是我完成的plugin.yml
對於Bukkit的外掛載入機制來說 你必須填寫的三個專案
name:外掛的名字
version: 外掛的版本
main: 外掛的主類 請注意是<主類所在的包>.<主類>
（如果 你在plugin.yml 使用了中文 請使用轉碼工具轉換為UTF-8 無Bom）
關於plugin.yml更加詳細的說明 請參考官方的Wiki http://wiki.bukkit.org/Plugin_YAML
外掛的打包
首先 我們新建一個Java 專案 如圖：
選擇新建>Java專案後,會出現 如圖所示
專案名：這是作為Java專案的名稱 屬於一種代號 方便你能找到他
位置：Java專案儲存在本地磁碟的位置 當你勾選使用預設位置的時候 Java專案所在的位置總是在{workspace}/{project}
最後 筆者編輯後的 如圖所示:
接下來 請不要點選完成 我們還需要為該Java專案新增依賴
點選下一步 選擇庫>新增外部JAR 如圖所示
圖中我們選定的bukkit-1.7.2-R0.2.jar正是本教程所使用的Bukkit API 外掛的編寫 全部依賴於這個jar檔案
下載地址:
當我們新增完成後 就可以點選完成了
當你完成這步後 你可以清晰的看到你的包資源瀏覽器中出現了一個叫做SimplePlugin的空專案
到此為止 我們已經完成了Bukkit 外掛編寫的第一步 專案的建立 當然如果你的外掛中出現了中文 請設定專案的編碼為UTF-8
接下來 這個專案我們就要為其新增原始碼
右擊這個專案 選擇新建>類
這裡筆者 已經填寫好了相關的資訊
包：關於包的概念 這裡我引用了http://blog.sina.com.cn/s/blog_4cd9865b010009h1.html這篇博文
在Java的編寫中 你有一些命名規則需要去了解 這只是作為一個潛規則存在
參考地址：
名稱：類的名稱 具體命名規則 請參考上方的參考資料
超類：這個類繼承的父類 在Bukkit 外掛編寫中 指定的主類你必須要繼承JavaPlugin這個類 當然你也可以實現JavaPlugin這個類中所實現的介面
當你新建好類 IDE會根據你的這些設定 自動幫你補全程式碼
這時你的外掛還需要對其過載 載入和關閉的方法
他們看起來是這樣的
@Override 是JDK提供的一個高階註釋 用於表示過載@Override public void onEnable() { } @Override public void onDisable() { }
當你完成對onEnable()和onDisable()的過載時 你的主類也就完成了 雖然並沒有什麼功能
為了讓外掛看起來cool 我們準備在這兩個方法中加入點什麼
JavaPlugin 作為Bukkit API 提供的一個類 當你繼承他時 會提供一些已經實現的功能給與作為外掛編寫者的你
this 是Java中的關鍵詞 用以表明當前例項
getLogger() 是JavaPlugin提供的一個方法 用於獲取外掛的Logger
這樣我們華而不實的主類就完成了。
對於Bukkit的編寫我們還缺少一步 那就是為Bukkit指明外掛的檔案
這個檔案就是plugin.yml
在Bukkit的外掛載入機制中 plugin.yml是至關重要的標識 如果沒有plugin.yml 外掛也就不會被載入
我們選中專案 右擊選擇 新建>檔案
檔名為plugin.yml
當我們建立完成後 IDE為我們預設開啟plugin.yml檔案
如圖所示 這是我完成的plugin.yml
對於Bukkit的外掛載入機制來說 你必須填寫的三個專案
name:外掛的名字
version: 外掛的版本
main: 外掛的主類 請注意是<主類所在的包>.<主類>
（如果 你在plugin.yml 使用了中文 請使用轉碼工具轉換為UTF-8 無Bom）
關於plugin.yml更加詳細的說明 請參考官方的Wiki http://wiki.bukkit.org/Plugin_YAML