Merge branch 'major-next' of github.com:pmmp/PocketMine-MP into string-block-type-ids

Author: dktapps

.github/workflows/draft-release.yml

@@ -155,7 +155,7 @@ jobs:
         run: php tools/generate-permission-doc.php rst
 
       - name: Upload release artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: release_artifacts
           path: |

.gitmodules

@@ -1,3 +1,6 @@
 [submodule "build/php"]
 	path = build/php
 	url = https://github.com/pmmp/php-build-scripts.git
+[submodule "examples/plugins/ExamplePlugin"]
+	path = examples/plugins/ExamplePlugin
+	url = git@github.com:pmmp/ExamplePlugin.git

build/php

@@ -642,6 +642,7 @@ However, if we add `src-namespace-prefix: pmmp\TesterPlugin` to the `plugin.yml`
   - `InventoryPickupItemEvent->getItem()` -> `InventoryPickupItemEvent->getItemEntity()`
 
 #### Other changes
+- The `@softDepend` doc-comment tag for `Listener` event handlers is no longer supported.
 - Disconnecting players during events no longer crashes the server (although it might cause other side effects).
 - Cancellable events must now implement `CancellableTrait` to get the cancellable components needed to satisfy interface requirements. `Event` no longer stubs these methods.
 - `PlayerInteractEvent` is no longer fired when a player activates an item. This fixes the age-old complaint of `PlayerInteractEvent` firing multiple times when interacting once. The following constants have been removed:

changelogs/4.0.md

@@ -0,0 +1,25 @@
+# 5.37.0
+Released 28th October 2025.
+
+This is a support release for Minecraft: Bedrock Edition 1.21.120.
+
+**Plugin compatibility:** Plugins for previous 5.x versions will run unchanged on this release, unless they use internal APIs, reflection, or packages like the `pocketmine\network\mcpe` or `pocketmine\data` namespace.
+Do not update plugin minimum API versions unless you need new features added in this release.
+
+**WARNING: If your plugin uses the `pocketmine\network\mcpe` namespace, you're not shielded by API change constraints.**
+Consider using the `mcpe-protocol` directive in `plugin.yml` as a constraint if you're using packets directly.
+
+## Interim releases
+If you're upgrading from 5.35.x directly to 5.37.0, please also read the following changelogs, as the interim releases contain important changes:
+- [5.36.0](https://github.com/pmmp/PocketMine-MP/blob/5.37.0/changelogs/5.36.md) - user experience improvements, new gameplay features, new API additions and network changes
+
+## General
+- Added support for Minecraft: Bedrock Edition 1.21.120 (@dries-c).
+- Removed support for earlier versions.
+
+# 5.37.1
+Released 7th November 2025.
+
+## Fixes
+- Updated BedrockProtocol dependency to get encoding fixes for `DebugDrawerPacket`.
+- Fixed critical hit particles not showing.

changelogs/5.37.md

@@ -35,9 +35,9 @@
       "adhocore/json-comment": "~1.2.0",
       "netresearch/jsonmapper": "~v5.0.0",
       "pocketmine/bedrock-block-upgrade-schema": "~5.2.0+bedrock-1.21.110",
-      "pocketmine/bedrock-data": "~6.1.0+bedrock-1.21.111",
+      "pocketmine/bedrock-data": "~6.2.0+bedrock-1.21.120",
       "pocketmine/bedrock-item-upgrade-schema": "~1.16.0+bedrock-1.21.110",
-      "pocketmine/bedrock-protocol": "~52.0.0+bedrock-1.21.111",
+      "pocketmine/bedrock-protocol": "~53.1.0+bedrock-1.21.120",
       "pocketmine/binaryutils": "^0.2.1",
       "pocketmine/callback-validator": "dev-rewrite",
       "pocketmine/color": "^0.3.0",
@@ -52,7 +52,7 @@
       "symfony/filesystem": "~7.3.0"
    },
    "require-dev": {
-      "phpstan/phpstan": "2.1.25",
+      "phpstan/phpstan": "2.1.32",
       "phpstan/phpstan-phpunit": "^2.0.0",
       "phpstan/phpstan-strict-rules": "^2.0.0",
       "phpunit/phpunit": "^12.2.1"

composer.json

@@ -0,0 +1,41 @@
+<?php
+
+namespace pmmp\ExampleScriptPlugin;
+
+use pocketmine\event\Listener;
+use pocketmine\event\world\WorldLoadEvent;
+use pocketmine\plugin\PluginBase;
+
+/**
+ * Script plugins are self-contained .php files. They are intended for quick testing only.
+ * They don't support all the features of a normal plugin.
+ * See the documentation at https://doc.pmmp.io/en/rtfd/developers/plugin-docs/plugin-formats/development.html#script
+ *
+ * Required fields
+ * @main pmmp\ExampleScriptPlugin\Main
+ * @api 5.37.0
+ *
+ * Optional fields
+ * Version and name are optional in script plugins for convenience, and will be filled with 1.0.0 and
+ * ScriptPlugin_{file name without extension} respectively.
+ * @version 1.0.0
+ * @name ExampleScriptPlugin
+ * @load STARTUP
+ */
+class Main extends PluginBase{
+	public function onEnable() : void{
+		$this->getServer()->getPluginManager()->registerEvents(new ExampleListener($this->getLogger()), $this);
+	}
+}
+
+class ExampleListener implements Listener{
+
+	public function __construct(
+		private \Logger $logger
+	){}
+
+	public function onWorldLoad(WorldLoadEvent $event) : void{
+		$this->logger->info("Script plugin detected world " . $event->getWorld()->getDisplayName() . " being loaded!");
+	}
+}
+

composer.lock

@@ -1,10 +1,8 @@
 includes:
 	- tests/phpstan/analyse-for-current-php-version.neon.php
 	- tests/phpstan/configs/actual-problems.neon
-	- tests/phpstan/configs/impossible-generics.neon
 	- tests/phpstan/configs/phpstan-bugs.neon
 	- tests/phpstan/configs/property-hook-sadness.neon
-	- tests/phpstan/configs/reflection-class-sadness.neon
 	- tests/phpstan/configs/spl-fixed-array-sucks.neon
 	- vendor/phpstan/phpstan-phpunit/extension.neon
 	- vendor/phpstan/phpstan-phpunit/rules.neon