PMMP/PocketMine-MP
0
0
Fork 0
mirror of https://github.com/pmmp/PocketMine-MP.git synced 2024-11-24 17:56:13 +00:00
Code
stable
PocketMine-MP/changelogs/3.0-alpha.md
Dylan K. Taylor 02bc43b440 missed a bit
2019-06-11 16:48:24 +01:00

1156 lines
74 KiB
Markdown
Raw Permalink Blame History

# 3.0.0-ALPHA1
**For Minecraft PE 1.0.0.16**
Initial snapshot of MCPE 1.0 changes.
**DISCLAIMER: THIS IS AN _ALPHA_ SNAPSHOT. THIS BUILD IS NOT FEATURE-COMPLETE AND IS LIKELY TO BE HIGHLY UNSTABLE. WE ARE NOT RESPONSIBLE FOR NUCLEAR WAR, EXPLOSIONS OR CORRUPTION OF DATA RESULTING FROM USE OF THIS BUILD.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA1. These changes are NOT yet complete.
## Core
- New generic in-memory chunk format for universal chunk handling and future conversion implementation.
## Gameplay
- Supported 256-height worlds
- Standard chunk interface changed from FullChunk to Chunk (see above)
## API
- Removed biome color support and all related biome color API methods (no longer supported by MCPE client)
## Fixes
- Fixed Win10 throws away their held item when the inventory is closed (https://github.com/pmmp/PocketMine-MP/commit/3b3abab3ad51dcc9b25e89612773ba4da172c7d4)
- Fixed MobHead bounding box and properties (https://github.com/pmmp/PocketMine-MP/commit/c79077cbed2e47653f11306e4dfba66cac9da010)
- Fixed server ignoring head rotation (https://github.com/pmmp/PocketMine-MP/commit/fa5624f87e937a518edd5790583ab4631f2100e6)
- Fixed gamemode switching to adventure/spectator for op players (https://github.com/pmmp/PocketMine-MP/commit/43a36dba40abdc8969a404665de8df4d619fed4c)
- Fixed clicking on fire to extinguish it (#132)
- Fixed players always respawning at the server spawn when the folder name is different to the world name (#150)
# 3.0.0-ALPHA2
**For Minecraft PE 1.0.0.16**
Less surface changes, better performance, large changes to Level IO
**DISCLAIMER: THIS IS AN _ALPHA_ SNAPSHOT. THIS BUILD IS NOT FEATURE-COMPLETE AND IS LIKELY TO BE HIGHLY UNSTABLE. WE ARE NOT RESPONSIBLE FOR NUCLEAR WAR, EXPLOSIONS OR CORRUPTION OF DATA RESULTING FROM USE OF THIS BUILD.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA2. These changes are NOT yet complete.
## Core
- Re-added support for async network chunk serialization
- Refactored level\format namespace (see files for changes)
- Added new world format PMAnvil (based on Anvil with some alterations)
## Gameplay
- Added Item Frames
- Added some 0.16 blocks and items.
- Updated creative inventory and crafting recipes for 1.0.0.16
## API
- Refactored Server::broadcastPacket() to be non-static, use available server references.
- Type declarations and strict types for most things in the level\format namespace.
- Refactor Level::chunkBlockHash() -> Chunk::chunkBlockHash()
- GenericChunk::fastSerialize() is no longer static.
- Refactored format\generic\GenericChunk -> format\Chunk. You should already have been using the format\Chunk interface, if not you may need to make alterations.
- Removed unused Entity stub classes in preparation for Entity API rewrite.
## Fixes
- Fixed unable to teleport over Y = 128
- Fix some mob head rotation bugs
- Fixed some issues with Flower Pot items vanishing and not saving correctly
- Fixed Win10 Edition default hotbar mapping
- Fixed issues crafting with items with NBT (5443b10, 77b3cd7)
- Fixed a crash in Item->deepEquals() where only one item had a tag
- Fixed issues with the title bar and /status reporting incorrect CPU and tick usage statistics (8bdfe0d)
- Fixed an age-old corruption bug due to use of IntTag for Time in PC worlds (3dcfa7b)
- Fixed negative effect amplifier crash (#191)
- Fixed some bugs with some blocks having to be broken twice (obsidian, netherrack) (wrong hardness values)
- Fixed Head drops
- Fixed dropped items disappearing after a server restart
# 3.0.0-ALPHA3
**For Minecraft PE 1.0.0.16**
API changes relating to closing Levels and anti-cheat, along with many bug fixes.
**DISCLAIMER: THIS IS AN _ALPHA_ SNAPSHOT. THIS BUILD IS NOT FEATURE-COMPLETE AND IS LIKELY TO BE HIGHLY UNSTABLE. WE ARE NOT RESPONSIBLE FOR NUCLEAR WAR, EXPLOSIONS OR CORRUPTION OF DATA RESULTING FROM USE OF THIS BUILD.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA3. These changes are NOT yet complete.
## Core
- Added a hack to workaround client-side text duplication (TODO REVERT 52748fc)
- Crashdumps are now created in the `crashdumps` folder instead of being dumped into your server root directory.
- Some tweaks for Anvil I/O for more performance in some circumstances (won't make much difference in heavily-built up worlds)
- Movement-checks and instabreak anti-cheats can now be disabled in pocketmine.yml (#287)
- **EXPERIMENTAL** LevelDB support is back, with support for MCPE 1.0 worlds. NOTE that LevelDB can be HIGHLY UNSTABLE and will segfault a lot. See #254 for progress.
- Added crafting data cache to reduce on-join lag spikes. (9c36e0c)
- Assertion behaviour is now configurable: the server will by default warn on startup if assertions are enabled, and assertion exception throws are now disabled by default. This can be configured under the `debug` section in pocketmine.yml.
## API
- API version suffix for plugins is now non-case-sensitive.
- Type-hints have been added to Item::get() and some Item API methods. This is in an effort to combat some peculiar issues which arose from using null or wrong types.
- Added API to allow customising randomly-ticked blocks in Level.
- Added method `Level->isClosed()` to allow checking if a Level is still usable before trying to do stuff with it.
- `Position->getLevel()` will now verify that the Level is usable before returning it, and if it is not will destroy the reference and return null. This is to help identify leaks with unloaded Levels.
- Added API methods to allow controlling anti-cheat configuration per-player (#287) and added PlayerIllegalMoveEvent to allow plugins to cancel movement anti-cheat positives.
- Removed deprecated `Utils::getRandomBytes()` (use php7 random_bytes() instead) (085d1a1)
- Moved LevelException, PluginException and ChunkException into more relevant namespaces (946d301)
## Fixes
- Fixed CommandReader hanging on shutdown on Windows (#171)
- Fixed vanilla McRegion worlds getting corrupted (8902992)
- Fixed total server freeze when teleporting long distances
- Fixed anti-cheat false-positives when climbing ladders and a wide variety of other movement issues (8ea0352)
- Fixed shutdown memory leaks related to double chests (e4aa3d7)
- Fixed eating golden apples with full hunger
- Fixed long-string NBT encoding (longer than 127 bytes, length is a uvarint not a byte), fixed corrupted sign issues, fixed issues with unicode sign text
- Fixed players appearing under the world when sleeping.
- Fixed players continuing to burn in creative mode.
- Fixed players sometimes not dying properly after taking lethal damage due to food regeneration (441961b)
- Fixed a logic error in the basic generator preventing swamp biomes from generating (b566c4e)
- Fixed setting item custom name doesn't update player (0584681)
- Fixed bad lighting issues when importing a PocketMine-MP world back to vanilla Minecraft (946d301)
# 3.0.0-ALPHA4
**For Minecraft PE 1.0.3.0**
Many bug fixes, changes to Chunk, Tile and Entity API, improved language system
**DISCLAIMER: THIS IS AN _ALPHA_ SNAPSHOT. THIS BUILD IS NOT FEATURE-COMPLETE AND IS LIKELY TO BE HIGHLY UNSTABLE. WE ARE NOT RESPONSIBLE FOR NUCLEAR WAR, EXPLOSIONS OR CORRUPTION OF DATA RESULTING FROM USE OF THIS BUILD.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA4. These changes are NOT yet complete.
## Core
- Removed SQLite3 hard dependency as it is no longer used by the core code.
- Translation system has been reworked for better synchronization and consistency. Please head over to http://translate.pocketmine.net if you would like to help.
## Gameplay
- Enchanted Golden Apples now give the eater Absorption 4
## API
- Removed chunk/provider/level/tile/entity entanglement. This is a very breaking change, see c21197ef176166b1c2c19b091cf84664aa878c00 for details.
- Removed some sound classes
- Removed deprecated version constants from PocketMine.php
- Added UnknownBlock class
- Added some API methods for changing entity scale (6dc6e3265666eb700305bdf4f484ce3f17c01650)
## Fixes
- Fixed a CPU leak that occurred when movement checks were disabled (this was the same underlying issue causing `player moved too fast, reverting movement`) (ccef045)
- Fixed a CrashDump bug causing all crashdumps to report an issue creating the crashdump directory (09a6776)
- Fixed incorrect git commit hash parsing when running a server from source code (#299)
- Fixed some issues with command sending
- Fixed Sea Lantern lighting issues
- Fixed half-trees in freshly-generated worlds
- Fixed DestroyBlockParticle
- Fixed some issues with removing items from item frames
- Fixed movement-checking bugs due to bad anti-spam check in MovePlayerPacket handler
- Fixed lots of improperly-implemented blocks causing suffocation
- Fixed issues breaking some improperly-implemented blocks
- Fixed heightmap-related crashes in McRegion worlds
# 3.0.0-ALPHA5
**For Minecraft PE 1.0.7.0**
Many bug fixes, changes to network API (work still in progress!), improved chunk sending, added resource packs support
**DISCLAIMER: THIS IS AN ALPHA SNAPSHOT. THIS BUILD IS NOT FEATURE-COMPLETE AND IS LIKELY TO BE HIGHLY UNSTABLE. WE ARE NOT RESPONSIBLE FOR NUCLEAR WAR, EXPLOSIONS OR CORRUPTION OF DATA RESULTING FROM USE OF THIS BUILD.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA5. These changes are NOT yet complete.
## Core
- World format implementations using Regions will now be more thoroughly checked for validity before the core attempts to use them. (#393)
- Fixed a crash that would prevent a world from being at all usable if a Human was created with an invalid skin.
- Fixed chunk object memory leak when chunks are replaced by the generator.
- Tile and Entity NBT trees are now destroyed when their close() methods are called to combat memory leaks.
- Fixed tile and entity object memory leaks and crashes when replacing chunks
- Chunk->addTile(Tile) and Chunk->addEntity(Entity) will now throw exceptions if something attempts to add a closed tile or entity to them.
- Fixed squid health attribute errors
- Fixed server crash when taking damage after dying when the Health Boost effect was applied before death.
- Fixed crashes when using xdebug and breaking very tall cacti or sugarcane (recursive block updates)
- Fixed some packets being sent with reliability level 0, may improve connections randomly being dropped
- Fixed memory leak related to persistent entities when lots of players join and quit a server in the same area
- Fixed possible item NBT duplication where items were holding references to the same NBT trees when cloned.
- Fixed usage always being reported even when disabled in pocketmine.yml
- Fixed stack traces in the logger sometimes missing the top stack frame.
- Fixed Entity object memory leak in EntityDamageByEntityEvent
- Fixed Player object memory leak when players subscribed to the administrative broadcast permission quit the server
- Non-generated chunks will no longer be saved to disk, fixes big dirty holes in some maps due to chunks being saved before being generated
- Rewritten the chunk sending algorithm, much better chunk sending (will now actually reach the horizon)
- Fixed a major memory leak when a W10 player set a very high render distance due to the server not enforcing radius limits. This has been corrected,. A player's render distance will now be set to the minimum of the spawn radius, the player's radius, or the server default render distance.
- The settings `chunk-sending.max-chunks` has been removed from pocketmine.yml in favour of a more vanilla `view-distance` setting in server.properties (values match MCPE render distance settings) and `chunk-sending.spawn-threshold` has been replaced with `chunk-sending.spawn-radius` (again, same values as MCPE).
- Fixed CPU waste of batched packets sometimes being encoded twice.
- Auto-updater checks are now done with an AsyncTask to prevent slowdown on server start.
- Added debug output for lots of network- and protocol-related things.
## API
- Massive refactor of the network namespace. All packets have moved from network\protocol to network\mcpe\protocol, and Info has been renamed to ProtocolInfo. This is to make space for future changes. **Note that these changes are far from complete and more will follow.**
- Added API methods to Player to allow transferring them to other servers, and to allow sending titles.
- Added Entity API for setting entity scale.
- Added support for commands with spaces in their names for future command implementation.
- Item->deepEquals() has been deprecated and its functionality added to Item->equals().
- Added the Color class to the utils namespace. This was primarily added for use when reversing the encoding of the ClientboundMapItemDataPacket.
- Player->hasPermission() will now throw an exception if the player has been closed.
- Commands no longer all have the same hints if you modify one command's data.
- API methods Player::isValidSkin() and Player::isValidName() have been added.
- The API for Utils internet access has been improved, added BulkCurlTask for batch-executing cURL operations. See #834 for details.
## Gameplay
- Fixed sounds not working after 1.0.4
- Added resource packs support. This support is currently very basic and will be improved in the future. Currently only resource packs in the .zip format are supported. See the resource packs configuration for details (will be created in the resource_packs/ directory after you run the server).
- Hunger now works!
- Implemented Absorption effect
- Fixed bows can't be fired after starting or stopping sprint.
- Fixed solid blocks filtering their own light, fixes light saving for lit furnace, pumpkins and glowing obsidian.
- Fixed unlit furnaces glowing in the dark.
- Fixed lighting issues due to light changes in subchunks which were not being saved to disk.
- Block light is now correctly updated when removing obstructions.
- Fixed potion bubbles not working.
- Added support for copying tile NBT onto items by ctrl+middle-clicking on Windows 10 Edition.
- Fixed blocks sometimes glitching and reappearing when broken due to timing issues.
- Fixed slowness being removed when trying to sprint
- Fixed lots of issues with the hotbar, armor equipment and item equipment in creative (and caused some creative transaction bugs)
- Fixed Cake recipe not showing up due to having multiple result items
- Fence-gates now work properly
- Spectator-mode players cannot break blocks anymore if the AdventureSettings flags were not set correctly.
- Fixed some issues with entity spawn rotation due to a silly mistake in AddEntityPacket.
# 3.0.0-ALPHA6
**For Minecraft PE 1.1.0.55**
Beginning of strict types, some performance improvements, lots of bug fixes.
**DISCLAIMER: THIS IS AN ALPHA SNAPSHOT. THIS BUILD IS NOT FEATURE-COMPLETE AND IS LIKELY TO BE HIGHLY UNSTABLE. WE ARE NOT RESPONSIBLE FOR NUCLEAR WAR, EXPLOSIONS OR CORRUPTION OF DATA RESULTING FROM USE OF THIS BUILD.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA6. These changes are NOT yet complete.
## Core
- 32-bit support has been removed for consistency and performance reasons. (#984)
- The `Binary` class now has strict types and type-hinting for safety reasons when writing data to network.
- Fixed incorrect PC world format versions causing Mojang's official McRegion -> Anvil converter to reject PocketMine-MP-generated McRegion worlds.
- Fixed ServerKiller does not work correctly on single-core machines.
- AsyncTasks no longer leak memory after completion. (#922)
- Fixed masses of console spam when a crash occurs and an NBT tag or EncapsulatedPacket was an argument somewhere in the call stack.
- NBT ListTags now default to TAG_End if no tag type is specified instead of null.
- Fixed /particle command crash when creating TerrainParticle or ItemBreakParticle
- Player `XpSeed` is now restricted to the bounds of an int32 on all platform (since it is supposed to be saved as an IntTag, which is bounded to the range of an int32).
- Player->close() now does its best to catch thrown exceptions and clean up after itself to avoid possible leaks and issues during the quit process.
- Fixed AutoUpdater crashing the server when invalid data is returned by the updater host.
- Changed updater host to https://update.pmmp.io
- Changed crash-archive host to https://crash.pmmp.io
- Fixed some issues with static properties not being included in memory dumps.
- Fixed server crashing when crashing while creating a CrashDump.
- Fixed silenced errors being reported in CrashDumps when a plugin uses `exit()` or `die()`.
- Fixed lots of bugs exposed by strict types.
## Network
- Chunk serialization and compression is now always done asynchronously to improve performance.
- Level area-broadcasted packets and block updates are now sent in batches instead of individual packets to improve performance.
- Workaround for packets sent with immediate priority being ignored by the client (#1026)
- Fixed UUID encoding (players will no longer see themselves twice in the player list)
- ResourcePackDataInfoPacket will now report the correct number of resource pack chunks.
## Gameplay
- Dropped items no longer bounce on partial blocks such as slabs.
- Fixed hunger decreasing too fast.
- Fixed server crash when vines are placed on some block faces.
- Falling sand is no longer destroyed by grass and no longer destroys slabs.
- Falling into water 1 block deep no longer causes fall damage.
- Removed eye-height offsets causing spawned entities to appear in wrong positions on the client-side.
- Arrows will now fly correctly towards targets and no longer spin round and fall flat when hitting a surface.
- Implemented basic sky-light population on chunk generation and sky-light updating when blocks are changed in the world. This will be needed for proper farming.
- Improved player movement (smoother, much less stuttery) and fixed several client-sided positioning bugs.
- Fixed other players don't see teleport movement when teleporting to nearby locations.
- Fixed player spawn points set using /spawnpoint not working.
## API
- Strict types are now enabled throughout the core code. See #969 and #993 for details.
- Plugins can now specify the `extensions` attribute in plugin.yml to specify PHP extensions required for the plugin to function correctly. This may be useful where plugins require extensions which are not supplied by default with PMMP-supplied PHP binaries. (#903)
- Added `Vector3->asVector3()`, `Position->asPosition()`, `Location->asLocation()` (#973). This is intended to provide an easy way to convert a descendent of one of these classes (such as an `Entity`) into an explicit Vector3, Position or Location.
- Added the following events:
- PlayerDataSaveEvent, which is called when a player's NBT data is about to be saved to disk. (#920)
- UpdateNotifyEvent, which is called when the AutoUpdater receives information that a new PocketMine-MP version is available.
- PlayerInteractEvent is now called with the left-click action when a player attempts to remove an item from an item frame.
- NBT classes now have more strict type-checking in the constructors, `Tag->getValue()` and `Tag->setValue()`. ByteTags, ShortTags and IntTags will now throw an exception if the supplied value is outside of the range they can store.
- Block constructors will now always retain the meta values passed in the constructor, fixes issues with crafting with recipes that required any-damage ingredients.
- Added API methods `Block->canClimb()`, `Entity->canClimb()`, `Entity->setCanClimb(bool)`, `Entity->canClimbWalls()` and `Entity->setCanClimbWalls(bool)` along with corresponding entity metadata flags.
- Added API methods `Block->getLightFilter()` and `Block->diffusesSkyLight()` (used in sky light population).
- Added `/title` command and API for resetting title durations.
- Refactored some JSON-parsing-specific NBT code into its own class.
- Added `Server->broadcastTitle()`.
- `Item->setLore()` is now fluent.
# 3.0.0-ALPHA7
**For Minecraft PE 1.1.0.55**
Many breaking API changes for type safety, major entity performance improvements, custom blocks & items
**DISCLAIMER: This is an ALPHA snapshot. This version is NOT FEATURE COMPLETE and may be unstable. PMMP is not responsible for nuclear war, explosions or loss of data resulting from use of this build. Please use our issue tracker to report bugs.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA7. These changes are NOT yet complete.
**NOTE: This will be the last big release to support PHP 7.0.**
## Core
- Backtraces no longer incorrectly show a `boolean` parameter when a function call in the stack trace had no parameters.
- Configs will now save correctly when the type was auto-detected due to being unspecified.
- Fixed RakLibInterface crashing when exceptions are raised during packet handling, after the player was closed.
- Fixed UUIDs becoming corrupted when converted to strings
- Fixed crashes caused by NBT TAG_Short being written as signed but read as unsigned.
- Plugin load error messages such as "incompatible API version" and "Unknown dependency" are now more verbose
- Significant performance enhancements to entity ticking and to explosions
- The server will no longer crash when players join if the spawn radius is set to 0.
## API
### The big breaking changes
A large number of API methods and interfaces have prototype changes - addition of scalar typehints throughout the code. The most breaking of these for plugins are the following:
- `CommandExecutor->onCommand()`:
- before: `onCommand(CommandSender $sender, Command $command, $label, $args)`
- after: `onCommand(CommandSender $sender, Command $command, string $label, $args) : bool`
- `Task->onRun()`:
- before: `onRun($currentTick)`
- after: `onRun(int $currentTick)`
Plugins implementing these methods will require the implementing methods' signatures changing to comply with the core code.
**NOTE THAT THESE CHANGES ARE NOT FINAL.** PHP 7.2 will add `void` and nullable return typehints which will also be made use of when we move to PHP 7.2.
### Other changes
#### Commands
- Added `InvalidCommandSyntaxException`. Throwing this exception in a Command's execution function will cause its usage to be displayed. This is used to reduce repeated code in the built-in commands and has not been tested from a `CommandExecutor` perspective (yet).
#### Block
- Plugins can now register their own custom blocks and/or override existing implementations. Refer to `BlockFactory` for documentation.
- Block ID constants are now generated automatically from vanilla. In the mix, many old aliases which didn't make sense have been removed.
- Several Block classes have been removed due to excess duplication. Blocks are now instantiated by creating clones of pre-initialized objects registered in BlockFactory.
- `Block->canBeActivated()` and `Item->canBeActivated()` have been removed due to extra confusion they caused in the implementation of new gameplay features.
- `Block->getDrops()` now returns `Item[]` instead of `int[][]`. Plugins which use this method will need alterations.
- `Block::get()` now redirects to `BlockFactory::get()`. This is backwards compatible with existing implementations.
- `Block::get()` will now throw exceptions when out-of-bounds block IDs or block meta values are given.
- `new Block()` should now **only** be used for constructing **block types**. `Block::get()` or `BlockFactory::get()` should be used instead for getting block instances to set into the world.
- `Block->getResistance()` has been deprecated, superseded by `Block->getBlastResistance()`.
- Added API method `Block->ticksRandomly() : bool` (used for level random block ticking registration, see below)
#### Entity
- Obsolete first parameters have been removed from `Entity->attack()` and `Entity->heal()`.
- `Entity->getHealth()` now returns a float, and `Entity->setHealth()` now accepts floats.
- Redundant public property `Entity->length` has been removed.
- `Entity->closed` is now protected, use `Entity->isClosed()` instead. (eebc52e00ba6ad38bf1c249a6f0e9415c81d5072)
#### Events
- Added the following events:
- NetworkInterfaceCrashEvent
- NetworkInterfaceRegisterEvent
- NetworkInterfaceUnregisterEvent
- PlayerJumpEvent
- Fixed `EntityEatBlockEvent` not being called when a player eats a slice of cake
- Fixed `PlayerBucketEmptyEvent` not being used anywhere
#### Item
- Plugins can now register their own custom items and/or override existing implementations. Refer to `ItemFactory` for documentation.
- Item ID constants are now generated automatically from vanilla. In the mix, many old aliases which didn't make sense have been removed.
- Added API methods `Item->hasEnchantment(int, int) : bool`, `Item->removeEnchantment(int, int)`, `Item->removeEnchantments()`
- Added API methods `Item->getAttackPoints() : int` and `Item->getDefensePoints() : int`
- Many redundant item classes have been removed due to excess duplication. Items are now instantiated by creating clones of pre-initialized objects registered in `ItemFactory`.
- `Item->clearCustomBlockData()` now works correctly.
- `new Item()` should now **only** be used for constructing **item types**. `Item::get()` or `ItemFactory::get()` should be used instead for getting item instances to set into an inventory.
- `Item::get()` and `Item::fromString()` now redirect to their respective methods in `ItemFactory`. This is backwards compatible with existing implementations.
- The `count` parameter has been removed from `Item::__construct()`.
- Fixed issues with serialize/deserialize items from NBT where the tag kept the wrong name
#### Level
- `Level->dropItem()` now returns a reference to the created item entity.
- `Nether` generator no longer returns `normal` in `getName()`.
#### Math
- Added precision and rounding mode arguments to `Vector3->round()`. This defaults to the original behaviour if the arguments are not specified.
- `Position->equals()` and `Location->equals()` will now additionally check level (if the parameter is an instance of Position) and yaw/pitch (if the parameter is an instance of Location) respectively. (b8a30309bbc4ec8600669ea0794c7d3d68c4a415)
#### Network
- MCPE packets are now registered in `pocketmine\network\mcpe\protocol\PacketPool`. API methods `registerPacket()` and `getPacket()` have been removed from `Network`. This is to allow easier auto-generation of protocol-related code.
- Added `PlayerNetworkSessionAdapter`. This is currently used to reduce the amount of empty handlers in `Player`, however this may cause problems which override handlers in `Player` to handle packets. Plugins which override `Player->handleDataPacket()` should still work correctly, provided that you remember to call the parent.
*The developers are aware that this is an API problem and this will be resolved in a future update. Please remember that the network refactor is **not finished** and don't kill the developers.*
- `Packet->decode()` and `Packet->encode()` should no longer be overridden by plugins as core functionality is performed in here. Use `Packet->decodePayload()` and `Packet->encodePayload()` when creating new packets.
#### Plugin handling
- Plugins can now specify the `mcpe-protocol` attribute in plugin.yml to specify compatible protocol versions.
- Specifying API as `2.0` when the server API is `2.0.0` or similar is now legal and will work correctly.
- Fixed plugins with unknown dependencies claiming to have circular dependencies.
#### Tasks
- The `MainLogger` is now accessible in AsyncTasks by use of `MainLogger::getLogger()`.
- Throwing exceptions during `Task->onCancel()` will no longer cause server crashes and undesirable behaviour.
- `ServerScheduler->scheduleAsyncTask()` now returns the ID of the worker the task was scheduled to.
#### Tile
- Added some methods to `tile\Sign` and `SignChangeEvent` for consistency. (42fb1d1fef47ae7cc55794764aa4057364348616)
- `Sign->setText()` now accepts null parameters to leave the text on those lines as-is.
- `Spawnable->getSpawnCompound()` is now final. Plugins implementing custom tiles should instead override `Spawnable->addAdditionalSpawnData()`. See #1259 for changes and examples.
## Gameplay
### Blocks
- Implemented: bone block, coloured beds, concrete, double plants, end rod, glazed terracotta, magma, nether wart, nether wart block, red nether brick, stained glass
- Beds can no longer be slept in beyond a 2-block distance.
- Fixed beds not requiring a solid block under the head
- Fixed bookshelves dropping themselves instead of 3 books
- Fixed quartz pillar rotation not working correctly
- Grass growth and death now works correctly.
- Lit redstone lamp block now emits the correct amount of light.
- Obsidian can no longer be destroyed by TNT
- Placing rails is now less weird (they still won't join up though yet).
- Re-added Nether Reactor core (decorative only, as in vanilla)
### Commands
- Command usage messages are now translated server-side to resolve client-side translation issues.
### Entities
- Armor will now correctly absorb damage when the resulting damage from an attack is less than 1 point.
- Fixed mobs such as zombies and villagers not having their positions updated server-side when something causes them to gain motion. This fixes problems with floating mobs and zombies being unkillable in earlier versions. As an added bonus, the change fixing this problem brought in substantial performance improvements. See 2f3c77c68a0d9e0fdfb0eb69bd44344f4c8d028d and c32b75fa188bcee58aa46977e97e140532fc47ba for details.
- Fixed cake not applying any food/saturation to the eater
- Absorption and damage resistance now absorb the correct amount of damage when armor is worn.
### Inventory
- Several furnace fuel items which did not work before now work correctly.
- Armor screen on PE will no longer duplicate armor items when equipping armor.
### World
- Fixed level random block ticking not being random anymore on the third iteration
- The presence of a spectator player will no longer prevent building at a target.
- Players will no longer take decades to spawn when the server is generating a new world. This was caused by a bug in chunk requesting causing the server not to fully utilize the CPU, which significantly delayed chunk generation before spawn.
# 3.0.0-ALPHA7 build 27
## Core
- Minimum PHP version requirement is now PHP 7.2. This is because of thread-safety issues in earlier versions which make PHP 7.0 & 7.1 unsafe. 7.2, while (at the time of writing) is still in RC, is far more stable.
- Fixed not being able to find sources when PocketMine.php is run from anywhere other than 3 levels up
- The server will no longer crash if a garbage value is set as the timezone in php.ini.
- Exception stack traces are now always logged regardless of debug level. **Note that this ONLY affects stack traces**, the usual debug level applies for everything else.
- `Non-packaged PocketMine-MP installation` is now more informative about the advantages of using a phar in production.
## Network
- Fixed #1358 - resource packs reporting incorrect sizes in preprocessed Jenkins builds
# 3.0.0-ALPHA8
**For Minecraft: Bedrock Edition 1.2.0.81**
Rewritten inventory transaction handling, (mostly) fixed desktop crafting, implemented Xbox Live authentication
**This version is an alpha snapshot, is NOT FEATURE COMPLETE and may be unstable. Please use our issue tracker to report bugs.**
**Please do not create issues for missing gameplay features.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA8. These changes are NOT yet complete.
## Core
- Composer is now required to run a server from source-code.
- Xbox Live authentication has been implemented and is enabled by default.
- The server no longer crashes when loading an old world containing furnaces with missing NBT tags.
- Stats reporting can now be disabled from the command-line using `--anonymous-statistics.enabled=0`
- Players with spaces in their names are now accepted on the server.
- Following from the above, commands now support quoted arguments, so if you want to kick player `Rotten Eggs`, use quotes, like so: `/kick "Rotten Eggs" reason why`
## API
### Block
- Added API method `BlockFactory::isRegistered()`
### Events
- Added `PlayerBlockPickEvent`
- API method `CraftItemEvent->getTransaction()` has been added and returns a `CraftingTransaction` object.
- `InventoryTransactionEvent->getTransaction()` now returns an `InventoryTransaction` instead of a `TransactionGroup`
### Inventory
The inventory transaction system has been almost completely rewritten, the following things have changed:
- The general naming of TransactionGroups and Transactions has been refactored to Transaction and InventoryAction respectively as the original naming did not make sense.
- Removed `SimpleTransactionGroup`, `TransactionGroup`, `BaseTransaction`, `Transaction` and `SlotType` classes
- Added the following:
- `InventoryTransaction` - used for regular inventory transactions, this replaces the old SimpleTransactionGroup in terms of functionality
- `CraftingTransaction` - represents an `InventoryTransaction` in which the actions are to create a crafted item.
- `InventoryAction` - base class which represents a change in the amount of an item, somewhere. This has several subclasses:
- `SlotChangeAction`: Represents a change of the amount of an item in a specific slot of an inventory. This replaces the functionality of the old `BaseTransaction`.
- `DropItemAction`: Represents a player throwing an item onto the ground out of their inventory.
- `CreativeInventoryAction`: Represents the action of creating or deleting items using the creative menu.
- `CraftingTransferMaterialAction`: Represents the action of consuming a crafting ingredient, or getting a secondary output from a crafting event (don't try too hard to understand this)
- `CraftingTakeResultAction`: Represents a player taking the primary result item from the crafting grid result slot.
- `CraftingGrid` and `BigCraftingGrid` have been added. **Note for plugin developers: if you change the contents of these, players _will not see_ the changes, due to a limitation in the current 1.2 client**.
- `PlayerCursorInventory` has been added - this is a container representing the item under the cursor on desktop platforms. **Note that sending this inventory's contents does not work correctly due to a bug in the current 1.2 client.**
- `InventoryType` has been removed
- API methods `BaseInventory->getDefaultTitle()`, `BaseInventory->getDefaultSize()` and `ContainerInventory->getNetworkType()` have been added.
- Due to changes in the 1.2 client, the API for changing hotbar linked slots has been removed - they now behave the same way as Minecraft PC Edition does. The following obsolete API methods have been removed:
- `PlayerInventory->resetHotbar()`
- `PlayerInventory->getHotbarSlotIndex()`
- `PlayerInventory->setHotbarSlotIndex()`
- `PlayerInventory->setHeldItemSlot()`
- `BaseInventory->getItem()` and `BaseInventory->setItem()` will now throw an exception if an out-of-bounds inventory slot index is given.
- `ShapedRecipe`'s constructor has been changed, it now accepts `Item $result, string[] $shape, Item[] $shapeItems, Item[] $extraResults`.
- Removed `BigShapedRecipe` and `BigShapelessRecipe` - these have been obsoleted by the addition of `CraftingRecipe->requiresCraftingTable()`
- Added `send` parameters to `BaseInventory->clear()`, `BaseInventory->setItem()`.
### Item
- Added API method `Item->isNull()`, which returns true if the count of the item is less than or equal to 0, or if its ID is air.
- Added API method `Item->equalsExact()` which asserts that the ID, count, damage and NBT must all be identical.
- Added API method `ItemFactory::isRegistered()`
### Level
- The server no longer crashes if a plugin uses `Level->unload()` directly. **Note that you should not be using this anyway!!! Use `Server->unloadLevel()` instead.**
### Plugins
- Refactored API checking code into its own function (`PluginManager->isCompatibleApi(string ...$apiVersions)`)
### Scheduler & AsyncTasks
- Added API method `AsyncTask->storeLocal()`, which must be explictly called to store objects in the scheduler object store. This replaces the functionality of `AsyncTask->__construct()` because the old behaviour was too easy to use by accident. See #1322 for details.
## Gameplay
- Implemented Coarse Dirt
- Eating sounds now work correctly.
- Reverted botched fix for #145 that caused problems with double slabs.
- Desktop crafting now works (except for a crash when using the recipe book - WIP)
# 3.0.0-ALPHA9
**For Minecraft: Bedrock Edition 1.2.0.81**
New skins API, new CompoundTag API, performance improvements
**This version is an alpha snapshot, is NOT FEATURE COMPLETE and may be unstable. Please use our issue tracker to report bugs.**
**Please do not create issues for missing gameplay features.**
This build has breaking API changes, so the API has been bumped to 3.0.0-ALPHA9. These changes are NOT yet complete.
## Core
### General
- Minimum PHP version has been upped to PHP 7.2.0RC3 due to more bugfixes needed for ZTS mode.
- Fixed PocketMine.php compatibility with PHP 5 (needed for incompatible PHP version messages to work correctly)
- Incompatible PHP version message on startup is now more clear and tells the user what PHP version they are attempting to use.
### Block
- Fixed a crash when Leaves2 is mined with a damage value > 1
### Entity
- Fixed debug spam when entities are created over zero tick diffs.
- Entities which are saved when on fire will now appear on fire when they are next loaded.
### Level
- Fixed performance degradation in `Level->getBlock()` which had very widespread effects.
- Fixed performance degradation with chunk ticking caused by expensive subchunk empty checks.
- Difficulty levels can now be set per-world, and can be set in pocketmine.yml using the `difficulty` key under the worlds section per-world.
### Network
- Chunk-packet caching is now non-optional, offering better performance (#1448)
- Compression level 0 in pocketmine.yml is no longer allowed and will be reset to the default if used.
- Fixed a crash which occurred during login verification due to trying to read a nonexistent public key
- Fixed ridiculous network upload & download statistics when the title ticker was disabled
- Removed a redundant asserting function in packet reads which was degrading performance.
## API
### General
- Added `\pocketmine\NAME` constant.
### Block
- Basic support has been added for separation of block bounding boxes and collision boxes. `Block->getCollisionBoxes()` has been added.
### Command
- Added API method `SimpleCommandMap->unregister()` to allow completely removing registered commands.
### Entity
#### Skins
A new `Skin` class has been added to allow proper management of player skins.
The following classes have been added:
- `pocketmine\entity\Skin`
The following events have been added:
- `PlayerChangeSkinEvent`, called when a player changes their skin
The following API methods have been removed:
- `Human->getSkinId() : string`
- `Human->getSkinData() : string`
The following API methods have been added:
- `Human->getSkin() : Skin`
- `Human->sendSkin(Player[])` The following methods have signature changes:
- `Human->setSkin()` now accepts `Skin` instead of `string, string`
- `Server->updatePlayerListData()` now accepts ` Skin` instead of the old skin string parameters.
#### Other changes
- Projectile-related classes such as `Projectile`, `ProjectileSource`, `Snowball` etc have been moved to an `entity\projectile` namespace.
- Added `EntityIds` interface containing named constants for Minecraft: Bedrock entity type IDs.
- Added API methods `Entity->canSaveWithChunk()` and `Entity->setCanSaveWithChunk()`. These methods allow marking an entity as non-permanent so that it does not get saved to disk when the chunk is saved.
- Added API method `Entity::createBaseNBT()` to allow creation of base NBT needed to spawn an entity without boilerplate CompoundTags everywhere.
- Added API method `Living->lookAt()` to make a mob turn and look at a certain position.
- `Entity->spawnTo()` should no longer be overridden for sending packets for spawning entities to players; override `Entity->sendSpawnPacket()` instead.
- Setting villager profession now shows the correct profession on the client side.
- `Villager::PROFESSION_GENERIC` has been removed since it does not exist in vanilla and crashes players if used.
- A range of API methods have been added to allow controlling entity oxygen supply (2601e359907fca98d95b10454256157977282f90)
### Events
- Removed `PlayerMoveEvent->setFrom()`.
- Added `PlayerChangeSkinEvent`
### Inventory
- Added `BaseInventory->removeAllViewers()` and `BaseInventory->dropContents()`.
### Level
- FloatingTextParticle now uses a transparent skin so that the tiny player cannot be seen.
- Explosions now correctly remove tiles.
### NBT
- A range of new methods have been added to `CompoundTag`'s API to allow more sane handling of the data they contain. See #1469 for details.
- `tagType` parameter has been added to `ListTag`'s constructor.
### Item
- `Durable` class has been added to abstract damage handling away from tools directly.
- `Enchantment::registerEnchantment()` method has been added.
- Items with out-of-bounds damage values will no longer crash the server.
- Serializing ItemBlocks which have previously been used to place blocks will no longer raise exceptions
- `Item->getNamedTag()` will now return an empty `CompoundTag` if the item does not have any NBT; this change was made after seeing that this function is only ever used when wanting to alter the item's NBT.
- Added API methods `Item->setNamedTagEntry()` and `Item->removeNamedTagEntry()`
- Added some constants for commonly-accessed item NBT tags.
- Some unnecessary/obsolete item classes have been removed.
### Player
- Added `Player->getXuid()` - note that this will ONLY return a valid XUID for players logged into Xbox Live
- Changed stupid default values for `Player->setAllowMovementCheats()` and `Player->setAllowInstaBreak()`
### Scheduler
- An ErrorException-throwing error handler is now set on AsyncWorkers. Due to a bug in PHP pthreads causing warnings not to get output, you may experience unexpected errors/crashes in AsyncTasks where previously everything appeared to work fine due to silenced warnings.
### Utils
- Fixed `Binary::unsignShort()` mistakenly being non-static
## Gameplay
### General
- Arrows will now fly through smaller spaces as their bounding boxes have been corrected.
- Arrows can no longer be shot through the top part of a stair.
- Fixed getting kicked for flight when walking on top of fences, fence-gates and stairs.
- Fixed a range of bugs with entity movement and collision on fences, fence-gates, glass panes, iron bars,
doors and a wide variety of other blocks (collision checks on these now account for their correct shape instead of assuming a cuboid bounding box). These bugs occurred due to outdated bounding box caches when blocks' shapes updated.
- Movement anti-cheat is now disabled by default on new installations.
- Oxygen supply is no longer used when the player is underwater in creative or spectator modes.
- Players will no longer take damage on respawn when they were killed while falling from causes other than fall damage.
- Peaceful difficulty no longer disables player-versus-player combat.
- Skins with custom capes and geometry models are now supported.
### Blocks
- Added the following:
- concrete powder
- red sandstone, red sandstone stairs and red sandstone slabs
- purpur, purpur stairs and purpur slabs
- end stone bricks
- Beds no longer leave their other halves behind invisible when broken in survival mode.
- Buttons now have the correct rotation when placed.
- Dead bush now drops 0-2 sticks instead of itself.
- Falling blocks will now fall when placed above fire.
- Falling blocks landing in water will no longer overwrite wrong blocks when moved slightly by currents.
- Farmland will now hydrate when <= 4 blocks from water (crops don't take notice of this yet)
- Farmland and grass path will now turn to dirt if a solid block is placed on top of them.
- Mob heads no longer rotate 45 degrees sideways when placed facing north
- Slab placement in half-block gaps should now (finally!) work correctly.
### Crafting
- Shift-clicking on the recipe book to batch-craft items now works correctly.
- Crafting using mirrored asymmetric shaped recipes now works correctly.
### Entities
- Mob death animations now last the correct length of time.
- Dropped items are now destroyed by lava.
### Items
- Flint and steel will now play a sound when a fire is created.
- Hoes and shovels now break when their damage exceeds their durability (although still take double damage).
- Implemented writable and written books (#1397)
# 3.0.0-ALPHA10
**For Minecraft: Bedrock Edition 1.2.6**
API additions, gameplay additions, bugfixes, more performance, liquids refactor
**This version is an alpha - it is not feature complete. Please do not create issues for missing gameplay features.**
This build does not have major breaking API changes, but has many new feature additions, so the API has been bumped to 3.0.0-ALPHA10.
This will likely be the last release in the ALPHAX series as we are planning to move to a new versioning system. Please see #1769 for details.
Please use our issue tracker to report bugs.
## Core
### General
- RakLib and PocketMine-SPL are now Composer libraries instead of submodules. The installation process is exactly as before - simply run `composer install [...optional extra flags]` and the correct versions of RakLib and SPL will be installed.
- The server will no longer crash when garbage is written in pocketmine.yml for `worlds` or `aliases`.
- Minecraft PE 1.2 LevelDB worlds are now supported with https://github.com/pmmp/php-leveldb version 0.2.1 and the latest version of https://github/com/pmmp/leveldb-mcpe on branch `pmmp-merge`.
- `server.properties` is no longer overwritten when stopping the server (finally!). However, there is one caveat - IF it has been modified at runtime (which rarely happens) without being saved, then it will still be overwritten.
### Performance changes
- Serialized spawn compounds are now cached by tiles for faster spawning. This significantly reduces chunk serialization overhead on the main thread when a chunk contains lots of tiles (since tile NBT has to be encoded on the main thread, and NBT is particularly slow). **Note that `Spawnable->onChanged()` MUST be called by implementations when their NBT changes, to ensure players see changes properly.**
- `CraftingManager` now caches a pre-compressed crafting-data packet to reduce workload on player join.
- Player skin geometry is now automatically stripped of pretty formatting to cut down on bandwidth overhead, since the geometry sizes tend to be very large.
- `Level->isInWorld()` is no longer so horribly (relatively) expensive since the world height is now stored as a field in the level for faster comparison.
- Liquid performance has been drastically improved.
- Light population performance has been drastically improved using subchunk direct accessing (see below in API section).
### Entity
- Fixed errors when an effect duration becomes negative due to the level tick rate being > 1 (such as under lag when auto-tick-rate is enabled).
### Level
- The `disable-block-ticking` config in pocketmine.yml now works correctly.
- Fixed crashes when `Level->getSafeSpawn()` encounters a non-full block.
### Locale
- Fixed incorrect translation key being used for level generation errors.
### NBT
- All known core code is now making use of the new CompoundTag API. **Note that the original method (using dynamic fields) is now deprecated and should be avoided, as it will cease to work in the future.**
### Player
- Players now respawn in the correct spawn world when dying in a different world. This was due to a bug with `Position->add()` returning a `Vector3` unexpectedly.
### Resource packs
- Resource pack UUIDs are now non-case-sensitive.
## API
### Block
- Added API method `Block->getPickedItem()`
### Commands
- The JSON mess leftovers from pre-1.2 in commands have been obliterated. Good riddance.
### Entity
- `Human->sendSkin()` now accepts and defaults to NULL for its `targets` parameter. For a `Human`, using NULL will broadcast its skin to all players who can see it. For a `Player`, it will be broadcasted to all online players (for player list purposes).
- `Entity->setCanClimb()` now has a default value of TRUE for its first parameter.
- `Living->setMaxAirSupplyTicks()` now actually sets the MAX air ticks instead of the current air ticks.
- `Living->addEffect()` now returns a boolean to indicate success.
- Added API methods `Entity->flagForDespawn()` and `Entity->isFlaggedForDespawn()`. These should be used instead of `kill()/close()` and `isAlive()` respectively when wanting to delete an entity without killing it and creating drops. Setting the despawn flag will cause the entity to be deleted on the next tick.
### Events
- Block face click vector is now accessible in `PlayerInteractEvent` for `RIGHT_CLICK_BLOCK` action. I don't know why this wasn't already accessible, but now you can go and make yourself some nice touchscreens with maps.
- Player data is once again saved after `PlayerQuitEvent`. This resolves issues with plugins doing odd things like killing players on quit.
- Cancelling `EntityEffectAddEvent` and `EntityEffectRemoveEvent` now work correctly when cancelled.
### Inventory
- `SlotChangeAction` now checks if the slot number is valid before trying to get items from the inventory - this fixes errors with players putting items at out of bounds offsets when PlayerInteractEvent is cancelled on a crafting table.
### Items
- Added API methods `Armor->getCustomColor()` and `Armor->setCustomColor()`
### Level
- Added API method `Chunk->getSavableEntities()`
- `Level->getName()` no longer crashes after the level has been unloaded and the provider doesn't exist anymore.
- Added a `SubChunkIteratorManager` to modularize the code for faster subchunk accessing. This is now used in `LightUpdate` and `Explosion` and provides drastic performance enhancements.
### NBT
- Extra parameters have been added to `CompoundTag`'s reading methods to allow returning the default when the tag type doesn't match expected.
- Extra parameters have been added to `CompoundTag`'s writing methods to allow forcefully overwriting existing tags with a type that is not what was expected.
### Player
- Added API method `Player->getLocale()`. This returns a locale code of the style `en_US`.
- Added API method `Player->getPing()`. This is reported by RakLib every 5 seconds and returns the player's last measured latency in milliseconds.
- Fixed bugs with bad time values for `Player->hasPlayedBefore()` by reusing calculated time when generating player data for the first time.
### Resource packs
- Added API method `ResourcePack->getPath()` - this returns a path to the resource pack's file(s).
### Server
- `Server->getConfigBoolean()` has been deprecated; its replacement is `Server->getConfigBool()`. The original will be removed in a later version.
- Added API method `Server->getResourcePath()` - this points to the server's file resource directory in the source/phar (`src/pocketmine/resources/`).
### Utils
- Added API method `Config->removeNested()`
- Added API method `Color::mix()`
## Gameplay
### Blocks
- Liquids have undergone a major refactor, the following issues have been fixed:
- CPU leaks when liquids try to flow into other liquids have been fixed
- Liquids no longer flow all over the place when they have a downwards path of least resistance
- Liquids no longer flow in all directions when flowing down a slope instead of just down the slope
- Lava is no longer impossible to get rid of when deleting the source block
- Lava no longer turns to cobblestone when flowing over the top of water
- Performance has been drastically improved
- Mobs now move correctly when liquids flow around them
- Added the following blocks: ender chest (#1462), banner (#1331)
- Block-picking crops will now give the correct item instead of the crop block itself.
### Commands
- Basic command lists are now visible on the client when typing `/`. Arguments are not yet implemented and will always show `[args: message]` (this will come in the future).
- Fixed a crash when attempting to create ListTags with JSON in the `/give` command.
### Entities
- Teleported entities will no longer continue to take damage from the blocks at their origin.
- Entity death smoke cloud now works correctly.
### Items
- Added the following items: banner, rotten flesh
### Level
- Implemented sky light reduction based on time of day. This is used for various things including mob spawning (not implemented yet), grass growth and crop growth (not implemented yet).
### Player
- Falling more than 3.5 blocks now correctly causes fall damage (incorrect floor() instead of ceil()).
- Added a hack to stop players falling into the ground on spawn.
# 3.0.0-ALPHA10 build 516
**For Minecraft: Bedrock Edition 1.2.7**
This release is a support patch for Minecraft: Bedrock Edition v1.2.7 (protocol version 160). It has no breaking changes over the previous ALPHA10 release (1.7dev-501).
# 3.0.0-ALPHA11
**For Minecraft: Bedrock Edition 1.2.7, 1.2.8, 1.2.9**
New gameplay features, level I/O handling refactor, NBT refactor, changes to enchantments
**This version is an alpha - it is not feature complete. Please do not create issues for missing gameplay features.**
This build has breaking API changes, so the API has been bumped to version 3.0.0-ALPHA11.
Please use our issue tracker to report bugs.
## Core
### General
- Fixed `__FILE__` and `__LINE__` being interpreted as C++ macros on Jenkins builds. This did not cause any noticeable bugs, but was still undesirable.
- The NBT library has been moved to its own Composer library, along with `pocketmine\utils\Binary` and `pocketmine\utils\BinaryStream`.
- **Instabreak anti-cheat has been removed from the core code.** A plugin implementing this can be found at https://github.com/pmmp/AntiInstaBreak
- Fixed a race condition causing log messages to not be written to `server.log` when the server crashes.
- Fixed a crash when using /dumpmemory to dump AsyncWorker global variables.
- Fixed memory dumps not including core class static properties.
### Blocks
- Fixed a crash when the right half of a double chest was destroyed while being viewed.
### Commands
- Fixed `/teleport` crash when extra spaces are placed between arguments.
### Entities
- Fixed a crash reading `CustomNameVisible` NBT tag from versions prior to API 3.0.0-ALPHA6.
### Network
- Added configuration option `network.max-mtu-size` to allow restricting the maximum byte size of packets sent without being split up. This may be useful to mitigate connection problems.
### Level
- Fixed ghost blocks bugs due to the block cache not getting cleared when chunks are replaced.
- Fixed Region-based worlds leaking file resources (region GC was broken).
- Entities are no longer close()d when changing levels. This fixes myriad bugs in plugins and finally properly resolves the age-old chunk unload memory leak without undesired behaviour.
- Players joining LevelDB worlds with folder names that don't match the world display name will now not spawn up at y=32767.
### Resource packs
- Errors decoding pack manifests will now raise appropriate error messages instead of `TypeError`s.
## API
### Block
- Added API methods `Block->getDropsForCompatibleTool()` and `Block->getSilkTouchDrops()`.
- `Block->canBeBrokenWith()` has been renamed to `isCompatibleWithTool()`.
### Enchantments
- Enchantments have been split into enchantment types (`Enchantment`) and enchantment instances (`EnchantmentInstance`). `EnchantmentInstance`s should now be used for applying enchantments to items. This change permits various optimizations, and allows separation of immutable type data (such as ID, max level, applicable items, etc) and mutable instance data (such as a specific enchantment's level on an item).
### Entity
- XP API has undergone significant changes. Generic math-only XP logic functions have been moved to `ExperienceUtils` from `Human`.
- Added the following `Human` API methods: `addXpLevels()`, `subtractXpLevels()`, `getCurrentTotalXp()`, `setCurrentTotalXp()`, `addXp()`, `subtractXp()`, `getLifetimeTotalXp()` and`setLifetimeTotalXp()`.
- Added API methods `Entity->isInvisible()` and `Entity->setInvisible()`.
- Data-property handling has undergone significant changes, see #1876 for details.
- Added API method `Living->getArmorInventory()`
### Events
- `PlayerPreLoginEvent` is now called before whitelist and banlist checks are done. This fixes backwards incompatibilities with older plugins which broke after a previous update.
- Cancelling `EntityEffectRemoveEvent` will now throw an exception if the effect's duration has expired.
- Removed `EntityEatEvent` and subclasses. These events didn't make sense because of their hunger-centric nature, meaning that they only applied to Players regardless.
### Inventory
- Added a `$send` parameter to `Inventory->clearAll()`
- Added a `$includeEmpty` parameter to `Inventory->getContents()`
- Removed `Inventory->getHolder()`. Inventories no longer require that you give them an `InventoryHolder`. A holder is now optional to be implemented by subclasses and is not required to be an `InventoryHolder`.
- Armor handling has been removed from `PlayerInventory` and separated into its own `ArmorInventory` class.
- All armor-related methods have been removed from `PlayerInventory`
- `ArmorInventory` now contains armor-specific logic. All living entities have an armor inventory.
- Fixed `Player->removeWindow()` breaking client-sided GUI.
### Item
- Added API method `Item->getEnchantmentLevel()`, which returns the level of the enchantment on the item with the given ID, or 0 if it does not have the enchantment.
- Removed `Item->getMaxDurability()` - this has been moved to `Durable` where it belongs.
### Level
- Added API method `Level->addGlobalPacket()`, which allows queuing a packet to be broadcasted to everyone in the level at the end of the tick, similar to how `addChunkPacket()` works.
- Added API method `Level->dropExperience()`, which drops a given amount of XP as XP orbs into the world.
- `LevelProvider`s are no longer dependent on Levels. This is a significant change because it makes it possible to construct `LevelProvider`s on threads without a `Level`, which opens up **future possibilities** to do many cool things:
- Super-simple world format conversion
- Asynchronous chunk I/O
**(DISCLAIMER: These things are NOT implemented yet, but are examples of things that COULD be done.)**
- The `LevelProvider` interface has undergone significant changes. Unused or redundant methods have been stripped out, and the remaining methods have significant changes:
- `loadChunk()` now directly returns a `Chunk` object read from disk.
- `saveChunk()` now directly accepts a `Chunk` object instead of coordinates.
- `__construct()` now **only** accepts a `string $path`, the `Level` parameter has been removed.
- The following methods have been obsoleted, and therefore removed: `getChunk()`, `setChunk()`, `saveChunks()`, `unloadChunk()`, `unloadChunks()`, `isChunkLoaded()`, `getLoadedChunks()`, `isChunkGenerated()`, `isChunkPopulated()` and `getLevel()`
- `getServer()` method has been removed from `BaseLevelProvider`.
### Math
- Added `Math::solveQuadratic()`
- Fixed `Vector2`'s coordinates magically incrementing when `ceil()` is used repeatedly
- Added `VoxelRayTrace` containing two generator functions, which allow iterating over blocks on a line between two points.
- Removed Math module dependency on `Level` (`AxisAlignedBB` depended on `MovingObjectPosition`).
- Added `RayTraceResult`, which contains data for AxisAlignedBB ray trace results.
### NBT
- NBT read/write logic (streams) have been moved to `NBTStream` and its descendents.
- `NBT` class is now abstract.
- Removed `network` parameters and endianness fields from NBT stream handling. These are now encapsulated in separate implementations of `NBTStream` (`BigEndianNBTStream`, `LittleEndianNBTStream`, `NetworkLittleEndianNBTStream`).
### Permission
- Added `BanList->getEntry()`
### Resource packs
- Added API method `ResourcePackManager->getPath()`, which returns the path to the server's resource packs directory.
### Utils
- The public constant `TextFormat::EOL` has been added. **This should be used instead of `PHP_EOL` when preparing messages to send to players, since `PHP_EOL` is platform-dependent.**
- API method `TextFormat::colorize()` has been added (see #1837 for details).
- `BlockIterator` has been removed in favour of `math\VoxelRayTrace`.
## Gameplay
### Blocks
- Block break times will now display correctly when an incorrect or not good enough tool is used to break a block.
- Fixed beds dropping in creative (#1525)
- Fixed chest items getting rearranged when creating a double chest.
### Effects
- Hunger effect now applies as expected with high amplifiers.
- Implemented the following effects: Saturation, Fatal Poison (used for parrots).
- Levitation effect no longer triggers anti-flight.
### Entities
- Fixed all currently-known occurrences of blocks like fire burning mobs when they are not actually intersecting with the block.
- Armour is now useful for damage types other than PvP.
- Non-player entities can now wear armour (with the help of plugins).
### Items
- Implemented Potion effects
- Implemented Chorus Fruit
- Added sounds for Buckets
- Buckets now show the correct liquid inside when used on still liquids
- Empty buckets now stack to 16
- Implemented the following enchantments: Respiration, Silk Touch, Efficiency, Unbreaking, Protection, Fire Protection, Blast Protection, Feather Falling, Projectile Protection.
### Player
- Fixed players' knockback being messed up.
- Crafting grid contents is no longer dumped into the player's inventory after respawning.
- Fixed interaction anti-cheat false-positives when doing the following (see #983):
- Standing on the corner of a block and breaking it/placing it (player was further than 0.5 blocks from block centre directionally)
- Breaking/placing blocks "behind" self by looking down and using multi-touch mode with mining circle on mobile devices.
- Breaking blocks right at the end of the survival reach distance.
- Adventure mode no longer prevents interacting with blocks.
- Implemented experience and experience orbs.
# 3.0.0-ALPHA11 build 698
**For Minecraft: Bedrock Edition 1.2.10**
This release is a support patch for Minecraft: Bedrock Edition v1.2.10 (protocol version 201). It has no breaking changes over the previous ALPHA11 release (1.7dev-677).
# 3.0.0-ALPHA11 build 703
**For Minecraft: Bedrock Edition 1.2.10**
This release is a bugfix update. It has no breaking changes over the previous ALPHA11 release (1.7dev-698).
### Fixes
- Fixed /timings paste not working since paste.ubuntu.com paste ID update.
# 3.0.0-ALPHA11 build 717
**For Minecraft: Bedrock Edition 1.2.10**
This release is a bugfix update. It has no breaking changes over the previous ALPHA11 release (1.7dev-703).
### Fixes
- Fixed client-side performance issue/lag due to constant spam of empty batch packets (#2020)
# 3.0.0-ALPHA11 build 743
**For Minecraft: Bedrock Edition 1.2.10**
This release is a bugfix update. It has no breaking changes over the previous ALPHA11 release (1.7dev-717).
### Fixes
- Fixed server freeze & performance problems due to XP orbs following players who are too far away (#2028)
# 3.0.0-ALPHA12
**For Minecraft: Bedrock Edition 1.2.13**
Event handler inheritance changes, crafting rewrite, gameplay additions, API changes.
**This version is an alpha - it is not feature complete. Please do not create issues for missing gameplay features.**
This build has breaking API changes, so the API has been bumped to version 3.0.0-ALPHA12.
Please use our issue tracker to report bugs.
## Core
### General
- `start.cmd` will now pause when the server exits with a non-zero exit code, to allow viewing any errors.
- Adding ban entries with ridiculous date values is no longer permitted and will no longer crash the server on restart. This works around [a bug in the date extension in PHP](https://bugs.php.net/bug.php?id=75992) which permits `format()` to create dates which it cannot parse.
- Memory dumps are now created in a separate `memory_dumps` directory.
### Commands
- `/dumpmemory` no longer requires a token to create a memory dump - instead it uses the current time to identify the dump.
### Network
- Query packet responses are now sent only to the originating interface, not all interfaces.
- Decreased on-join load by reducing size of `CraftingDataPacket`.
- Fixed unhandled packet debug spam when armour items are set from the server side.
### World saves
- **Region-based worlds will now no longer be loaded if there are a mixture of types of region files in their `region` directory.** This would previously cause astonishing undefined behaviour which was dependent on the default level format. An error will now be emitted instead: `Cannot identify format of world`.
- `Human` skins now save their skin data using `TAG_ByteArray` instead of `TAG_String`. **This is a backwards-incompatible change, earlier versions will raise errors if you have `Human` entities in your world after upgrading.**
- `Human`s now save their cape data, geometry model and geometry data in their NBT.
- Fixed a huge number of bugs relating to entities being saved on incorrect chunks in negative coordinates.
- Fixed a bug in Region handling that caused incomplete corrupted regions to be retained and later crash the server.
- Fixed chunks getting saved to disk twice on shutdown.
### Player
- Exploits relating to players quitting to main menu on death have been patched.
- Players can no longer modify item frames or signs inside spawn protection.
## Dependency libraries
Requires the following libraries:
- `pocketmine/binaryutils` v0.0.1
- `pocketmine/math` v0.1.0
- `pocketmine/nbt` v0.1.0
- `pocketmine/raklib` v0.11.0
- `pocketmine/spl` v0.3.0
## API
**WARNING: API changes to dependent libraries are not documented here. See individual library releases for notes on their changes.**
### Event handler inheritance changes
This is a new major feature of this release, which makes the hierarchy of event handling much more flexible and versatile. See #1792 for details on this.
Highlights:
- `public static $handlerList` is no longer required in event declarations.
- Any non-abstract event can have a handler registered to it - for example, you can now register handlers for both `EntityDamageEvent` (which will receive any instanceof `EntityDamageEvent`) and also be able to register a separate handler specifically for `EntityDamageByEntityEvent`.
- Abstract events may be handled using the above rules if they declare the `@allowHandle` PhpDoc annotation.
- Handlers will always handle all subclasses of an event. This slightly differs from existing behaviour, where handlers would only receive subclass events which did not declare their own handler lists.
### Block
- `Block->onUpdate()` hook has been removed, and is replaced by several new methods: `onScheduledUpdate()`, `onNearbyBlockChange()`, and `onRandomUpdate()`. The associated `Level::BLOCK_UPDATE_*` constants have been removed.
### Commands
- `Command->getPermissionMessage()` is now permitted to return `null`.
- `ConsoleCommandSender->isPlayer()` has been removed.
### Entity
- `Item`, `PrimedTNT` and `FallingSand` have been moved to `object\ItemEntity`, `object\PrimedTNT` and `object\FallingBlock` respectively.
- Classes `entity\object\Painting` and `entity\object\PaintingMotive` have been added.
- Added hook for nearby block updates: `Entity->onNearbyBlockChange()`.
- Added API method `Living->hasEffects()` which returns if the entity has any active status effects.
- `Effect` has been split into `Effect` (type) and `EffectInstance`. Methods relating to instance-specific things of `Effect` have been moved to `EffectInstance`. See dc3bf8546e2f700cb79adf988e15735a0c2d84fa for implementation examples.
### Events
- `PlayerCreationEvent->getClientId()` has been removed.
- Added new events `ProjectileHitBlockEvent` and `ProjectileHitEntityEvent`.
- Added new event `PlayerExperienceChangeEvent`.
- Triggering a call to an event inside a handler of that event will no longer cause a segmentation fault. Instead, the maximum recursion depth for event calls has now been limited to 50 calls. Trying to go beyond this depth will cause an exception to be thrown.
### Inventory
- `BigCraftingGrid` has been removed. Instead, `CraftingGrid` now accepts a grid size in the constructor.
- Added API method `Inventory->isSlotEmpty()`.
- Optimized `BaseInventory->getContents()` method.
- `DropItemAction` no longer requires a source item in the constructor (this was useless anyway).
- `InventoryAction->getCreationTime()` has been removed.
#### Crafting
Crafting-related things have been mostly rewritten in this release and have significant changes.
The following classes have been removed:
- `CraftingTransferMaterialAction`
- `CraftingTakeResultAction`
The following classes have significant changes:
- `CraftingManager`
- removed the following: `getRecipe(UUID)`, `getRecipes()`
- `matchRecipe()` now accepts `CraftingGrid, Item[]` instead of `Item[][], Item, Item[]`
- `CraftingTransaction`
- All API methods have been removed and are now handled in `CraftItemEvent`
- `CraftItemEvent`
- added the following: `getInputs()`, `getOutputs()`, `getRepetitions()`
- `Recipe` interface:
- Removed `getResult()` (because individual recipes may handle this differently)
- `CraftingRecipe` interface
- removed the following: `matchItems()`, `getExtraResults()`, `getAllResults()`, `requiresCraftingTable()`, `getId()`, `setId()`
- added the following: `getResultsFor(CraftingGrid)`, `getIngredientList()`, `matchesCraftingGrid(CraftingGrid)`
- `ShapedRecipe`
- constructor now accepts `string[], Item[], Item[]`
- `ShapelessRecipe`
- constructor now accepts `Item[], Item[]`
### Item
- `ItemFactory::init()` no longer calls `Item::initCreativeItems()`.
- `ItemFactory::fromString()` now throws exceptions on failure to parse a string as a valid item ID. Previously it would silently return an Air item.
- Added API method `Item->getVanillaName()`, which returns the name of an item without any custom name NBT masking it.
### Language
- `event\TranslationContainer` and `event\TextContainer` have been moved to the `lang` namespace.
### Level
- Added API method `Level->getRandomTickedBlocks()`.
- `Explosion->__construct()` will now throw exceptions on invalid parameters.
- Removed dead generator things `Level->generateChunk()`, `Level->regenerateChunk()`, `GenerationTask`.
- `Level->setBlock()` now clones the `Block` object given as a parameter, fixes unexpected behaviour with setting blocks in `BlockPlaceEvent` using `BlockPlaceEvent->getBlock()`.
- `MovingObjectPosition` has been removed.
### Player
- `Player->__construct()` no longer accepts a `clientID` parameter.
- `Player->teleportImmediate()` has been removed.
- `Player->getClientSecret()` has been removed.
- `Player->getLastPlayed()` no longer always returns when the player started their current session. In the future it will only return when they last quit the server (or the same as firstPlayed if they haven't played before), but existing save data will still cause the bug until the player next joins.
### Plugin
- Added API method `PluginDescription->getMap()` which returns an associative array of the contents of `plugin.yml`.
- `PluginLoader` interface now requires the implementation of `canLoadPlugin(string) : bool`.
### Scheduler
- Throwables thrown from `AsyncTask->onCompletion()` will no longer crash the server.
### Server
- `Server->updatePlayerListData()` now has an extra `xuid` parameter before the `players` parameter.
- `Server->getResourceManager()` has been renamed to `Server->getResourcePackManager()`
- `Server->addPlayer()` now accepts a `Player` as its only parameter.
- `Server->addRecipe()` has been removed. Use `Server->getCraftingManager()->registerRecipe()` instead.
- `Server->getConfigBoolean()` has been removed in favour of `Server->getConfigBool()`.
- `Server->getDifficultyFromString()` has been removed in favour of its corresponding method in `Level`.
- Added API methods `Server->getPlayerByUUID()` and `Server->getPlayerByRawUUID()`.
### Utils
- All generic utility functions have been moved from `PocketMine.php` to the `Utils` class.
- Timezone-related functions have been moved to `pocketmine\utils\Timezone`.
- `TextFormat::toANSI()` has been moved to `Terminal` since it directly pertains to the terminal output and has platform-dependent output.
## Gameplay
### Blocks
- Fixed a block-updating race-condition bug causing ghost blocks to sometimes appear on the client-side.
### Commands
- Commands with aliases are now shown correctly on the client-side. Previously only the aliases would be visible and the original command would be missing.
### Entities
- Entity teleporting now is now correctly visible to players.
- Regeneration effect no longer permits more than 2 sets of incoming damage per second on mobs.
- Implemented Paintings.
- Projectiles now use ray tracing for movement. This significantly improves movement of projectiles, particularly fixing arrows getting stuck in mid-air and clipping through the corners of blocks.
- Arrows now make the correct collision sound and shake on impact.
- Taking damage with Resistance levels >5 will no longer give the subject absorption hearts.
- Falling blocks are no longer moved by liquid currents.
### Items
- Implemented Ender Pearls, Splash Potions and Bottle o' Enchanting.
- Bows and throwable projectiles now make the correct sound when used.
- Implemented armour durability.
- Added some missing food items.
- Fixed mess of incorrectly-registered Fish items.
### Player
- Xbox Live icons are now shown on the server list.
- Fixed a slot count offset bug that caused changes to player armour not to be visible in the inventory.
- Implemented critical hits.
- Players can no longer eat food requiring hunger when in creative mode.
- Fixed block placement bugs due to AABB floating-point inaccuracies.
# 3.0.0-ALPHA12 build 999
**For Minecraft: Bedrock Edition 1.4.0**
This release is a support patch for Minecraft: Bedrock Edition v1.4.0 (protocol version 261). It has no breaking changes over the previous ALPHA12 release (1.7dev-937).
# 3.0.0-ALPHA12 build 1001
**For Minecraft: Bedrock Edition 1.4.0**
This release is a hotfix update over the previous build and has no breaking changes versus the previous release (1.7dev-999).
### Fixes
- Command data is no longer sent on permission recalculation prior to player spawning, fixes game crash issues when the server is using PurePerms or similar.
View Git Blame Copy Permalink