Event API Reference/en - 版本历史

Sheep-realms：修复错误的模板使用

2024-04-01T09:14:33Z

修复错误的模板使用

←上一版本		2024年4月1日 (一) 09:14的版本
第49行：		第49行：
	就像我说的，Bukkit通过EventHandler注解来知道你这个方法是用来监听事件的，通过方法需要传入的参数知道要监听的是哪个事件，比如: <code>PlayerLoginEvent</code>.		就像我说的，Bukkit通过EventHandler注解来知道你这个方法是用来监听事件的，通过方法需要传入的参数知道要监听的是哪个事件，比如: <code>PlayerLoginEvent</code>.

	{{特别提醒:要想监听事件，你还必须得执行一个注册监听事件类的方法才能让插件正常监听事件}}		特别提醒:要想监听事件，你还必须得执行一个注册监听事件类的方法才能让插件正常监听事件

	你必须在你的插件主类里(也就是那个继承JavaPlugin的类)的onEnable方法里加上如下代码:		你必须在你的插件主类里(也就是那个继承JavaPlugin的类)的onEnable方法里加上如下代码:

Tdiant：/* Video Tutorial */

2017-08-01T10:41:25Z

Video Tutorial

←上一版本		2017年8月1日 (二) 10:41的版本
第349行：		第349行：
	}</source></blockquote>		}</source></blockquote>

	== ~~Video Tutorial~~ ==		== 视频资料 ==
	~~If you would prefer to watch a video tutorial version of this, please click~~ [http://www.youtube.com/watch?v=PWQNsqwD-AY ~~here~~].		如果你更希望观看视频版的本教程，请点击 [http://www.youtube.com/watch?v=PWQNsqwD-AY 这里！].

	[[Category: 条目原文]] [[分类:开发教程]]		[[Category: 条目原文]] [[分类:开发教程]]

Tdiant：/* Making your CustomEvent Cancellable */

2017-08-01T10:40:22Z

Making your CustomEvent Cancellable

←上一版本		2017年8月1日 (二) 10:40的版本
第302行：		第302行：
	}</source></blockquote>		}</source></blockquote>

	==== ~~Making your CustomEvent Cancellable~~ ====		==== 让你的自定义事件可以被取消 ====
	~~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!~~		如果你希望你的自定义事件可以被取消，记住，要"implements Cancellable."（实现Cancelled类），就像你去实现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;
第338行：		第338行：
	}</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>

Tdiant：/* Listening to a Custom Event */

2017-08-01T10:36:56Z

Listening to a Custom Event

←上一版本		2017年8月1日 (二) 10:36的版本
第290行：		第290行：
	请您记住：你现在正在控制你的事件，如果你不去触发他，他就没有办法正常工作，什么都不会发生！		请您记住：你现在正在控制你的事件，如果你不去触发他，他就没有办法正常工作，什么都不会发生！

	==== ~~Listening to a Custom Event~~ ====		==== 监听自定义事件 ====
	~~How do you listen to a custom event you say? Simple, the same way as listening to a normal event!~~		如何来监听一个自定义事件呢？通常情况下，监听自定义事件与其他普通的事件是一样的！
	<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;
第298行：		第298行：
	@EventHandler		@EventHandler
	public void normalLogin(CustomEvent event) {		public void normalLogin(CustomEvent event) {
	// ~~Some code here~~		// 你的代码
	}		}
	}</source></blockquote>		}</source></blockquote>

Tdiant：/* 唤起你的自定义事件 */

2017-08-01T10:35:47Z

唤起你的自定义事件

←上一版本		2017年8月1日 (二) 10:35的版本
第279行：		第279行：
	}</source></blockquote>		}</source></blockquote>

	==== ~~唤起你的自定义事件~~ ====		==== 触发你的自定义事件 ====
	~~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!~~		请您记住：你现在正在控制你的事件，如果你不去触发他，他就没有办法正常工作，什么都不会发生！

	==== Listening to a Custom Event ====		==== Listening to a Custom Event ====

星燚：/* Creating Custom Events */

2016-11-16T16:11:59Z

Creating Custom Events

←上一版本		2016年11月16日 (三) 16:11的版本
第232行：		第232行：
	</source></blockquote>		</source></blockquote>

	== ~~Creating Custom Events~~ ==		== 创建自定义事件 ==
	~~Creating custom events is very simple, you can use the same system that Bukkit uses without ruining performance.~~		要创建一个自定义的事件是很简单的，而且不会和Bukkit所自带的事件冲突

			要创建你的自定义事件，有下面的几点是需要注意的
			你的自定义事件的类必须继承Event类，并且必须要有
			HandlerList这个静态常量和getHandlers这个方法
			所以你的一个基础的自定义事件的类应该看起来像下面这样:

	~~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:~~

	<blockquote><source lang="java">private static final HandlerList handlers = new HandlerList();		<blockquote><source lang="java">private static final HandlerList handlers = new HandlerList();
第246行：		第250行：
	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~~.		因为为了不和别的事件起冲突，你必须要拥有自己的HandlerList才可以.

	=== ~~Custom Event Example~~ ===		=== 自定义事件的一个小例子 ===
	~~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;
第274行：		第279行：
	}</source></blockquote>		}</source></blockquote>

	==== ~~Calling your Custom Event~~ ====		==== 唤起你的自定义事件 ====
	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">// Create the event here

星燚：/* 翻译段落 */

2016-11-16T16:05:44Z

翻译段落

←上一版本		2016年11月16日 (三) 16:05的版本
第223行：		第223行：
	下面我们将会学习自定义事件		下面我们将会学习自定义事件

	==== ~~Un-register all events~~ ====		==== 注销一个插件所有的监听器 ====
	~~Using the HandlerList class and its unregisterAll~~() ~~static method you can easily unregister events from listener classes or plugins.~~		你可以使用HandlerList类下面的unregisterAll()这个静态方法来对一个插件所监听的所有事件的监听器进行注销
	~~Example~~:		比如下面这样:
	<blockquote><source lang="java">		<blockquote><source lang="java">
	HandlerList.unregisterAll(plugin);		HandlerList.unregisterAll(plugin);
	// ~~this will unregister all events from the specified plugin~~		// 这将会注销这个插件监听这个事件的所有监听器
	// ~~you can also specify a listener class instead of plugin.~~		// 当然这里的参数也可以用一个指定的监听类来代替，可以单独注销一个监听器
	</source></blockquote>		</source></blockquote>

星燚：/* Un-register specific event */

2016-11-04T03:23:05Z

Un-register specific event

←上一版本		2016年11月4日 (五) 03:23的版本
第213行：		第213行：
	前面提到了如何去创建并且注册监听器使之生效，同样的服务端也提供了注销监听器的方法，你可以注销一个插件里所有的监听器，也可以注销一个插件里所有指定事件的监听器		前面提到了如何去创建并且注册监听器使之生效，同样的服务端也提供了注销监听器的方法，你可以注销一个插件里所有的监听器，也可以注销一个插件里所有指定事件的监听器

	==== ~~Un-register specific event~~ ====		==== 注销一个插件内指定事件的监听器 ====
	~~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);
	// ~~this will unregister all PlayerInteractEvent instances from the plugin~~		// 这样就代表会注销plugin这个插件内所有监听PlayerInteractEvent这个事件的监听器
	// ~~you can also specify a listener class instead of plugin.~~		// 当然了你也可以单独在plugin那个参数里面写入要注销指定监听器的类
	</source></blockquote>		</source></blockquote>
	~~Now you know why you'll need the getHandlerList() in your custom events.~~		下面我们将会学习自定义事件

	==== Un-register all events ====		==== Un-register all events ====

星燚：/* Un-registering events or listeners */

2016-11-04T03:18:25Z

Un-registering events or listeners

←上一版本		2016年11月4日 (五) 03:18的版本
第210行：		第210行：
	}</source></blockquote>		}</source></blockquote>

	== ~~Un-registering events or listeners~~ ==		== 注销你的监听器 ==
	~~You can un-register individual events, entire listener classes or all events registered by your plugin or even by other plugins!~~		前面提到了如何去创建并且注册监听器使之生效，同样的服务端也提供了注销监听器的方法，你可以注销一个插件里所有的监听器，也可以注销一个插件里所有指定事件的监听器

	==== Un-register specific event ====		==== Un-register specific event ====

星燚：/* Registering Events in your Listener */

2016-11-04T03:15:13Z

Registering Events in your Listener

←上一版本		2016年11月4日 (五) 03:15的版本
第178行：		第178行：
	}</source></blockquote>		}</source></blockquote>

	=== ~~Registering Events in your Listener~~ ===		=== 用监听类的构造器注册监听类 ===
	~~There are many ways to register your events. Here's an example where you register them in your listener class.~~		有很多很多不同的方式来注册你的监听类，下面代码示范了如何使用监听类的构造器来注册监听类
	<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;
第192行：		第192行：
	@EventHandler		@EventHandler
	public void normalLogin(PlayerLoginEvent event) {		public void normalLogin(PlayerLoginEvent event) {
	// ~~Some code here~~		// 你的代码
	}		}

	@EventHandler(priority = EventPriority.HIGH)		@EventHandler(priority = EventPriority.HIGH)
	public void highLogin(PlayerLoginEvent event) {		public void highLogin(PlayerLoginEvent event) {
	// ~~Some code here~~		// 你的代码
	}		}
	}</source></blockquote>		}</source></blockquote>

	~~The LoginPlugin would look like this~~:		现在插件的主类代码应该看起来像这样:
	<blockquote><source lang="java">import org.bukkit.plugin.java.JavaPlugin;		<blockquote><source lang="java">import org.bukkit.plugin.java.JavaPlugin;

Event API Reference/en - 版本历史

Sheep-realms：​修复错误的模板使用

Tdiant：​/* Video Tutorial */

Tdiant：​/* Making your CustomEvent Cancellable */

Tdiant：​/* Listening to a Custom Event */

Tdiant：​/* 唤起你的自定义事件 */

星燚：​/* Creating Custom Events */

星燚：​/* 翻译段落 */

星燚：​/* Un-register specific event */

星燚：​/* Un-registering events or listeners */

星燚：​/* Registering Events in your Listener */