查看“Plugin.yml”的源代码

<!--
=== 创建plugin.yml ===

你已经创建了项目和主类，如果你想要Bukkit能够加载你的插件，你还必须创建 '''[[Plugin YAML|plugin.yml]]''' 文件. 这个文件包含有基础的插件信息，如果缺失这个文件，你的插件也将会失效. 此时你需要右键''src/main/resources''. 选择''New &gt; File''. 命名为"'''plugin.yml'''" 并右键完成新文件的创建.Eclipse会打开默认的文本编辑窗口来显示'''plugin.yml'''文件中空白的内容并提供编辑. ''(Hint:&nbsp;如果你想要使得你的工作空间更加规整，关闭文本编辑器并将'''plugin.yml''' 文件拖到主工作空间(拖到文件目录的右边) 之后你就可以在eclipse中编辑文件了.)''

有三个基础的内容需要在plugin.yml写明. 
: name:  插件名称. 
: main: [http://docs.oracle.com/javase/specs/jls/se7/html/jls-6.html#jls-6.7 插件主类的完整，合法名称] . 
: version: 插件当前版本号. 

最简单的 '''plugin.yml''' 文件内就像这样&nbsp;: 

 name: {插件名称}
 main: {包名}.{主类}
 version: {版本号}

 PS:插件的包名经常会包括插件的名称，所以看到这个的时候不要感到惊讶。
    你的主类是否是你的插件名取决于你之前的命名方式，时刻记住这一点很重要。

'''''更多例子''', 请看[[#Example_Files_and_Templates]]''

此时你的插件已经可以被Bukkit加载了,同时服务端日志也会开始记录你的插件. 不过它现在什么用都没有!

*以上内容来自 [[Bukkit/插件开发教程]] 4.6 创建plugin.yml
-->
=== Plugin.yml ===


-----

Plugin.yml 文件包含了你的插件信息，没有这个文件，你的插件将'''不会正常工作'''，它由一组属性组成，'''注意！！！''' 这些属性是严格区分大小写的。接下来粗体是必需属性（缺了就会有问题），斜体是可选属性(但有一些在一些特定的情况下必须要有)

<h3>
目录：
</h3>
* [[#Required|必需属性]]
* [[#Optional|可选属性]]
* 命令
* 权限
* 实例

<h4 id="Required">
必需属性
</div>
要想 plugin.yml 有效 则有三个属性 必须存在

<u>'''main：'''</u>

* 指插件的主类名
* 在插件中主类名有且仅有一个，而且需要继承<code>JavaPlugin</code>类
* 主类名是插件的“入口” 反正这玩意在插件启动时执行

''例：''

<syntaxhighlight lang="yaml">main: org.mineplugin.testplugin.Test 
# 格式是包名加上主类名   你可别说你不知道什么是包和主类</syntaxhighlight>
<u>'''name：'''</u>

* 插件的名称
* 必须由(a-z,A-Z,0-9, _)组成 这里建议写“''一个特殊''”一点名字避免和其它插件重名

''例：''

<syntaxhighlight lang="yaml">name: MinePlugin</syntaxhighlight>
<u>'''version'''</u>

* 这是你插件的版本
* 理论上可以填写任何String类型 [https://semver.org/lang/zh-CN/ 参考文献]

<syntaxhighlight lang="yaml">version: 1.0.0</syntaxhighlight>
<h4 class="Optional">
可选属性
</h4>