mirrors/PocketMine-MP
1
0
Fork 0
mirror of https://github.com/pmmp/PocketMine-MP.git synced 2025-09-06 09:56:06 +00:00
Code Issues Projects Releases Wiki Activity

LegacyStringToItemParser: mark as deprecated, and point people towards StringToItemParser, which is much nicer

Browse Source
This commit is contained in:
Dylan K. Taylor
2021-08-29 16:13:19 +01:00
parent dee2062b1b
commit 8847aa2d7f
1 changed files with 8 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
src/item/LegacyStringToItemParser.php
View File

@ -38,9 +38,14 @@ use function strtolower;
use function trim; use function trim;
/** /**
* This class fills in as a substitute for all the stuff that used to make ItemFactory::fromString() * @deprecated
* work. Since legacy item IDs are on their way out, we can't keep using their constants as stringy * @see StringToItemParser
* IDs (especially not considering the unnoticed BC-break potential posed by such a stupid idea). *
* 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{ final class LegacyStringToItemParser{
use SingletonTrait; use SingletonTrait;