mirror of
https://github.com/pmmp/PocketMine-MP.git
synced 2025-05-16 02:38:54 +00:00
889d048ca3
I've stuck to only doing this in the places where I'm sure we should never get false back. Other places I'm less sure of (and I found more bugs along the way).
129 lines
3.7 KiB
PHP
129 lines
3.7 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\item;
|
|
|
|
use pocketmine\utils\AssumptionFailedError;
|
|
use pocketmine\utils\SingletonTrait;
|
|
use pocketmine\utils\Utils;
|
|
use Webmozart\PathUtil\Path;
|
|
use function explode;
|
|
use function file_get_contents;
|
|
use function is_array;
|
|
use function is_int;
|
|
use function is_numeric;
|
|
use function json_decode;
|
|
use function str_replace;
|
|
use function strtolower;
|
|
use function trim;
|
|
|
|
/**
|
|
* @deprecated
|
|
* @see StringToItemParser
|
|
*
|
|
* This class replaces the functionality that used to be provided by ItemFactory::fromString(), but in a more dynamic
|
|
* way.
|
|
* Avoid using this wherever possible. Unless you need to parse item strings containing meta (e.g. "dye:4", "351:4") or
|
|
* item IDs (e.g. "351"), you should prefer the newer StringToItemParser, which is much more user-friendly, more
|
|
* flexible, and also supports registering custom aliases for any item in any state.
|
|
*/
|
|
final class LegacyStringToItemParser{
|
|
use SingletonTrait;
|
|
|
|
/** @var ItemFactory */
|
|
private $itemFactory;
|
|
|
|
private static function make() : self{
|
|
$result = new self(ItemFactory::getInstance());
|
|
|
|
$mappingsRaw = Utils::assumeNotFalse(@file_get_contents(Path::join(\pocketmine\RESOURCE_PATH, 'item_from_string_bc_map.json')), "Missing required resource file");
|
|
|
|
$mappings = json_decode($mappingsRaw, true);
|
|
if(!is_array($mappings)) throw new AssumptionFailedError("Invalid mappings format, expected array");
|
|
|
|
foreach($mappings as $name => $id){
|
|
if(!is_int($id)) throw new AssumptionFailedError("Invalid mappings format, expected int values");
|
|
$result->addMapping((string) $name, $id);
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* @var int[]
|
|
* @phpstan-var array<string, int>
|
|
*/
|
|
private $map = [];
|
|
|
|
public function __construct(ItemFactory $itemFactory){
|
|
$this->itemFactory = $itemFactory;
|
|
}
|
|
|
|
public function addMapping(string $alias, int $id) : void{
|
|
$this->map[$alias] = $id;
|
|
}
|
|
|
|
/**
|
|
* @return int[]
|
|
* @phpstan-return array<string, int>
|
|
*/
|
|
public function getMappings() : array{
|
|
return $this->map;
|
|
}
|
|
|
|
/**
|
|
* Tries to parse the specified string into Item types.
|
|
*
|
|
* Example accepted formats:
|
|
* - `diamond_pickaxe:5`
|
|
* - `minecraft:string`
|
|
* - `351:4 (lapis lazuli ID:meta)`
|
|
*
|
|
* @throws LegacyStringToItemParserException if the given string cannot be parsed as an item identifier
|
|
*/
|
|
public function parse(string $input) : Item{
|
|
$key = $this->reprocess($input);
|
|
$b = explode(":", $key);
|
|
|
|
if(!isset($b[1])){
|
|
$meta = 0;
|
|
}elseif(is_numeric($b[1])){
|
|
$meta = (int) $b[1];
|
|
}else{
|
|
throw new LegacyStringToItemParserException("Unable to parse \"" . $b[1] . "\" from \"" . $input . "\" as a valid meta value");
|
|
}
|
|
|
|
if(isset($this->map[strtolower($b[0])])){
|
|
$item = $this->itemFactory->get($this->map[strtolower($b[0])], $meta);
|
|
}else{
|
|
throw new LegacyStringToItemParserException("Unable to resolve \"" . $input . "\" to a valid item");
|
|
}
|
|
|
|
return $item;
|
|
}
|
|
|
|
protected function reprocess(string $input) : string{
|
|
return str_replace([" ", "minecraft:"], ["_", ""], trim($input));
|
|
}
|
|
}
|