mirror of
https://github.com/pmmp/PocketMine-MP.git
synced 2025-09-07 18:32:55 +00:00
49fbbea7bf
* Event handlers always handle subclass events. public static $handlerList no longer required. * Removed $handlerList declarations * HandlerList cleanup: Removed HandlerList->handlers and related bake methods * Removed obsolete Event->getHandlers() * EventPriority: Added fromString() * PluginManager: throw exceptions on registering handlers with invalid priorities This allows specifying a handler of `EntityDamageEvent` which will handle any instanceof it (as per current behaviour), AND also now allows specifying a handler specifically for `EntityDamageByEntityEvent`, which only handles `EntityDamageEvent`. This was not previously possible due to limitations in the way handlers were registered. Abstract events may not be handled unless they declare the `@allowHandle` PhpDoc tag.
92 lines
2.2 KiB
PHP
92 lines
2.2 KiB
PHP
<?php
|
|
|
|
/*
|
|
*
|
|
* ____ _ _ __ __ _ __ __ ____
|
|
* | _ \ ___ ___| | _____| |_| \/ (_)_ __ ___ | \/ | _ \
|
|
* | |_) / _ \ / __| |/ / _ \ __| |\/| | | '_ \ / _ \_____| |\/| | |_) |
|
|
* | __/ (_) | (__| < __/ |_| | | | | | | | __/_____| | | | __/
|
|
* |_| \___/ \___|_|\_\___|\__|_| |_|_|_| |_|\___| |_| |_|_|
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* @author PocketMine Team
|
|
* @link http://www.pocketmine.net/
|
|
*
|
|
*
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace pocketmine\event;
|
|
|
|
|
|
/**
|
|
* List of event priorities
|
|
*
|
|
* Events will be called in this order:
|
|
* LOWEST -> LOW -> NORMAL -> HIGH -> HIGHEST -> MONITOR
|
|
*
|
|
* MONITOR events should not change the event outcome or contents
|
|
*/
|
|
abstract class EventPriority{
|
|
public const ALL = [
|
|
self::LOWEST,
|
|
self::LOW,
|
|
self::NORMAL,
|
|
self::HIGH,
|
|
self::HIGHEST,
|
|
self::MONITOR
|
|
];
|
|
|
|
/**
|
|
* Event call is of very low importance and should be ran first, to allow
|
|
* other plugins to further customise the outcome
|
|
*/
|
|
public const LOWEST = 5;
|
|
/**
|
|
* Event call is of low importance
|
|
*/
|
|
public const LOW = 4;
|
|
/**
|
|
* Event call is neither important or unimportant, and may be ran normally.
|
|
* This is the default priority.
|
|
*/
|
|
public const NORMAL = 3;
|
|
/**
|
|
* Event call is of high importance
|
|
*/
|
|
public const HIGH = 2;
|
|
/**
|
|
* Event call is critical and must have the final say in what happens
|
|
* to the event
|
|
*/
|
|
public const HIGHEST = 1;
|
|
/**
|
|
* Event is listened to purely for monitoring the outcome of an event.
|
|
*
|
|
* No modifications to the event should be made under this priority
|
|
*/
|
|
public const MONITOR = 0;
|
|
|
|
/**
|
|
* @param string $name
|
|
*
|
|
* @return int
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
*/
|
|
public static function fromString(string $name) : int{
|
|
$name = strtoupper($name);
|
|
$const = self::class . "::" . $name;
|
|
if($name !== "ALL" and \defined($const)){
|
|
return \constant($const);
|
|
}
|
|
|
|
throw new \InvalidArgumentException("Unable to resolve priority \"$name\"");
|
|
}
|
|
}
|