Event API Reference - 版本历史

FunnyCrafter：/* 在实现监听器接口的插件中注册事件监听器 */

2018-07-24T06:49:08Z

在实现监听器接口的插件中注册事件监听器

←上一版本		2018年7月24日 (二) 06:49的版本
第164行：		第164行：
	==== 在实现监听器接口的插件中注册事件监听器 ====		==== 在实现监听器接口的插件中注册事件监听器 ====
	<ref>准确来说是在实现了监听器接口的继承了JavaPlugin的类中注册事件（笑</ref>		<ref>准确来说是在实现了监听器接口的继承了JavaPlugin的类中注册事件（笑</ref>
	~~You could even have the events in the main class, for example~~:		你甚至可以在主类中创建监听器，像这样:
	<blockquote><source lang="java">import org.bukkit.plugin.java.JavaPlugin;		<blockquote><source lang="java">import org.bukkit.plugin.java.JavaPlugin;
	import org.bukkit.event.Listener;		import org.bukkit.event.Listener;

FunnyCrafter：Listener打成了Listenr，已修改

2018-07-24T03:54:13Z

Listener打成了Listenr，已修改

←上一版本		2018年7月24日 (二) 03:54的版本
第123行：		第123行：

	== 注册事件(监听器) ==		== 注册事件(监听器) ==
	~~要注册你的方法，包含EventHandler的类必须是implent了Listenr类的~~		要注册你的方法，包含EventHandler的类必须是implent了Listener类的
	<blockquote><source lang="java">import org.bukkit.event.Listener;		<blockquote><source lang="java">import org.bukkit.event.Listener;

Etcfyj：删除了原文中的“233”——维基要严肃

2017-12-29T13:30:38Z

删除了原文中的“233”——维基要严肃

←上一版本		2017年12月29日 (五) 13:30的版本
第3行：		第3行：
	== 介绍 ==		== 介绍 ==

	服务器里发生的事情，服务器会用'''事件''' 来告诉你。 '''Bukkit'''中有各种各样的事件，例如玩家的互动(玩家登录, 玩家点击了一个方块, 玩家死了,玩家重生...), 方块的动态(方块被放置, 方块被破坏, 方块附近的实体被改变...), 实体事件(~~一个怪物看上了你233~~, 一个苦力怕帮你收集土方块...), 世界事件 (一个世界被加载或卸载, 一个区块被加载或卸载)等等. 由于MC官方的一些原因，他们的JavaDocs都挂了= =		服务器里发生的事情，服务器会用'''事件''' 来告诉你。 '''Bukkit'''中有各种各样的事件，例如玩家的互动(玩家登录, 玩家点击了一个方块, 玩家死了,玩家重生...), 方块的动态(方块被放置, 方块被破坏, 方块附近的实体被改变...), 实体事件(一个怪物看上了你, 一个苦力怕帮你收集土方块...), 世界事件 (一个世界被加载或卸载, 一个区块被加载或卸载)等等. 由于MC官方的一些原因，他们的JavaDocs都挂了= =

	== 基础 ==		== 基础 ==

Etcfyj：翻译章节：/* 调用你的自定义事件 */

2017-12-29T13:25:36Z

翻译章节：调用你的自定义事件

←上一版本		2017年12月29日 (五) 13:25的版本
第277行：		第277行：

	==== 调用你的自定义事件 ====		==== 调用你的自定义事件 ====
	~~You are in control of creating and calling your events, where you call it is completely up to you. Here's an example~~		你可以自由地创建并触发事件，也可以自由地选择在何处触发。以下是一个例子：
	<blockquote><source lang="java">// 创建一个自定义事件对象		<blockquote><source lang="java">// 创建一个自定义事件对象
	CustomEvent event = new CustomEvent("Sample Message");		CustomEvent event = new CustomEvent("Sample Message");

星星：对文本进行汉化,保留原文方便后来者更正错误和参考原文

2017-07-26T06:25:33Z

对文本进行汉化,保留原文方便后来者更正错误和参考原文

←上一版本		2017年7月26日 (三) 06:25的版本
第151行：		第151行：

	=== 在插件中注册事件监听器 ===		=== 在插件中注册事件监听器 ===
			注册事件需要监听器和对应插件，幸运的是，我们拥有属于我们自己的登陆监听器，现在我们来写一个登陆插件吧
	The registerEvents method requires a listener and a plugin. Luckily, we already have our LoginListener. Now for the LoginPlugin!		The registerEvents method requires a listener and a plugin. Luckily, we already have our LoginListener. Now for the LoginPlugin!
	<blockquote><source lang="java">import org.bukkit.plugin.java.JavaPlugin;		<blockquote><source lang="java">import org.bukkit.plugin.java.JavaPlugin;

2017年6月15日 (四) 14:03 Yxfmmmm

2017-06-15T14:03:38Z

←上一版本		2017年6月15日 (四) 14:03的版本
第216行：		第216行：

	==== 注销特定的事件监听器 ====		==== 注销特定的事件监听器 ====
	~~Each event class has the getHandlerList~~() ~~static method~~, ~~call that and then you can use~~ .unregister() ~~method.~~		每个事件类getHandlerList()静态方法,调用,然后你可以使用.unregister()方法。例子:
	~~Example~~:
	<blockquote><source lang="java">		<blockquote><source lang="java">
	PlayerInteractEvent.getHandlerList().unregister(plugin);		PlayerInteractEvent.getHandlerList().unregister(plugin);

2017年6月15日 (四) 14:03 Yxfmmmm

2017-06-15T14:03:14Z

←上一版本		2017年6月15日 (四) 14:03的版本
第213行：		第213行：

	== 在监听器中注销事件监听器 ==		== 在监听器中注销事件监听器 ==
	~~You can un-register individual events~~, ~~entire listener classes or all events registered by your plugin or even by other plugins~~!		你可以自己取消个人事件,整个注册侦听器类或所有事件由你的插件或者其他插件!

	==== 注销特定的事件监听器 ====		==== 注销特定的事件监听器 ====

2017年6月15日 (四) 08:47 Yxfmmmm

2017-06-15T08:47:15Z

←上一版本		2017年6月15日 (四) 08:47的版本
第6行：		第6行：

	== 基础 ==		== 基础 ==
	~~为了保持简单易懂，这一节只讨论一种事件——PlayerLoginEnvent。让我们从创建一个监听器开始吧。~~		为了保持简单易懂，这一节只讨论一种事件——PlayerLoginEnvent(玩家登录事件)。让我们从创建一个监听器开始吧。

	=== 创建方法 ===		=== 创建方法 ===

Tdiant：/* 创建自定义事件 */

2017-02-25T14:03:02Z

创建自定义事件

←上一版本		2017年2月25日 (六) 14:03的版本
第235行：		第235行：

	== 创建自定义事件 ==		== 创建自定义事件 ==
	~~Creating custom events is very simple, you can use the same system that Bukkit uses without ruining performance.~~		创建一个自定义事件是非常简单的，你可以使用跟Bukkit用的一样的系统，而不需要担心服务器性能的问题。

	~~There are two (2) things to keep in mind when you create a Custom Event. They are~~ "~~extend~~ Event" ~~and~~ "~~static~~ handlers." ~~With static handlers, you must input the following code into your custom event:~~		在你创建一个自定义事件的时候，有两个东西你要记住——"继承 Event 类" 和 "静态的 handlers" 。你必须像下面这样写来做静态的handlers：

	<blockquote><source lang="java">private static final HandlerList handlers = new HandlerList();		<blockquote><source lang="java">private static final HandlerList handlers = new HandlerList();
第248行：		第248行：
	return handlers;		return handlers;
	}</source></blockquote>		}</source></blockquote>
	~~This block of code makes the~~ EventHandlers ~~contained inside your own event, keeping any unrelated events completely separated.~~		这块代码可以让 EventHandlers 更方便的操作事件，使无关的事件完全的分开。

	=== 自定义事件示例 ===		=== 自定义事件示例 ===
	~~The following example shows how easy it is to create your own "CustomEvent."~~		下面的这个例子向你展示如何简单地创建一个你自己的事件——“CustomEvent事件”。
	<blockquote><source lang="java">import org.bukkit.event.Event;		<blockquote><source lang="java">import org.bukkit.event.Event;
	import org.bukkit.event.HandlerList;		import org.bukkit.event.HandlerList;
第278行：		第278行：
	==== 调用你的自定义事件 ====		==== 调用你的自定义事件 ====
	You are in control of creating and calling your events, where you call it is completely up to you. Here's an example		You are in control of creating and calling your events, where you call it is completely up to you. Here's an example
	<blockquote><source lang="java">// ~~Create the event here~~		<blockquote><source lang="java">// 创建一个自定义事件对象
	CustomEvent event = new CustomEvent("Sample Message");		CustomEvent event = new CustomEvent("Sample Message");
	// ~~Call the event~~		// 触发事件（创建好自定义事件对象，要使用本语句触发事件，否则什么都不会发生）
	Bukkit.getServer().getPluginManager().callEvent(event);		Bukkit.getServer().getPluginManager().callEvent(event);
	// ~~Now you do the event~~		// 然后继续操作事件
	Bukkit.getServer().broadcastMessage(event.getMessage());</source></blockquote>		Bukkit.getServer().broadcastMessage(event.getMessage());</source></blockquote>

	~~Remember: You are in control of your events. If you don't call it, and act upon it, it doesn't happen!~~		请你记住！你正在控制你的自定义事件的对象。如果你不触发它，那就啥都不会发生。

	==== 监听一个自定义事件 ====		==== 监听一个自定义事件 ====
	~~How do you listen to a custom event you say? Simple, the same way as listening to a normal event!~~		如何监听一个自定义事件呢？简单！就像监听Bukkit其他普通的事件是一样的！
	<blockquote><source lang="java">import org.bukkit.event.Listener;		<blockquote><source lang="java">import org.bukkit.event.Listener;
	import org.bukkit.event.EventHandler;		import org.bukkit.event.EventHandler;
第295行：		第295行：
	@EventHandler		@EventHandler
	public void normalLogin(CustomEvent event) {		public void normalLogin(CustomEvent event) {
	// ~~Some code here~~		// 你的代码
	}		}
	}</source></blockquote>		}</source></blockquote>

Tdiant：/* 使得你的自定义事件具有可撤销性 */

2017-02-25T13:41:35Z

使得你的自定义事件具有可撤销性

←上一版本		2017年2月25日 (六) 13:41的版本
第300行：		第300行：

	==== 使得你的自定义事件具有可撤销性 ====		==== 使得你的自定义事件具有可撤销性 ====
	~~If you ever want to make your event cancellable, remember one thing: "implements Cancellable." Just like you would import Listener. It's really that simple, let me show you an example!~~		如果你想让你的自定义事件可以被撤销，记得，要“继承Cancellable类”。就像你继承Listener那样。这十分简单，让我向你展示一个例子！
	<blockquote><source lang="java">import org.bukkit.event.Event;		<blockquote><source lang="java">import org.bukkit.event.Event;
	import org.bukkit.event.HandlerList;		import org.bukkit.event.HandlerList;
第335行：		第335行：
	}</source></blockquote>		}</source></blockquote>

	~~Afterwards, you would check if a plugin had cancelled the event in your code, before processing normally~~		之后，你需要在你执行相应代码前，检查一下是否有插件把你的事件撤销掉了。
	<blockquote><source lang="java">// ~~Create the event here~~		<blockquote><source lang="java">// 创建一个事件对象
	CustomEvent event = new CustomEvent("Sample Message");		CustomEvent event = new CustomEvent("Sample Message");
	// ~~Call the event~~		// 触发事件
	Bukkit.getServer().getPluginManager().callEvent(event);		Bukkit.getServer().getPluginManager().callEvent(event);
	// ~~Check if the event is not cancelled~~		// 检查一下是否事件被撤销
	if (!event.isCancelled()) {		if (!event.isCancelled()) {
	// ~~Now you do the event~~		// 现在在这里做些什么吧！
	Bukkit.getServer().broadcastMessage(event.getMessage());		Bukkit.getServer().broadcastMessage(event.getMessage());
	}</source></blockquote>		}</source></blockquote>

Event API Reference - 版本历史

FunnyCrafter：​/* 在实现监听器接口的插件中注册事件监听器 */

FunnyCrafter：​Listener打成了Listenr，已修改

Etcfyj：​删除了原文中的“233”——维基要严肃

Etcfyj：​翻译章节：/* 调用你的自定义事件 */

星星：​对文本进行汉化,保留原文方便后来者更正错误和参考原文

2017年6月15日 (四) 14:03 Yxfmmmm

2017年6月15日 (四) 14:03 Yxfmmmm

2017年6月15日 (四) 08:47 Yxfmmmm

Tdiant：​/* 创建自定义事件 */

Tdiant：​/* 使得你的自定义事件具有可撤销性 */

FunnyCrafter：/* 在实现监听器接口的插件中注册事件监听器 */

FunnyCrafter：Listener打成了Listenr，已修改

Etcfyj：删除了原文中的“233”——维基要严肃

Etcfyj：翻译章节：/* 调用你的自定义事件 */

星星：对文本进行汉化,保留原文方便后来者更正错误和参考原文

Tdiant：/* 创建自定义事件 */

Tdiant：/* 使得你的自定义事件具有可撤销性 */