Minecraft(我的世界)中文论坛

标题: Day's 水桶插件开发教程 第二章 我的第一个插件

---

作者: whatafcukday    时间: 2015-4-30 22:03
标题: Day's 水桶插件开发教程 第二章 我的第一个插件


Day’s 水桶插件开发教程第二章 我的第一个插件
※讲的不好欢迎指正
首先，了解插件成分 (又引用+倒霉的忍者+的教程了。。不好意思了!我懒。。)

插件主类：一般与插件同名，作为插件的启动器，服务器启动时将首先执行插件主类里的方法， 　　　　　　　 所有插件功能最初都由此触发； 事件：游戏内数据的变化将引起事件，事件按其主要参与对象的主动和被动的行为特点分类； 监听器：按事件的类别分类，一个监听器可以监听一个或多个事件，通过事件的发生触发一些代码； 命令执行器：当玩家输入某一命令时（聊天时内容以“/”开头），由命令执行器执行该命令所触发的代码； 信息文件：plugin.yml，记录插件的主类位置，名称，以及版本等等，需要手动添加，缺少此文件插件将无法运行； 设置文件：CB为每个插件都配置了一个默认的设置文件（config.yml），你可以将插件的相关设定都放置在此文件中； 数据库：用来储存相关数据，虽然YAML文件同样能做到，但用数据库更安全更稳定（方便还真不敢说）。

1.首先新建项目 文件->新建->java项目 名字就叫你插件的名字 这里示例使用的是pluginname
2.给项目添加BukkitAPI库
在包资源管理器中->右键新建好的项目->属性->java构建路径->添加外部jar->选择你的BukkitAPI库
BukkitAPI库下载地址： 引用stool先森的帖子  
3.新建一个包，在包里新建一个类

右键项目中的scr->新建->包->名字为域名倒过来如 com.xx.xx org.xx.xx   推荐使用com.github.github用户名 这里以com.github.jiaocheng 示例 严禁使用以下包名，会导致与BukkitAPI冲突 - org.bukkit - net.bukkit - com.bukkit 然后，右键新建好的包->新建->类->类名为插件名，最好与项目名相同 这里以pluginname示例->next 然后我们就在包下创建了一个类：pluginname.java 了 我们称呼他为主类。他首先被Bukkit所加载。然后根据其中代码选择性的加载其他类。

4.编辑主类写代码了！

public class pluginname 在他的后面必须加上extends JavaPlugin 让他继承水桶中的JavaPlugin类。 编辑完毕后的代码： package com.github.jiaocheng; public class pluginname extends JavaPlugin{ } 复制代码 当在代码下出现一条红线，旁边出现一个红色的小叉叉的时候，表示编译错误，其实此时有可能!!只是有可能并不是你的代码写错了，而是没有导入特定包中的类，导致某些东西无法被识别，导入类这也是java的一大特色。 可以使用IDE的快速修正来解决：右键小叉叉->快速修正->导入"xxxxx"即可 这时在package的下方就会出现一条: import org.bukkit.plugin.java.JavaPlugin; 代表导入org.bukkit.plugin.java.JavaPlugin类。 保存一下，现在再看看，红线是不是没有了？当然要是这东西本身就不存在于java自带库或你添加的库中，那么将不会有导入的提示。 以后类似的东西将不会再次提及，请自己翻教程解决。

onEnable/onDisable方法：

水桶中定义了一个public void onEnable() {}方法，在该插件被加载时调用。所以现在，在类中添加这一方法吧！ 与其相对的，还有一个public void oDisable() {}方法，在该插件被关闭前调用。 package com.github.jiaocheng; import org.bukkit.plugin.java.JavaPlugin; public class pluginname extends JavaPlugin{         public void onEnable() {                 //做你想做的事0.0         }                  public void onDisable() {                 //做你想做的事0.0         } } 复制代码 介绍一个方法 getLogger().info(String); 参数为String类型 例子： getLogger().info("启用咯~"); 后台就会收到 [pluginname]启用咯~ 这个方法能够向后台发送[插件名]+内容的消息 可以用它来对后台说： 我启用了！ 我关闭了！ 之类的 Logger为记录器 相当于后台那个黑色的框框吧 （只是相当于） 当然使用System.out.print() 也可以达到差不多的效果，不过就没有前面的插件名了 推荐使用Logger 要比sysout好用

都做好了 却缺少点睛之笔，就是怎么才能让Bukkit发现这个插件并且加载他呢？

plugin.yml创建

对着项目右键，新建，文件，名称为plugin.yml,确定。 然后右键创建好的plugin.yml,属性,资源,文本文件编码,其他,UTF-8。 然后就可以编辑plugin.yml了， 注意不要在系统自带的记事本中编辑，可以选择在IDE中编辑或在记事本++中编辑 我给模板，错了一个空格都不行，yml文件的格式要求非常严格。 1.不允许使用tab 2.缩进要有规律 3.区分大小写！ 4.每一个冒号后都应该有一个空格 name: pluginname #名称 main: com.github.jiaocheng.pluginname #包名+主类名 version: 1.0 #版本 复制代码

好了好了终于做好了
现在右键项目->导出->jar文件 导出来的jar文件就是你的第一个插件了，虽然他没什么用。
返回索引{:10_493:}...写了好久，有疑问在跟帖子提出，谢。

---

作者: 914554688wyt    时间: 2015-5-1 08:38
赞！ 一些比较常见的问题都写到了

---

作者: ljserver    时间: 2015-5-1 09:19
赞，期待更新

---

作者: whatafcukday    时间: 2015-5-1 09:27

ljserver 发表于 2015-5-1 09:19
赞，期待更新

第三章已经发了。。等待审核中{:10_492:} 开发板这审核机制真是。。

---

作者: wodeshijieglq    时间: 2015-5-2 18:37
纠正一个错误.新建类的时候第一个字母是不是要大写哒！...{:10_513:}

---

作者: whatafcukday    时间: 2015-5-2 18:40

wodeshijieglq 发表于 2015-5-2 18:37
纠正一个错误.新建类的时候第一个字母是不是要大写哒！...

恩对的，最好按照JAVA的命名机制{:10_509:} 谢谢你的纠正

---

作者: wodeshijieglq    时间: 2015-5-2 18:54
其实这玩意前面吧.和C语言前面差不多.

---

作者: ak1115284886    时间: 2015-7-4 23:56
楼主，bukkit库的所有方法可以在哪看？

---

作者: whatafcukday    时间: 2015-7-5 07:01

ak1115284886 发表于 2015-7-4 23:56
楼主，bukkit库的所有方法可以在哪看？

继续看我的教程吧 ， 后面有

---

作者: ExplodingCreepr    时间: 2015-7-5 17:15
yml加注释就是用#号吗                                               

---

作者: ak1115284886    时间: 2015-7-5 18:59

whatafcukday 发表于 2015-7-5 07:01
继续看我的教程吧 ， 后面有

感谢万分

---

作者: whatafcukday    时间: 2015-7-9 08:02

ExplodingCreepr 发表于 2015-7-5 17:15
yml加注释就是用#号吗

对的 {:10_492:}

---

作者: moheng2014    时间: 2015-8-2 15:30
JAR 导出完成，但带有警告。请参阅“详细信息”以获取更多信息。
  已导出，但存在编译错误：moheng0001/src/com/github/a810587921/mohengcj0001.java

错误行内容：package qq570084949;
无法解析类型 com.avaje.ebean.EbeanServer。从必需的 .class 文件间接引用了它

怎么办 ，，

---

作者: 2528611422    时间: 2015-8-21 13:16

moheng2014 发表于 2015-8-2 15:30
JAR 导出完成，但带有警告。请参阅“详细信息”以获取更多信息。
  已导出，但存在编译错误：moheng0001/sr ...

无法识别包.....

---

作者: qxdnfsy    时间: 2015-9-12 08:14
导入xxx
是随便导入一个什么文件吗

---

作者: 拉普达    时间: 2016-1-13 02:23
核心就是api？

---

作者: zzzzzzzabczz    时间: 2016-1-13 17:16
可否推荐一个编辑plugin.yml的软件？
eclipse默认用了记事本
然后我便不知所措了

---

作者: whatafcukday    时间: 2016-1-30 18:29

zzzzzzzabczz 发表于 2016-1-13 17:16
可否推荐一个编辑plugin.yml的软件？
eclipse默认用了记事本
然后我便不知所措了 ...

notepad++不错

---

作者: Green_stone    时间: 2016-2-13 21:05
只是那个解决快速修复的步骤有点不懂，导致编译出现警告，望楼主能细教。

---

作者: kjkj2173135    时间: 2016-2-16 21:13
JAR 创建失败。请参阅“详细信息”以获取更多信息。
  资源与文件系统不同步："/FirstPlugin/plugin.yml"。

---

作者: 2571612311    时间: 2016-7-11 19:43
有两个问题，第一怎么送金粒，第二，为什么我就是汉化不成功啊！！！！

---

作者: 2571612311    时间: 2016-7-12 20:44
C:\Users\Administrator\Documents\360截图这是为什么啊
求大神回复

---

作者: SB22753    时间: 2016-7-17 20:47
请问楼主
getLogger().info()
info()括号里面彩色字符§没有效果啊
后台显示是§a§l插件加载
我是craftbukkit-1.9.2

---

作者: TaiwanBill5    时间: 2016-7-22 13:31
加油，希望可持續教程

---

作者: 2571612311    时间: 2016-7-30 17:45
[17:31:48 ERROR]: Could not load 'plugins\demo.jar' in folder 'plugins'
org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml
        at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPlug
inLoader.java:164) ~[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager
.java:133) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.craftbukkit.v1_8_R3.CraftServer.loadPlugins(CraftServer.ja
va:291) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.craftbukkit.v1_8_R3.CraftServer.reload(CraftServer.java:74
0) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.Bukkit.reload(Bukkit.java:534) [spigot-1.8.7.jar:git-Spigo
t-b3c0272-7723b90]
        at org.bukkit.command.defaults.ReloadCommand.execute(ReloadCommand.java:
25) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:14
1) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.craftbukkit.v1_8_R3.CraftServer.dispatchCommand(CraftServe
r.java:642) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.craftbukkit.v1_8_R3.CraftServer.dispatchServerCommand(Craf
tServer.java:628) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at net.minecraft.server.v1_8_R3.DedicatedServer.aO(DedicatedServer.java:
404) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at net.minecraft.server.v1_8_R3.DedicatedServer.B(DedicatedServer.java:3
68) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at net.minecraft.server.v1_8_R3.MinecraftServer.A(MinecraftServer.java:6
57) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at net.minecraft.server.v1_8_R3.MinecraftServer.run(MinecraftServer.java
:560) [spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at java.lang.Thread.run(Unknown Source) [?:1.8.0_91]
Caused by: org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInp
utException: Input length = 1
        at org.yaml.snakeyaml.reader.StreamReader.update(StreamReader.java:200)
~[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.yaml.snakeyaml.reader.StreamReader.<init>(StreamReader.java:60) ~
[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.yaml.snakeyaml.Yaml.load(Yaml.java:381) ~[spigot-1.8.7.jar:git-Sp
igot-b3c0272-7723b90]
        at org.bukkit.plugin.PluginDescriptionFile.<init>(PluginDescriptionFile.
java:232) ~[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPlug
inLoader.java:159) ~[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        ... 13 more
Caused by: java.nio.charset.MalformedInputException: Input length = 1
        at java.nio.charset.CoderResult.throwException(Unknown Source) ~[?:1.8.0
_91]
        at sun.nio.cs.StreamDecoder.implRead(Unknown Source) ~[?:1.8.0_91]
        at sun.nio.cs.StreamDecoder.read(Unknown Source) ~[?:1.8.0_91]
        at java.io.InputStreamReader.read(Unknown Source) ~[?:1.8.0_91]
        at org.yaml.snakeyaml.reader.UnicodeReader.read(UnicodeReader.java:123)
~[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at java.io.Reader.read(Unknown Source) ~[?:1.8.0_91]
        at org.yaml.snakeyaml.reader.StreamReader.update(StreamReader.java:184)
~[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.yaml.snakeyaml.reader.StreamReader.<init>(StreamReader.java:60) ~
[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.yaml.snakeyaml.Yaml.load(Yaml.java:381) ~[spigot-1.8.7.jar:git-Sp
igot-b3c0272-7723b90]
        at org.bukkit.plugin.PluginDescriptionFile.<init>(PluginDescriptionFile.
java:232) ~[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPlug
inLoader.java:159) ~[spigot-1.8.7.jar:git-Spigot-b3c0272-7723b90]
        ... 13 more
这是报错，为什么不能加载

---

作者: MCHandler    时间: 2016-10-17 10:31
赞一个！

---

作者: IFEN1993    时间: 2016-11-14 17:15
.每一个冒号后都应该有一个空格
厉害了我的哥
就是这个空格害我出师不利，哈哈哈哈哈哈多亏了你我要写出我的第一个插件了

---

作者: @TGL    时间: 2016-11-16 13:32
希望更详细一点

---

作者: SakuraYuyuko233    时间: 2017-10-21 17:00
成功+1 很棒的帖子 很适合小白 就是有一些地方细节没有讲清楚  那个bukkitAPI也没有下载链接

---

作者: 18278436235    时间: 2017-12-13 20:20
“他首先被Bukkit所加载。然后根据其中代码选择性的加载其他类。”
请问一下怎么写才能加载其他类？

---

作者: steveyang137    时间: 2020-6-7 18:28
IDEA怎么导出JAR呢

---