Plugin.yml - 版本历史

2021年5月5日 (三) 02:21 THS-yuhao

2021-05-05T02:21:16Z

←上一版本		2021年5月5日 (三) 02:21的版本
第3行：		第3行：

	{\| cellspacing="0" cellpadding="4" border="1" class="wikitable"		{\| cellspacing="0" cellpadding="4" border="1" class="wikitable"
	\|+ ~~Attributes~~		\|+ 属性
	\|-		\|-
	! ~~Attribute~~		! 属性
	! ~~Required~~		! 必需
	! ~~Description~~		! 描述
	! ~~Example~~		! 示例
	! ~~Notes~~		! 笔记
	\|- style="font-weight: bold;"		\|- style="font-weight: bold;"
	\| name		\| name
	\| ~~yes~~		\| 是
	\| ~~The name of your plugin~~.		\| 插件的名字.
	\| <code>name: MyPlugin</code>		\| <code>name: MyPlugin</code>
	\|		\|

2021年5月5日 (三) 02:19 THS-yuhao

2021-05-05T02:19:34Z

←上一版本		2021年5月5日 (三) 02:19的版本
第1行：		第1行：
	{{DocsInclude}}		{{DocsInclude}}
	~~When Bukkit loads a plugin~~, ~~it needs to know some basic information about it~~. ~~It reads this information from a YAML file, 'plugin~~.~~yml'~~. ~~This file consists of a set of attributes~~, ~~each defined on a new line and with no indentation~~.		当Bukkit读取一个插件时,它需要知道插件的一些基础属性.它从plugin.yml中读取. 这个文件由一组元素组成,并且没有缩进必需在新行定义.

	{\| cellspacing="0" cellpadding="4" border="1" class="wikitable"		{\| cellspacing="0" cellpadding="4" border="1" class="wikitable"

2021年5月5日 (三) 02:16 THS-yuhao

2021-05-05T02:16:28Z

显示更改

THS-yuhao：/* Plugin.yml */

2021-05-04T14:39:26Z

Plugin.yml

←上一版本		2021年5月4日 (二) 14:39的版本
第66行：		第66行：

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

	<syntaxhighlight lang="yaml">version: 1.0.0</syntaxhighlight>		<syntaxhighlight lang="yaml">version: 1.0.0</syntaxhighlight>

THS-yuhao：/* Plugin.yml */

2021-05-04T14:37:16Z

Plugin.yml

←上一版本		2021年5月4日 (二) 14:37的版本
第66行：		第66行：

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

	<syntaxhighlight lang="yaml">version: 1.0.0</syntaxhighlight>		<syntaxhighlight lang="yaml">version: 1.0.0</syntaxhighlight>

THS-yuhao：/* Plugin.yml */

2021-05-04T14:36:16Z

Plugin.yml

←上一版本		2021年5月4日 (二) 14:36的版本
第66行：		第66行：

	* 这是你插件的版本		* 这是你插件的版本
	* 理论上可以填写任何String类型 ~~<a href="~~https://semver.org/lang/zh-CN/~~" target="iframe">~~参考~~</a>~~		* 理论上可以填写任何String类型 [[https://semver.org/lang/zh-CN/\|参考]]

	<syntaxhighlight lang="yaml">version: 1.0.0</syntaxhighlight>		<syntaxhighlight lang="yaml">version: 1.0.0</syntaxhighlight>

2021年5月4日 (二) 14:34 THS-yuhao

2021-05-04T14:34:37Z

←上一版本		2021年5月4日 (二) 14:34的版本
第1行：		第1行：
			<!--
	=== 创建plugin.yml ===		=== 创建plugin.yml ===

第22行：		第23行：

	*以上内容来自 [[Bukkit/插件开发教程]] 4.6 创建plugin.yml		*以上内容来自 [[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类型 <a href="https://semver.org/lang/zh-CN/" target="iframe">参考</a>

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

Iwar：创建

2015-03-15T05:00:01Z

创建

新页面

=== 创建plugin.yml ===

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

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

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

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

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

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

Plugin.yml - 版本历史

2021年5月5日 (三) 02:21 THS-yuhao

2021年5月5日 (三) 02:19 THS-yuhao

2021年5月5日 (三) 02:16 THS-yuhao

THS-yuhao：​/* Plugin.yml */

THS-yuhao：​/* Plugin.yml */

THS-yuhao：​/* Plugin.yml */

2021年5月4日 (二) 14:34 THS-yuhao

Iwar：​创建

THS-yuhao：/* Plugin.yml */

THS-yuhao：/* Plugin.yml */

THS-yuhao：/* Plugin.yml */

Iwar：创建