AmberPM v1.7.1

AmberPM 1.7.1

AmberPM 1.7.1 is a hotfix that brings redstone closer to Bedrock, improves a few networking messages and tightens chunk handling.

Minecraft: Bedrock Edition: Multi-version support up to 26.60 (protocol 2225)
Plugin API: 5.44.2

Highlights

Redstone

• Dust connects to the back and sides of pistons, as in Bedrock.
• Pistons start moving two ticks after the power changes and keep short pulses.
• Repeaters stretch short on-pulses to their delay.
• Comparators no longer take a block of redstone as side input, read through a block, and measure cakes, lecterns, jukeboxes, respawn anchors, item frames, end portal frames, chiseled bookshelves and copper bulbs.
• Pistons can move lanterns, candles, bells, lecterns, daylight detectors and chiseled bookshelves.
• Redstone updates for unloaded chunks are kept and run when the chunk loads.

Pistons and repeaters now follow Bedrock timings more closely, so clocks and machines built for 1.7.0 may behave slightly differently.

Networking

• The RakNet server list reply advertises the current protocol and version.
• A taken NetherNet signaling port now names the port and points at plugins like RCON.

Performance & stability

• The block cache counter stays exact when blocks are invalidated.
• The chunk unload queue stops at the first chunk that is not due yet.
• Generator workers are checked by id when picking one for a task.

For the complete list of changes, see the 1.7.1 changelog:

https://github.com/Amber-PM/Amber/blob/main/changelogs/1.7.md

---

Pull requests

The following are the main pull requests included in this release.

Hotfix

• #69 - Hotfix 1.7.1

Contributors

Thanks to everyone who contributed to this release:

• @vapebw - Redstone parity, performance fixes, networking fixes, and release engineering.

Downloads & upgrading

Download PocketMine-MP.phar from the assets below.

A compatible PHP runtime with ext-rtc is required for this release:

• Amber PHP 8.4.27 (Recommended): https://github.com/Amber-PM/PHP-Binaries/releases/tag/amber-php-8.4.27-r5
• Amber PHP 8.5.12 (Pre-release runtime): https://github.com/Amber-PM/PHP-Binaries/releases/tag/amber-php-8.5.12-r5

The Linux runtime from r5 runs on Debian 12, Ubuntu 22.04 and other hosts with glibc 2.35 or newer.

NetherNet needs TCP on your server port and UDP for game traffic (20000-20127 by default). On hosting panels with one or two ports, follow the setup guide below.

The PocketMine-MP plugin API remains at 5.44.2. Back up your worlds, configuration and nethernet.key before upgrading.

AmberPM is intended primarily for custom servers, minigames, and multi-version networks. It is not a complete vanilla Minecraft implementation.

---

Setup help

NetherNet is new for everyone, so we will help you set it up.

• Setup guide: https://github.com/Amber-PM/Amber/wiki/NetherNet-Setup
• AI guide: paste docs/NetherNet-AI-Guide.md into ChatGPT, Claude or Gemini and it will walk you through your case step by step. It is also attached below.
• Pterodactyl / Pelican egg: https://github.com/Amber-PM/egg
• Still stuck? Ask in Discord with your console lines that contain NetherNet and we will help.

---

Support & community

• Discord: https://discord.gg/w2nHHADWvF
• Bug reports: https://github.com/Amber-PM/Amber/issues
• Source code: https://github.com/Amber-PM/Amber

AmberPM v1.7.0

AmberPM 1.7.0

AmberPM 1.7.0 brings NetherNet, the WebRTC transport Minecraft: Bedrock Edition uses from 26.60 on, together with support for Bedrock 26.60.

This release also makes AmberPM easier to run on hosting panels and containers.

Minecraft: Bedrock Edition: Multi-version support up to 26.60 (protocol 2225)
Plugin API: 5.44.2

Highlights

NetherNet

• Native NetherNet transport over the ext-rtc extension. Clients from 26.50 on join over NetherNet, 26.60 clients only use NetherNet, and RakNet keeps serving older versions.
• Persistent nethernet.key server identity, signed answers, and the transport key is checked against the Login key.
• Per-IP limits for signaling and connections.
• Native ping and bandwidth stats for NetherNet sessions in /status.

Multi-version

• Added Minecraft: Bedrock Edition 26.60 (protocol 2225).
• Tested with 26.60 and 26.52 clients on the same server.

Hosting & setup

• The console prints the TCP and UDP ports to open on startup.
• network.raknet-port moves RakNet to another UDP port, or turns it off with -1 on single-port hosts.
• AMBER_NETHERNET_PORT and AMBER_NETHERNET_PUBLIC_IP environment variables for panels and containers.
• The phar cache falls back to a tmp folder next to the phar when /tmp is too small.
• /etc/machine-id is only read when readable, fixing startup in locked-down containers.

For the complete list of changes, see the 1.7.0 changelog:

https://github.com/Amber-PM/Amber/blob/main/changelogs/1.7.md

---

Pull requests

The following are the main pull requests included in this release.

Networking

• #66 - NetherNet transport
• #67 - raknet-port and machine-id fix

Multi-version

• #65 - Bedrock 26.60

Contributors

Thanks to everyone who contributed to this release:

• @vapebw - NetherNet integration, Bedrock 26.60 support, hosting compatibility, and release engineering.

Downloads & upgrading

Download PocketMine-MP.phar from the assets below.

A compatible PHP runtime with ext-rtc is required for this release:

• Amber PHP 8.4.27 (Recommended): https://github.com/Amber-PM/PHP-Binaries/releases/tag/amber-php-8.4.27-r5
• Amber PHP 8.5.12 (Pre-release runtime): https://github.com/Amber-PM/PHP-Binaries/releases/tag/amber-php-8.5.12-r5

NetherNet needs TCP on your server port and UDP for game traffic (20000-20127 by default). On hosting panels with one or two ports, follow the setup guide below.

The PocketMine-MP plugin API remains at 5.44.2. Back up your worlds, configuration and nethernet.key before upgrading.

AmberPM is intended primarily for custom servers, minigames, and multi-version networks. It is not a complete vanilla Minecraft implementation.

---

Setup help

NetherNet is new for everyone, so we will help you set it up.

• Setup guide: https://github.com/Amber-PM/Amber/wiki/NetherNet-Setup
• AI guide: paste docs/NetherNet-AI-Guide.md into ChatGPT, Claude or Gemini and it will walk you through your case step by step. It is also attached below.
• Pterodactyl / Pelican egg: https://github.com/Amber-PM/egg
• Still stuck? Ask in Discord with your console lines that contain NetherNet and we will help.

---

Support & community

• Discord: https://discord.gg/w2nHHADWvF
• Bug reports: https://github.com/Amber-PM/Amber/issues
• Source code: https://github.com/Amber-PM/Amber

AmberPM v1.6.0

AmberPM 1.6.0

AmberPM 1.6.0 is a major feature release focused on multi-version compatibility, native gameplay mechanics, and expanded APIs for plugin developers.

This release also includes protocol handling improvements, security fixes, and performance optimizations.

Minecraft: Bedrock Edition: Multi-version support up to 1.26.50 (protocol 2193)
Plugin API: 5.44.2

Highlights

Multi-version & networking

• Updated the default Bedrock protocol to 2193.
• Decoupled protocol mappings from CURRENT_PROTOCOL.
• Improved chunk caching, palette sharing, and compatibility fallbacks for older clients.
• Improved protocol admission, inventory synchronization, and packet handling.

Native gameplay

• Redstone simulation, pistons, sticky pistons, dispensers, and droppers.
• Shields, crossbows, tipped arrows, and firework projectiles.
• Elytra gliding and firework boosting.
• Wolves, cats, and persistent pet ownership.
• Armor Stands with equipment and posing.
• Native Bedrock Spectator mode.

APIs & server tools

• Native Camera API with custom presets and camera controls.
• Fluent Forms API with typed responses and callbacks.
• Manual and automatic world backups with asynchronous verification.
• New /world and /protocols commands.

Fixes & stability

• Fixed anvil item duplication and login replay handling.
• Fixed offhand inventory prediction issues.
• Fixed item dropping on newer Bedrock clients.
• Corrected projectile effects, shield interactions, and several entity state issues.

For the complete list of changes, see the 1.6.0 changelog:

https://github.com/Amber-PM/Amber/blob/main/changelogs/1.6.md

---

Pull requests

The following are the main pull requests included in this release.

Core & networking

• #40 - Decouple multi-version mappings from CURRENT_PROTOCOL
• #30 - Protocol-aware cache and palette optimizations
• #29 - Security fixes for anvils, login handling, and item renaming
• #13 - Adventure placement prediction and combat feedback fixes

Gameplay

• #20, #21 - Armor Stands and tameable pets
• #22, #23 - Shields and Elytra
• #25, #27 - Dispensers, droppers, and pistons
• #26, #38 - Crossbows, archery, and tipped arrows

APIs & tools

• #14 - Native Camera API
• #32 - Fluent Forms API
• #33 - Automatic world backups
• #36 - Native Spectator mode

Release integration: #42 - AmberPM 1.6.0

Contributors

Thanks to everyone who contributed to this release:

• @vapebw - Project maintenance, protocol integration, Camera API, and release engineering.
• @ManiTheFerfri - Native gameplay systems, APIs, performance improvements, and security fixes.
• @Kazurikiope - Adventure-mode compatibility and combat feedback fixes.

Downloads & upgrading

Download PocketMine-MP.phar from the assets below.

A compatible PHP runtime is required:

• Amber PHP 8.4.27 (Recommended): https://github.com/Amber-PM/PHP-Binaries/releases/tag/amber-php-8.4.27-r2
• Amber PHP 8.5.12 (Pre-release runtime): https://github.com/Amber-PM/PHP-Binaries/releases/tag/amber-php-8.5.12-r2

The PocketMine-MP plugin API remains at 5.44.2. Back up your worlds and configuration before upgrading.

AmberPM is intended primarily for custom servers, minigames, and multi-version networks. It is not a complete vanilla Minecraft implementation.

---

Support & community

• Discord: https://discord.gg/w2nHHADWvF
• Bug reports: https://github.com/Amber-PM/Amber/issues
• Source code: https://github.com/Amber-PM/Amber

v1.5.0

Release 1.5.0

• Added support for Minecraft: Bedrock Edition 1.26.5x.

Credits:

• Special thanks to @Kazurikiope for the initial Minecraft 1.26.5x support implementation.

---

For support and discussions, join our Discord Server.
PLEASE REPORT ANY BUG!

v1.4.2

Hotfix Release - v1.26.44

This hotfix addresses critical network desynchronization issues and scoreboard handling for Minecraft Bedrock 1.26.4x clients.

Fixes

• Network & Connectivity: Fixed an unexpected client disconnect issue affecting mobile and desktop clients on recent Bedrock versions (1.26.44 / 1.26.45).
• Scoreboard: Fixed compatibility and property access errors with SetScorePacket entry actions, ensuring custom scoreboard plugins operate properly.
• World Storage: Corrected LevelDB world format protocol version checks.

---

For support and discussions, join our Discord Server.
PLEASE REPORT ANY BUG!

v1.4.1

Fix

• Fixed SetScorePacket (>= protocol 1.26.40) not matching the real 1.26.44 wire format, causing scoreboard desync with clients on that version.
  • The entry type name is now validated against the action ordinal instead of being silently discarded.
  • REMOVE entries now correctly use a double-optional objectiveName, matching the client's actual encoding.
  • Entry type is now represented as a ScorePacketEntryAction enum instead of a raw int, with a PacketOrdinalEnumTrait helper for ordinal/string mapping.
• Older protocol versions (< 1.26.40) are untouched — this only affects the current protocol branch.
• No composer/dependency changes, no plugin API changes.

v1.4.0

Release v1.4.0

• Added native PrimitiveShapes API with 10 3D shape primitives (Box, Sphere, Circle, Cylinder, Text, etc.).
• Added entity shape attachment and chunk replay for shape rendering.
• Implemented native ClientInputLocks API for rubberband-free movement and action freezes.
• Added PlayerInputLockEvent for cancellable client input locking.
• Fixed connection issues on 1.26.20 & 1.26.30 Bedrock clients.
• Added protocol allowlist and denylist configuration in pocketmine.yml.

v1.3.0

v26.40

• Added support for Minecraft: Bedrock Edition 1.26.40.
• Update by @funaoo.

v1.2.0

Release v1.2.0

• Added chunk unloading optimizations (saves up to 90% memory on high render distances). (credits to remminiscent)
• Implemented command overloading with PHP 8 attributes. (credits to funaoo)
• Migrated 40+ vanilla default commands to the new model.
• Added native command autocompletion mappings to the network session.
• Fixed item autocomplete icons for the /give command using Bedrock's item dictionary.

v1.1.0

v1.1.0

• Case-insensitive commands: You can now run /GAMEMODE or /gAmeMoDe and they'll work just fine.
• Perm commands in core: /checkperm and /listperms (along with /listpermissions alias) are now built into the core, no DevTools needed.
• Shaders control: Added default-disable-vibrant-visuals to pocketmine.yml and an event method (PlayerResourcePackOfferEvent::setForceDisableVibrantVisuals) so plugins can toggle client shaders per-player.